Sing-box 常见报错排障与自查手册

针对 Sing-box 遇到 JSON 解析错误、启动崩溃或无法连接时的核心自救指南。

场景一：提示 `parse config: invalid json` (配置文件解析失败)

成因：导入的订阅 URL 返回的不是标准的 Sing-box JSON 格式（例如机场误返回了 Clash YAML 或普通 Base64 文本），或者 JSON 含有未闭合的括号逗号。
解决：
1. 打开浏览器直接访问该订阅 URL，观察返回的内容开头是否为 { "outbounds": [ ... ] }；
2. 若不是，请使用正规订阅转换工具将 Clash 转换为标准的 Sing-box 配置。

场景二：提示 `create tun interface: operation not permitted` (无法创建虚拟网卡)

成因：系统缺少 root / 管理员权限，无法向内核注入 TUN 网络设备。
解决：
- Windows 端右键以管理员身份运行；
- macOS 端在弹出的密码框中输入开机密码以允许 Network Extension。

🗂️ 返回百科导航