Skip to content

installation.md

Latest commit

 

History

History
272 lines (173 loc) · 6.74 KB

installation.md

File metadata and controls

272 lines (173 loc) · 6.74 KB
Raw

安装指南

系统要求

平台 支持情况 说明
Windows 支持 推荐 Windows 10 或更高版本
Linux 支持 预构建版本要求 Ubuntu 22.04 或更高版本
macOS 支持 支持 Intel 和 Apple Silicon
Docker 支持 适用于其他 Linux 发行版或无预构建版本的平台
Python 支持 推荐 Python 3.11

方法一：下载预构建版本

前往 GitHub Releases，下载与当前系统及处理器架构对应的安装包。

常见平台对应关系如下：

系统 处理器架构 安装包标识
Windows x86_64 / AMD64 windows_amd64
Linux x86_64 / AMD64 linux_amd64
Linux ARM64 / AArch64 linux_arm64
macOS Apple Silicon macos_arm64
macOS Intel macos_intel

下载完成后，解压安装包并运行其中的程序：

  • Windows：biliTickerBuy.exe
  • Linux / macOS：biliTickerBuy

如果安装包中包含更新脚本，也可以使用其中的脚本更新程序。

方法二：Linux / macOS 命令行安装

Linux 预构建版本要求 Ubuntu 22.04 或更高版本。其他 Linux 发行版建议使用 Docker 或 PyPI 安装。

安装脚本会自动识别当前系统和处理器架构、下载最新版本，并创建 btb 启动命令。

执行以下命令：

curl -fsSL https://raw.githubusercontent.com/mikumifa/biliTickerBuy/main/install.sh | sh

安装完成后运行：

btb

如果是在服务器上运行，为了让其他设备能够访问 Web 界面，server_name 应配置为服务器对外访问的 IP，例如：

btb --server_name 服务器对外访问的IP

GitHub 下载代理

Linux / macOS 安装脚本默认使用以下加速前缀下载 GitHub Release 文件：

https://gh-proxy.org/

如果默认代理失效，可以前往 ghproxy.link 查找其他可用前缀。

安装脚本会在代理下载失败后尝试直连 GitHub。

自定义 Linux / macOS 安装参数

安装脚本支持通过环境变量自定义 GitHub 下载代理、程序安装目录和命令目录。

环境变量 说明
GH_PROXY GitHub 下载加速前缀，设置为空可禁用代理
INSTALL_DIR 程序安装目录
BIN_DIR btb 启动命令所在目录

通过管道执行安装脚本时，需要将环境变量传递给 sh。

自定义代理

curl -fsSL https://raw.githubusercontent.com/mikumifa/biliTickerBuy/main/install.sh |
  GH_PROXY="https://其他代理前缀" sh

禁用代理并直连 GitHub

curl -fsSL https://raw.githubusercontent.com/mikumifa/biliTickerBuy/main/install.sh |
  GH_PROXY="" sh

自定义安装目录

curl -fsSL https://raw.githubusercontent.com/mikumifa/biliTickerBuy/main/install.sh |
  INSTALL_DIR="$HOME/apps/biliTickerBuy" \
  BIN_DIR="$HOME/.local/bin" \
  sh

同时自定义代理和安装目录

curl -fsSL https://raw.githubusercontent.com/mikumifa/biliTickerBuy/main/install.sh |
  GH_PROXY="https://其他代理前缀" \
  INSTALL_DIR="$HOME/apps/biliTickerBuy" \
  BIN_DIR="$HOME/.local/bin" \
  sh

方法三：使用 Docker

如果 GitHub Releases 中没有适用于当前系统的预构建版本，或者当前 Linux 发行版不满足预构建版本要求，可以使用 Docker 运行。

具体步骤请参考：

Docker 部署指南

使用 Docker 前，请先确认已经安装：

  • Docker Engine 或 Docker Desktop
  • Docker Compose

Docker 方式不会依赖宿主机中的 Python 环境，适合服务器部署或环境隔离。

方法四：使用 PyPI 安装

项目支持通过 PyPI 安装，推荐使用 Python 3.11。

确认 Python 版本：

python --version

安装 biliTickerBuy：

python -m pip install --upgrade bilitickerbuy

安装完成后运行：

btb

如果系统中存在多个 Python 版本，也可以明确指定 Python 3：

python3 -m pip install --upgrade bilitickerbuy

更新程序

Windows 预构建版本

进入程序所在目录，运行安装包中的更新脚本：

update.bat

也可以前往 GitHub Releases 手动下载并替换为最新版本。

Linux / macOS 命令行安装版本

再次运行安装脚本即可下载并安装最新版本：

curl -fsSL https://raw.githubusercontent.com/mikumifa/biliTickerBuy/main/install.sh | sh

如果安装目录中包含更新脚本，也可以运行：

./update.sh

PyPI 安装版本

python -m pip install --upgrade bilitickerbuy

常见问题

下载失败

Linux / macOS 安装脚本会在代理下载失败后尝试直连 GitHub。

如果仍然失败，可以：

  1. 检查当前网络是否能够访问 GitHub。
  2. 更换 GH_PROXY 加速前缀。
  3. 设置 GH_PROXY="" 禁用代理并尝试直连。
  4. 前往 GitHub Releases 手动下载安装包。

禁用代理：

curl -fsSL https://raw.githubusercontent.com/mikumifa/biliTickerBuy/main/install.sh |
  GH_PROXY="" sh

Linux 提示权限不足

安装脚本默认安装到用户目录，不需要使用 sudo。

如果手动下载了可执行文件，可以添加执行权限：

chmod +x biliTickerBuy

Windows 阻止程序运行

如果 Windows Defender 或 SmartScreen 弹出安全提示，请先确认程序来自本项目的官方 GitHub 仓库。

项目官方下载地址：

GitHub Releases

确认文件来源可信后，再根据系统提示选择是否继续运行。

Linux / macOS 安装后找不到 btb

安装脚本默认会将命令目录添加到用户的 PATH。

更新后的 PATH 通常不会立即应用到已经打开的终端。请关闭并重新打开终端，然后执行：

btb

也可以根据安装完成时显示的提示，使用完整路径运行程序。

PyPI 安装后找不到命令

这通常是 Python 的脚本目录没有加入 PATH。

可以通过以下命令查看用户安装目录：

python -m site --user-base

也可以直接通过 Python 模块方式尝试启动：

python -m biliTickerBuy