适用范围与准备

适用于准备在自己管理的Linux主机安装sing-box,或脚本提示完成但运行版本、配置路径不清楚。本文以系统包和systemd服务为边界;手机图形客户端、容器与路由固件需查各自入口。

先区分原因

“安装成功”可能只代表某个二进制已复制。命令行找到的程序、systemd执行的程序和服务读取的配置可能不一致;旧教程中的虚构下载站不能作为来源。

按顺序操作

  1. 从文末sing-box官方安装页进入,按发行版选择官方仓库或明确列出的安装方式。先核对架构和稳定/测试分支,不从搜索广告复制一键脚本。安装会写入系统文件,需要管理权限,先保留已有版本与配置。
  2. 如果已有安装,先在本机查明命令解析到的sing-box路径,再读取该程序的version输出。记录包管理器登记的版本及安装来源;发现多个路径时先辨明归属,不覆盖或删除仍被服务使用的文件。
  3. 在使用systemd的主机查看sing-box服务单元及覆盖项,核对ExecStart所用绝对路径、参数和运行用户。配置可能由-c指定文件或-C指定目录,不把网上常见路径当成本机事实;查看内容时避免将环境值和日志整段公开。
  4. 用服务实际使用的那个二进制,对实际配置副本执行check,参数路径按本机情况填写。检查通过只说明配置可被这个版本读取;若缺字段或功能,先查官方安装页的Problematic Sources及迁移说明,不反复重装掩盖构建差异。
  5. 需要启动服务时先确认没有另一实例占用入口,再按官方systemd管理方式操作。记录本次启动日志、读取的配置和监听结果;验证业务后再决定是否启用开机启动。
核对对象留存结果
安装来源项目官方链接、包渠道、分支
命令行程序解析路径与version输出
systemd服务ExecStart、运行用户、配置参数
实际请求应用入口、命中出站与响应

怎样确认有效

版本、服务执行路径与配置路径互相对应,且经过该服务的目标请求正常,才算安装可用。仅退出码为零、文件存在或服务active不足以完成验收。

无效时恢复与下一步

失败时停止本轮新增实例,恢复原包、服务覆盖项和配置,再确认原网络可用。保留脱敏的路径差异与日志。单节点JSON编写见关联教程,本文不重复搭建完整代理。