sing-box订阅链接怎么添加？安卓、iOS、电脑步骤与格式自查
简答：sing-box 订阅链接的正确添加方式是：优先点击账户页面提供的“导入到 sing-box”链接；没有一键导入时，在客户端新增 Remote（远程）Profile，粘贴完整 URL，更新配置后再启动服务。复制链接却导入失败或节点为空，先用浏览器打开链接：响应内容去掉空白后若不是以 { 开头，通常就不是可直接使用的 sing-box JSON 配置。
定义：sing-box 订阅链接，是一个用于远程获取 sing-box JSON 配置文件的 URL，客户端将它保存为 Remote Profile，并在更新时重新拉取配置。
先用 30 秒判断订阅链接能不能直接添加
先不要反复点击导入。用浏览器打开订阅 URL，查看返回内容的第一部分：去掉空格和换行后，如果以 { 开头，才有可能是 JSON；还要确认它实际包含 sing-box 配置所需的结构。sing-box 官方文档明确说明，配置文件使用 JSON 格式。查看 sing-box 官方配置说明
| 拿到的内容 | 能否直接作为 Remote | 下一步 |
|---|---|---|
| 完整 sing-box JSON 配置 | 可以尝试 | 在客户端新增 Remote Profile，粘贴完整 URL |
| Clash YAML | 不能直接当作 sing-box JSON 使用 | 向链接提供方索取 sing-box 格式，或使用提供方明确给出的转换入口 |
| 普通 Base64 或其他文本 | 不能直接判断为 sing-box 配置 | 不要只看链接名称，先要求提供 sing-box JSON 链接 |
| 登录页、错误页或 HTML | 不能使用 | 检查登录状态、URL 是否复制完整、链接是否过期 |
Remote Profile 的定义是“以 URL 作为更新来源的远程 sing-box 配置”；官方图形客户端还应支持自动更新和内容查看。查看 Remote Profile 官方说明
安全提示：订阅 URL 可能包含可识别账户的令牌。不要把完整链接发到群组、截图或不可信的转换网站；如果已经公开，优先在链接提供方的账户页面查找重新生成、撤销或重置入口。
Android 添加 sing-box 订阅链接
- 复制订阅 URL：在获取订阅的账户页面中查找“sing-box”“JSON”“远程配置”或“导入到 sing-box”等入口，只复制完整 URL，不要把说明文字一起复制。
- 优先尝试一键导入：如果页面提供“导入到 sing-box”按钮，点击后应由系统唤起客户端并创建远程配置。sing-box 官方图形客户端定义了
sing-box://import-remote-profileURL Scheme，用于导入远程 Profile。查看官方导入链接格式 - 没有反应时手动添加：打开 sing-box for Android，进入 Profiles（配置），点击新增按钮，选择 Create Manually（手动创建）；在 Type（类型）中选择 Remote（远程），Name（名称）填写便于识别的名称，URL 输入框只粘贴订阅地址。客户端支持管理和运行本地或远程 sing-box 配置。查看 Android 官方客户端说明
- 创建并更新：保存或点击 Create（创建）后，在配置列表中执行 Update（更新），确认最后更新时间发生变化。自动更新选项的名称和位置可能随版本变化，以当前版本界面为准。
- 启动服务：回到 Dashboard（面板），启动 sing-box 服务；Android 客户端在需要 TUN 时会通过 Android VpnService 工作。查看 Android 客户端功能说明
- 检查节点：如果配置包含 Selector 或 URLTest 等分组，Dashboard 中通常会出现 Group（分组）选择入口；先选择一个可用项目，再打开网页测试。查看官方 Dashboard 与 Groups 说明
如果你准备修改本地配置文件，先复制一份原文件。远程订阅更新会重新拉取内容，手动改动远程配置本身通常不会持久保留。
iOS 和 macOS 添加订阅的操作卡片
- 先找一键导入：在账户页面点击“导入到 sing-box”或类似按钮；如果系统询问是否打开 sing-box，允许即可。官方 Apple 客户端支持管理和运行本地或远程 sing-box 配置文件。查看 Apple 平台官方客户端说明
- 手动添加远程配置：打开 sing-box for Apple platforms，在配置或 Profiles 列表中点击新增，选择 Remote（远程），填写名称和 URL。不同 iOS、macOS 版本的按钮位置可能不同，以当前版本界面为准；关键是选择 Remote，而不是 Local（本地）或 iCloud。
- 更新配置：保存后执行 Update（更新）或刷新操作，确认远程配置已经成功下载；如果内容查看器显示 HTML、YAML 或错误信息，回到格式自查表，不要直接启动。
- 启动网络服务：在 Dashboard 或服务开关处启动 sing-box。iOS 和 macOS 的系统网络接管由 Apple 的 NetworkExtension 等机制提供，权限弹窗出现时需要允许。查看 Apple 客户端功能说明
- 验证连接：确认服务状态为运行中，再选择配置中提供的分组或节点，打开网页进行实际访问测试。
如果你使用的是 Apple tvOS，不要直接照搬 iPhone 的按钮位置；官方资料说明 tvOS 支持从 iPhone 或 iPad 导入 Profile，具体入口以当前版本为准。查看 Apple 平台功能差异
Windows、Linux 与第三方 GUI 怎么选入口
| 你使用的程序 | 应找的入口 | 注意事项 |
|---|---|---|
| 官方 sing-box for Desktop | Profiles、Remote 或远程配置 | 官方桌面客户端支持管理和运行本地或远程配置；Windows 要求为 Windows 10 或更高版本，Linux 也有对应构建。查看官方 Desktop 说明 |
| 第三方 GUI.for.SingBox 等图形前端 | 查找 Quick Start、Profiles、Remote 或订阅入口 | 第三方界面不等同于官方 Desktop，按钮和配置格式可能不同；优先按该程序当前说明操作，不要把 Android 按钮名称当成固定标准 |
| 命令行 sing-box 核心 | 保存 JSON 配置文件后使用命令检查和运行 | 命令行核心没有统一的图形化订阅入口，需要先取得配置文件，再用当前版本命令检查 |
- 官方 Desktop：打开 Profiles 或配置管理区域，新增 Remote Profile，填入名称和 URL，保存后执行更新，再启动服务。官方 Desktop 的定位就是管理和运行本地或远程 sing-box 配置。查看官方 Desktop 客户端说明
- 第三方 GUI：如果程序显示 Quick Start 或 Remote，按其界面添加 URL；如果只接受文件，就先向链接提供方索取 JSON 文件或该 GUI 明确支持的格式。不要把普通网页地址直接改名为配置文件。
- 命令行核心：把配置保存为 JSON 文件后，可使用
sing-box check检查配置语法；官方文档同时列出了格式化和合并命令。查看官方命令说明
一键导入无反应、更新失败或节点为空怎么办
| 现象 | 先检查什么 | 可执行处理 |
|---|---|---|
| 点击“导入到 sing-box”没有反应 | 系统是否允许打开 URL Scheme、客户端是否已安装 | 复制 URL 后回到客户端手动新增 Remote Profile；URL Scheme 的官方格式见官方通用客户端说明 |
| JSON 解析失败 | 返回内容是否为完整 JSON | 浏览器打开 URL，若出现 HTML、YAML、登录页或错误提示，重新获取 sing-box 格式链接 |
| 远程拉取失败、超时或状态码错误 | URL 是否完整、链接是否过期、当前网络是否能访问订阅域名 | 重新复制并更新；直连失败时，可在已有可用连接下更新，或换一个网络再试；仍失败则让链接提供方确认订阅状态 |
| 配置字段不支持 | 客户端和配置生成端的版本是否相差较大 | 先更新客户端，再索取兼容当前版本的配置；不要在不了解作用的情况下删除字段 |
| 导入成功但节点列表为空 | 配置是否更新完成、是否确实包含 outbounds 或分组 | 手动 Update，查看最后更新时间和配置内容；如果返回的是空配置或错误页，重新索取专用链接 |
| 启动后无法联网 | VPN 或系统网络权限、服务状态、节点选择、DNS 与其他网络工具冲突 | 先确认服务正在运行并重新允许系统权限，再选择节点测试；暂时关闭其他会接管 VPN 或系统代理的工具 |
排查顺序建议固定为：格式 → URL 可访问性 → 配置更新 → 服务状态 → 节点或分组 → 系统权限 → DNS。如果使用电脑保存了 JSON 文件，可先运行 sing-box check；官方配置文档将该命令列为配置检查方式。查看配置检查说明
导入成功后的 5 项自查清单
- 格式：远程内容是 sing-box JSON，而不是登录页、HTML 或其他订阅格式。
- 更新时间：手动更新后，Profile 显示的最后更新时间发生变化。
- 内容：配置中存在可运行的出站和节点分组，而不是空配置。
- 运行状态：Dashboard 或服务区域显示 sing-box 正在运行。
- 实际访问：选择节点后打开普通网页测试；若失败，再回到权限、DNS 和节点选择排查。
本文为第三方使用指南，客户端菜单会随版本变化；账户页面中的订阅格式、链接有效期和重新生成方式，以链接提供方当前说明为准。
常见问题
sing-box 订阅链接是不是复制后直接粘贴就能用？
不一定。只有链接返回可识别的 sing-box JSON 配置时，才适合添加为 Remote Profile；如果返回网页、Clash YAML、普通 Base64 或错误信息，应先索取 sing-box 格式链接。
为什么点击“导入到 sing-box”没有反应？
可能是客户端没有安装、系统没有允许打开 URL Scheme，或者当前页面没有生成有效的 sing-box 导入链接。复制完整 URL 后，回到客户端手动新增 Remote Profile；官方支持的导入链接格式见sing-box 通用客户端说明。
为什么订阅添加成功，但节点列表是空的？
先执行 Update 并查看更新时间，再确认返回内容是否为完整 JSON 配置。如果链接返回空内容、错误页或不包含可用出站，客户端可以保存 URL，但不会出现可选择的节点。
Windows、iOS、macOS 能不能照着 Android 的步骤添加？
不能完全照搬按钮位置。Android、Apple 平台和 Desktop 都支持本地或远程配置，但菜单名称和系统权限流程可能不同；应在当前客户端中寻找 Profiles、Remote 或远程配置入口。官方平台列表可见sing-box 图形客户端说明。
订阅链接泄露后应该怎么办？
停止继续分享旧链接，并在链接提供方的账户页面查找重新生成、撤销或重置入口；如果没有该功能，联系提供方处理。新链接不要提交给不可信的转换网站。
常见问题
sing-box 订阅链接是不是复制后直接粘贴就能用？
不一定。只有链接返回可识别的 sing-box JSON 配置时，才适合添加为 Remote Profile；如果返回网页、Clash YAML、普通 Base64 或错误信息，应先索取 sing-box 格式链接。
为什么点击“导入到 sing-box”没有反应？
可能是客户端没有安装、系统没有允许打开 URL Scheme，或者当前页面没有生成有效的 sing-box 导入链接。复制完整 URL 后，回到客户端手动新增 Remote Profile；官方支持的导入链接格式见 sing-box 通用客户端说明。
为什么订阅添加成功，但节点列表是空的？
先执行 Update 并查看更新时间，再确认返回内容是否为完整 JSON 配置。如果链接返回空内容、错误页或不包含可用出站，客户端可以保存 URL，但不会出现可选择的节点。
Windows、iOS、macOS 能不能照着 Android 的步骤添加？
不能完全照搬按钮位置。Android、Apple 平台和 Desktop 都支持本地或远程配置，但菜单名称和系统权限流程可能不同；应在当前客户端中寻找 Profiles、Remote 或远程配置入口。官方平台列表可见 sing-box 图形客户端说明。
订阅链接泄露后应该怎么办？
停止继续分享旧链接，并在链接提供方的账户页面查找重新生成、撤销或重置入口；如果没有该功能，联系提供方处理。新链接不要提交给不可信的转换网站。