sing-box Android 节点为空怎么办？按页面现象逐层排查

更新于 2026-11-02 · glados.lat

简答：sing-box Android 节点为空时，先不要反复删除配置：打开 Profiles 确认配置是否存在，再查看更新结果和日志。若配置存在但 Groups 为空，重点检查 JSON 是否包含 outbounds，以及是否定义了 Selector 或 URLTest；若只有名称空白，再单独排查客户端版本和显示异常。

定义：sing-box Android 节点为空，是指配置文件未成功导入、导入后无法解析出出站节点，或配置存在但没有可供 Dashboard 选择的分组。

先用 3 分钟判断：到底是哪一种“节点为空”

本文是第三方使用指南，不代表任何客户端或订阅服务的官方页面。sing-box Android 图形客户端可以管理 Local 和 Remote 配置，并在运行时通过 Dashboard 查看状态；官方文档还说明，只有配置包含 Selector 或 URLTest 这类分组出站时，Dashboard 才会提供 Groups 选择界面。官方客户端功能说明

你看到的现象	优先检查位置	判断结果
Profiles 页面没有配置	导入入口、Remote URL、保存结果	配置根本没有保存成功，先处理导入或地址问题
Profiles 有配置，但 Groups 空白	配置内容中的 outbounds、Selector、URLTest	配置可能可读，但没有可选择的分组
Groups 有内容，但节点名称空白	节点 tag、客户端版本、显示页面	可能是显示异常，不一定代表节点不存在
节点存在，但无法启动	Logs、Android VPN 权限、其他 VPN 应用	这是运行或权限问题，不是节点列表解析问题

先试这一步：进入 sing-box Android 的 Profiles 页面，点击当前配置并执行更新或重新载入；随后打开配置详情、更新结果或日志入口，记录是否出现 HTTP 错误、JSON 解析错误、字段不支持或权限提示。不同版本的菜单名称可能变化，应以当前安装版本显示为准。

第一步：确认导入的是 sing-box 配置，而不是其他格式

sing-box 官方配置文档明确说明，配置文件使用 JSON 结构，常见顶层字段包括 inbounds、outbounds、route 和 dns。因此，不能仅因为订阅链接能打开，就认定它能被 sing-box Android 当作节点配置解析。sing-box 配置结构说明

回到订阅提供方的格式选择页面：确认选择的是 sing-box 或 JSON 配置格式；不要把 Clash YAML、Base64 裸节点文本或普通网页地址直接当作 sing-box 配置导入。
检查 Remote 配置地址：确认 URL 完整，没有换行、首尾空格或被截断；如果链接包含访问令牌，不要把完整地址发到群组、工单或截图中。
查看更新返回结果：如果日志显示返回的是登录页、错误页、验证码页或 HTML，而不是 JSON，说明地址、权限、有效期或网络访问仍需核验。
检查配置开头：如果客户端提供配置预览，开头通常应能看到 JSON 对象结构，例如 {，而不是以网页标签、错误提示或一长串未解析文本开头。不要把这一步当作格式完整性的最终证明。

如果配置内容疑似正确但仍为空，继续检查配置是否含有 outbounds。只有 DNS、路由或 TUN 等字段而没有出站定义时，客户端没有可显示的代理节点是正常结果。

第二步：区分“没有节点”与“没有分组”

sing-box 的节点和分组不是同一个概念。配置可以包含多个出站节点，但如果没有 Selector 或 URLTest 分组，Dashboard 可能没有可切换的 Groups 项。官方 URLTest 文档要求配置提供待测试的出站 tag 列表；因此，看到 Groups 为空时，应优先让订阅提供方核对分组定义，而不是随意手改整份配置。URLTest 官方配置说明

打开配置预览或编辑入口：搜索 outbounds，确认它不是空数组。
记录出站类型与 tag：只记录类型、数量和脱敏后的 tag，不要复制服务器地址、UUID、密码、私钥或完整订阅 URL。
检查是否有分组出站：查找类型为 selector 或 urltest 的对象，并确认其 outbounds 列表引用了实际存在的 tag。
重新载入后观察 Groups：如果 outbounds 存在但分组仍为空，记录配置更新结果和日志，交给订阅提供方核对生成的 sing-box 配置。

不要把其他客户端的 YAML 配置字段直接粘贴进 sing-box JSON。官方文档列出的配置结构、字段名称和版本兼容范围会随核心版本变化；无法确认字段属于当前版本时，应以订阅提供方和 sing-box 当前文档为准。

第三步：检查 Remote 更新是否真的成功

Remote Profile 是由 URL 提供更新内容的远程配置。官方通用客户端说明要求图形客户端支持远程配置查看和自动更新，但“请求发出”不等于“内容已解析成功”。Remote Profile 说明

查看最后更新时间：在 Profiles 中确认更新时间是否发生变化；如果时间不变，可能是更新未执行、网络访问失败或客户端没有拿到新内容。
查看更新日志：重点记录 HTTP 状态、TLS 证书错误、超时、重定向、解析失败和未知字段，不要只记录“更新失败”四个字。
切换网络复测：分别使用当前 Wi-Fi 和移动数据尝试更新。若只有一种网络失败，先记录网络类型、时间和错误阶段，不要立即修改大量 DNS 或 TUN 参数。
避免泄露令牌：提交截图或日志前，遮挡订阅 URL 中的 token、用户名、密码、UUID、私钥及服务器地址。

如果 Remote 更新成功但节点仍为空，问题更可能位于配置格式、outbounds 或分组定义；如果更新本身失败，则先解决 URL、权限、网络或证书问题。

第四步：核对版本兼容与 Android 运行环境

sing-box 配置字段并非永远兼容。官方配置文档提供 JSON Schema 和检查机制，且部分字段会标注引入、弃用或移除版本。Android 客户端的可用 TUN 选项也受图形客户端实现限制，例如官方功能表列出了 Android 可用和不可用的 TUN 选项。JSON Schema 官方说明 Android 功能与 TUN 支持说明

记录客户端版本与 Android 版本：在应用关于页面和系统设置中分别记录，提交问题时一并提供。
核对配置要求：如果订阅页面注明最低 sing-box 核心版本或特定客户端版本，按该要求核对；没有明确要求时，不要凭经验强行删除字段。
检查 VPN 权限：启动服务时接受 Android VPN 请求；若系统提示其他 VPN 或代理应用正在占用，先停止冲突应用，再重新启动 sing-box。
检查分应用设置：如果 Android 客户端启用了仅代理部分应用，确认测试浏览器或目标应用没有被排除。官方文档说明 Android 客户端可通过界面覆盖 include_package 和 exclude_package。
重新启动而非反复改配置：先停止服务、重新打开配置、再启动一次，并记录 VPN 图标、Dashboard 状态和 Logs 变化。

曾有公开 issue 记录 Android 客户端特定版本中 tag 名称显示为空的现象，但这只能作为版本相关的显示异常线索，不能推广为所有 Android 版本的普遍原因。若节点实际可选、延迟测试可执行，只是名称空白，应优先升级或回退到订阅方确认的版本，并保留复现信息。Android tag 显示异常 issue

最后复测、回滚与提交问题

完成修正后，按下面顺序复测，不要只凭“VPN 图标出现”判断节点已经正常：

Profiles 中能看到并选中目标配置。
更新结果显示成功，且更新时间发生变化。
Groups 或对应出站选择器中能看到可选项。
执行节点延迟或 URLTest；记录成功、失败或超时，不要把一次结果当成长期性能结论。
启动服务后观察 Android VPN 图标、Dashboard 状态和 Logs。
用一个允许访问的网页或应用进行实际访问，分别记录“节点选择成功”“DNS 解析成功”“页面访问成功”三个结果。

回滚方法：先停止服务，恢复导入前的配置或重新选择上一份可用 Profile；不要在原配置上连续覆盖修改。若无法解决，向订阅提供方提交客户端版本、Android 版本、问题发生阶段、配置更新时间、脱敏日志片段和是否更换网络复测过，避免提交完整订阅链接。

截至 2026-11-02，本文只引用了 sing-box 官方文档、官方 Android 客户端资料及公开 issue；客户端菜单、可用字段和版本行为仍应以当前安装版本及配置提供方要求为准。

常见问题

sing-box Android 导入订阅后 Profiles 里没有配置，怎么办？

先确认是否使用了 sing-box 或 JSON 格式，再检查 Remote URL 是否完整、是否含空格或已失效。重新导入后查看更新结果；如果返回登录页、错误页或 HTML，应先核对访问权限和订阅地址，而不是修改 TUN 参数。

Profiles 有配置，但 Groups 页面为空，是不是节点没有导入？

不一定。配置可能含有 outbounds，但没有 Selector 或 URLTest 分组。查看配置预览中的 outbounds 和分组定义；若节点 tag 存在而分组不存在，应让配置提供方核对生成的 sing-box 配置。

sing-box Android 节点名称为空，但可以启动，怎么处理？

这更像显示异常而非节点完全不存在。记录客户端版本、Android 版本、tag 是否过长或包含特殊字符，并检查当前版本的公开 issue。不要仅凭名称空白断言节点不可用，先看是否能选择、测试延迟并完成实际访问。

能不能把 Clash YAML 直接导入 sing-box Android？

不能把格式不同当作通用兼容。sing-box 官方配置使用 JSON；如果订阅提供方同时提供 sing-box 格式，应选择对应格式。没有对应格式时，应让提供方生成兼容配置，不要直接改动整份 YAML。

排查 sing-box Android 节点为空时，日志要提交什么？

提交客户端版本、Android 版本、Profiles 是否存在、更新是否成功、错误发生阶段和脱敏后的关键日志。必须遮挡订阅 token、密码、UUID、私钥和完整远程 URL。