节点手册NODE HANDBOOK
完整教程

sing-box完整入门:安装、配置检查、运行、升级与恢复

sing-box中文入门教程,覆盖官方安装、JSON配置结构、配置检查、前台运行、TUN与服务部署、版本迁移和故障恢复。

节点手册编辑部 · 资料核对日期:2026.10.28
基本结论
  • 平台:多平台核心与命令行
  • 收费:免费
  • 授权:公开源代码

当前版本 v1.14.4(发布于 2026-10-24)· 在下载中心核对安装包、文件大小与签名校验方式

适合谁

愿意直接维护配置、需要高级协议和路由能力的技术用户。

主要优点

  • 免费开源,协议与路由能力广
  • 多款图形客户端采用其作为核心
  • 适合自动化和精细配置

主要缺点与限制

  • 不是普通用户的一体化图形客户端
  • 需要编辑配置并理解路由、DNS和平台权限
  • 配置版本变化可能要求迁移,排错需要理解命令行输出和字段含义

官方下载

前往sing-box官方项目或产品页。本站不重新打包安装文件,也不提供来历不明的网盘镜像。

验证状态

官方资料核对;不作为普通新手默认推荐。没有完成的速度、稳定性、耗电和资源占用测试不计分。

配置检查、格式化与升级前验证

sing-box官方配置文档明确提供检查、格式化与合并命令。检查用于判断执行该命令的版本能否解析配置,格式化用于整理配置,合并用于按指定输入生成结果。三者用途不同,也都不代表节点连通、路由正确或DNS符合预期。

动作官方命令或对象能够证明不能证明
语法检查sing-box check执行该命令的二进制能够解析指定配置节点可用或路由正确
格式化sing-box format按工具规则整理配置自动修复字段含义
合并sing-box merge按指定输入生成合并结果所有引用与策略没有冲突
前台运行日志与实际请求本次启动和请求的观察结果长期稳定性

升级时按这个顺序

  1. 记录当前二进制版本并备份配置目录。
  2. 阅读目标版本的迁移说明,不直接套用旧教程字段。
  3. 使用目标版本二进制,对实际配置的副本运行检查,处理未知字段和弃用提示。
  4. 继续使用配置副本以前台方式运行,分别观察DNS、路由和一个普通HTTPS请求;这只隔离了配置修改,不代表运行环境或网络影响已经隔离。
  5. 验证完成后再替换系统服务;失败则恢复旧二进制与配置。

JSON能够解析只说明格式有效。TUN权限、路由表、DNS服务器、出站协议和证书仍需分别观察。来源:sing-box官方配置文档。资料核对日期:2026-10-28。

也可以前往全部文章浏览。