先判断失败发生在哪一步：远程配置下载不下来、配置已保存却启动失败，还是显示运行中但网页打不开。按下面对应分支检查，比反复重装更容易缩小范围。第一次使用请先看 配置与启动教程。
远程配置下载或导入失败，先查什么？
先检查地址是否完整、是否过期，以及当前网络能否访问提供方。地址返回登录页、错误页或 Clash YAML 时，即使请求成功也不能作为 sing-box 配置导入；请让提供方确认它返回完整、兼容的 sing-box JSON。
如果错误提到认证失败或 HTTP 状态码，先核对提供方的登录要求与地址有效期；如果提到 JSON 解析，再核对格式。下载阶段失败不等于节点失效。本地导入则先确认选到的是配置文件，而不是压缩包或节点列表。
配置能保存，但启动时报错怎么办？
保存配置和启动成功是两个步骤。记录客户端显示的内核版本及第一条启动错误：字段或类型不识别时核对配置适用版本；文件、规则集读取失败时检查对应路径或下载条件；系统拒绝建立隧道时检查平台权限与其他正在运行的 VPN。一次只处理一个明确错误，再重新启动验证。
升级后旧字段失效，应让配置提供方按目标版本更新，或按迁移说明修改自己的配置。不要只删除报错字段来强行启动，删除 DNS 或路由设置可能改变流量处理方式。
显示运行中，但网页打不开怎么办？
先停止 sing-box，确认原网络能够访问普通网站，再启动同一配置测试目标网站。运行状态和流量计数只说明服务在工作，不能证明每个节点、DNS 或路由都正常。
若配置带节点分组，确认所选节点可用；随后对照日志区分 DNS 解析失败、连接超时和认证失败。只有部分应用受影响时，检查分应用设置和路由规则。改完一个条件后用同一目标重新测试，避免同时切换节点、DNS 和模式。
需要反馈问题时，准备系统、客户端与内核版本、失败阶段和已遮挡的错误片段。分享前删去远程地址中的令牌、节点密码及其他私人信息，不必公开整份配置。
为什么没有节点分组或模式开关？
分组需要配置包含 Selector 或 URLTest 类型的出站；模式开关需要配置使用至少两个 clash_mode 值。没有这些定义时，界面不出现对应入口并不等于安装失败。先确认当前配置是否应当包含它们，再看 节点分组说明。
安装 sing-box 后，还需要准备什么？
还需要兼容的配置与可用的代理服务。可以使用自己维护的服务，也可以使用提供方给出的配置；软件安装完成不会自动生成节点。远程地址和本地 JSON 的选择见 准备配置。
我能直接使用 Clash 的订阅吗？
不能把 Clash YAML 直接当成 sing-box JSON 使用。优先获取提供方的 sing-box 格式；必须转换时，应同时核对节点、DNS、路由与目标内核版本，转换后的结果仍需验证。不同客户端对“订阅”的用法不同，仅看到订阅链接不能判断其返回格式。
sing-box 支持 ShadowsocksR 吗？
当前版本不支持 ShadowsocksR；这项支持已在 sing-box 1.6.0 移除。SSR 与 Shadowsocks 是不同协议，改扩展名或转换订阅格式不能把 SSR 节点变成 Shadowsocks 节点，需要服务端提供客户端支持的协议。
旧 GeoIP 和 Geosite 配置怎么处理？
旧 GeoIP、Geosite 功能在 1.8.0 弃用，并于 1.12.0 移除。现在用规则集（rule-set）维护 IP 或域名规则；旧配置引用这些功能时报错，需要迁移规则和引用方式，不能只把文件改名。
第一次使用，应该看哪篇教程？
先用 通用使用教程完成配置添加与启动，再查看 Android、iOS、macOS 或 Windows 的安装和权限差异。需要自己编写参数时，再查 配置参考和 版本迁移说明。
Windows 有官方图形客户端吗？
有。sing-box for Desktop 是 Windows/Linux 官方图形客户端；GUI for SingBox 是另一款第三方软件。官方客户端的安装与界面见 Windows SFW 教程。
Windows 应该下载 EXE 还是 ZIP？
需要官方图形界面时选择 SFW 开头的 EXE 安装程序，按 Windows 的 x64、x86 或 ARM64 架构下载；普通 sing-box Windows ZIP 是命令行内核。官方 GUI 要求 Windows 10 及以上，下载入口见 Windows 下载。
远程配置刷新后为什么还不能连接？
刷新只会重新获取远程配置，不会保证新配置兼容或节点在线。先确认更新成功，再选择该配置并启动，最后实际访问验证；下载更新失败与启动后的连接失败应分别排查。