sing-box 导入订阅教程：从链接检查到成功连接
简答：复制订阅地址后，在 sing-box 客户端新建 Remote 配置并更新，再选择节点、启动服务和授权 VPN。若保存成功却没节点或出现 JSON 错误，先检查链接返回格式；排查后可区分是获取、解析还是连接层问题。
定义：sing-box 远程订阅是客户端通过 URL 获取并更新的远程配置文件，必须同时满足地址可访问、返回内容符合 sing-box 配置结构以及客户端支持相关字段和协议。
先试这一步：先判断自己卡在获取、解析还是连接
复制链接后保存成功却没有节点，或者更新时一直提示 JSON 错误，通常不能靠重复粘贴解决。先按下面顺序定位问题：先确认订阅地址能返回内容，再确认内容是不是 sing-box JSON，最后才检查节点、系统代理、TUN 和 DNS。
| 现象 | 优先检查 | 下一步 |
|---|---|---|
| 更新后没有节点 | 配置预览、返回内容、出站或节点组 | 重新更新并查看客户端日志，确认不是空配置、登录页或错误页 |
| 出现 JSON parse error | 响应是否为 JSON | 查看内容开头，排除 HTML、YAML、Base64 或访问错误文本 |
| 有节点但无法联网 | 服务状态、节点握手、系统代理、TUN、DNS | 一次只修改一个设置，并查看服务日志 |
| 返回 403 或 404 | 链接权限、地址是否失效 | 从原订阅面板重新复制，必要时联系提供方 |
sing-box 官方把 Remote Profile 定义为“以 URL 作为更新来源的远程配置”，图形客户端应提供配置内容查看、自动更新和 HTTP Basic 认证支持；默认自动更新间隔为 60 分钟。可查看sing-box 图形客户端通用配置说明。
第一步：复制订阅地址，但不要把面板入口当成已核实官网
- 登录你自己的订阅面板。本文中的 bv2.best 仅指读者手中的订阅面板地址，本文未核实其归属、官方入口或当前后台界面，因此不把具体按钮名称写成固定路径。
- 寻找客户端配置入口。优先查看“客户端选择”“配置文件”“订阅管理”“下载配置”或相近区域，寻找明确标注为 sing-box、JSON 或 Remote Profile 的地址。
- 复制完整 HTTPS 地址。检查开头是否为
https://，并确认没有多余空格、换行、引号或截断。不要把二维码下方的说明文字一并复制。 - 保护订阅地址。订阅 URL 可能包含账号凭据，不要发到公开群组、截图、工单或代码仓库。若已经泄露，先在面板查找重新生成、重置或撤销入口；找不到时联系提供方处理。
如果面板只有 Clash、V2Ray、Base64 或通用订阅，不要直接假设它能被 sing-box 原生读取。先在面板里继续找客户端类型或配置下载入口；仍然找不到时，向提供方索取 sing-box 专用链接，并询问其支持的协议和配置格式。第三方转换会把包含账号凭据的订阅地址交给额外服务，使用前应先确认隐私风险，不要把真实订阅地址粘贴到不明转换页面。
第二步：导入前检查链接返回格式
浏览器能打开订阅地址，不等于客户端拿到了可用配置。浏览器可能显示登录页、403 页面、HTML 错误页或一段非 JSON 文本。桌面用户可以先用 GET 请求保存响应，检查格式后再导入。
在终端中执行下面的命令，把“订阅地址”替换为自己的完整链接；User-Agent 中的客户端版本不要照抄示例，应改成你实际安装版本，版本以客户端“关于”页面或官方发布页为准：
curl -L --fail --user-agent "SFA/你的客户端版本 sing-box" --max-time 20 "订阅地址" -o sing-box-response.txt
查看文件开头：
sed -n '1,12p' sing-box-response.txt
- 开头接近
{，说明可能是 JSON，但仍需确认结构是否为 sing-box 配置。 - 出现
<html、登录提示或 Access denied，说明返回的是网页或错误内容。 - 出现很长的字母、数字和符号串，可能是 Base64 节点列表，不等同于 sing-box JSON。
- 返回 YAML 时，不能仅凭外观判断 sing-box 客户端一定支持，应确认提供方是否提供专用格式。
在 PowerShell 中执行：
Invoke-WebRequest -Method Get -Uri "订阅地址" -Headers @{"User-Agent"="SFA/你的客户端版本 sing-box"} -OutFile "sing-box-response.txt"
这里使用 GET 而不是 HEAD，是为了尽量模拟客户端实际获取配置的过程。不要在终端输出、截图或日志中暴露 Cookie、token 或完整订阅地址。sing-box 配置文件本身使用 JSON 结构，官方配置说明也提供了配置字段和检查方式，可参考sing-box 配置文件说明。
Android 和 iPhone 用户可以直接使用客户端的配置预览、更新结果或服务日志查看返回情况；如果移动端界面无法显示完整响应，建议先在电脑上完成格式检查，再把确认过的地址导入移动端。
第三步：按平台导入 Remote 配置
Android：sing-box for Android
- 打开 sing-box for Android，在配置文件或 Profiles 区域新增远程配置。
- 选择 Remote 或同等含义的远程配置入口，填写名称并粘贴完整订阅地址。
- 保存后手动执行更新，打开配置预览，确认内容不是 HTML、错误文本或空配置。
- 返回主面板选中配置并启动服务。首次需要接管系统流量时，按 Android 系统提示允许 VPN 权限。
官方资料确认 sing-box for Android 可以管理和运行本地或远程配置，并通过 Android VpnService 提供 TUN 实现。客户端平台和下载信息以sing-box for Android 官方说明为准；其工作目录和日志说明见sing-box for Android 功能说明。官方页面列出的工作目录为 /sdcard/Android/data/io.nekohasekai.sfa/files，其中的 stderr.log 属于崩溃日志；排查运行问题时仍应优先查看客户端提供的服务日志或错误提示。
iPhone 或 iPad：sing-box for Apple
- 打开 sing-box for Apple，进入配置管理区域并新增 Remote Profile。
- 粘贴订阅地址，填写名称后保存并更新。
- 选中配置并启动服务，按系统提示允许 VPN 或网络扩展。
- 如果配置加载但没有节点，先查看配置内容和服务日志，再回到格式检查步骤确认返回内容。
sing-box 官方 Apple 客户端支持管理和运行本地或远程配置。Apple 平台要求、发行渠道和支持范围以sing-box for Apple platforms 官方说明为准。服务日志入口在官方功能说明中写作 Settings → View Service Log，应称为服务日志，不要与崩溃日志混用；详见sing-box Apple 客户端功能说明。
macOS：sing-box for Apple
- 打开客户端的配置管理页面，新增 Remote Profile。
- 粘贴 HTTPS 订阅地址并保存，手动执行更新。
- 确认配置可以查看后启动服务；如果系统要求网络扩展或辅助权限，按 macOS 提示完成授权。
- 连接失败时进入
Settings→View Service Log查看服务日志。
macOS 客户端存在独立版本等发行差异，安装入口和菜单文字以sing-box for Apple platforms 官方说明为准。
Windows：sing-box for Desktop
- 打开 sing-box for Desktop，在配置管理区域新增 Remote 配置。
- 填写名称并粘贴订阅地址，保存后执行更新。
- 检查配置预览、节点或出站组是否出现，再启动服务。
- 如果配置包含 TUN 或需要接管更多系统流量，按照客户端和 Windows 的权限提示完成授权。
官方资料显示 sing-box for Desktop 用于管理和运行本地或远程配置，并支持 Windows 10 及以上版本；具体安装包和平台支持以sing-box for Desktop 官方说明为准。
第四步：更新订阅、选择节点和启动连接不是同一个动作
导入完成后，按“更新配置 → 检查节点或出站组 → 选择节点 → 启动服务”的顺序操作。Remote Profile 默认支持自动更新，官方通用说明给出的默认间隔是 60 分钟；客户端若提供自动更新开关或间隔设置，通常位于远程配置的编辑、详情或更新设置区域，具体菜单名称以实际版本为准。
如果配置包含 Selector 或 URLTest 等出站组，图形客户端的 Dashboard 可以提供组选择或状态显示；如果只是保存了远程地址，还没有执行更新或启动服务，不能认为已经连接。相关行为可参考sing-box 图形客户端通用配置说明。
- 更新配置：确认客户端实际发起了获取请求，并查看返回状态或日志。
- 检查节点：确认配置预览中存在出站、节点或可切换的出站组。
- 选择节点：如果有多个节点或选择器，手动选中一个有效项。
- 启动服务：启动后再测试网页、应用或 DNS，不要把配置保存状态当成运行状态。
第五步：按三层故障流程处理 403、解析错误和无法联网
- HTTP 获取层：出现 403 或 404 时，先从原面板重新复制订阅地址，再用带 User-Agent 的 GET 请求检查。403 表示当前请求被拒绝，404 表示请求资源不存在，但仅凭状态码不能确定是链接失效、权限策略还是请求条件不匹配。
- 配置解析层：出现 JSON parse error、Schema error 或类似错误时，保存响应内容并查看开头。HTML、登录页、YAML、Base64 或空响应都不能直接当作 sing-box 原生配置。
- 运行连接层：配置能加载但无法联网时，依次检查服务是否启动、是否选中有效节点、节点握手是否成功、系统代理或 TUN 是否启用，以及 DNS 是否正常。一次只修改一个设置，便于判断问题来自哪一层。
日志优先从客户端内置入口查看：Android 检查服务状态和客户端日志，Apple 客户端进入 Settings → View Service Log，Windows 则优先使用应用内日志面板。若使用命令行配置，官方日志字段支持设置输出文件、日志级别和时间戳，详见sing-box 日志配置说明。
导入前后核对清单
- 订阅地址来自你自己的面板，没有被公开分享。
- 地址是完整 HTTPS 链接，没有空格、换行、引号或截断。
- GET 请求或客户端预览返回的是配置内容，而不是登录页、HTML 或错误文本。
- 如果只有 Clash、Base64 或通用订阅，已经向提供方索取 sing-box 专用链接，或确认格式兼容性。
- 客户端已经分别完成更新配置、选择节点和启动服务。
- 首次使用移动端 TUN 时，已经完成系统 VPN 或网络扩展授权。
- 自动更新间隔已在远程配置设置中确认，默认值以客户端文档和实际版本为准。
- 无法联网时，已经按 HTTP 获取、配置解析、运行连接三层查看日志。
本文最后核对日期：2026-10-25。本文是第三方使用指南，不代表 sing-box、bv2.best 或任何订阅提供方。
常见问题
只有 Clash 订阅，没有 sing-box 链接，下一步怎么做？
先回到订阅面板查找客户端选择、配置文件或下载配置入口；如果仍只有 Clash、Base64 或通用链接，向提供方索取 sing-box 专用地址，并确认支持的协议和格式。不要把真实订阅地址直接交给不明转换服务。
Remote Profile 的自动更新在哪里设置？
通常在远程配置的详情、编辑或更新设置区域，可以看到自动更新开关或更新间隔。sing-box 官方通用说明给出的默认自动更新间隔为 60 分钟，但不同客户端版本的菜单名称可能不同，应以实际界面为准。
多个订阅如何切换？
分别创建多个 Remote 配置并使用容易区分的名称，更新后在配置列表中选择需要运行的配置。启动前确认当前选中的配置和节点组，避免把“已保存”误认为“正在运行”。
订阅链接泄露后应该怎么处理？
立即停止公开传播，回到原面板查找重新生成、重置或撤销入口；如果没有这些功能，联系提供方申请更换链接。更换后删除旧配置，并检查客户端中是否仍保存旧地址。
手机无法运行订阅，但电脑检查正常，怎么办？
先确认手机端使用的是兼容的 sing-box 图形客户端，再检查配置更新结果、VPN 或网络扩展授权、系统后台限制和客户端服务日志。电脑能获取配置不代表手机一定完成了更新和启动。