sing-box怎么添加订阅?按设备导入、更新与连接排查
简答:sing-box 添加订阅的核心是获取服务提供方给出的远程配置 URL,然后在客户端新增 Remote(远程)配置并更新。先确认链接返回的是 sing-box 可识别的 JSON 配置,而不是 Clash YAML 或普通节点文本;导入后再启动 VPN、选择出站并用日志或网页访问验证。具体入口与域名以服务提供方官方为准,可从原账户站内通知、注册邮件或原订阅来源重新获取。
定义:sing-box 订阅通常指一个可远程更新的配置 URL,客户端通过 Remote Profile 下载并保存 sing-box 配置,而不是把任意节点链接直接当作完整配置。
先判断格式:不要把所有订阅链接都直接粘贴进 sing-box
本文是饿饭cc云-高速云端数据加密传输服务!的第三方使用指南,不代表任何品牌官方。sing-box 官方客户端把远程配置称为 Remote Profile:它以 URL 作为更新来源,并可由图形客户端查看配置内容、自动更新和处理 HTTP Basic 认证。可参考 sing-box 官方图形客户端通用说明。
| 你拿到的内容 | 可能的格式 | 处理方式 |
|---|---|---|
| 服务商后台明确标注 sing-box、JSON 或 Remote | 远程 sing-box 配置 | 优先直接添加为 Remote URL |
打开后以 { 开头,包含 inbounds、outbounds 或 route | JSON 配置 | 可尝试直接导入,并在客户端更新 |
内容以 YAML 缩进、proxies: 或 proxy-groups: 开头 | Clash/Mihomo 配置 | 不要直接当作 sing-box JSON;回到服务商后台寻找 sing-box 格式 |
内容是多行 vless://、vmess:// 或其他 URI | 节点链接集合 | 需要客户端支持批量链接导入,或使用服务商提供的 sing-box 配置,不要自行猜测转换参数 |
如果服务商只提供一种通用订阅,是否兼容 sing-box 不能仅凭链接名称判断。最稳妥的做法是先在浏览器或下载工具中检查响应内容,但不要把带账号凭据的完整订阅链接发到群聊、截图或在线转换站。
最快导入流程:先备份,再新增远程配置
- 找到订阅来源。登录原账户后台,寻找“订阅”“客户端配置”“sing-box”“JSON”“Remote”或类似入口。找不到时,检查注册邮件、原订阅邮件和账户站内通知;具体入口与域名以官方为准。
- 复制完整 URL。从协议头到参数全部复制,不要手动删除问号、等号、斜杠或 URL 参数。订阅 URL 通常等同于账户凭据,泄露后应回到账户后台重置或重新生成。
- 打开客户端的配置管理。在 Android、iOS、macOS 或 Windows 图形客户端中寻找“Profiles”“配置”“远程配置”“Remote”或“添加 URL”。官方通用说明要求图形客户端支持 Remote Profile,但不同客户端的菜单名称可能不同。
- 保存并执行更新。粘贴 URL,填写便于识别的名称,保存后点击更新、刷新或拉取配置。若客户端支持 HTTP Basic 认证,再按服务方提供的用户名和密码填写;不要把认证信息写入公开配置。
- 启用并验证。选择新增配置,启动 VPN 或系统代理,再打开一个普通网页测试。若配置含有多个 Selector 或 URLTest 出站,客户端通常会提供分组选择;官方说明提到图形客户端可在存在相应出站组时提供组选择界面。
官方项目将 Android 客户端、Apple 客户端和桌面客户端分别维护;项目组织页列出了 Android 客户端仓库、iOS/macOS/tvOS 客户端仓库以及 Windows 桌面客户端仓库。客户端界面和支持状态可能变化,安装渠道与版本应以对应项目页面为准。
按设备操作:Android、iPhone/iPad、macOS 与 Windows 的差异
Android
打开 sing-box Android 客户端后,先进入配置或 Profiles 页面,选择新增远程配置、Remote 或 URL 导入。粘贴完整订阅地址,保存并执行更新;确认配置列表出现名称和更新时间,再启用 VPN 权限。若 Android 系统弹出 VPN 连接确认,必须允许,否则配置可能已经导入但流量不会经过客户端。
iPhone 或 iPad
在 Apple 客户端中寻找配置、Profiles 或 Remote Profile,添加远程 URL 后执行更新。首次启动通常还需要允许系统创建 VPN 配置;如果只完成了下载配置、没有完成系统授权,节点列表可能正常显示,但网页仍无法访问。官方通用文档还定义了远程配置导入 URL Scheme:sing-box://import-remote-profile?url=urlEncodedURL#urlEncodedName,但是否能由当前客户端或服务商页面直接调用,要以客户端实际支持为准。
macOS
macOS 端可以使用远程配置或本地配置。普通用户优先选择 Remote,避免手动编辑 JSON;保存后更新配置,再启动服务并检查系统代理或 TUN 相关权限。若 macOS 客户端只显示本地配置,先确认使用的是支持图形配置管理的客户端,而不是仅有命令行核心。
Windows
Windows 图形客户端的菜单可能使用 Profiles、Remote、订阅或配置管理等不同名称。导入后先确认配置文件能正常打开,再启动服务;如果使用 TUN,需要按客户端提示授予管理员权限或安装所需网卡组件。只想让支持系统代理的应用使用时,可先采用系统代理方式验证,确认配置有效后再处理 TUN。
导入成功后的更新、切换与基础验证
- 更新订阅:在配置列表中点击更新、刷新或右键更新。官方通用说明中,Remote Profile 需要支持自动更新,默认更新间隔写为 60 分钟;实际客户端可以提供不同设置,不能把该默认值当成所有客户端的固定行为。
- 选择节点或出站:打开 Dashboard、Groups 或出站选择界面。如果配置没有 Selector、URLTest 等组,客户端可能只显示一个默认出站,不能凭空增加节点。
- 选择路由模式:有些配置提供 Rule、Direct、Global 等模式。Rule 通常按配置规则分流,Direct 直连,Global 尝试让更多流量走代理;具体含义取决于配置中的路由规则,不能只看按钮名称。
- 验证连接:先访问一个普通网页,再查看客户端日志中的 DNS、TLS、超时或连接失败信息。验证应至少做两次:一次在未启动客户端时记录结果,一次在启动并选择节点后重复访问,用于区分本地网络问题和配置问题。
如果配置包含分组出站,官方说明指出图形客户端可提供组选择与状态显示;如果没有分组,出现“没有可切换节点”不一定代表导入失败,可能只是配置本身没有提供选择组。相关能力可查阅 官方 Remote Profile 与 Dashboard 说明。
按现象排查:节点为空、JSON 报错或启动后没网
| 现象 | 先检查什么 | 下一步 |
|---|---|---|
| 保存后没有节点 | URL 是否完整、配置是否更新成功、响应是否为空 | 重新复制链接;确认服务商后台提供的是 sing-box/JSON 格式,而不是 Clash YAML |
| 提示 JSON 或格式错误 | 响应是否为登录页、验证码页、错误文本或 HTML | 在原账户后台重新生成链接;不要把网页地址误当订阅地址 |
| 有节点但无法连接 | 是否完成 VPN 授权、是否选择了可用出站、系统时间是否正常 | 先切换另一个出站,再查看日志中的 DNS、TLS、超时信息;不要仅凭一次失败判断服务状态 |
| 更新后节点消失 | 更新是否返回新配置、订阅是否过期或被撤销 | 回到账户后台确认订阅状态;必要时删除旧 Remote Profile 后重新添加 |
| 启动后所有应用都没网 | TUN、DNS、系统代理和权限是否同时启用 | 先关闭 TUN,仅用系统代理验证;若仍失败,再检查 DNS 和日志,最后回滚到更新前配置 |
建议按“链接响应—配置解析—客户端权限—节点选择—DNS/TUN”的顺序排查。这样可以先排除订阅本身无效,再处理本机权限和网络路径。若你无法确认某个转换服务是否会保存订阅内容,优先不要上传真实订阅链接,改用已撤销或脱敏的测试配置。
回滚与安全检查:避免订阅泄露导致重复排查
- 在更新前保留旧配置名称或导出本地副本,更新失败时先切回旧配置。
- 不要把包含 token、用户名、密码或长参数的订阅 URL 发布到公开平台。
- 不要把普通网页、登录地址或 Clash YAML 链接强行改成 JSON 后缀;格式转换必须由服务提供方或你明确可信的工具完成。
- 如果订阅链接曾经公开,优先在原账户后台撤销、重置或重新生成,再在客户端替换 Remote URL。
- 客户端升级前查看对应项目的发布说明。sing-box 核心的发布页会列出版本和变更,具体兼容性以当前客户端和配置实际提示为准,可查看 sing-box 官方发布页。
常见问题
sing-box 订阅链接从哪里获取?
从你实际使用的服务账户后台、注册邮件、原订阅邮件或站内通知获取。页面没有 sing-box 或 JSON 标识时,不要猜测兼容格式;具体入口与域名以官方为准。
Clash 订阅能直接添加到 sing-box 吗?
不能一概而论。Clash YAML 与 sing-box JSON 是不同配置格式;如果服务方明确提供 sing-box、JSON 或 Remote 配置,应优先使用该链接。仅看到 Clash YAML 时,应回到账户后台寻找对应格式,不要只修改文件后缀。
导入后没有节点,是订阅失效了吗?
不一定。可能是链接返回登录页、错误页、空内容,或者客户端无法解析当前格式。先查看更新结果和配置内容,再确认账户后台的订阅状态;单凭客户端列表为空不能确定服务端状态。
为什么有节点但启动后无法联网?
可能是系统 VPN 权限未授权、TUN 权限不足、DNS 配置冲突、出站不可用或路由规则将流量设为直连。先切换到系统代理或另一个出站做对照,再查看 DNS、TLS 和超时日志。
Remote 配置会自动更新吗?
官方通用说明要求图形客户端为 Remote Profile 提供自动更新,文档写明默认间隔为 60 分钟;实际客户端的开关、时间和后台行为可能不同,应以当前客户端设置为准。
常见问题
sing-box 订阅链接从哪里获取?
从实际使用的服务账户后台、注册邮件、原订阅邮件或站内通知获取。具体入口与域名以官方为准。
Clash 订阅能直接添加到 sing-box 吗?
不能一概而论。Clash YAML 与 sing-box JSON 是不同格式,优先使用服务方明确标注为 sing-box、JSON 或 Remote 的链接。
导入后没有节点怎么办?
先检查更新响应是否为空、是否返回登录页或错误页,再确认链接格式和账户后台状态;不要只凭节点列表为空判断服务已失效。
有节点但启动后无法联网怎么办?
依次检查 VPN 授权、出站选择、DNS、TUN 权限和日志,先用系统代理做对照,再处理高级 TUN 设置。
Remote 配置会自动更新吗?
官方通用说明要求图形客户端支持自动更新,并写明默认间隔为 60 分钟;具体开关和间隔以当前客户端为准。