sing-box 怎么导入机场订阅?
简答:sing-box 导入机场订阅的关键不是把任意链接粘贴进去,而是先确认服务商提供的是 sing-box 配置或可转换链接。然后在客户端的 Profiles/配置中新增 Remote/远程配置,粘贴订阅 URL,保存并刷新;看到配置内容、节点或分组后,再启动 VPN/TUN 并测试联网。本文是第三方使用指南,不代表任何订阅服务商官方页面。
定义:sing-box 订阅导入,是把服务商提供的远程配置 URL 添加到 sing-box 图形客户端的 Remote Profile 中,由客户端下载、保存并按设置自动更新配置。
先试这一步:确认链接能不能直接给 sing-box 使用
先不要急着在客户端里反复点击。打开服务商用户中心,寻找名称中带有 sing-box、JSON、Remote 或“远程配置”的订阅入口。不同服务商对链接的命名不统一,不能仅凭“通用订阅”四个字判断兼容性。
| 你拿到的内容 | 通常表现 | 下一步 |
|---|---|---|
| 完整 sing-box 配置 | 内容类似 JSON,常见顶层字段包括 outbounds、route 或 dns | 可作为远程配置或本地配置导入,具体看客户端入口 |
| Clash 配置 | 通常是 YAML,能看到 proxies、proxy-groups 等字段 | 不要直接当作 sing-box JSON;需要服务商提供兼容格式或转换后的配置 |
| 单节点链接 | 通常只描述一个节点,不包含完整路由和分组 | 使用“添加节点/手动节点”类入口,不要当作订阅 URL |
| 无法打开或返回登录页 | 浏览器显示错误、登录页面或 HTML | 检查是否复制完整链接、是否需要登录,以及链接是否已失效 |
官方文档说明,sing-box 配置文件使用 JSON;图形客户端的 Remote Profile 以 URL 作为更新来源,并支持自动更新。可查看 sing-box 配置说明 与 图形客户端 Profile 说明。如果你无法确认返回内容,先保存一份原始链接,不要把完整订阅公开发到群聊、工单截图或代码仓库。
按设备导入:Remote 配置的最短路径
Android 客户端
- 打开 sing-box Android 客户端,进入 Profiles/配置 或同义入口。
- 点击新增配置,选择 Remote/远程,不要选择只用于手写 JSON 的 Local/本地类型。
- 在 URL 字段粘贴完整订阅链接,填写容易识别的名称。
- 保存后点击更新、刷新或同步,等待客户端下载配置。
- 进入 Dashboard/主面板,选择配置中的节点分组或出站组,再启动服务。
- 首次启动时,按 Android 系统提示允许 VPN 权限。官方 Android 客户端在需要 TUN 时使用 Android 的 VpnService;相关能力和限制可参考 sing-box Android 客户端功能说明。
iPhone 或 iPad
- 进入客户端的 Profiles、配置或设置页面。
- 选择新增 Remote Profile/远程配置,粘贴订阅 URL 并保存。
- 手动执行更新,确认配置内容已经下载,而不是只看到一个空白名称。
- 回到主面板选择节点或分组,启动连接,并允许系统添加 VPN 配置。
iOS 与 macOS 客户端在官方项目中归为 Apple 平台客户端,但不同发行版本的菜单名称可能不同;如果找不到按钮,可在应用内搜索 Profile、Remote、Import 或 Update。
Windows
- 打开桌面客户端,先找到 Profiles、配置管理或远程配置入口。
- 新增 Remote 配置,粘贴 URL 并保存。
- 执行更新,确认配置解析成功后再选择出站组。
- 启动服务;如果客户端提供系统代理或 TUN 开关,先只启用一种方式测试,避免多个代理软件同时接管网络。
官方项目将 sing-box 核心与图形客户端分开维护,Windows 图形客户端的菜单可能随版本变化;桌面端项目和平台归属可从 SagerNet 官方项目列表核对。不要把命令行核心的配置文件路径直接当成图形客户端的导入入口。
macOS
- 进入 Profiles 或配置管理页面,新增 Remote Profile。
- 粘贴订阅 URL,保存后执行 Update/更新。
- 确认配置没有解析错误,再选择节点或分组。
- 启动连接,并按 macOS 提示允许网络扩展或 VPN 权限。
导入成功后的验证闭环
- 看配置状态:远程配置应显示名称、更新时间或已下载状态,而不是一直处于空白、等待或错误状态。
- 看节点内容:打开配置查看 outbounds、节点分组或可选出站;如果只有配置名称而没有节点,优先回到格式和订阅权限检查。
- 启动服务:在 Android/iOS 上确认 VPN 图标或系统 VPN 状态;桌面端确认客户端状态变为运行中。
- 测试实际业务:先访问一个普通网页,再测试你真正需要访问的业务。只看到 VPN 图标并不等于配置已经正确工作。
- 记录失败点:把“更新失败、解析失败、无节点、启动后无网、单个节点失败”分别记录,不要把它们混为一个问题。
如果远程配置能更新、节点也能显示,但启动后无法联网,优先检查当前选择的分组、系统代理/TUN 是否重复接管、DNS 是否异常,以及是否有其他 VPN 或网络过滤软件同时运行。
导入失败、无节点、无法联网:按现象排查
| 现象 | 先检查什么 | 处理方法 |
|---|---|---|
| 粘贴后提示格式错误 | 返回内容是否为 JSON;链接是否被截断 | 重新复制完整 URL;向服务商索取 sing-box 格式或兼容配置,不要把 YAML 直接改后缀成 JSON |
| 配置能保存但没有节点 | 配置是否真的完成更新;链接是否需要登录或授权 | 手动刷新;查看更新时间和错误信息;确认订阅没有过期或达到访问限制 |
| 订阅更新失败 | 当前网络能否打开订阅域名;是否启用了错误代理 | 临时关闭其他代理软件测试;切换网络;检查 URL 中是否包含空格、换行或多余引号 |
| 启动后完全无法联网 | VPN 权限、系统代理、TUN 状态和节点选择 | 先关闭其他网络接管工具,只保留 sing-box;重新授权 VPN;换一个节点或分组测试 |
| 只有某个节点连接失败 | 是单节点问题还是整份配置问题 | 先换同一分组中的其他节点;如果全部失败,再检查配置更新和本地网络 |
排查时建议遵循固定顺序:编辑或重新添加配置—保存—校验或刷新—重新载入—查看日志—验证业务。命令行用户可以用官方核心的配置检查命令 sing-box check,配置格式为 JSON;该命令适用于你已经下载到本地的配置文件,不适用于只存在于客户端内部的远程配置。相关说明见 官方配置文档。
订阅链接安全:不要把它当普通网址分享
订阅 URL 往往带有用于获取配置的账号标识或令牌。即使链接看起来只是普通网址,也不建议公开粘贴到论坛、截图、工单、公共代码仓库或聊天群。本文不展示任何真实订阅链接,也不要求你把链接发给他人排查。
- 复制时只粘贴到客户端的 URL 字段,不要把链接写入公开笔记或脚本。
- 截图时遮挡完整域名后的路径、查询参数和令牌。
- 如果确认链接已经泄露,登录服务商用户中心查找重新生成、重置或撤销订阅的功能;没有该功能时联系服务商处理。
- 重新生成后,删除客户端中的旧 Remote Profile,再添加新链接并验证更新时间。
如果服务商没有提供 sing-box 格式,本文无法替你判断其转换服务是否安全或兼容;这类情况应优先索取服务商明确支持的 sing-box 配置。
常见问题
sing-box 能直接导入 Clash 订阅吗?
不能一概而论。sing-box 官方配置使用 JSON,而许多 Clash 配置使用 YAML;是否能直接导入取决于客户端是否提供转换能力以及链接返回的实际内容。最稳妥的做法是使用明确标注为 sing-box 的订阅,或让服务商提供兼容配置。
为什么 Remote 配置保存了,却看不到节点?
常见原因是保存动作没有完成更新、URL 返回的不是完整配置、订阅需要登录授权,或配置本身没有可用节点。先查看更新时间和错误提示,再用浏览器或客户端日志确认返回结果,不要直接修改配置字段。
导入订阅后一定要开启 TUN 吗?
不一定。图形客户端可能支持系统代理或 TUN 等不同接管方式;TUN 更适合需要接管非 HTTP 应用的场景,但也会涉及 VPN 权限、路由和 DNS。首次排查时只启用一种接管方式,确认联网后再调整。
订阅更新失败,但之前导入的节点还能用,怎么办?
先不要删除旧配置。检查当前网络、订阅 URL 是否完整、是否被其他代理接管,以及服务商是否要求重新登录或生成链接。确认新链接可用后,再替换旧 Remote Profile。
Android 上 VPN 已连接,但应用仍然无法联网怎么办?
先确认选中了正确分组和节点,再临时关闭其他 VPN、私人 DNS 或网络过滤工具测试;如果仍失败,查看客户端日志并换一个节点。VPN 图标只能说明系统权限已建立,不能单独证明业务流量已经正常转发。
常见问题
sing-box 怎么导入机场订阅?
先取得明确支持 sing-box 的远程配置 URL,再在客户端 Profiles/配置中新增 Remote/远程配置,粘贴 URL、保存、刷新,看到节点或分组后选择节点并启动 VPN/TUN。
Clash 订阅可以直接放进 sing-box 吗?
不能默认认为可以。sing-box 官方配置使用 JSON,Clash 配置常见为 YAML;应以链接实际返回内容和客户端兼容能力为准,优先使用明确标注为 sing-box 的配置。
导入后没有节点怎么办?
先检查是否完成更新、URL 是否完整、返回内容是否为完整配置,以及链接是否需要授权。查看更新时间或日志后,再决定是否重新复制链接。
启动后无法联网怎么排查?
先只保留 sing-box 一个网络接管工具,确认 VPN 权限、节点分组和当前节点,再检查 DNS、TUN 或系统代理状态;单个节点失败时先换同组节点。
订阅链接泄露后怎么办?
不要继续公开使用旧链接。登录服务商用户中心查找重置、重新生成或撤销订阅的入口;如果没有,联系服务商处理,再把新链接添加到 Remote Profile。