sing-box配置报错
sing-box 启动不了、导入 Profile 时报错、出现 decode config 之类的提示,可以从订阅格式、配置字段在不同版本间的差异、TUN 权限和端口冲突几方面逐项处理。
简要答案:sing-box 起不来,大多是配置问题。第一,检查订阅是不是 sing-box 格式,而不是 Clash 的 YAML;第二,把客户端升到最新,因为字段随版本变得很快;第三,TUN 需要系统授权;第四,端口冲突的话,改一下 inbound 的端口。错误信息一般会指出哪一行、哪个字段有问题,照着修改就行。
问题现象
导入 Profile 时提示错误,或刚点启动就失败;日志中可见 decode config error、unknown field、bind: address already in use、permission denied 等信息。
按报错处理
| 报错关键词 | 原因 | 解决 |
|---|---|---|
| decode / unknown field | 配置字段与内核的版本对不上 | 升级客户端,并让服务商提供与之匹配版本的订阅 |
| yaml / 解析失败 | 把 Clash 订阅直接导进来了 | 改用 sing-box 格式的订阅 |
| address already in use | 端口被别的程序占了 | 关掉其他代理软件,或者修改端口 |
| permission denied | TUN 没有权限 | 用管理员身份运行,或授权系统扩展 |
| fetch 失败 | 订阅拉取环节出了问题 | 参考订阅更新失败的排查 |
逐步排查
- 到服务商面板里找有没有 sing-box 专用的订阅入口,复制那个链接,重新建立 Profile;
- 先将客户端(SFI/SFA/SFM/SFW)更新至最新版本;sing-box 1.x 的不同小版本确实存在字段差别。
- 第一次启动时,按系统提示完成 VPN 或扩展的授权;
- 错误信息里带行号的话,多是服务商模板的小问题,直接联系对方客服,比自己动手改靠谱;
- 启动成功却没有网络,那是另一类问题,转到节点连接不上。
什么时候是机场问题
如果相同版本的客户端跑示例配置没有问题,一用服务商的订阅就报错,那就是它的模板与当前内核不兼容,需要让对方更新。基本用法见 sing-box 入门教程。
需要各平台的安装包,可前往下载中心;配置因升级而失效时,参阅客户端升级后的使用故障中的通用办法;类似故障还可查阅网络故障排查 · 系统与客户端。
常见问题
提示 decode config 或 unknown field?
这是配置字段和内核版本不匹配造成的:服务商的 sing-box 订阅,可能是按旧版或新版格式生成的。把客户端升到最新版,或者请对方提供与当前版本相符的订阅。
为什么导入 Clash 订阅会失败?
sing-box 读不懂 Clash 的 YAML 文件,需要使用服务商单独提供的 sing-box 格式订阅;如果对方没有,只能改用能做转换的客户端,或者直接用 Clash 系的软件。
桌面端启动后提示权限错误,怎么办?
开启 TUN 要有相应权限:macOS 要在系统里放行扩展,Windows 要以管理员身份运行,Linux 则需 root,或者给程序授予对应的 capability。