sing-box Android 使用教程：SFA 安装、配置格式判断与连接排错

更新于 2026-10-30 · xn--mesv7f5toqlp.shop

简答：如果你第一次在 Android 手机上使用 sing-box，最快路径是：安装官方 SFA，先判断手里的链接或文件是否为 sing-box JSON 配置，再导入 Remote 或 Local Profile，设为当前配置并启动 VPN。本文先解决最容易出错的格式判断，再说明 APK 架构选择、VPN 授权和连接排错。适用于 Android 手机上的 sing-box 图形客户端；不覆盖 iPhone、Windows 客户端，也不判断任何具体订阅服务的价格、状态或稳定性。

定义：SFA 是 sing-box 的 Android 图形客户端，用于管理和运行本地或远程 sing-box 配置，并通过 Android 的 VpnService 建立系统 VPN 连接。

先做四步速查：不要把链接直接粘贴后反复启动

判断格式：确认手里的内容是 sing-box JSON、Clash/Mihomo YAML、单节点链接，还是网页登录页。
选择安装包：只从项目官方发布页获取，按 Android 设备 ABI 选择 APK。
导入配置：远程链接使用 Remote Profile，本地 JSON 使用 Local Profile；导入后先设为当前配置。
启动并验证：完成 Android VPN 授权，再看 VPN 图标、日志、流量统计和实际网页访问。

sing-box 官方文档将 Android 客户端列为图形客户端，配置文档则以 JSON 结构和 JSON Schema 为基础。配置能被保存或解析，并不等于节点、DNS、路由和目标网络都已经可用。可先核对官方图形客户端说明、官方配置文档和JSON Schema 文档。

本文是独立使用指南，不代表任何具体品牌的官方页面；涉及品牌、订阅入口或服务状态时，请以对应官方资料为准。

第一步：判断订阅、文件或分享链接能否导入

sing-box Android 导入前的格式判断

手里的内容	能否直接作为 SFA 配置	处理方法
远程 sing-box JSON 配置链接	可以尝试	在 SFA 中创建 Remote Profile，保存后执行更新。
本地 sing-box JSON 文件	可以尝试	先复制备份，再通过 Local 或文件导入入口添加。
Clash 或 Mihomo YAML	不能直接等同于 sing-box JSON	获取 sing-box 格式配置，或使用可靠的转换流程后再校验。
单个节点分享链接	不是完整配置	不能直接推断它包含 DNS、路由、出站和策略组；应获取完整配置或按客户端支持方式添加。
打开后是 HTML、登录页或报错文本	不能导入	先核对链接权限、有效期和返回内容，不要直接点击启动。

判断格式时，不建议把带 Token、用户名或密码的订阅链接粘贴到公开网页、在线格式转换器或群组中。更稳妥的做法是在自己的设备上查看文件内容；如果链接需要鉴权、强制下载或浏览器无法显示，不要因此公开分享完整链接，可以从提供方重新获取适用于 sing-box 的配置。

JSON 结构是否符合 sing-box 配置要求，应以官方配置文档和 Schema 为准。即使 JSON 语法正确，也可能因字段版本、缺少出站或规则不完整而无法建立实际连接。

第二步：安装 SFA，并按设备架构选择 APK

sing-box 官方 GitHub Releases 页面会列出 Android 构建及其 SHA-256 校验值。以 2026-10-30 页面可见信息为例，官方发布页同时出现稳定版本和预发布版本，当前稳定发布条目标记为 Latest，预发布条目标记为 Pre-release；版本和资产会变化，安装时应以当前页面标记为准，不要把本文日期或版本号当成固定要求。

官方发布页当前可见的 Android 资产名称包含 arm64-v8a、armeabi-v7a、x86、x86_64 和 universal，部分旧系统构建还带有 legacy-android-5 标记。具体文件是否仍存在，应以官方 Releases 页面实际显示为准。

先在 Android 的“设置—关于手机”“设备信息”或系统信息页面查找 ABI、CPU 架构等字段。不同厂商的菜单名称可能不同。
现代 ARM 手机通常需要在 arm64-v8a 与 armeabi-v7a 中选择，但不要只凭手机品牌或型号猜测。
模拟器或特殊设备可能使用 x86 或 x86_64；无法确认时，只把官方发布页提供的 universal 构建作为兼容性尝试，不要下载随机 APK。
普通使用优先选择官方页面标注为稳定、非 Pre-release 的发布条目。不要把 testing 分支文档或第三方改版当成稳定版本依据。
安装前核对文件大小和 SHA-256；如果出现解析失败、应用未安装或打开即退出，先重新下载并核对架构，不要连续安装多个来源不同的 APK。
从浏览器或文件管理器安装 APK 时，系统可能要求允许该应用安装未知来源应用。安装完成后，可以在系统设置中关闭这项权限。

如果找不到 ABI 信息，优先回到官方发布页选择 universal 构建；如果仍无法安装，记录 Android 系统版本、APK 文件名和系统报错，再按发布页当前资产重新核对。

第三步：导入 Remote 或 Local Profile

Remote：导入远程配置链接

打开 SFA，进入配置列表页面，入口可能显示为 Profiles、Profile 或配置管理。
点击新增按钮，选择 Remote、远程配置或相近名称。
粘贴完整 URL，删除前后空格、引号和中文标点；填写便于识别的名称。
保存后执行更新，观察是否出现 JSON 解析、权限、超时或网络错误。
回到配置列表，点击刚保存的 Profile，将它设为当前配置。

如果找不到 Remote，先从配置列表页面的加号、添加按钮或菜单进入，而不是在 Dashboard 中寻找。不同版本可能调整入口名称，但“配置列表—新增—远程配置”是定位路径。

Local：导入本地 JSON 文件

把 JSON 文件保存到手机，并先复制一份备份。
在配置列表选择新增本地配置、Local、Import File 或文件导入。
选择 JSON 文件并保存；如果应用提供校验或编辑入口，先检查错误提示。
将导入的 Profile 设为当前配置，再进入 Dashboard 或主控制页。

Local 文件常见问题包括：下载到的是网页错误页、JSON 中存在多余逗号或注释、配置只有单个节点对象、字段属于当前客户端不识别的版本。不要为了消除报错就直接删除 dns、route 或 outbounds 区块；先恢复备份或重新取得原始配置。

如果找不到 Local，优先从配置列表的加号菜单或系统文件选择器进入。若只有导入文件按钮而没有 Local 字样，仍可通过文件选择器添加本地 JSON。官方配置结构和字段范围可参考sing-box 配置文档与JSON Schema。

第四步：设为当前配置，启动 VPN 并完成分层验证

回到配置列表，确认刚导入的 Profile 已被选为当前配置。
进入 Dashboard 或主控制页，点击启动。
首次启动时，Android 会显示 VPN 授权窗口；确认应用名称后允许连接。
观察状态栏是否出现 VPN 图标，再查看运行状态、日志和流量统计。
先打开普通网页或非关键应用验证，再测试需要特定规则的目标。

Android 官方说明，VPN 应用通过 VpnService 建立虚拟网络接口，并且同一个用户或工作资料同时只能有一个处于活动状态的 VPN 服务；启动新的 VPN 服务时，已有服务会被停止。遇到“已有 VPN”“无法建立 VPN”或启动后立即停止时，先关闭其他系统 VPN、始终开启 VPN、企业管理配置或同类 VPN 应用，再重新授权 SFA。可查看Android VPN 官方指南和VpnService API 说明。

不要仅凭 VPN 图标亮起就判断连接完全正常。建议按以下顺序验证：配置是否成功更新 → Profile 是否为当前配置 → VPN 是否获得授权 → 日志是否有出站或 DNS 错误 → 是否产生流量 → 网页和应用是否实际可用。

如果只有部分应用不通，检查 SFA 的应用分流设置。官方 Android 客户端文档列出应用分流、TUN 和服务相关功能，但具体入口和默认行为要以当前 SFA 版本与配置为准，可参考SFA Android 功能文档。应用分流列表为空时，不能仅凭这一点推断所有应用一定都会走 VPN。

节点和模式怎么选：不存在的入口不要自行添加

导入成功后，如果配置提供节点组或策略组，入口可能显示为 Groups、Outbound、Selector 或其他名称；是否存在取决于配置文件和客户端版本。先确认当前 Profile 正在运行，再查看是否有可选择的出站或策略组。

如果存在明确的节点组，先固定选择一个节点，不要一开始使用自动选择来掩盖问题。
如果配置出现 Rule、Global、Direct 等模式，只使用配置实际提供的模式；不存在对应入口时不要自行新增。
每次只修改一个变量，切换后查看日志和流量结果。
如果节点列表为空，优先检查配置是否包含出站和策略组；如果节点有名称但连接失败，再检查网络、DNS、时间、协议字段和服务端状态。

“没有节点”“有节点但启动失败”“VPN 已启动但网页打不开”属于不同阶段，不能用同一种方法处理。sing-box 官方文档将 DNS、Route、Inbound、Outbound 和 Selector 等配置部分分开说明，遇到字段问题应回到对应文档核对，不要把界面名称推断成配置一定具备的功能。

连不上时按现象分流：先恢复，再进阶修改

sing-box Android 常见故障排查表

现象	优先检查	下一步
APK 无法安装	架构、Android 系统版本、下载完整性和未知来源权限	删除错误文件，回到官方 Releases 重新选择实际存在的资产。
Remote 保存或更新失败	URL 是否完整、链接权限、有效期和返回内容	在本地确认是否返回 JSON；不要公开粘贴含 Token 的链接。
提示 JSON 解析错误	文件是否为 HTML、语法是否完整、字段是否匹配当前版本	恢复备份或重新获取原始配置，再按官方 Schema 核对。
启动后没有 VPN 图标	当前 Profile、Android 授权和活动中的其他 VPN	关闭冲突服务，撤销后重新授权 SFA。
VPN 图标亮但网页打不开	节点、出站、DNS、规则和日志	先固定一个节点，查看日志，再恢复默认 DNS 或规则进行对比。
只有部分应用不通	应用分流、工作资料和系统 VPN 设置	暂时取消应用分流进行对比，再逐项恢复。
锁屏后断连	电池优化、后台活动和厂商自启动限制	允许 SFA 后台运行或不限制电池，再单独观察。
修改 TUN、DNS 或路由后全局断网	最近一次改动和配置备份	先切回备份，不要同时继续修改多个字段。

基础连接没有确认前，不要先调整 MTU、DNS、TUN 和复杂路由。单独看到 VPN 图标、流量数字或一次网页打开，都不能证明所有应用、所有域名和所有节点均正常。

如果确实需要排查 TUN 或路由，先记录当前配置并保留回滚副本，再一次只改一个字段。官方文档提供了TUN 配置说明和Route 配置说明，字段含义以当前文档和客户端版本为准。

完成配置后的备份与安全清单

保留原始 Remote URL 或 JSON 文件，更新前不要覆盖最后一个可用 Profile。
不要在公开群组、截图或第三方工具中发布完整订阅链接、Token、用户名和密码。
首次测试使用普通网页和非关键应用，不要把未知配置直接用于网银、企业管理或主邮箱。
只从项目官方发布页获取 SFA；第三方修改版、增强版或随机 APK 的来源和行为未核实。
需要停止时，先在 SFA 中关闭 VPN，再检查 Android 系统 VPN 设置是否仍有活动连接。
如果修改 DNS、MTU、TUN 或分流后出现全局断网，立即切回备份 Profile。

如果菜单名称、字段或安装资产与本文不同，应优先以当前 SFA 版本、官方 Releases 页面和官方配置文档为准。

常见问题

sing-box Android、SFA 和 sing-box 核心有什么区别？

sing-box 是核心和配置体系，SFA 是面向 Android 的图形客户端。SFA 负责管理本地或远程配置，并调用 Android VPN 能力运行配置；官方图形客户端页面将 Android 客户端列为 sing-box for Android。

Clash 或 Mihomo YAML 可以直接导入 SFA 吗？

不能把两者直接当成同一种格式。sing-box 官方配置文档以 JSON 结构和 JSON Schema 为基础，Clash 或 Mihomo YAML 需要获取对应的 sing-box 配置，或经过可靠转换后再校验。

为什么配置导入成功，启动后还是打不开网页？

导入成功只说明配置文件被保存或解析，不代表节点、出站、DNS、规则和目标网络可用。请先确认 Profile 已设为当前配置，再检查 VPN 授权、节点选择、日志、DNS 和应用分流。

Android 没有 Google Play，应该从哪里安装 SFA？

优先使用项目官方 GitHub Releases 页面列出的 Android 构建，并核对发布条目的稳定性标记、APK 架构和 SHA-256。不要把搜索结果中的随机 APK 页面当作官方发布渠道。

SFA 启动时提示已有 VPN 怎么办？

Android 官方文档说明同一个用户或工作资料只能有一个活动的 VPN 服务。先关闭其他系统 VPN、始终开启 VPN、企业管理 VPN 或同类 VPN 应用，再重新启动并完成 SFA 授权。

锁屏后 sing-box Android 自动断开怎么办？

先检查系统电池优化、后台活动和厂商自启动限制，将 SFA 设置为允许后台运行或不限制电池，再单独观察。不要同时修改 DNS、MTU 和路由，否则很难判断真正原因。

找不到 Profiles、Remote、Local 或 Groups 按钮怎么办？

先回到 SFA 的配置列表或主控制页，查找加号、添加配置、文件导入、远程配置或出站相关入口。不同版本可能更改名称；如果当前版本没有对应功能，不要根据教程自行新增字段或模式。