Linux 安装说明

适用范围

当前 Linux 原生安装包覆盖以下 GNU 目标，并作为 release 页面附件提供：

• x86_64-unknown-linux-gnu
• aarch64-unknown-linux-gnu

提供的 Linux 原生包格式为：

• .deb
• .rpm

其他 Linux 目标，或你的 Linux 环境不适用这两种包格式时，仍然可以继续使用 .tar.gz 手动解压安装。

NOTE

当前只提供 release 附件下载，不提供 apt / yum 软件源托管。

选择哪种安装方式

• Debian / Ubuntu / Linux Mint：优先使用 .deb
• Fedora / Rocky / AlmaLinux / RHEL 系：优先使用 .rpm
• 希望快速完成安装、自动选择架构，且只需要 cnb-rs 二进制文件：使用仓库里的 scripts/install.sh
• 其他 Linux 发行版，或你希望自行控制安装目录：使用 .tar.gz

使用 scripts/install.sh 一键安装

curl -fsSL https://cnb.cool/wwvo/cnb-rs/cnb-rs/-/git/raw/main/scripts/install.sh | bash

这条入口适合始终获取最新安装脚本。

如果你希望第一跳和后续附件都走 GitHub，可以改用 GitHub 托管的脚本入口：

curl -fsSL https://raw.githubusercontent.com/wwvo/cnb-rs/main/scripts/install.sh | CNB_RS_INSTALL_SOURCE=github bash

如果你想固定某个版本，或者指定安装目录，可以先把脚本下载到本地再执行：

curl -fsSL https://cnb.cool/wwvo/cnb-rs/cnb-rs/-/git/raw/main/scripts/install.sh -o install.sh
bash ./install.sh --version v<VERSION> --bin-dir "$HOME/.local/bin"

如果你更希望脚本本身也与某个版本严格绑定，可以直接从对应 Release 下载 cnb-rs-v<VERSION>-install.sh 后执行：

bash ./cnb-rs-v<VERSION>-install.sh --bin-dir "$HOME/.local/bin"

如果你希望固定使用 GitHub Release，也可以在本地执行时显式指定：

bash ./install.sh --source github --version v<VERSION> --bin-dir "$HOME/.local/bin"

这个脚本会自动识别 Linux x86_64 / arm64，并优先使用更通用的 musl 压缩包附件。它默认从 CNB Release 下载文件，也可以切换到 GitHub Release；两种来源都会校验 sha256sum.txt。如果你在 shell 管道里用环境变量切换下载源，请把变量放在 bash 那一侧，而不是放在 curl 前面。如果你直接执行 Release 自带的 cnb-rs-v<VERSION>-install.sh，默认就会安装该版本。然后它只安装 cnb-rs 二进制文件，不会额外安装 Bash / Zsh / Fish 补全文件。

使用 .deb 安装

cargo-deb 产物的架构后缀遵循 Debian 习惯：

• x86_64 使用 amd64
• arm64 使用 arm64

# x86_64
sudo dpkg -i ./cnb-rs_*_amd64.deb

# arm64
sudo dpkg -i ./cnb-rs_*_arm64.deb

安装后默认会包含：

• /usr/bin/cnb-rs
• Bash 补全：/usr/share/bash-completion/completions/cnb-rs
• Zsh 补全：/usr/share/zsh/vendor-completions/_cnb-rs
• Fish 补全：/usr/share/fish/vendor_completions.d/cnb-rs.fish

使用 .rpm 安装

# x86_64
sudo dnf install ./cnb-rs-*.x86_64.rpm

# arm64
sudo dnf install ./cnb-rs-*.aarch64.rpm

如果你使用的 RPM 系环境更偏底层，也可以改用：

# x86_64
sudo rpm -i ./cnb-rs-*.x86_64.rpm

# arm64
sudo rpm -i ./cnb-rs-*.aarch64.rpm

安装内容与 .deb 保持一致，包括 cnb-rs 可执行文件和 Bash / Zsh / Fish 补全文件。

使用 .tar.gz 手动安装

tar -xzf ./cnb-rs-<VERSION>-x86_64-unknown-linux-gnu.tar.gz
sudo install -m 755 ./cnb-rs-<VERSION>-x86_64-unknown-linux-gnu/cnb-rs /usr/local/bin/cnb-rs

如果你下载的是 arm64 GNU 压缩包，请把上面的目标后缀替换为 aarch64-unknown-linux-gnu。

这种方式不会自动安装 Bash / Zsh / Fish 补全文件；如果需要，请参考 cnb-rs completion 手动生成。

验证安装

cnb-rs --version
cnb-rs auth status

如果命令找不到，请先确认：

• cnb-rs 已位于 PATH 中
• 当前 shell 已重新加载
• 你使用的是 cnb-rs，而不是旧命令名 cnb

旧命令迁移说明见：从 cnb 迁移到 cnb-rs。