sing-box 订阅怎么添加？从复制链接到启动连接的完整步骤
简答：sing-box 订阅通常要作为 Remote 远程配置添加，而不是直接粘贴到本地 JSON 编辑器。先从服务商面板复制明确标注为 sing-box 或 JSON 的订阅链接，再在对应客户端的 Profiles 中新建 Remote、保存并更新。若导入后没有节点，优先检查链接格式、有效期、客户端版本和日志，不要把“保存成功”当成“已经可以联网”。
定义：sing-box 订阅是由服务商提供的远程配置地址，客户端通过 Remote 配置保存该 URL，并按客户端支持的格式拉取和更新配置。
先看这张速查表：你应该添加哪一种配置
本文是 AgentNEO 的第三方使用指南，不是 sing-box 官方页面。sing-box 官方维护的图形客户端按平台分为 Android、Apple 平台、Windows 和 Linux；不同客户端的按钮名称可能随版本变化，但官方通用概念都包括 Local、iCloud 和 Remote Profile。官方客户端列表与官方图形客户端通用说明可作为界面和功能核对依据。
| 你手里的内容 | 应选择的类型 | 判断标准 | 不要这样做 |
|---|---|---|---|
| 服务商提供的 sing-box 配置 URL | Remote / 远程配置 | 客户端保存一个 URL，并能手动或自动更新 | 不要把 URL 当成本地 JSON 内容粘贴 |
| 已经下载的 sing-box JSON 文件 | Local / 本地配置 | 文件内容是完整 JSON，通常以大括号开始 | 不要把文件路径当成订阅链接 |
| Clash、V2Ray、Base64 或通用订阅 | 先核对客户端支持或转换方式 | 服务商明确写明兼容 sing-box 才能直接尝试 | 不要看到“订阅”二字就默认格式通用 |
先试这一步：回到服务商后台，重新复制明确标注为 sing-box、sing-box JSON 或 Remote 的链接。若页面只提供 Clash 或其他格式，先不要反复点击导入；格式不匹配时，客户端可能显示解析失败、配置为空或保存后没有节点。
不超过 5 步的通用添加流程
- 备份：如果客户端里已有可用配置，先保留原配置，不要直接覆盖。新建一个容易识别的名称，例如“订阅-日期”，便于失败后删除并回滚。
- 确认链接：检查链接是否完整复制，开头通常是
http://或https://。不要把带空格、换行或页面说明文字的整段内容一起复制。订阅 URL 可能包含账号标识或 Token，不要公开发到群聊、工单截图或代码仓库。 - 新建 Remote：打开客户端的 Profiles、配置或配置文件页面，选择新增远程配置，填写名称和 URL，保存。官方通用说明把 Remote Profile 定义为“以 URL 作为更新来源的远程 sing-box 配置”。查看 Remote Profile 定义
- 手动更新：保存后执行一次 Update、Refresh 或更新操作。停止条件是客户端显示拉取成功、配置内容可以查看，或节点组已经出现；如果只显示“已保存”，还不能证明远程内容已经成功下载。
- 启动并验证：进入 Dashboard 或运行页面启动服务，按客户端提示授予 VPN 权限，再选择节点或出站组。验证至少包括运行状态、节点组是否有可选项、日志是否持续报错，以及浏览器或目标应用是否实际能够建立连接。
官方通用客户端说明还区分了 Dashboard、Groups 和 Status：运行后应能看到服务状态、连接或流量信息；当配置包含 Selector 或 URLTest 等出站组时，客户端才可能提供组选择。官方 Dashboard 与 Groups 说明
按设备操作：Android、iOS、macOS、Windows 怎么添加
Android
- 打开 sing-box 客户端，进入 Profiles 或配置文件页面。
- 选择新增远程配置，类型选 Remote，填写名称和订阅 URL。
- 保存后手动更新，确认配置能被读取并出现节点或出站组。
- 回到 Dashboard 启动服务，首次使用时按系统提示允许 VPN 连接。
若 Android 界面没有 Profiles 或 Remote，先核对当前安装的是否为支持图形配置的客户端，以及版本和应用来源；不要把命令行版本当成图形客户端操作。
iOS 或 iPadOS
- 进入配置文件或 Profiles 页面，新增 Remote 配置。
- 粘贴订阅 URL，保存后执行更新。
- 确认节点或出站组出现，再进入 Dashboard 启动。
- 首次启动时允许添加 VPN 配置；拒绝权限时，配置可能已经成功拉取，但系统流量不会经过该客户端。
macOS
- 在 Profiles 中新增 Remote 配置，填写名称和 URL。
- 保存并更新，确认配置内容或节点组可以读取。
- 在 Dashboard 启动服务，再到 Groups 选择出站组或节点。
- 如果你使用的是命令行或自行安装的核心，操作路径不会与图形客户端完全相同，应按当前客户端的配置文件位置和启动方式执行。
Windows
- 先确认安装的是带图形界面的 sing-box for Desktop，还是只有核心程序。
- 图形客户端中进入 Profiles 或配置页面，新增 Remote 并填写订阅 URL。
- 保存、更新、检查节点组，再启动服务。
- 如果只有核心程序，需要准备本地 JSON 配置并通过命令或服务方式启动；不能照搬图形客户端的按钮路径。
官方客户端页面明确列出 Windows 和 Linux 的 sing-box for Desktop；官方安装文档也分别列出 Windows、macOS、Android 等平台的安装渠道。官方图形客户端列表 官方安装方式
添加后怎么判断真的成功，而不是只保存了链接
- 配置拉取成功：更新操作没有报 URL、HTTP 状态码、超时或解析错误。
- 节点或出站组出现：配置页面能看到可用内容；如果只有配置名称，没有节点或组，说明仍需检查格式和内容。
- 服务已启动：Dashboard 显示运行状态，而不是停留在已保存或已导入。
- 权限已授予：移动端 VPN 权限已允许；桌面端则检查系统代理、TUN 或客户端要求的网络权限。
- 实际连接可用：用一个普通网页或目标应用验证，同时查看日志是否出现连续 DNS、TLS、认证或超时错误。浏览器能打开不等于所有应用都已走同一条路径，单次打开页面也不等于长期稳定。
如果配置包含出站组，官方 Dashboard 说明支持查看状态、连接和流量，并可在满足条件时切换组；这些界面结果比“按钮显示已连接”更适合作为验证依据。官方 Dashboard 功能说明
常见失败现象：按顺序排查，不要同时改很多项
1. 解析失败或导入后立即报错
先检查复制的是否为完整 URL，再确认服务商提供的格式是否明确兼容 sing-box。若拿到的是 Clash、V2Ray 或 Base64 订阅，不要直接断定 sing-box 支持；应向提供方确认是否有 sing-box 专用链接，或使用你信任且能说明处理方式的转换工具。转换前要注意订阅内容可能包含敏感凭据，不要把链接交给不明网页。
2. 配置保存了，但节点为空
先手动更新一次并查看日志；然后检查链接是否过期、是否需要登录认证、服务商是否返回了空配置。若 Remote 能保存但每次更新都失败，保存动作本身不能证明 URL 可访问。换网络只应作为排查方向，不能把一次成功更新推断为长期可用。
3. 节点出现，但启动后没网
先确认是否已选择出站组或节点，再确认 VPN 或系统代理权限，最后查看日志中的 DNS、TLS、认证和连接超时信息。若设备上已有其他 TUN、VPN 或代理工具，可能发生路由或端口冲突；可以暂时停止其他网络接管工具，验证是否恢复，确认后再决定保留哪一个。
4. 更新成功，但使用一段时间后失效
检查订阅的更新周期、服务商是否更换链接、客户端是否仍支持当前配置字段，并保留一个旧配置用于回滚。官方通用说明要求图形客户端支持 Remote Profile 的自动更新，默认更新间隔为 60 分钟；实际客户端是否提供开关、间隔和认证选项，以当前版本界面为准。Remote 自动更新说明
5. 订阅泄露或怀疑链接被公开
不要继续在公开位置测试原链接，先回到提供订阅的账户后台查看是否能重置、撤销或重新生成链接。本文不对任何服务商的重置能力作未核实承诺；如果后台没有相关选项，应联系提供方确认。
什么时候该用 Local，而不是 Remote
如果你需要自己编辑 JSON、固定配置内容或离线使用，可以选择 Local；如果配置由服务商持续维护、需要定期拉取更新，则优先使用 Remote。官方通用说明将 Local Profile 定义为本地 sing-box 配置，并要求图形客户端提供编辑配置内容的能力；Remote 则以 URL 为更新来源。官方 Local 与 Remote 定义
| 需求 | 建议 | 回滚方式 |
|---|---|---|
| 想自动获取远程配置更新 | Remote | 保留旧 Remote 或导出当前配置 |
| 想手动编辑 JSON | Local | 恢复备份文件 |
| 只想测试一次配置 | 新建单独的 Remote 或 Local | 删除测试配置，不覆盖主配置 |
常见问题 FAQ
sing-box 订阅链接是不是所有客户端都能直接导入？
不是。能否直接导入取决于链接返回的配置格式、客户端版本和具体实现。优先使用明确标注为 sing-box 或 JSON 的链接；Clash、V2Ray、Base64 等格式需要先确认兼容性，不能只根据“订阅链接”这个名称判断。
Remote 和本地 JSON 有什么区别？
Remote 保存的是远程 URL，客户端之后可以再次更新；本地 JSON 保存的是设备上的配置内容，需要你自己编辑或替换。Remote 适合持续维护的配置，本地 JSON 适合需要固定和手动调整的配置。
订阅添加成功但没有节点，应该先做什么？
先执行手动更新并查看日志，确认客户端实际拿到了配置；再检查链接是否过期、格式是否匹配、是否需要认证。如果日志显示更新成功但内容为空，应向订阅提供方确认返回内容，而不是反复切换节点。
启动后显示已连接，但网页打不开怎么办？
先确认 VPN 或系统代理权限，再查看 DNS、TLS、认证和超时日志；如果设备上同时运行其他 TUN 或 VPN 工具，先暂时停止其他工具做对照。已连接状态只说明服务尝试启动，不等于目标网站或所有应用都已验证成功。
Windows 只有 sing-box.exe，能按图形客户端步骤添加吗？
不能完全照搬。官方图形客户端和核心程序的操作方式不同；核心程序通常需要本地 JSON 配置和命令或服务方式启动。若希望使用 Profiles、Dashboard 等界面，应确认安装的是对应的图形客户端。
常见问题
sing-box 订阅链接是不是所有客户端都能直接导入？
不是。要同时满足返回格式、客户端版本和客户端实现兼容。优先使用明确标注为 sing-box 或 JSON 的链接。
Remote 和本地 JSON 有什么区别？
Remote 保存远程 URL，之后可以更新；Local 保存设备上的配置内容，适合手动编辑和固定使用。
订阅添加成功但没有节点，应该先做什么？
先手动更新并查看日志，确认客户端确实拉到了配置，再检查链接有效期、格式和认证要求。
启动后显示已连接，但网页打不开怎么办？
检查 VPN 或系统代理权限、DNS、TLS、认证和超时日志，并暂时停止其他 TUN 或 VPN 工具做对照。
Windows 只有 sing-box.exe，能按图形客户端步骤添加吗？
不能完全照搬。核心程序通常需要本地 JSON 配置，并通过命令或服务方式启动。