平行线路网络

sing-box 导入订阅教程：安卓、iPhone、Windows、macOS 步骤与排错

更新于 2026-11-02 · xn--gwtw23etrg7yf.shop

简答：sing-box 导入订阅的核心是：确认服务商提供的链接格式与客户端兼容，再在对应平台的配置管理区域新增远程配置，填写名称和完整 URL，保存后刷新并启动。不要把带有账号凭证或 token 的订阅链接提交给不可信的在线转换站；如果导入失败，先回到订阅格式、链接完整性、登录状态和客户端版本这四项检查。

定义：sing-box 订阅是由服务商提供的远程配置地址，客户端通过 URL 拉取配置或节点信息，导入后再由 sing-box 解析、更新并启动连接。

先判断：你拿到的到底是哪一种订阅

本文是平行线路网络的第三方使用指南，不代表 sing-box 项目或任何服务商的官方页面。sing-box 本身使用 JSON 配置文件，官方文档列出了 log、dns、inbounds、outbounds、route 等配置结构；因此，能否直接导入，取决于链接返回的内容和当前客户端是否支持，而不是只看链接后缀。

你拿到的内容常见特征处理方式
原生 sing-box 配置返回 JSON，通常包含 outbounds、route、dns 等字段优先使用客户端的远程配置或导入配置入口
Clash 配置返回 YAML，常见字段包括 proxies、proxy-groups、rules先确认服务商明确提供 sing-box 兼容格式；不要默认认为 YAML 可直接作为 sing-box JSON 使用
单节点分享链接一次只包含一个节点或一条协议链接使用客户端的单节点导入、剪贴板导入或二维码导入功能
Base64 或通用订阅打开后是编码文本，无法直接读出完整 JSON询问服务商是否提供 sing-box 专用订阅，避免自行转换导致字段丢失

最短判断方法是：复制链接到浏览器或文本工具中查看返回内容，但不要公开粘贴完整链接。若内容不是 JSON，或者返回登录页、HTML 错误页、空白内容，应先联系链接提供方确认格式。官方配置说明可参考 sing-box 配置文档。

一分钟速查：导入前先记录四项信息

  1. 客户端与平台：确认你使用的是 Android、iPhone/iPad、macOS，还是 Windows/Linux。官方图形客户端页面将 Android、Apple 平台和 Desktop 客户端分别列出，具体入口名称可能随版本变化，可先查看 官方图形客户端列表。
  2. 订阅格式：记录服务商是否明确写出 sing-box、SFA、SFI、SFM 或原生 JSON。没有明确说明时，不要把“通用订阅”直接等同于 sing-box 订阅。
  3. URL 完整性：从复制开始到末尾完整粘贴，检查是否被聊天软件截断、换行或自动添加空格。
  4. 账号状态：确认订阅需要的登录、授权、有效期或设备限制要求。若浏览器打开后出现登录页，客户端通常无法直接解析该页面。

建议先备份已经能工作的配置，再新增远程配置。不要删除旧配置后再测试新链接，这样出现解析失败时可以快速回滚。

Android：新建远程配置并启动

官方将 Android 客户端单独列为 sing-box for Android；以下步骤按功能入口描述，当前版本的菜单名称可能不同。

  1. 打开 Android 客户端，进入配置、Profiles、配置文件或同义的配置管理区域。
  2. 选择新增配置，并优先选择远程配置、Remote、URL 导入或从链接导入，而不是新建空白 JSON。
  3. 在名称字段填写便于识别的名称，例如“办公线路”；在 URL 字段粘贴完整订阅地址。名称可以自定义，URL 不要改写。
  4. 保存后手动刷新或更新该配置。观察结果应是配置被下载，且列表中出现节点、出站或分组信息。
  5. 选择该配置并启动。首次启动时，Android 可能要求确认 VPN 权限；只有在你确认使用该配置时才允许建立系统 VPN。
  6. 如果配置包含节点分组，先选择一个分组或节点，再观察日志、连接状态和请求记录。

如果保存后列表为空，不要马上修改 DNS 或 TUN。先检查 URL 是否完整、服务商是否提供 sing-box 格式、链接是否需要登录，以及更新时是否能正常访问远程地址。

iPhone 或 iPad：导入配置并处理 VPN 权限

官方客户端页面将 iOS、macOS 和 Apple tvOS 归为 Apple 平台客户端。由于系统权限和应用版本会影响菜单名称，以下使用“配置管理”“远程配置”等功能名称描述。

  1. 打开 sing-box 的 Apple 平台客户端，进入配置文件或 Profiles 区域。
  2. 选择新增远程配置、从 URL 导入，或使用剪贴板导入。若服务商提供二维码，也可以使用客户端明确提供的扫码入口。
  3. 填写自定义名称和订阅 URL。粘贴后不要在 URL 前后加入空格，也不要把带 token 的地址发到群聊或在线转换工具。
  4. 保存并执行刷新。导入成功的可观察结果是配置条目出现，或者配置内容能够被客户端解析。
  5. 选中配置并启动。系统弹出 VPN 添加或允许连接提示时，确认配置来源可信后再授权。
  6. 首次启动失败时，先关闭其他 VPN、网络过滤器或代理客户端，避免多个系统级网络扩展同时接管流量。

如果旧版本配置无法迁移，先导出或截图记录现有配置，再重新添加远程 URL。官方迁移文档说明，部分版本会发生配置字段变化或 Apple 平台应用数据迁移问题，应以当前版本提示为准，参考 官方迁移文档。

Windows 和 macOS：图形客户端与配置文件的区别

Windows 端可使用官方 Desktop 客户端管理本地或远程 sing-box 配置文件，并提供包括 TUN 在内的平台功能；官方页面明确列出 Windows 10 及以上要求。macOS 则属于 Apple 平台客户端，不能把 Windows 的安装包或操作路径直接套用到 macOS。

  1. Windows：打开 Desktop 客户端，进入配置文件管理区域，新增远程配置或导入远程配置文件，填写名称和完整 URL，保存后执行更新。
  2. macOS：打开 Apple 平台客户端，进入配置或 Profiles，新增远程配置并粘贴 URL，保存后刷新。
  3. 启动前：先确认配置条目能被解析，再选择节点或分组。不要在配置尚未成功更新时直接开启 TUN。
  4. 启动时：如果系统要求管理员权限、网络扩展或 TUN 权限，先确认弹窗来自系统和已安装客户端，再授权。
  5. 验证：观察客户端状态、日志、节点选择和实际请求是否有变化。仅看到“已启动”或出口 IP 变化，不足以证明所有应用流量和 DNS 请求都经过同一配置。

官方 Desktop 文档说明，该客户端可以管理本地或远程配置文件，并支持平台相关的 TUN 功能；下载入口和支持平台以 官方 Desktop 文档及其发布页为准。

导入成功后：刷新、选节点、启动和复测

  1. 刷新订阅：在配置列表中找到更新、刷新、同步或同义操作，记录更新时间和返回结果。若没有更新时间或节点数量变化，不能直接判断更新成功。
  2. 选择节点：如果配置提供分组，先在客户端显示的分组中选择节点；如果没有分组，使用配置中已有的默认出站，不要随意修改 JSON。
  3. 启动连接：先启动客户端，再按平台提示授予 VPN、网络扩展或 TUN 权限。启动后观察日志是否出现解析失败、握手失败、超时或 DNS 错误。
  4. 复测网页和应用：分别测试一个普通网页、一个需要域名解析的应用和实际工作软件。不同应用的代理行为可能不同，不能只用一个网页结果代表全部流量。
  5. 记录结果：记录时间、网络类型、配置名称、节点或分组、错误文本和是否能复现。之后更换节点或网络时，一次只改一个变量。

如果你使用命令行或本地 JSON 文件，可先用官方提供的 sing-box check 检查配置；官方文档还提供格式化和合并命令。远程订阅不能直接修改时，应回到提供方修正原始配置。

按现象排查：导入失败、更新失败、启动失败

现象优先检查处理与回滚
JSON 解析失败返回内容是否真的是 JSON；是否复制了登录页、错误页或不完整内容重新复制完整 URL；确认服务商提供 sing-box 格式；保留旧配置并删除新建的失败条目
格式不支持是否拿到了 Clash YAML、Base64 或单节点链接改用对应导入入口，或向提供方索取 sing-box 兼容配置；不要盲目改后缀
订阅更新失败网络是否可访问 URL、URL 是否过期、是否需要登录或授权用浏览器仅检查响应类型，不公开完整 token；恢复到上一次可用配置
启动失败VPN、TUN、网络扩展权限，是否有其他客户端占用关闭其他网络代理工具后重试；先使用系统代理或默认模式验证，再决定是否启用 TUN
启动后无网络节点是否可用、默认出站是否正确、DNS 和路由是否冲突先切换到配置中已有的其他节点；关闭 TUN 或恢复旧配置，记录日志后再继续
节点或分组全空远程内容是否包含可解析的 outbounds、分组或客户端需要的字段确认订阅类型和客户端版本；不要仅凭“下载成功”判断配置有效

sing-box 的配置字段会随版本演进，官方迁移文档记录了旧 DNS 格式等字段变化，部分旧格式在后续版本中可能被移除。因此，遇到“以前能用、更新后解析失败”，应记录客户端版本和错误文本，再对照官方迁移说明，而不是直接复制旧配置继续覆盖。

安全与回滚：不要把订阅链接当普通网址处理

  • 订阅 URL 可能包含账号凭证、随机 token 或授权信息，获得链接的人可能可以访问同一配置，因此不要公开发布完整地址。
  • 不要把完整订阅链接粘贴到不可信的在线转换、测速或格式转换服务。
  • 导入前备份旧配置；测试时一次只改一个变量，例如先只更换订阅，再单独测试 TUN 或 DNS。
  • 如果新配置导致无网络，先停止客户端、关闭 TUN 或网络扩展，恢复旧配置，再重新测试。
  • 官方配置文档说明 sing-box 使用 JSON；如果手动编辑配置，应先使用配置检查能力，避免把示例字段直接复制到生产配置中。

完成一次可复现记录后，至少保留：平台、客户端名称、版本、订阅格式、更新时间、错误原文、是否开启 TUN、网络类型和回滚结果。这样后续排查连接问题时，不会把订阅解析、节点握手、DNS 和系统权限混为一谈。

常见问题

sing-box 可以直接导入 Clash 订阅吗？

不能仅凭“订阅链接”四个字判断。先查看返回内容和服务商说明：如果是 Clash YAML，通常应使用明确支持该格式的入口，或向提供方索取 sing-box JSON 订阅。不要只修改文件后缀，也不要把 YAML 当作原生 sing-box JSON。

sing-box 导入订阅后为什么没有节点？

优先检查远程链接是否返回了登录页、错误页、空内容或不兼容格式，再确认客户端是否完成刷新。若配置能下载但列表为空，还要检查返回内容是否包含客户端需要的 outbounds、分组或路由字段。

sing-box 订阅更新失败怎么办？

先记录错误原文和更新时间，检查 URL 是否完整、是否过期、是否要求登录或授权，再换一个网络复测。不要公开完整订阅地址；如果旧配置仍可用，先保留并恢复旧配置，避免在排查过程中丢失可用设置。

sing-box 启动后仍然无法联网，订阅是否导入错了？

不一定。订阅解析成功、节点握手失败、DNS 冲突、系统 VPN 权限和 TUN 路由问题都可能造成启动后无网络。先查看日志和连接状态，关闭其他网络代理工具，暂时回退到非 TUN 模式或旧配置，再一次只改变一个变量。

Windows 和 macOS 的 sing-box 导入方式一样吗？

不完全一样。官方将 Windows 归入 Desktop 客户端，将 macOS 归入 Apple 平台客户端；两者都可以管理配置，但安装包、权限和网络扩展入口可能不同。应按当前平台客户端显示的配置管理入口操作。

相关阅读

参考资料

  1. sing-box 官方图形客户端列表
  2. sing-box 官方 Android 客户端文档
  3. sing-box 官方 Apple 平台客户端文档
  4. sing-box 官方 Desktop 客户端文档
  5. sing-box 官方配置文档
  6. sing-box 官方迁移文档
  7. sing-box 官方 GitHub Releases