CreamData返回首页

sing-box 安卓客户端教程：从安装到首次连接

更新于 2026-11-01 · creamdata.buzz

简答：sing-box 安卓客户端通常指 SFA，也就是 sing-box for Android。新手按“官方渠道安装 → 确认 sing-box 配置格式 → Profiles 添加 Remote → Dashboard 启动并允许 VPN 权限 → Groups 选择节点”的顺序操作即可。若导入后没有节点、启动后无法联网或锁屏断连，先不要修改 DNS、MTU 等高级参数，应先检查配置格式、订阅链接、VPN 冲突和安卓后台限制。本文只讲 Android 客户端，不覆盖 iOS、Windows、macOS 和命令行配置。

定义：sing-box 安卓客户端是用于管理本地或远程 sing-box 配置，并通过 Android VPN 服务运行透明代理功能的图形客户端，常见名称为 SFA。

先看结论：安卓安装和首次连接只需完成这五步

本文是面向新手的 sing-box 安卓客户端教程。站点为第三方使用指南，不是 sing-box 官方页面；客户端名称、版本和菜单可能随发布版本变化，遇到界面不同应优先以当前应用显示为准。

  1. 安装客户端：优先从Google Play 的 sing-box 页面安装；也可以使用F-Droid 页面，或从官方 GitHub Releases核对 APK。
  2. 准备配置：从你的服务后台复制 sing-box、JSON 或 SFA 专用配置链接，不要把 Clash YAML、mihomo 配置或普通 Base64 节点文本直接当成 sing-box Remote 配置。
  3. 添加配置：打开应用，在 Profiles 中新建 Remote 配置，填写名称和远程 URL，保存后等待配置解析。
  4. 启动服务：回到 Dashboard，启动服务并允许 Android VPN 权限；看到系统 VPN 图标后，再进行网页访问测试。
  5. 选择节点：如果配置包含 Selector 或 URLTest 等分组，在 Dashboard 的 Groups 区域选择或切换节点；没有分组时，应用内可能不会出现可切换节点列表。

停止条件：如果 Remote 保存后立即显示解析错误，先停止后续操作，重新核对链接是否完整、是否需要登录授权，以及返回内容是否为 sing-box JSON。不要用“浏览器能打开链接”作为唯一判断，因为浏览器能显示内容不等于客户端能解析。

安装渠道、版本和 APK 架构怎么选

官方客户端列表将 Android 对应到 sing-box for Android；Google Play 页面说明该应用可以管理本地和远程 sing-box profiles，并通过 Android VpnService 实现 TUN 透明代理。安装渠道可按下表选择。

渠道适合谁核验重点
Google Play大多数安卓用户确认应用包名为 io.nekohasekai.sfa，并以商店当前页面显示为准。
F-Droid希望通过开源应用仓库安装的用户F-Droid 页面会列出当前收录版本、架构和系统要求；不要把旧页面的系统要求套用到新版本。
GitHub Releases需要手动下载 APK 或核对资产的用户截至 2026年11月1日，发布页显示稳定版为 v1.14.4，同时还列有预发布版本。稳定版和预发布版不要混用。

系统版本需要特别注意：官方 Android 文档写有 Android 5.0+ 的客户端要求，但当前 F-Droid 页面显示的版本要求 Android 7.0 或更高；GitHub 稳定版资产中另有带 legacy-android-5 名称的 APK。由此不能简单认为普通主包和旧系统兼容包使用同一最低版本。请先在手机“设置—关于手机”查看 Android 版本，再根据当前发布页资产说明选择；主包安装失败时，不要随意安装来源不明的修改版 APK。

架构方面，常见资产名称包括 arm64-v8a、armeabi-v7a、x86 和 x86_64。新手机通常需要以设备实际架构为准；无法确认时，优先使用 Google Play、F-Droid，或选择官方发布页提供的 universal 资产。安装完成后，进入应用信息核对包名和版本，停止条件是包名不一致或安装器提示签名冲突，此时不要继续覆盖安装。

准备正确的 sing-box 订阅或远程配置

sing-box 使用 JSON 配置文件。官方配置文档列出了 dns、inbounds、outbounds、route 等配置区块；因此，能在浏览器中看到一串文本，并不代表它就是可供 SFA 使用的完整配置。

  1. 登录你已购买或管理配置的服务后台。
  2. 寻找名称接近“sing-box”“SFA”“JSON”“通用配置”或“远程配置”的入口。不同服务后台命名不一致，若只看到 Clash、Surge 或 Base64 订阅，应先确认是否提供 sing-box 格式。
  3. 复制完整 URL，不要截断参数、删除问号后的内容，或把链接粘贴到公开群组、截图和日志中。
  4. 如果后台同时提供下载 JSON 文件和远程 URL，首次导入优先使用远程 URL；本地文件适合在你已经保存并确认配置内容时使用。

格式分流：Clash 或 mihomo 的 YAML 配置、普通节点分享链接、Base64 节点集合，不能因为“也是订阅”就直接当作 sing-box Remote 配置。没有 sing-box/JSON 配置入口时，应向提供方确认转换方式；不要把不明第三方转换站当作默认方案，也不要将包含访问凭证的订阅链接提交给不信任的服务。

SFA 中添加 Remote 配置并启动 VPN

不同版本的界面文字可能略有差异，但操作逻辑是“配置文件—运行服务—选择分组”。官方通用客户端说明中，Remote Profile 指以 URL 作为更新来源的远程配置；Dashboard 用于服务运行时查看状态、连接和流量，Groups 只在配置含有相应分组出站时提供选择入口。

  1. 打开 SFA，进入 Profiles 或配置管理页面。
  2. 选择新建配置，类型选择 Remote。如果当前版本将 Local、Remote 放在添加按钮或下拉菜单中，选择含义相同的远程配置项。
  3. 在名称字段填写便于识别的名称，例如“工作配置”；在 URL 字段粘贴完整 sing-box 配置链接。
  4. 保存或创建配置，等待应用拉取并解析。成功标准是配置出现在列表中，且没有 JSON 解析错误、HTTP 错误或鉴权失败提示。
  5. 进入 Dashboard，启动服务。Android 首次运行通常会弹出 VPN 连接授权，选择允许。
  6. 观察系统状态栏是否出现 VPN 图标，再打开一个普通网页进行验证。VPN 图标只说明系统 VPN 服务已建立，不等于远端节点一定可用。
  7. 若配置包含分组，进入 Dashboard 中的 Groups 区域选择节点或分组。若没有 Groups 入口，可能是配置没有 Selector、URLTest 等可切换分组，不要据此判断导入失败。

最小改动原则：首次连接不要同时改 DNS、分流模式、TUN 参数和应用排除列表。先用原始配置完成一次基础联网，再针对单个现象逐项调整。每次只改一项，并记录原值，便于回滚。

按现象排查：导入成功但仍然不能用

1. 保存 Remote 后提示解析失败

  • 检查 URL 是否复制完整，尤其是问号、等号和参数部分。
  • 确认返回内容是 sing-box JSON，而不是网页登录页、Clash YAML 或错误提示文本。
  • 在服务后台重新生成或复制链接，再删除旧配置后重新添加。
  • 如果链接需要账号、密码或特定请求头，确认当前客户端版本是否支持对应方式；无法确认时以配置提供方说明为准。

验证边界：配置能保存只说明文件被接受，不代表节点可用；不要跳过启动和网页测试。

2. 配置显示出来，但没有节点或 Groups

  • 先查看配置是否包含 outbounds，以及是否包含 Selector 或 URLTest 等分组。
  • 如果只有一个固定出站，可能没有可供手动切换的节点列表。
  • 如果配置来自错误格式转换，可能出现文件能打开但出站结构不完整的情况，应回到原始 sing-box 配置来源核对。

3. Dashboard 已启动，但网页打不开

  1. 确认 Android VPN 权限已允许，且系统没有同时运行其他 VPN、代理或网络防护应用。
  2. 暂时关闭其他 VPN 服务后重新启动 SFA，避免多个 VPN 服务竞争系统通道。
  3. 在 Groups 中切换到另一个已存在的节点；如果所有节点都失败，优先核对订阅是否过期、配置是否需要鉴权，以及网络是否能访问配置 URL。
  4. 再检查 DNS 或分流规则。不要因为某个网页打不开就直接修改 MTU；先用多个普通网页和应用进行交叉验证。

验证边界：看到 VPN 图标、Dashboard 有流量，或某一个网页能打开，都不能单独证明所有应用和所有节点正常。

4. 锁屏后断连或后台停止

F-Droid 页面列出了该应用请求前台服务、开机运行和忽略电池优化等权限，说明后台运行可能受到系统权限和厂商省电策略影响。可以按以下顺序处理：

  1. 在系统设置中搜索“电池优化”“后台活动”“自启动”或“省电策略”。
  2. 为 SFA 允许必要的后台运行权限；具体菜单名称因手机品牌和系统版本不同，不能套用其他品牌的固定路径。
  3. 锁屏后观察 VPN 图标是否消失，并在解锁后查看 SFA 是否仍显示运行状态。
  4. 如果权限已允许仍断连，记录 Android 版本、应用版本、断连时间和日志现象，再逐项关闭省电限制测试。

停止条件是不要为了保活安装来历不明的“加速器”或修改版客户端，也不要把订阅 URL 直接发给他人排查。

订阅凭证、分流和回滚注意事项

订阅 URL 通常可能包含账号标识、访问令牌或其他授权参数，应当按密码处理。不要把完整 URL 放进公开截图、工单、群聊或第三方转换工具；如果已经泄露，应在配置提供方后台重新生成或撤销旧链接。

Rule、Global 等模式的实际含义取决于配置文件和客户端当前实现。本文不建议新手首次连接时主动修改分流逻辑：先确认基础连接，再根据具体应用是否需要代理或直连进行单项调整。SFA 还支持在图形界面中对部分 Android 应用设置代理或绕过，但这属于后续优化，不是首次联网的必需步骤。

回滚时按相反顺序操作：停止 Dashboard 服务，删除刚新增或修改的配置，恢复原来的 DNS、分流和应用选择设置，确认其他 VPN 已关闭，再重新导入一份未经修改的 sing-box 配置。若原始配置本身无法解析，应回到提供方重新获取，不要继续叠加本地改动。

相关站内指南

如果你还需要处理其他客户端或网络现象，可以继续阅读：站内客户端与网络排查指南、Clash Verge Rev 网速慢的分场景排查、Mihomo Linux 安装与运行排查。这些页面分别对应不同客户端或平台，不应把其中的菜单路径直接套用到 sing-box 安卓客户端。

常见问题

sing-box 安卓客户端应该从哪里下载？

优先使用 Google Play 的 sing-box 页面；也可以使用 F-Droid，或在 SagerNet/sing-box 的官方 GitHub Releases 中核对 APK。手动安装时要检查包名、版本、架构和系统要求，不要使用无法核验来源的修改版安装包。

Clash 订阅可以直接导入 sing-box 安卓客户端吗？

通常不能直接假定可以。sing-box 使用 JSON 配置，而 Clash 或 mihomo 常见配置是 YAML；普通 Base64 节点文本也不等于完整 sing-box 配置。请在配置提供方后台寻找 sing-box、JSON 或 SFA 专用链接，无法确认时以提供方说明为准。

为什么导入成功后没有 Groups 或节点列表？

Groups 入口依赖配置中存在可切换的分组出站，例如 Selector 或 URLTest。如果配置只有固定出站，或者配置结构不完整，可能没有可选择的节点。先查看配置来源和解析提示，不要仅凭是否出现 Groups 判断客户端安装失败。

Dashboard 已启动但网页打不开，先改 DNS 还是 MTU？

先不要改高级参数。首先确认 Android VPN 权限、是否存在其他 VPN 冲突、配置是否需要鉴权、节点是否可用，再用多个网页或应用交叉验证。DNS 和 MTU 应在基础连接确认后逐项调整，并保留原设置以便回滚。

为什么手机锁屏后 sing-box 会断开？

常见优先检查项包括电池优化、后台活动、自启动和厂商省电策略。F-Droid 页面列出了前台服务、开机运行和忽略电池优化等相关权限，但具体菜单路径因手机品牌和系统版本不同，应使用系统设置搜索对应选项。

相关阅读

参考资料

  1. sing-box 官方：图形客户端列表
  2. sing-box 官方：图形客户端通用功能说明
  3. sing-box 官方：Android 客户端功能说明
  4. sing-box 官方：配置文件结构与 JSON 格式
  5. SagerNet/sing-box 官方 GitHub Releases
  6. sing-box 官方：Android 客户端文档
  7. F-Droid：sing-box Android 客户端（f-droid.org）