Sing-Box

全平台通用代理软件

Sing-Box使用教程-Windows/macOS/Android/iOS/Linux

使用 sing-box 前，准备一份兼容当前版本的配置文件或远程配置地址。添加配置后，选中它并启动服务，再验证实际访问。本文集中说明这些共通步骤，平台安装与权限差异单独列出。

本教程适用于官方图形客户端，截图以 Windows 1.14.2 为例。客户端不会附带代理节点；自行配置服务端和使用服务提供方配置都可以，前提是格式与版本兼容。

阅读顺序：下载与权限 · 配置格式 · 添加配置 · 启动验证 · 选择节点 · 更新与停止 · 排查错误

先下载客户端，处理安装与系统权限

从下载页选择对应平台。Windows 的图形安装包以 SFW 开头，Linux 为 SFL，Android APK 为 SFA，macOS 独立版为 SFM；iOS 使用商店客户端。命令行内核包不带本文的图形界面。

1. 判断手里的是哪种配置

客户端需要兼容当前内核版本的完整 sing-box JSON 配置。它不只是节点地址，还可以定义入站、出站、DNS 和路由；具体包含哪些字段由使用方式决定。

  • 远程配置地址：通过 URL 下载配置，适合需要定期更新的配置源。先确认提供方注明支持 sing-box。
  • 本地 JSON：已经保存的完整配置内容，通过客户端的本地配置功能录入或编辑。
  • Clash YAML、Base64 节点列表或单条分享链接：不能当成完整 sing-box 配置直接使用。优先获取兼容格式；转换后也要核对版本和路由行为。

不要把下载软件的网页地址填进配置 URL。订阅地址可能含有账号凭据，截图或求助前应遮挡；不要随意提交给不熟悉的在线转换站。

2. 添加远程配置或本地配置

以下用 Windows 1.14.2 简体中文界面示范字段含义。其他平台的入口可能叫 Profiles、配置或新建配置，菜单位置不完全相同。

  • 打开配置列表或配置卡片，选择新建。在 Windows 示例中，入口是“仪表 → 配置”右上角的“＋”。
  • 填写便于辨认的名称；有配置 URL 时将类型选为“远程”，填写完整地址。名称可以自定，不决定配置格式。
  • 按需开启自动更新并设置间隔。示例值为 60 分钟；如需认证，按提供方要求在客户端填写。
  • 保存或创建后，确认条目出现在配置列表中。失败时先看下载错误，不要直接进入连接排查。
Windows 1.14.2 新建远程配置示例
Windows 示例：类型为远程，填写配置 URL。图中地址是示例值，请勿照抄。

已有本地配置时，选择本地类型，按客户端提供的录入或编辑功能保存完整 JSON。本文图片未展示本地编辑器，不把某个平台的“导入文件”按钮位置当作通用步骤。

3. 选中配置、启动，再验证实际访问

返回仪表或 Dashboard，选中刚保存的配置，启动服务。首次使用若出现 VPN 或系统权限提示，按对应平台说明确认；拒绝必要权限可能导致启动失败。

运行计时、停止按钮和流量面板只能说明服务状态。再用浏览器或目标应用访问一次需要通过代理连接的目标，观察连接与流量变化。能打开网页也不单独证明走了预期出站：还要结合当前路由、连接记录或日志判断。

Windows 1.14.2 运行状态示例
Windows 示例：已有运行计时，但图中流量为零，不能据此确认代理访问成功。此图为本地配置，与上一张远程配置分别演示不同状态。

4. 按配置中的分组选择节点

配置包含 Selector 或 URLTest 分组时，客户端会提供组列表或对应状态。Selector 用于手动选择出站；URLTest 根据配置中的测试规则选择。列表名称和节点来自你的配置，不要求与截图一致。

没有“组”不一定是导入失败，单一出站配置可能没有可切换列表。模式选择同样取决于配置：使用至少两个 clash_mode 值时才有相应模式选择器，不能假定每份配置都有“规则 / 全局”开关。

5. 刷新配置、更新客户端与停止连接

远程配置刷新会重新获取 URL 返回的内容；本地配置不会因为远程源更新而自动变化。修改前保存可恢复副本，远程源更新可能覆盖自己对下载内容的改动。

更新客户端与刷新配置分开处理。升级前备份配置并查看版本变更，旧字段报错时按目标版本调整。结束使用时停止服务，再确认需要直连的访问恢复；桌面端关闭窗口可能仍在托盘运行。

按错误发生的阶段排查

  • 配置下载或导入失败：确认地址完整、未过期、认证要求已满足，返回内容不是登录页或错误页面。解析报错时核对是否为完整 sing-box JSON。
  • 保存成功但启动失败：查看启动日志中的第一条相关错误，核对字段与内核版本、引用文件及系统权限。保存成功不等于配置可运行。
  • 已启动但无法访问：检查选中的配置和出站，再看 DNS、路由及 TUN 是否符合预期；暂时退出其他代理程序以排除冲突。每次改一项并复测。

更多问题见常见问题。求助时记录系统、客户端与内核版本、失败步骤和脱敏后的错误提示，不公开完整订阅 URL 或节点密码。

下方保留相关教程索引。初次配置按上面的通用流程操作；只有使用对应平台、第三方客户端或部署服务端时，才需要阅读相应文章。