安装指南

中文 | English

本页列出全部获取方式。当前最新版本见 Releases。各芯片架构与操作系统的详细支持矩阵见 芯片与操作系统支持。

直接下载

渠道	地址	说明
GitHub Releases	https://github.com/yxpil/bit/releases	官方发布页
官网镜像	https://osbt.space	Fastly CDN，无重定向
Gitee 镜像	https://gitee.com/yxpil/bit	国内网络备用

平台安装包对照

平台	安装包	说明
Windows x64	*-setup.exe（NSIS）或 *.msi	双击安装
Windows ARM64（骁龙 X）	*_arm64-setup.exe	WiX 对 ARM64 支持差，无 MSI
macOS Apple Silicon	*_aarch64.dmg	M 系列芯片；另有 *_app.zip 便携版
macOS Intel	*_x64.dmg	拖入 Applications
Linux x64 / ARM64	*.deb / *.AppImage / *.rpm	按发行版习惯选择
龙芯 LoongArch64（3A5000/3A6000）	*_loongarch64.deb / *.tar.gz	deb 双击安装；其他发行版解压二进制
RISC-V 64（VisionFive 2 等）	*_riscv64.deb / *.tar.gz	同上
飞腾 / 鲲鹏 / 麒麟 ARM	*_arm64.deb / *_arm64.AppImage / *_arm64.rpm	与 Linux ARM64 通用
兆芯 / 海光	*_amd64.deb / *_x86_64.rpm	与 Linux x64 通用

包管理器

macOS（Homebrew）：

brew tap yxpil/bit
brew install --cask bit

Windows（Scoop）：

scoop bucket add bit https://github.com/yxpil/scoop-bit
scoop install bit

Windows（winget，审核中）：

winget install yxpil.bit

npm（跨平台，自动下载对应平台应用）：

npm install -g bit-agent
bit-agent   # 启动 BIT

Debian / Ubuntu / UOS / 麒麟（APT 源）：

echo "deb [trusted=yes] https://yxpil.github.io/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/bit.list
sudo apt update && sudo apt install bit

Fedora / RHEL / openSUSE（dnf 源）：

sudo tee /etc/yum.repos.d/bit.repo <<'EOF'
[bit]
name=BIT
baseurl=https://yxpil.github.io/dnf-repo
enabled=1
gpgcheck=0
EOF
sudo dnf install bit

Arch / Manjaro（pacman 源）：

echo "
[bit]
Server = https://yxpil.github.io/pacman-repo/\$arch
SigLevel = Never" | sudo tee /etc/pacman.d/bit.conf
# 再在 /etc/pacman.conf 的 [core] 前加一行：Include = /etc/pacman.d/bit.conf
sudo pacman -Sy bit

ChromeOS（Crostini）

ChromeOS 内置 Linux 开发环境（Debian 12 容器），Linux 安装包可直接使用：

1. 设置 → 关于 ChromeOS → 开发者 → Linux 开发环境 → 启用（Intel/AMD 与 ARM 机型均支持）
2. Linux 终端安装（Intel/AMD 选 amd64，ARM 选 arm64）：

sudo apt install ./BIT_0.5.6_amd64.deb

依赖（libwebkit2gtk-4.1、libgtk-3、libayatana-appindicator3）由 Debian 12 仓库自动补齐。安装后 BIT 出现在「Linux 应用」文件夹。

安装问题

macOS 提示"已损坏，无法打开"

BIT 未购买 Apple 开发者证书，采用 ad-hoc 签名，从网络下载的应用会被默认拦截。任选其一：

方式一：移除隔离属性（推荐）

xattr -cr /Applications/BIT.app

方式二：系统设置放行

双击 dmg 安装，首次打开若弹警告，先不要点"移到废纸篓"；打开 系统设置 → 隐私与安全性 → 安全区 → 点击 "仍要打开"。

方式三：右键打开（macOS 14 及更早）

按住 Control 点击 BIT → 选"打开" → 再点"打开"确认。

Windows 提示 SmartScreen

安装包未做代码签名。弹窗时点 "更多信息" → "仍要运行" 即可。参见 FAQ 关于杀毒软件误报的说明。

Linux 运行 AppImage

chmod +x BIT_0.5.6_amd64.AppImage
./BIT_0.5.6_amd64.AppImage