sing-box 如何添加订阅：Android Remote 导入与启动排查
简答：Android 上添加 sing-box 订阅，先向服务商索取 sing-box JSON 或 Remote 配置链接，再在 SFA 的 Profiles 中新建 Remote、粘贴 URL、刷新并启动 VPN。若失败，按内容格式、HTTP 状态、配置字段和 VPN 权限逐项排查，最后可确定是链接、配置还是网络问题。
定义：sing-box 订阅是由远程 URL 提供的 sing-box 配置来源，在 Android 客户端中通常以 Remote Profile 保存并更新。
先看结论：你应该拿到什么链接、在 SFA 里选什么
如果你使用的是 Android 版 sing-box 客户端 SFA，最短路径是：向订阅服务提供方索取 sing-box JSON 配置或 Remote 配置链接，然后在客户端的 Profiles 中创建 Remote Profile。官方文档确认，SFA 可以管理和运行本地或远程 sing-box 配置，并通过 Android 的 VPN 能力实现 TUN 功能，最低系统要求为 Android 5.0。可查看sing-box for Android 官方说明。
| 你手里的内容 | 是否适合直接添加 Remote | 下一步 |
|---|---|---|
| 服务商明确标注的 sing-box、JSON 或 Remote 链接 | 通常适合 | 在 SFA 中创建 Remote，刷新后查看配置内容 |
| 完整 sing-box JSON 文件 | 不需要远程链接 | 保存到 Android 后作为 Local 配置导入 |
| Clash、Surge、Base64 订阅或单条节点链接 | 不能默认直接使用 | 向服务商索取 sing-box 专用 JSON 或 Remote 配置 |
| 打开后是登录页、错误页或 HTML | 不适合 | 检查链接权限、有效期、认证方式和服务商返回内容 |
一句话判断标准：不要只看 URL 后缀，关键是更新后得到的内容是否为可解析的 sing-box 配置。官方通用客户端文档将 Remote Profile 定义为“以 URL 作为更新来源的远程 sing-box 配置”，并说明图形客户端应提供配置内容查看和自动更新能力，详见sing-box 图形客户端通用 Profile 说明。
获取兼容订阅：向服务商索取这三项信息
如果后台只有“通用订阅”“一键复制”或其他客户端名称，不要直接猜测它能否被 SFA 使用。你可以向提供链接的一方确认下面三项：
- 是否提供 sing-box 专用配置，格式是 JSON 还是其他格式。
- 链接是否是 Remote 配置 URL，打开或更新后是否直接返回配置内容，而不是账户登录页面。
- 是否需要用户名、密码、额外请求头或特定客户端标识；如果需要，应使用服务商明确说明的认证方式。
可以把问题直接写成：“请提供适用于 sing-box for Android 的 Remote 配置链接，或可导入的 sing-box JSON 文件；如果需要认证，请同时说明认证字段和有效期。”如果对方只能提供 Clash、Surge、Base64 或单节点格式，本文不把它们视为可直接导入的 sing-box 订阅，也不对第三方转换结果作兼容性保证。
复制链接时只在自己的设备和账户中操作。公开截图、工单和日志中应遮住完整 URL、token、Cookie、用户名和密码；这些信息是否可以被撤销或重新生成，以提供订阅的一方后台说明为准。
Android SFA：创建 Remote Profile 并启动服务
以下路径以官方仓库中记录的 Android 图形客户端操作为依据，示例版本为 1.13.13：Profiles → + → Create Manually → 填写名称 → Type: Remote → 填写 URL → Create。该路径出现在官方仓库的远程配置复现记录中，可查看Android 远程配置问题复现步骤。较新或不同发行渠道的界面可能调整，因此只把这些名称作为该版本的已核实路径，不把其他版本的按钮位置写成固定事实。
- 打开 SFA，进入
Profiles。如果首页没有直接显示该名称，寻找配置文件列表或配置管理入口。 - 点击
+，选择Create Manually，填写一个便于识别的名称，例如“工作配置”。 - 在类型中选择
Remote，把已核对过的 sing-box 配置 URL 粘贴到 URL 字段，然后点击Create。 - 创建后先执行一次手动刷新，打开配置内容查看器，确认返回的不是空白、登录页、HTML 错误页或 JSON 解析错误。
- 确认配置可读取后，返回服务控制界面启动。首次使用 TUN 时，按 Android 系统弹窗允许 SFA 建立 VPN；如果系统中已有其他 VPN，先停止冲突服务。
- 启动后观察 Dashboard 或状态区域中的连接、内存和流量信息，再用一个普通应用进行实际访问验证。官方通用客户端说明把这些状态列为 Dashboard 应显示的信息，但是否完整呈现取决于客户端版本。
Remote Profile 适合会变化的远程配置。官方通用文档说明，图形客户端应支持自动更新，默认更新间隔为 60 分钟，并支持 HTTP Basic Authorization。建议先手动刷新并确认配置能读取，再打开自动更新；认证字段应只填写在客户端提供的认证位置，不要写进公开截图。
导入后没有节点、刷新失败或无法联网：按顺序排查
- 先看配置内容：在 Remote Profile 的内容查看区域确认返回内容。若是 HTML、登录页、空响应或格式错误，问题仍在链接、权限或返回格式，不要先修改客户端规则。
- 再看 HTTP 结果：如果更新提示 401 或 403，检查链接是否过期、账户是否需要重新生成订阅、是否缺少认证信息。是否支持特定认证方式，要以订阅提供方说明为准。
- 再看配置字段：如果内容能下载但提示字段不支持，记录报错中的字段名和客户端版本，优先核对官方配置文档或更新客户端，不要直接删除未知字段。sing-box 官方发布记录可在sing-box Releases中核对。
- 如果没有节点或组：确认返回的是完整 sing-box 配置，而不是只含单条节点信息的分享链接。官方通用客户端文档说明，只有配置包含 Selector 或 URLTest 等组出站时，Dashboard 才应提供相应的组选择；是否显示还取决于客户端实现。
- 如果已启动但无法联网：确认 Android VPN 权限已允许，停止其他 VPN 或网络接管工具，再查看 SFA 日志中的 DNS、路由、TLS 和出站连接错误。SFA 官方特性页面确认其在需要 TUN 时通过 Android VpnService 工作，可查看sing-box for Android 特性说明。
- 最后看日志位置：优先使用应用内日志。如果需要从文件中取崩溃日志，官方 Android 特性页面列出的工作目录是
/sdcard/Android/data/io.nekohasekai.sfa/files，崩溃日志为该目录下的stderr.log；不同 Android 文件管理器可能无法直接访问该目录，能在应用内查看时不要绕开应用日志。
排查时不要把完整订阅 URL、token 或认证信息贴到日志平台。可以只保留错误类型、HTTP 状态码、字段名和客户端版本，这些信息通常足以判断下一步。
Remote、Local 怎么选：Android 只需要记住这条规则
| 配置类型 | 适用情况 | 更新方式 |
|---|---|---|
| Remote | 服务商持续维护配置，你拿到的是 URL | 在 Profile 中手动刷新或按客户端能力自动更新 |
| Local | 你已经获得 JSON 文件，或需要自行编辑配置 | 替换本地文件或在客户端编辑后重新加载 |
| iCloud | 只适用于 iOS 和 macOS 的官方图形客户端场景 | 以 iCloud 作为远程配置来源 |
对 Android 用户而言，如果订阅服务方给的是 URL，优先选 Remote；如果给的是已经下载到手机的 JSON 文件，才考虑 Local。不要为了“能导入”而把不确定格式强行改名为 .json，文件名变化不会改变文件内容。
本文是第三方使用指南，不是 sing-box 官方站点；文中涉及 SFA 的平台支持、Profile 定义、日志位置和 VPN 实现，均以已链接的官方资料为准。
最后核对：2026 年 10 月 26 日
本文按 2026 年 10 月 26 日核对到的 sing-box 官方 Android、图形客户端通用说明、Android 特性页面、官方仓库问题复现记录和 Releases 页面整理。由于客户端界面会随版本和发行渠道变化，能够明确核对的路径只限定到 Android 图形客户端的 Remote Profile 创建流程；没有核实的菜单名称没有写成固定步骤。
常见问题
sing-box 可以直接添加 Clash、Base64 或单条节点订阅吗？
不能默认直接添加。Android SFA 的 Remote Profile 需要远程 sing-box 配置来源；如果手里的内容是 Clash、Base64、Surge 或单条节点链接，应先向提供方索取 sing-box JSON 或 Remote 配置，不要仅凭 URL 后缀判断兼容。
SFA 里找不到 Profiles 或 Create Manually 怎么办？
官方仓库中的已核实路径来自 Android 客户端 1.13.13 的复现记录。不同版本或发行渠道可能调整界面，先确认使用的是 sing-box for Android，再寻找配置文件列表、加号按钮或配置管理入口；不要把其他客户端的菜单名称直接套用。
Remote 创建成功但没有节点，是什么原因？
先打开配置内容查看器，确认返回的是完整 sing-box JSON，而不是空响应、登录页、HTML 错误页或单条分享链接。若内容正常，再检查配置是否包含可供选择的组出站；组选择是否显示还取决于配置和客户端实现。
为什么订阅更新会提示 401 或 403？
常见检查顺序是确认链接是否过期、账户是否要求重新生成订阅、是否缺少 HTTP Basic Authorization，以及服务端是否限制访问。认证方式应以提供订阅的一方说明为准，不要把用户名和密码写入公开反馈。
导入后已经启动，但 Android 仍然无法联网怎么办？
先确认 Android VPN 权限已允许，停止其他 VPN 或网络接管工具，再查看 SFA 日志中的 DNS、路由、TLS 和出站错误。配置能下载或解析，只能说明导入环节通过，不代表实际出站连接一定正常。
订阅链接泄露后如何处理？
回到提供订阅的一方账户中重置、撤销或重新生成链接，旧链接是否立即失效以其后台说明为准。随后删除旧 Remote Profile、临时文件和公开截图，日志中只保留错误类型、状态码和字段名。