常见问题

先定位：卡在哪一步

• 下载配置失败：远程地址打不开、返回的不是配置、提示格式错误，多半是地址或格式问题，不是客户端坏了。
• 启动服务失败：配置已导入，但点启动就报错或立刻停掉，多半是配置本身有错、端口被占或权限没给够。
• 服务已启动但打不开目标：先确认是不是所有目标都打不开，还是只有某一个；再确认是不是只有浏览器打不开，还是所有应用都打不开。

高频问题

装好了为什么还连不上？

安装包不附带代理服务。没有配置、配置没选中、服务没启动，三种情况看起来都像“连不上”，但处理方法完全不同。先按《新手第一步》检查：有没有配置、选中没有、启动没有。

Clash 订阅能直接导入吗？

不能直接当 sing-box 配置用。Clash 的 YAML 和 sing-box 的 JSON 是两种格式，字段名和结构都不一样。正确做法是向配置提供方要一份 sing-box 格式的配置或远程配置地址，而不是把 YAML 文件改个后缀就导进去。

Windows 该下 EXE 还是 ZIP？

SFW 开头的 EXE 是图形安装程序，适合新手。sing-box 开头的 ZIP 是命令行内核，没有图形界面。下载页文件名认前缀，别只看“Windows 版”四个字。

任何订阅链接都能导入吗？

不能。远程地址必须返回兼容的 sing-box 配置才行；如果返回的是登录网页、Clash 配置或纯节点列表，导入都会失败。先在浏览器里看一眼那个地址返回的是什么，再决定是不是配置问题。

升级前要注意什么？

先备份配置。跨大版本升级时，个别字段可能改名或废弃，升级后先看官方更新说明，再启动服务；不要在没备份的情况下直接覆盖旧版本。macOS 1.14 换新应用后旧配置不会自动继承，详见《版本与升级》。

为什么没有节点分组或模式开关？

分组需要配置包含 Selector 或 URLTest 类型的出站，模式开关需要配置使用至少两个 clash_mode 值；没有这些定义时，界面不出现对应入口并不等于安装失败，先确认当前配置应不应该有它们。

远程配置刷新后为什么还不能连接？

刷新只会重新获取远程配置，不会保证新配置兼容或节点在线。先确认更新成功，再重新选中并启动，最后实际访问验证；下载更新失败与启动后的连接失败要分别排查。

sing-box 支持 ShadowsocksR 吗？

不支持，支持已在 1.6.0 移除。SSR 与 Shadowsocks 是不同协议，改扩展名或转换订阅格式不能把 SSR 节点变成 Shadowsocks 节点，需要服务端提供客户端支持的协议。

旧 GeoIP、Geosite 配置报错怎么办？

旧功能在 1.8.0 弃用、1.12.0 移除，现在用规则集（rule-set）维护 IP 或域名规则；旧配置引用这些功能时报错，要迁移规则和引用方式，不能只把文件改名。

求助时要注意什么？

准备系统、客户端与内核版本、失败阶段和脱敏后的错误片段；分享前删去远程地址里的令牌、节点密码及其他私人信息，不必公开整份配置。桌面端只关窗口可能仍在托盘运行，停止服务要确认托盘状态。

更完整的排查步骤见《连不上的排查：按阶段找原因》。