- 平台:多平台核心与命令行
- 收费:免费
- 授权:公开源代码
当前版本 v1.14.4(发布于 2026-10-24)· 在下载中心核对安装包、文件大小与签名校验方式
适合谁
愿意直接维护配置、需要高级协议和路由能力的技术用户。
主要优点
- 免费开源,协议与路由能力广
- 多款图形客户端采用其作为核心
- 适合自动化和精细配置
主要缺点与限制
- 不是普通用户的一体化图形客户端
- 需要编辑配置并理解路由、DNS和平台权限
- 配置版本变化可能要求迁移,排错需要理解命令行输出和字段含义
官方下载
前往sing-box官方项目或产品页。本站不重新打包安装文件,也不提供来历不明的网盘镜像。
sing-box 从安装到正常退出
Windows / macOS / Linux / Android 等核心环境
开始前先检查
- 确认确实需要命令行核心而非图形客户端
- 记录当前 sing-box 版本并阅读对应配置文档
- 备份配置、路由、DNS 和服务定义后再修改
先确认你需要的是核心
sing-box 是网络代理平台与命令行核心,不是普通用户的一体化订阅 GUI。只想点选节点时优先使用基于它的图形客户端;需要自动化和精细路由时再直接使用。
只从官方渠道安装
按官方安装文档选择包管理器或 GitHub Releases,并记录版本。不同大版本可能调整配置字段,复制旧教程配置前必须核对迁移说明。
配置至少分清四部分
输入负责接收流量,输出负责连接目标,route 决定去向,DNS 决定解析。订阅通常需要可信工具转换;不要把服务方网页地址直接当 JSON 配置。
先检查再运行
使用当前版本的官方检查方式验证配置,然后以前台方式运行并观察日志。先解决未知字段、缺少引用和权限错误,再考虑系统服务、开机启动或 TUN。
升级要先在副本验证
升级二进制前备份配置,阅读变更与迁移说明,在副本上完成检查。不要直接替换正在运行的版本后才发现弃用字段导致服务无法启动。
停止后的恢复
停止进程或系统服务,移除临时 TUN、路由和系统代理。断网时核对残留路由、DNS 与防火墙规则;不熟悉系统网络管理时不要直接使用高权限 TUN 配置。
常见问题对照
核对当前版本文档和迁移说明,旧字段可能已弃用或移动。
查看第一条致命错误,区分语法、文件权限、端口占用和系统权限。
停止进程并恢复原路由/DNS;先用非 TUN 输入验证出站和规则。
恢复旧二进制或已验证配置,不在生产配置上直接试错。
- 普通 HTTPS 网站可以访问。
- 用站内 IP检测 对比连接前后的出口。
- 常用应用能够联网,且没有另一款客户端同时接管。
- 关闭客户端后普通网络能够恢复。
图示说明:以上为本站绘制的操作路径示意,不是复制的软件截图;按钮名称可能随系统和版本变化。未完成的设备实测不会写成亲测结论。
官方依据:sing-box 官方文档。本站按新手完成任务的顺序重新整理,没有复制官方页面结构或第三方教程截图。
验证状态
官方资料核对;不作为普通新手默认推荐。没有完成的速度、稳定性、耗电和资源占用测试不计分。
配置检查、格式化与升级前验证
sing-box官方配置文档明确提供检查、格式化与合并命令。检查用于判断执行该命令的版本能否解析配置,格式化用于整理配置,合并用于按指定输入生成结果。三者用途不同,也都不代表节点连通、路由正确或DNS符合预期。
| 动作 | 官方命令或对象 | 能够证明 | 不能证明 |
|---|---|---|---|
| 语法检查 | sing-box check | 执行该命令的二进制能够解析指定配置 | 节点可用或路由正确 |
| 格式化 | sing-box format | 按工具规则整理配置 | 自动修复字段含义 |
| 合并 | sing-box merge | 按指定输入生成合并结果 | 所有引用与策略没有冲突 |
| 前台运行 | 日志与实际请求 | 本次启动和请求的观察结果 | 长期稳定性 |
升级时按这个顺序
- 记录当前二进制版本并备份配置目录。
- 阅读目标版本的迁移说明,不直接套用旧教程字段。
- 使用目标版本二进制,对实际配置的副本运行检查,处理未知字段和弃用提示。
- 继续使用配置副本以前台方式运行,分别观察DNS、路由和一个普通HTTPS请求;这只隔离了配置修改,不代表运行环境或网络影响已经隔离。
- 验证完成后再替换系统服务;失败则恢复旧二进制与配置。
JSON能够解析只说明格式有效。TUN权限、路由表、DNS服务器、出站协议和证书仍需分别观察。来源:sing-box官方配置文档。资料核对日期:2026-10-28。