Tutorial
sing-box 内核配置入门教程
sing-box 更像代理内核，不是普通图形客户端。新手先分清配置格式、启动方式和接管流量的方法，再用 IP 检测确认出口。
先跑通
只用这 6 步跑通
先照这 6 步做。最小配置能跑通以后，再看 route、dns、rule_set 和 TUN。
01
确认定位
sing-box 是通用代理平台，新人先确认自己拿到的是 sing-box JSON，不是 Clash YAML。
02
准备配置
配置文件通常包含 inbounds、outbounds、route、dns，缺一块都可能启动失败。
03
先检查配置
先保留一个最简单的 mixed inbound 和一个可用 outbound，再逐步加规则。
04
启动服务
用 sing-box check 检查配置，再启动服务或导入到图形客户端。
05
接管流量
确认浏览器、系统代理、TUN 或外部控制接口真的接到当前服务。
06
IP 检测
确认本地端口或 TUN 生效后，用 IP 检测看出口和 DNS。
准备工作
默认先看配置文件和图形客户端
准备 sing-box JSON，确认它和 sing-box 的格式匹配。
下载或打开入口优先看 sing-box 官方文档，不要从不明网盘或二次打包站开始。
准备 52.mk IP 检测页，用来确认出口 IP、DNS、共享人数和服务连通性。
操作步骤
按顺序操作，出问题时回到当前步骤的检查点，不要同时改多个地方。
Step 1
下载和准备
先把软件定位、设备路径和配置格式分清楚。
1.1
确认软件定位和下载来源
sing-box 是通用代理平台，新人先确认自己拿到的是 sing-box JSON，不是 Clash YAML。
点哪里
点哪里：打开 sing-box 官方文档 或软件详情页，核对名称、平台、维护状态和下载入口。
成功标志
成功标志：设备上能打开 sing-box，并且能看到配置、Profile、订阅或状态入口。
卡住先查
卡住先查：下载前先看系统版本、CPU 架构、移动端权限和官方发布页说明。
sing-box 配置自由度高，别一开始复制一大段不理解的 JSON。
下载前核对
本图看哪里
图源：52.mk 站内步骤图
1.2
准备正确的配置格式
配置文件通常包含 inbounds、outbounds、route、dns，缺一块都可能启动失败。
点哪里
点哪里：机场后台找 sing-box JSON，优先复制当前软件明确支持的订阅入口。
成功标志
成功标志：你手里有一条完整订阅 URL、二维码或 sing-box JSON 文件。
卡住先查
卡住先查：如果只有登录页、付款页、邀请链接或截图，就还没有拿到可导入配置。
订阅链接要当密码保管，不要发到公开群里排错。
配置来源
本图看哪里
图源：52.mk 站内步骤图
Step 2
检查配置和启动服务
先用最少变量跑通，不要一开始研究高级功能。
2.1
先检查配置能不能被读取
配置文件通常包含 inbounds、outbounds、route、dns，缺一块都可能启动失败。
点哪里
点哪里：配置检查、日志、Profile、Config 或命令行 check 入口。
成功标志
成功标志：配置检查没有报错，日志里没有 JSON/YAML 解析失败。
卡住先查
卡住先查：导入为空时先检查链接是否完整、订阅是否过期、当前网络能否访问订阅域名。
导入成功不等于已经接管流量，后面还要启动代理层。
导入配置
本图看哪里
图源：52.mk 站内步骤图
2.2
确认流量怎么接进来
先保留一个最简单的 mixed inbound 和一个可用 outbound，再逐步加规则。
点哪里
点哪里：inbounds、监听端口、系统代理、TUN 或外部控制接口。
成功标志
成功标志：你能说清当前是规则模式、全局模式、直连模式还是只监听本地端口。
卡住先查
卡住先查：如果停在 Direct / 直连，或者没有任何入站端口，实际流量可能没有经过代理。
新手先只改一个主代理组或一个模式，不要同时动 DNS、规则集、脚本和 TUN。
模式和节点
本图看哪里
图源：52.mk 站内步骤图
Step 3
启动和验证
启动以后用真实出口说话，不只看按钮颜色。
3.1
启动服务或连接面板
用 sing-box check 检查配置，再启动服务或导入到图形客户端。
点哪里
点哪里：启动按钮、服务状态、日志、控制地址或系统代理开关。
成功标志
成功标志：系统出现 VPN 标识、System Proxy 已开启，或日志显示核心正常运行。
卡住先查
卡住先查：只导入配置但没开启代理层，浏览器仍然会按原网络直连。
这一步只确认代理层接管，不代表所有流媒体和 AI 服务都能用。
启动代理层
本图看哪里
图源：52.mk 站内步骤图
3.2
用 IP 检测确认出口
确认本地端口或 TUN 生效后，用 IP 检测看出口和 DNS。
点哪里
点哪里：打开 52.mk IP 检测页，看出口 IP、地理位置、DNS、共享人数和服务连通性。
成功标志
成功标志：出口地区符合你选择的节点，DNS 不明显泄漏，常用服务连通性有结果。
卡住先查
卡住先查：出口没变时，回头检查当前配置、节点、模式和代理层是否真的开启。
IP 检测正常，才算从配置、节点到实际访问完整跑通。
结果验收
本图看哪里
图源：52.mk 站内步骤图
Step 4
跑通以后再看什么
把进阶动作放到基础链路之后，新手排错会轻很多。
4.1
暂时别叠太多高级功能
sing-box 配置自由度高，别一开始复制一大段不理解的 JSON。
点哪里
点哪里：高级设置、DNS、TUN、脚本、模块、规则集或外部控制这些入口先只看不改。
成功标志
成功标志：基础访问稳定后，你再一次只打开一个进阶功能做对比。
卡住先查
卡住先查：改了多个高级功能后再出问题，很难知道是哪一项造成的。
新手排错最重要的是少变量，一次只改一处。
进阶顺序
本图看哪里
图源：52.mk 站内步骤图
4.2
记录可复现的排错信息
如果还是不能用，先记录当前客户端、配置格式、节点、模式、错误提示和 IP 检测结果。能说清这些信息，才好判断是订阅、节点、规则、DNS 还是设备权限问题。
点哪里
点哪里：日志、测试结果、当前 Profile、当前节点和 52.mk IP 检测页。
成功标志
成功标志：你能把问题描述成具体环节，而不是只说“连不上”。
卡住先查
卡住先查：没有错误提示时，先换节点、换网络，再看订阅是否过期。
排错信息不要包含完整订阅链接，公开截图前先打码。
排错记录
本图看哪里
图源：52.mk 站内步骤图
排错清单
sing-box 卡住时先查什么
现象
订阅导入后没有节点
先查
确认复制的是订阅链接，不是登录页、邀请链接、付款页面或单个说明页面。
处理
回到机场后台重新复制对应客户端的订阅地址，再手动更新一次订阅。
现象
节点能看到，但网页打不开
先查
先看系统代理、TUN 或 VPN 权限是否真的开启，再看当前模式是不是直连。
处理
关闭后重新开启代理层，必要时换一个节点和网络环境交叉测试。
现象
部分网站能打开，部分 App 不行
先查
多半是规则分流命中不同路径，或者目标服务限制了当前出口 IP。
处理
临时切全局代理对比，再用 IP 检测看出口地区、DNS 和服务连通性。
现象
更新订阅失败
先查
检查订阅是否过期、当前网络能否访问订阅域名、系统时间是否异常。
处理
换网络后再更新；仍失败就带着错误提示联系机场客服，不要把订阅链接发到公开群。
现象
客户端显示已启动但出口没变
先查
检查当前模式、系统代理、VPN 权限、TUN 或监听端口。
处理
重新选择节点并重启代理层，再用 IP 检测确认。
善意提醒
订阅链接要当密码保管，里面可能包含你的套餐身份和节点权限。
客户端只是工具，不承诺线路质量；线路稳定性要看机场本身。
下载软件和导入订阅是两件事。软件装好以后，还需要有效订阅或节点。
模块、覆写、TUN 和自定义路由属于进阶玩法，基础访问没跑通前先不要叠加。
遵守所在地法律和服务条款，本站教程只做软件使用和网络诊断说明。
sing-box 配置自由度高，别一开始复制一大段不理解的 JSON。