sing-box 订阅导入教程：从链接核验到启动连接
简答：sing-box 订阅导入的关键，是确认订阅地址返回的是当前客户端能够解析的远程配置，而不是只看链接后缀或首字符。最快流程是：在服务面板复制订阅 URL → 判断响应是否正常 → 在对应客户端新建 Remote 配置 → 手动更新并确认出站或分组 → 授予 VPN、网络扩展或 TUN 权限 → 用日志和实际应用复测。若你使用 Nexitally，面板入口和是否提供 sing-box 专用链接需以当前用户中心为准；找不到时不要把 Clash YAML 或单节点链接直接当作 sing-box 配置。
定义：sing-box 订阅导入，是把远程 sing-box 配置的 URL 添加为 Remote Profile，由图形客户端拉取、解析、保存并按设置自动更新。
先看这里：你的订阅链接能否直接导入
本文是 nxonearth.shop 的第三方使用指南，不代表 sing-box 或任何订阅服务的官方页面。sing-box 图形客户端把配置分为本地配置、iCloud 配置和 Remote 配置；其中 Remote Profile 以 URL 作为更新来源，客户端还应提供配置查看、自动更新和远程导入能力，具体可核对sing-box 官方图形客户端说明。
| 拿到的内容 | 是否能直接作为 Remote | 下一步 | 风险提示 |
|---|---|---|---|
| HTTP 请求正常，正文是完整 sing-box JSON | 有可能，但仍需客户端解析 | 新建 Remote，填入 URL，手动更新 | 不能只凭 { 开头判断有效 |
正文是 YAML，包含 proxies: 或 proxy-groups: | 不能直接假定兼容 | 向服务方索取 sing-box 格式，或采用可审查的本地转换流程 | 不要把订阅 URL 直接交给未知在线转换站 |
| 只有一条协议 URI、二维码或单节点参数 | 不是完整远程配置 | 使用支持单节点导入的客户端，或根据协议文档制作本地配置 | 字段和传输方式需以当前文档为准 |
| 返回登录页、HTML、403、404 或空内容 | 不能导入 | 检查授权、链接有效期、网络和复制是否完整 | 保存错误文本，不要公开分享完整 URL |
判断标准不能只看首字符、文件后缀或浏览器是否能打开。最终以 HTTP 响应、配置正文、客户端解析结果或命令行校验结果为准。订阅 URL 可能包含账户识别信息或访问凭据，排查时只保留域名、状态码和错误文本，隐藏完整路径及参数。
一分钟最短流程：复制、添加、更新、启动、复测
- 复制订阅：登录你的订阅服务用户中心，优先寻找“sing-box”“JSON”“Remote”“客户端配置”或类似选项。若使用 Nexitally，无法确认当前面板是否提供独立 sing-box 链接时，以用户中心当前显示和服务方说明为准。
- 检查响应：在本机打开链接，或使用
curl -L -I "你的订阅链接"查看响应头。该命令只能检查请求是否得到响应，不能证明正文是有效 sing-box 配置。需要查看正文时保存到本地，不要上传到公开网站。 - 新建 Remote：在客户端进入配置、Profiles、配置文件或订阅管理，选择 Remote 或远程配置，填写名称和 URL 后保存。官方通用规范还定义了远程导入 URL Scheme：
sing-box://import-remote-profile?url=urlEncodedURL#urlEncodedName，但系统是否能唤起要以当前客户端和设备界面为准。 - 手动更新：点击更新、拉取、刷新或同步，记录更新时间、HTTP 错误和解析结果。更新成功后查看是否出现出站、节点、Selector 或 URLTest 分组。
- 启动服务：选择目标出站或分组，启动服务并允许系统 VPN、网络扩展或 TUN 权限。看到“运行中”只说明客户端进程启动，不代表所有应用流量都已经经过 sing-box。
- 复测与回滚：先测试一个明确网页，再测试 DNS 请求和实际办公应用；同时查看客户端日志。若新配置导致网络异常，停止服务并恢复此前可用配置，不要覆盖唯一备份。
Remote Profile 的自动更新、HTTP Basic 授权和默认更新间隔等能力，属于图形客户端规范的一部分；当前客户端是否完整实现、入口名称是否一致，需以官方通用客户端文档和实际界面为准。
按设备操作：Android、iPhone/iPad、macOS、Windows
| 平台 | 客户端层次 | 最短步骤 | 需要确认的结果 |
|---|---|---|---|
| Android | sing-box for Android 或兼容图形客户端 | 配置/Profile → 新建 Remote → 填名称和 URL → 更新 → 允许 VPN | 配置中出现出站或分组，VPN 服务保持运行 |
| iPhone/iPad | sing-box for Apple platforms 或兼容客户端 | Profiles/配置 → 添加 Remote → 填 URL → 更新 → 允许 VPN 配置 | 网络扩展已批准，客户端状态和日志无解析错误 |
| macOS | 图形客户端或命令行核心 | 图形客户端按 Remote 导入；命令行先保存 JSON，再执行校验 | 图形客户端能显示配置；命令行校验通过 |
| Windows | sing-box for Desktop 或命令行核心 | 配置管理 → 新建远程配置 → 填 URL → 更新 → 按需启用 TUN | 远程配置可查看，系统权限已允许，日志无启动错误 |
Android：先更新配置，再申请 VPN 权限
- 打开当前 Android 图形客户端，进入配置文件、Profiles 或订阅管理页面；菜单名称可能随版本变化。
- 选择 Remote、远程配置或添加订阅，填写一个便于识别的名称和完整 URL。
- 保存后手动点击更新，确认出现出站、节点或分组；如果列表为空，不要直接启动。
- 选择目标出站或分组，启动 VPN，并在系统弹窗中允许 VPN 权限。
- 如果启动后很快停止，检查电池优化、后台活动限制、移动数据权限，以及是否有其他 VPN 应用同时运行。
Android 属于 sing-box 官方图形客户端列表中的独立平台，具体支持能力和当前安装方式请查看官方 Android 客户端页面；不要把第三方应用的菜单名称当成所有版本都固定不变。
iPhone/iPad：重点确认网络扩展权限
- 打开当前 Apple 平台客户端，进入配置或 Profile 管理。
- 选择 Remote 或远程配置，填写名称和 URL，保存后手动更新。
- 查看配置内容，确认存在可选择的出站或分组，而不是只有基础设置。
- 启动服务，按系统提示允许添加 VPN 配置或网络扩展。
- 若应用能启动但网页打不开，先检查系统 VPN 状态、其他 VPN 应用和客户端日志。
官方客户端列表把 iOS、macOS 和 Apple tvOS 归入 Apple 平台，但具体功能仍可能受系统版本、客户端版本和应用分发方式影响，可参考Apple 平台官方说明。
macOS：区分图形客户端与命令行核心
如果使用图形客户端，入口通常是配置、Profiles 或远程配置管理，再按“新建 Remote → 填 URL → 更新 → 选择出站 → 启动”操作；菜单名称需以当前版本为准。如果使用命令行核心，不要寻找图形界面的 Remote 按钮，而应先把配置保存为本地 JSON，再使用当前版本的检查命令验证。macOS 图形客户端属于 Apple 平台，命令行核心则是另一种运行方式，二者的权限、日志和启动入口不能混用。
Windows：Desktop 客户端与核心不是同一层
sing-box 官方 Desktop 页面明确列出 Windows 10 及以上要求，并说明 Desktop 可管理和运行本地或远程配置，同时提供平台相关的 TUN 功能。导入时进入配置管理区域新建 Remote，填入 URL 后更新；如果启用 TUN，按系统提示处理网络权限。下载来源和当前版本以官方 Desktop 页面及其发布渠道为准。
导入后没有节点：按“链接—格式—版本—权限—网络”排查
| 现象 | 第一检查点 | 判定方法 | 处理动作 |
|---|---|---|---|
| 更新失败、403、404 或返回 HTML | URL、授权和网络 | 保存状态码与错误正文，不公开完整链接 | 重新复制 URL，确认账户权限和链接有效期 |
| 更新成功但没有节点 | 配置正文和出站结构 | 查看是否存在可选出站、Selector 或 URLTest | 确认服务方提供的是完整配置，而不是空模板或其他格式 |
| 提示字段不支持 | 客户端版本和配置版本 | 记录错误字段、客户端版本和配置来源 | 先查看当前发布说明，再要求提供兼容配置；不要盲删未知字段 |
| 配置能启动但网页打不开 | VPN/TUN、节点、DNS、其他代理 | 分别看服务状态、日志、DNS 请求和实际应用 | 停用重复 VPN，切换已知可用出站后复测 |
| 只有部分应用能用 | 系统代理范围和应用自身设置 | 比较浏览器、终端和办公应用的行为 | 核对系统代理、TUN、路由规则及应用独立代理 |
| 手机后台断开 | 系统后台和电池策略 | 前台运行与锁屏后台分别测试 | 检查后台联网、电池优化和 VPN 权限 |
- 记录：客户端名称、系统版本、客户端版本、配置名称、失败时间和错误原文。
- 隔离：暂时退出其他 VPN、代理工具和重复系统代理，避免多个网络接管组件同时工作。
- 复测：先手动更新配置，再启动服务；分别测试网页、DNS 和实际办公应用。
- 回滚：停止异常配置，恢复上一份本地配置或停用 Remote，不要在没有备份时批量修改字段。
如果你使用命令行核心，可进一步查看当前版本配置文档中的校验和格式化命令；命令名称、参数和配置字段可能随版本变化，须以官方配置文档当前内容为准。校验通过只表示结构可解析，不代表远端节点、DNS 或线路一定可用。
订阅安全与版本核对：避免把导入问题变成凭据泄露
完整订阅 URL 应按敏感凭据处理，不要发布到公开 issue、聊天群、截图、代码仓库或未知在线转换页面。若必须提交工单，只提供域名、状态码、时间和脱敏后的错误信息。在线转换会把订阅内容交给第三方处理，是否保存、是否记录和是否能删除，需要先看其隐私说明；无法确认时优先向服务方索取 sing-box 格式，或使用能在本机审查的转换方式。
如果面板只有 Clash YAML、通用订阅或单节点链接，不要把“能下载”当成“能被 sing-box 解析”。应先确认服务方是否提供当前 sing-box JSON；找不到选项时，向服务方询问配置格式、客户端兼容范围和更新方式。本文不对任何订阅服务的套餐、价格、节点数量、性能或可用性作判断。
截至 2026 年 11 月 2 日，本文只根据当前可访问的官方客户端和配置资料整理流程；客户端入口、系统要求和字段支持仍可能变化。升级前查看官方更新说明，升级后保留旧配置和错误日志，再进行一次手动更新与复测。可从sing-box 官方文档首页进入当前客户端、配置和更新资料。
导入成功的判断标准
一次可复现的 sing-box 订阅导入，至少要满足四点：订阅 URL 返回预期配置；客户端完成解析并显示出站或分组；系统 VPN、网络扩展或 TUN 权限已生效；网页、DNS 和实际应用复测结果符合预期。仅看到“更新成功”“配置已保存”或“服务运行中”，都不足以证明连接链路正常。
遇到延迟、丢包、DNS 或 MTU 问题时，先把订阅解析与线路问题分开：先确认配置能更新、节点能建立连接，再记录网络类型、发生时间、日志和复测结果。这样可以避免把格式错误误判成线路故障。
常见问题
sing-box 可以直接导入 Clash YAML 订阅吗？
不能直接假定可以。Clash YAML、单节点 URI 和 sing-box JSON 是不同输入形式；如果服务方没有明确提供 sing-box 兼容配置，就应先索取对应格式，或采用能在本机审查的数据转换流程。最终以客户端解析结果或当前版本校验结果为准。
只看到订阅链接打开后以大括号开头，是否就能导入？
不能。首字符只能说明响应正文可能像 JSON，不能证明 HTTP 状态、授权、配置结构、字段版本和客户端支持范围都正确。还要确认响应不是错误页、配置包含可用出站，并让客户端完成实际解析。
Nexitally 用户在哪里找 sing-box 订阅？
应先登录当前用户中心，在订阅、客户端配置、快捷导入或类似页面寻找 sing-box、JSON 或 Remote 选项。具体入口、名称和是否提供独立格式均需以当前用户中心为准；如果只有通用订阅或 Clash YAML，直接向服务方确认兼容方式，不要凭名称猜测。
订阅导入成功但节点列表为空怎么办？
先查看更新后的配置内容，确认是否存在可选择的出站、Selector 或 URLTest 分组；再检查订阅权限、响应正文和客户端版本。如果返回的是空模板、被裁剪的配置或其他格式，刷新不会自动生成节点，应重新确认订阅类型。
sing-box 启动后仍然无法联网，是不是订阅失效？
不一定。先检查 VPN、网络扩展或 TUN 权限，退出其他 VPN 和系统代理，再查看节点连接日志与 DNS 请求；随后切换一个出站复测。客户端显示运行中，不等于所有应用流量都已经过 sing-box。
Remote 配置要不要开启自动更新？
首次导入建议先手动更新并记录结果，确认配置和连接都正常后再考虑自动更新。官方通用客户端说明包含自动更新能力，但不同客户端和系统的后台限制、更新入口和实际行为可能不同，不能把自动更新本身当作连通性证明。