包管理器

仓库安装

Debian / APT Redhat / DNF 5 Redhat / DNF 4

sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://apt.oixcloud3rd.akinokaede.com/gpg.key \
  | sudo tee /etc/apt/keyrings/oixcloud3rd.asc >/dev/null
sudo chmod 0644 /etc/apt/keyrings/oixcloud3rd.asc

echo '
Types: deb
URIs: https://apt.oixcloud3rd.akinokaede.com/
Suites: *
Components: *
Enabled: yes
Signed-By: /etc/apt/keyrings/oixcloud3rd.asc
' | sudo tee /etc/apt/sources.list.d/oixcloud3rd.sources >/dev/null

sudo apt-get update
sudo apt-get install sing-box # or sing-box-beta

sudo dnf config-manager addrepo --from-repofile=https://public.oixcloud3rd.akinokaede.com/oixcloud3rd.repo
sudo dnf install sing-box # or sing-box-beta

sudo dnf install -y dnf-plugins-core
sudo dnf config-manager --add-repo https://public.oixcloud3rd.akinokaede.com/oixcloud3rd.repo
sudo dnf install sing-box # or sing-box-beta

手动安装

该脚本从 GitHub 发布中下载并安装最新的软件包，适用于基于 deb 或 rpm 的 Linux 发行版、ArchLinux 和 OpenWrt。

curl -fsSL https://sing-box.oixcloud3rd.akinokaede.com/installation/tools/install.sh | sh

或最新测试版：

curl -fsSL https://sing-box.oixcloud3rd.akinokaede.com/installation/tools/install.sh | sh -s -- --beta

或指定版本：

curl -fsSL https://sing-box.oixcloud3rd.akinokaede.com/installation/tools/install.sh | sh -s -- --version <version>

存在问题的源

类型	平台	链接	原因
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