跳转至

包管理器

仓库安装

sudo curl -fsSL https://sing-box.app/gpg.key -o /etc/apt/keyrings/sagernet.asc
sudo chmod a+r /etc/apt/keyrings/sagernet.asc
echo "deb [arch=`dpkg --print-architecture` signed-by=/etc/apt/keyrings/sagernet.asc] https://deb.sagernet.org/ * *" | \
  sudo tee /etc/apt/sources.list.d/sagernet.list > /dev/null
sudo apt-get update
sudo apt-get install sing-box # or sing-box-beta


sudo dnf -y install dnf-plugins-core
sudo dnf config-manager --add-repo https://sing-box.app/sing-box.repo
sudo dnf install sing-box # or sing-box-beta
（这适用于任何使用 dnf 作为包管理器的发行版：Fedora、CentOS，甚至安装了 DNF 的 OpenSUSE。）

手动安装

bash <(curl -fsSL https://sing-box.app/deb-install.sh)


bash <(curl -fsSL https://sing-box.app/rpm-install.sh)
（这适用于任何使用 rpm 和 systemd 的发行版。由于 rpm 定义依赖关系的方式，如果安装成功，就多半能用。）

bash <(curl -fsSL https://sing-box.app/arch-install.sh)

托管安装

类型 平台 链接 命令
AUR Arch Linux ? -S sing-box AUR package
nixpkgs NixOS nix-env -iA nixos.sing-box nixpkgs unstable package
Homebrew macOS / Linux brew install sing-box Homebrew package
APK Alpine apk add sing-box Alpine Linux Edge package
DEB AOSC apt install sing-box AOSC package
类型 平台 链接 命令
Homebrew macOS brew install sing-box Homebrew package
类型 平台 链接 命令
Scoop Windows scoop install sing-box Scoop package
Chocolatey Windows choco install sing-box Chocolatey package
winget Windows winget install sing-box winget package
类型 平台 链接 命令
Termux Android pkg add sing-box Termux package
类型 平台 链接 命令
FreshPorts FreeBSD pkg install sing-box FreeBSD port

存在问题的源

类型 平台 链接 原因
DEB AOSC aosc-os-abbs 存在问题的构建标志列表修改
Homebrew / homebrew-core 存在问题的构建标志列表修改
Termux Android termux-packages 存在问题的构建标志列表修改
FreshPorts FreeBSD FreeBSD ports 太旧的 Go (go1.20)

如果您是其用户，请向他们报告问题：

  1. 在未完全了解相关功能的情况下，请勿修改发布版本标签：启用非默认标签可能会导致性能下降；缺少默认标签可能会引起用户混淆。
  2. sing-box 支持使用一些较旧的 Go 版本进行编译，但不推荐使用（特别是已不再受 Go 支持的版本）。

服务管理

对于带有 systemd 的 Linux 系统，通常安装已经包含 sing-box 服务， 您可以使用以下命令管理服务：

行动 命令
启用 sudo systemctl enable sing-box
禁用 sudo systemctl disable sing-box
启动 sudo systemctl start sing-box
停止 sudo systemctl stop sing-box
强行停止 sudo systemctl kill sing-box
重新启动 sudo systemctl restart sing-box
查看日志 sudo journalctl -u sing-box --output cat -e
实时日志 sudo journalctl -u sing-box --output cat -f