sing-box for Android 怎么下载、安装并导入配置？
简答：先安装官方 Android 客户端 SFA，再导入兼容的 sing-box JSON 配置并授权 Android VPN。下载时优先选择官方渠道和匹配架构；Clash YAML、单节点链接或普通订阅地址不能默认直接使用。
定义：sing-box for Android 是由 Project S 维护的 Android 图形客户端，简称 SFA，用来管理本地或远程 sing-box 配置，并通过 Android VpnService 提供 TUN 等平台功能。
先看结论：下载哪一个、能不能直接导入
如果你搜索的是 sing-box for Android，通常要找的是官方 Android 图形客户端 SFA，而不是命令行核心、源码压缩包或第三方改版。官方图形客户端列表把 Android 对应到 sing-box for Android；项目仓库也将其定义为 Android client for sing-box。本文是第三方使用指南站，不是该项目官方站点，下载前请以项目页面当前显示为准。
| 你的情况 | 建议选择 | 判断标准 |
|---|---|---|
| 想在手机上点按导入、启动和停止 | 安装 SFA 图形客户端 | 选择官方文档列出的 Google Play、F-Droid 或 GitHub Releases 渠道 |
| 只想运行命令行核心 | 不要误装 Android 图形客户端 | CLI 核心不是面向新手的完整图形界面 |
| 已有配置文件 | 优先准备 sing-box JSON | 配置需要符合 sing-box 的 JSON 结构和字段 |
| 只有 Clash YAML、单节点链接或普通订阅地址 | 先确认是否有兼容转换或专用配置 | 不要把任意文本直接当成 sing-box 配置导入 |
截至2026-10-24，sing-box Releases 标记为 Latest 的是 1.14.4。普通用户应优先选择稳定渠道，不要仅因为文件名更新或带有 alpha 标识就替换现有安装。
第一步：从官方渠道下载 SFA
- Google Play：打开官方 Android 客户端说明，从其中的 Play Store 入口进入应用商店。适合希望由商店管理安装和更新的用户。
- F-Droid：使用F-Droid 的 sing-box 条目，更适合已经使用 F-Droid 的用户。F-Droid 页面说明该应用由 Project S 发布，并提供源代码、构建元数据和可复现构建信息。
- GitHub Releases：从项目 Releases 页面选择 Android 资产。适合需要手动保存 APK、核对发布资产或不使用应用商店的用户。
不要把“sing-box”关键词搜索结果中的任意应用都当作官方客户端。官方图形客户端页面明确提醒，部分第三方项目虽然声称使用 sing-box，但不在官方客户端列表中；选择前应核对项目名称、发布组织和来源链接。
第二步：判断 Android 版本与 APK 架构
官方 Android 客户端文档列出的要求是 Android 5.0 及以上；F-Droid 条目当前对其分发构建标注了更高的系统要求。因此，如果你的手机系统较旧，应以实际下载渠道的兼容提示为准，不要只看一处说明。
| 文件标识 | 通常对应的设备 | 选择建议 |
|---|---|---|
arm64-v8a | 大多数较新的 64 位 ARM 手机 | 新款 Android 手机通常先看这一项 |
armeabi-v7a | 较旧的 32 位 ARM 手机 | 只有确认设备为 32 位 ARM 时选择 |
x86 | 少数旧款 Intel Android 设备 | 不要与 ARM 手机混选 |
x86_64 | 64 位 Intel Android 设备或部分模拟器 | 适合确认使用 x86_64 的设备或模拟器 |
universal | 包含多种架构的通用包 | 文件较大，但在不确定架构时更容易选择 |
如果不知道手机架构，可以查看手机系统信息中的 CPU ABI；也可以优先使用 Google Play 或 F-Droid 客户端，让分发渠道替你处理兼容选择。手动安装时，只对从项目发布页下载的原始 APK 做校验，不要拿解压后的文件或截图中的摘要值比较。
第三步：安装 SFA 并授权 Android VPN
- 从选定渠道下载并安装 SFA。通过浏览器或文件管理器安装 APK 时，Android 可能要求对当前应用开启“允许安装未知应用”；只为实际执行安装的来源临时开启，完成后可以关闭。
- 首次打开应用，先阅读系统弹出的 VPN 连接请求。Android 的 VPN 权限由系统确认，选择允许后，客户端才能建立系统级 VPN 通道。
- 如果手机已经有其他 VPN、网络防火墙或企业管理软件，先停止或退出冲突应用，再重新启动 SFA。Android 通常只允许一个 VPN 服务处于工作状态。
- 当系统显示 VPN 图标或通知后，再回到 SFA 查看运行状态。只看到“已授权”不等于配置可用，还要确认日志中有连接、解析或路由活动。
SFA 的 TUN 功能依赖 Android VpnService；F-Droid 条目也将其描述为通过 Android VpnService 提供 TUN 透明代理能力。若系统弹窗被拒绝，请到系统设置中的 VPN、应用权限或电池管理页面重新检查。
第四步：导入本地 JSON 或远程配置
- 本地文件：把配置文件保存到手机存储，文件名可使用
config-<版本号>.json。在 SFA 中选择添加或导入本地配置，定位到该文件并保存。 - 远程 URL：仅在你确认地址返回的是 sing-box 配置或兼容的远程配置时使用。复制完整地址，在 SFA 的远程配置入口添加，保存后等待客户端读取内容。
- 检查格式：sing-box 使用 JSON 作为配置格式，常见顶层结构包括
dns、inbounds、outbounds、route等。官方文档还提供 JSON Schema，可用于编辑器补全和校验。 - 再启动：配置保存成功后，选中该配置并启动；如果出现解析错误，先回到配置来源检查格式、字段名称、引号和是否返回了网页登录页。
Clash YAML 不能因为包含代理节点就自动变成 sing-box 配置；单个节点链接也不等于完整配置。缺少入站、出站、路由或 DNS 等必要结构时，导入可能失败，或者导入后无法建立有效连接。不要把账号密码、订阅地址和完整配置公开粘贴到论坛或截图中。
第五步：启动后如何确认真的在工作
- 在 SFA 中启动配置，并确认 Android 系统的 VPN 状态已经出现。
- 打开 SFA 的连接或运行日志，观察是否出现 DNS 请求、连接建立、出站选择或路由命中信息。
- 用浏览器访问一个你平时能打开的页面，再对比连接前后的出口 IP；不要只凭 VPN 图标判断流量已经按预期经过配置。
- 如果只有部分应用无法联网，检查分应用代理、绕过应用和系统电池限制；如果所有应用都无法联网，优先检查配置格式、出站地址、DNS 和 VPN 冲突。
验证重点是“配置是否被成功加载、VPN 是否建立、连接日志是否命中策略、出口是否发生预期变化”，而不是单纯查看应用首页的开关颜色。
常见连接问题与处理顺序
| 现象 | 优先检查 | 处理方法 |
|---|---|---|
| 安装失败或提示不兼容 | 系统版本、CPU 架构、下载渠道 | 改用匹配架构或应用商店渠道，避免混装不同来源的包 |
| 配置导入失败 | 文件是不是 JSON、内容是否完整 | 用 JSON 编辑器或 Schema 校验，确认不是 HTML 错误页或 Clash YAML |
| 启动后没有 VPN 图标 | 系统授权和其他 VPN | 重新授权 Android VPN，停止其他 VPN、防火墙或企业网络工具 |
| VPN 已连接但网页打不开 | 出站、DNS、路由和日志 | 先看日志命中的策略，再检查 DNS 解析和远程端点是否可达 |
| 只有某个应用打不开 | 分应用代理、绕过列表、电池限制 | 检查该应用是否被排除，并暂时取消后台限制后复测 |
如果问题集中在 DNS 或 TUN 路由，不要一开始就反复更换 APK。先保留当前配置副本，逐项改变一个设置，再根据日志和出口 IP 对比结果。
使用前必须分清的三件事
- SFA：Android 图形客户端，负责配置管理、VPN 授权和平台功能。
- sing-box 核心：负责按照配置处理网络连接，不能等同于完整的 Android 图形界面。
- 节点或订阅服务：由用户自行准备的网络连接资源，sing-box 客户端本身不提供节点、代理订阅或 VPN 服务。
因此，安装成功只代表客户端已就绪；要真正连接，还需要一份格式兼容、内容有效且包含必要出站信息的 sing-box 配置。对于来自其他客户端的配置，应先确认是否有转换方案，不要直接改后缀名。
结语：最短可执行流程
- 打开官方 Android 客户端说明，选择 Google Play、F-Droid 或 GitHub Releases。
- 确认 Android 系统和 APK 架构，手动安装时只使用可信发布页的原始资产。
- 打开 SFA，允许 Android VPN 权限，停止其他 VPN 冲突应用。
- 导入本地 JSON 或确认格式兼容的远程配置。
- 启动后查看 VPN 状态、连接日志和出口 IP；出现问题时按“格式—授权—冲突—DNS—路由”顺序排查。
如果你的目标只是让 Android 手机稳定使用一份 sing-box 配置，这个顺序比先改大量 DNS、MTU 或路由参数更容易定位原因。
常见问题
sing-box for Android 官方客户端叫什么？
官方 Android 图形客户端是 sing-box for Android，常简称 SFA。它用于管理本地或远程 sing-box 配置，并通过 Android VpnService 提供 TUN 等平台功能。
Android 手机应该下载 arm64-v8a 还是 armeabi-v7a？
大多数较新的 Android 手机通常使用 arm64-v8a；较旧的 32 位 ARM 设备才使用 armeabi-v7a。不确定时优先使用 Google Play 或 F-Droid 客户端，或者查看手机系统信息中的 CPU ABI。
Clash YAML 能直接导入 sing-box for Android 吗？
不能默认直接导入。sing-box 使用 JSON 配置格式，Clash YAML、单个节点链接和普通订阅地址都需要先确认是否有兼容转换或专用配置。
SFA 启动后为什么没有网络？
先确认 Android VPN 权限是否允许，再停止其他 VPN、防火墙或企业网络工具；随后查看连接日志，检查配置是否成功加载、DNS 是否可用、出站是否能建立连接。
sing-box for Android 会自带节点或订阅吗？
不会。SFA 是客户端，负责加载和运行配置；节点、远程配置或订阅内容需要由用户自行准备，并且必须与 sing-box 配置格式兼容。