sing-box Android 订阅转换后怎么导入？
简答：转换完成后，复制实际返回 sing-box JSON 配置的远程 URL，在 sing-box for Android 的配置列表中添加 Remote 配置，再执行更新。若只有配置名称却没有节点，先检查返回内容、链接有效性和客户端解析错误，不要反复刷新或把完整订阅链接粘贴到在线检测工具。
定义：sing-box 订阅导入，是把可返回 sing-box JSON 配置的远程 URL 添加为 Remote 配置，而不是把原始订阅文本直接当作本地 JSON 文件导入。
先判断：你拿到的是 Remote URL 还是本地文件
本文只讲 sing-box for Android 的转换订阅导入，不延伸到 iPhone、Windows 或 macOS。资料核验日期：2026-11-02。本站是第三方使用指南站，不是 sing-box 官方网站。
| 你手里的内容 | 应选择的方式 | 先看什么 |
|---|---|---|
| 转换器生成的远程链接 | Remote | 打开后应返回 sing-box JSON，而不是网页、登录页或错误提示 |
| 已经下载的配置文件 | Local | 文件内容应是可解析的 JSON 配置 |
| 原始 Clash、通用 YAML 或其他格式链接 | 先转换 | 不要直接粘贴到 sing-box 的 Remote 字段 |
| 只有单条节点分享文本 | 按客户端支持的导入方式处理 | 它未必包含完整配置、路由和出站组 |
官方文档说明，Remote Profile 是以 URL 作为更新来源的远程 sing-box 配置；sing-box 配置文件本身使用 JSON 格式。查看 Remote Profile 说明 查看配置格式说明
最重要的判断：链接名称写着“sing-box”并不能证明格式正确。优先通过客户端更新结果或本地文本查看工具确认返回内容；不要把包含账号凭据的完整订阅 URL 粘贴到在线 JSON 查看器。
Android 最短导入步骤：新建 Remote、更新、启动
- 准备链接：在转换结果页复制生成的 sing-box 远程 URL。不要复制原始订阅，也不要把 URL 两端的引号、空格或换行一起复制。
- 打开入口：启动 sing-box for Android，进入配置文件或 Profiles 列表，点击新增、加号或导入配置。不同版本的按钮文字可能不同，以当前客户端显示为准。
- 选择类型：选择 Remote 或“远程配置”。如果页面只有 Local、Remote 等类型，远程 URL 应放在 Remote，不要放入 JSON 编辑器。
- 填写字段：名称填写便于识别的文字，在 URL 字段粘贴转换后的链接。除非服务端明确要求，不要自行修改 URL 参数。
- 保存配置：点击保存、创建或确认添加。回到配置列表，确认记录出现。
- 手动更新：打开该配置的操作菜单，执行 Update、Refresh 或更新。等待客户端完成请求，再查看是否出现配置内容、出站组或节点。
- 启动服务：回到 Dashboard 或服务页面，选中刚更新的配置并启动。Android 客户端在需要 TUN 时通过 Android VpnService 提供实现，系统弹窗出现时应允许 VPN 权限。Android 客户端说明 Android 特性与 TUN 说明
成功判定：不能只看“配置名称已出现”。至少还应确认更新没有报错、配置内容可以查看、出站组或节点已经出现，并且服务状态显示正在运行。
导入后没有节点：按这个顺序分流
- 只有名称，没有配置内容：先重新执行 Update，确认 URL 没有被截断、过期或复制错误。若仍失败，记录客户端显示的原始错误。
- 返回网页或登录页：这通常说明链接没有返回配置内容，可能是订阅失效、转换结果过期、需要授权，或上游服务返回了错误页面。重新从原服务获取输入，再重新转换。
- 返回内容不是 JSON：sing-box 官方配置格式为 JSON。若本地查看内容明显是 HTML、纯文本节点列表或其他格式，不要继续在客户端反复导入，应重新选择 sing-box 输出格式。官方配置格式与检查说明
- 提示字段不支持或解析失败：查看完整错误原文，重点记录不支持的字段、配置片段和客户端当前核心版本。再对照转换器模板说明与客户端文档；如果模板与核心版本不匹配，优先重新转换，而不是手动删除不认识的字段。
- 配置能更新但出站为空：检查转换时是否筛选掉了全部节点，或者原始订阅本身没有可用节点。此时问题不一定在 Android 导入入口。
如果需要在本地检查已经下载的 JSON 文件，官方命令行提供 sing-box check 检查方式；远程订阅不要直接覆盖旧配置，先保留旧文件或旧 Remote 记录，便于回滚。官方配置检查命令
能更新但启动后没网：只做最小复测
订阅更新成功，只能证明客户端拿到了配置，不代表节点、路由和 Android VPN 服务已经正常工作。按以下顺序复测：
- 确认已选择出站：如果配置包含多个出站组，先在 Dashboard 或组选择页面确认没有停留在失效节点或空分组。
- 确认服务状态：检查客户端是否真的处于运行状态，并确认系统 VPN 权限没有被撤销。Android 客户端的 TUN 与应用分流能力受平台权限和配置影响。Android TUN 与应用分流说明
- 只测一个目标：先用浏览器访问一个普通网页，再测试目标应用。不要同时修改 DNS、规则、TUN 和节点，否则无法判断是哪一步产生变化。
- 检查 DNS 与规则：如果只有部分应用异常，优先查看路由规则、应用分流和 DNS；如果所有应用都异常，先回到节点选择、VPN 权限和服务状态。
- 回滚：停用新导入的 Remote 配置，恢复旧配置或旧订阅，再重新获取转换结果。不要为了“修好”而直接覆盖唯一可用配置。
本文只保留导入后的最小判断，不把 DNS、MTU、路由和节点质量扩展成另一篇故障教程；需要继续查连接错误时，可查看站内的 sing-box 连接失败排查页面。
订阅安全与版本边界
订阅 URL 可能包含访问凭据，应当像密码一样处理：不要公开发送，不要提交给不可信的转换服务、在线 JSON 查看器或截图工具。若链接已经公开，优先在原服务后台撤销、重置或重新生成，再删除 Android 客户端中的旧 Remote 配置。
sing-box 官方资料说明，图形客户端可管理本地或远程配置；Android 客户端还提供 TUN 等平台能力。但具体按钮名称、发布渠道、核心版本和配置字段可能变化，本文不把某个版本号、模板名称或第三方转换结果视为已核实事实。资料核验日期：2026-11-02；遇到版本差异，以当前客户端显示和对应官方文档为准。
官方客户端列表将 Android 客户端单独列为 sing-box for Android。查看官方图形界面客户端列表
常见问题
sing-box Android 应该导入转换后的 URL 还是下载 JSON 文件？
有远程更新链接时选择 Remote 并粘贴 URL；已经下载完整 JSON 文件时选择 Local。不要把 URL 粘贴进本地 JSON 编辑器，也不要把原始其他格式订阅直接当作 sing-box 配置。
Remote 配置添加成功，但列表里没有节点，怎么办？
先执行 Update，并查看客户端的完整错误信息。随后确认链接实际返回的是 sing-box JSON，而不是 HTML、登录页、过期提示或空内容；如果格式不对，应重新获取或转换。
为什么订阅能更新，但启动后 Android 没网？
先确认选择了可用出站、服务确实运行，并且系统 VPN 权限已允许。若只有部分应用异常，再检查应用分流、路由和 DNS；不要同时修改多个设置。
可以把完整订阅链接放到在线 JSON 查看器检查吗？
不建议。订阅 URL 可能包含访问凭据，优先使用客户端预览、可信的本地文本工具或本地命令检查，避免把完整链接提交给第三方网站。
什么时候应该重新转换，而不是反复点击 Update？
如果 URL 返回网页、登录页、过期提示、空内容或明显不是 JSON，或者错误明确指出字段不兼容，应重新获取输入、选择匹配的输出模板并重新生成链接。反复 Update 无法修复错误格式。
导入失败后可以直接删掉旧配置吗？
不建议。先保留旧 Remote 配置或备份文件，确认新配置能够更新、解析并启动后，再删除失效记录，方便随时回滚。