需要自行运行 sing-box 核心时，可从软件仓库、安装脚本或系统维护的包中选择安装方式。选择入口时，优先考虑谁负责更新包、你是否需要固定版本，以及目标机器是否由 systemd 管理服务。
本页依据 Package Manager 文档在
2026-06-02的内容整理。执行前请核对当前安装说明，确认命令和受支持平台未变化。
官方软件仓库
官方文档为 Debian/APT 和 Red Hat/DNF 给出 SagerNet 软件源的配置方式，安装包名称为 sing-box，测试通道包名为 sing-box-beta。需要由系统包管理器管理升级、且希望使用官方软件源的 Linux 机器，适合从这里开始。
- Debian / Ubuntu 路径：配置官方 APT source 后安装
sing-box。 - Red Hat 系路径：添加官方 repo 后通过 DNF 安装
sing-box。 - 测试通道：只有明确接受测试版本风险时才选择
sing-box-beta。
执行前应核对当前安装说明，确认软件源地址和受支持平台没有变化。
官方安装脚本
官方页面还提供安装脚本，用于从 GitHub Releases 安装最新软件包或指定版本，覆盖基于 deb / rpm 的 Linux、Arch Linux 与 OpenWrt 等场景。对于需要固定版本的实例，应显式选择版本并记录下来，而不是长期依赖不固定的“最新”行为。
系统维护的包
官方文档列出 Homebrew、Scoop、Chocolatey、winget、AUR、nixpkgs 等安装入口，也特别列出部分来源可能存在构建标签修改或 Go 版本老旧等问题。选择系统仓库包时，应分清它是官方仓库还是第三方维护包，并优先查阅官方页面当下的提示。
Linux 服务管理
对于带 systemd 的 Linux 系统，官方文档说明安装通常已包含 sing-box 服务，列出的基本操作包括：
sudo systemctl enable sing-box
sudo systemctl start sing-box
sudo systemctl restart sing-box
sudo journalctl -u sing-box --output cat -e在启动或重启服务前，先按检查与格式化配置验证配置。服务失败时，优先读取日志，而不是反复重装。
Docker 与平台客户端
如果你要的是 Android 或 Apple 平台图形客户端，而非自行管理核心配置，则应从客户端与平台选择开始。
下载稳定版前的版本确认
Releases 中的稳定版为 v1.13.12。测试版本不应替代日常安装中的稳定版选择。