sing-box 使用教程：导入、分流与故障排查

先理解配置层次

sing-box 配置通常分为入站、出站、路由和 DNS。先用最小配置验证出站，再逐步加规则，避免一次复制复杂模板。

跨平台时记录差异

桌面、移动端和路由器的权限与网络栈不同。相同配置在不同平台表现不一致时，优先比较系统权限和 DNS。

安全地处理配置

配置文件可能包含服务器地址、UUID、密码或订阅令牌。分享日志前删除敏感字段，存储时使用本地安全位置。

安装前核对来源与权限

开始配置“sing-box”前，先确认项目或应用的官方发布渠道、系统版本要求和许可方式。不要从搜索结果中的改包、网盘或不明脚本安装同名程序，也不要把账号交给代配置服务。

记录安装包版本、系统版本和配置文件来源。桌面端、移动端和路由器的权限边界不同，同一份配置在不同平台出现差异时，先比较权限、DNS 和系统代理状态。

先建立最小可用配置

导入订阅后先只启用一个节点、一个基础模式和一个公开网页测试。确认订阅更新时间、节点数量、实际出口和日志状态，再逐步增加规则集、策略组、脚本、重写或 TUN。

最小配置的价值是保留清晰的回滚点。遇到全局断网、DNS 错误或应用无法连接时，先恢复到最小配置，再逐项打开高级功能，而不是一次替换整套模板。

日志和规则命中比截图更有用

教程应说明如何查看连接日志、DNS 结果、规则命中和实际使用的出站，而不是只展示“已连接”状态。浏览器能打开不代表终端、游戏或移动应用走了同一条代理路径。

记录一次成功和一次失败的差异：节点、模式、规则、系统代理、TUN、时间段和错误原文。这样读者可以复现步骤，也能判断问题来自客户端、订阅格式还是目标服务。

更新时保留可回滚版本

升级核心、界面或移动应用前导出当前配置，记下旧版本和可用节点。更新后先做最小测试，不要在同一时间更换客户端、规则库和订阅转换方式。

订阅链接是账户凭证，导入、备份和分享时都应隐藏令牌。公开排障只提供脱敏的错误字段，发现链接泄露后尽快按服务商流程重置或撤销。

如何判断教程是否适用

客户端功能会随系统和版本变化。文章应写清适用平台、版本日期、订阅格式和测试范围，并把平台官方文档作为优先来源。不能把某个用户的配置截图写成所有设备都适用。

如果文档与实际界面不一致，先记录版本和页面路径，再提交纠错或更新说明。教程的目标是让读者能安全复现和回退，而不是堆叠复杂配置。