sing-box Linux 首次安装与运行步骤

这份流程面向自行维护 Linux 系统上的 sing-box 核心程序的人。你需要已有合法且适用于目标版本的配置输入；本文不会生成节点或服务端参数。

1. 先确认版本通道

sing-box 当前稳定版为 v1.13.12。首次部署或稳定运行环境，优先使用稳定通道；测试版本更适合明确需要验证新功能的场景。

2. 选择安装方式

按系统选择安装方式：

• Debian / APT 或 Red Hat / DNF 的官方 SagerNet 软件仓库，适合由系统包管理器持续维护。
• 安装脚本，适合文档列出的受支持系统，且可以选择指定版本。
• 文档列出的其他托管包；使用前注意官方页面是否对其构建方式有提示。

完整命令应以当前版本的安装说明为准，以免安装源地址或支持状态更新后仍执行旧命令。

3. 准备配置并先校验

配置文件采用 JSON。把配置放入你所选安装方式要求的位置后，先在终端执行：

sing-box check

如果校验失败，先处理 JSON 或字段错误，不要急于启动服务。配置来自旧版本时，还应先阅读迁移已弃用配置。

4. 启动 systemd 服务

带 systemd 的 Linux 系统可以使用这些常见服务命令：

sudo systemctl enable sing-box
sudo systemctl start sing-box
sudo journalctl -u sing-box --output cat -e

启用服务负责开机启动；启动后查看日志，确认配置读取、监听和网络行为没有明显错误。之后修改配置时，先重新校验，再按需重启服务：

sudo systemctl restart sing-box
sudo journalctl -u sing-box --output cat -f

5. 记录维护信息

首次可用后记录以下内容，以便升级或排错：

• 安装来源与当前稳定版本号。
• 配置文件的备份位置与修改历史。
• 引用的 rule-set 等外部资源来源。
• 服务日志查看方式，以及升级前的回滚方案。

下一步

继续阅读JSON 配置结构参考，再按你的入站、出站与路由目标查具体字段文档。升级服务前，请回到升级与迁移执行兼容性检查。