sing-box 安卓如何排除应用?SFA 分应用代理设置与失效排查
简答:sing-box 安卓排除应用,最稳妥的方法是打开 SFA 的“分应用代理”,选择“黑名单”,再勾选要直连的应用。若列表为空,先处理 Play 商店版的 Shizuku 或 Root 权限;若手动配置不生效,再核对 exclude_package、package_name 和实际包名。
定义:sing-box 安卓排除应用,是通过 Android TUN 的分应用代理设置或包名规则,让指定应用流量不进入 sing-box 的代理路由。
先试这一步:SFA 中把应用加入排除列表
本文是第三方使用指南,具体菜单名称可能随 SFA 版本、Android 版本和安装渠道变化;请优先查找英文关键词 Per-App Proxy。官方客户端界面文案确认了“分应用代理”“白名单”“黑名单”等选项,其中黑名单的含义是让选定应用从 VPN 中排除。可先按下面顺序操作:
- 打开 sing-box for Android,进入当前配置或服务的设置区域。
- 查找并打开“分应用代理(Per-App Proxy)”。
- 将“代理模式”设为“黑名单”,不要误选“白名单”。
- 在应用列表中勾选需要直连的应用;如需核对包名,可使用列表中的“复制包名”功能。
- 返回配置页面,保存更改,停止并重新启动 VPN 服务。
- 只打开刚才排除的应用进行验证,再查看 SFA 日志或连接记录。
官方客户端源码中的界面文案明确区分了两种模式:白名单是“仅允许选定的应用程序通过 VPN”,黑名单是“选定的应用将从 VPN 中排除”。查看 SFA 中文界面字符串
| 现象 | 优先处理 | 验证方法 |
|---|---|---|
| 应用能在列表中找到 | 选择黑名单并勾选应用 | 重启 VPN 后单独打开该应用 |
| 应用列表为空或不完整 | 检查安装渠道与 Shizuku/Root 权限 | 重新进入分应用代理并刷新列表 |
| 手动规则保存但仍被代理 | 检查包名、规则位置和配置是否生效 | 查看日志是否识别到 package name |
| 只想排除某个网址或 IP | 不要使用应用排除字段 | 改查路由地址规则的适用范围 |
手动配置:使用 tun.exclude_package 排除应用
如果你使用的是可编辑 JSON 配置,应用排除应放在 inbounds 下的 TUN 入站中,字段是 exclude_package。官方 TUN 文档将它定义为“排除 Android 应用包名的路由”;同时要求 Android 应用规则配合 auto_route 使用,具体客户端是否允许直接编辑该字段,要以当前版本为准。查看官方 TUN 配置文档
{
"inbounds": [
{
"type": "tun",
"tag": "tun-in",
"auto_route": true,
"exclude_package": [
"需替换为实际应用包名"
]
}
]
}上面只是字段位置示例,不能直接把示例包名当成真实应用包名。请先在 SFA 的应用列表中找到目标应用,使用“复制包名”,再替换 需替换为实际应用包名。修改后保存配置,重新启动 VPN,再通过日志和实际访问结果验证。
如果配置中已经有 include_package,不要只追加排除项而忽略两者关系。官方文档把 include_package 定义为限制进入路由的 Android 包名,把 exclude_package 定义为排除进入路由的 Android 包名;同一份配置中存在相互冲突的范围时,应先简化为一种分应用策略,再测试。
exclude_package 和 route.rules 的 package_name 有什么区别?
两者都涉及应用包名,但作用层级不同:tun.exclude_package 是 TUN 入站层面的应用排除;route.rules 里的 package_name 是路由规则匹配条件,匹配后还要由规则中的 outbound 或其他动作决定流量去向。官方路由规则文档将 package_name 定义为匹配 Android 包名。查看官方 Route Rule 文档
| 字段 | 放置位置 | 适合场景 | 注意事项 |
|---|---|---|---|
exclude_package | inbounds[].tun | 指定应用整体不进入 TUN 路由 | 优先用于简单的分应用直连需求 |
package_name | route.rules[] | 按应用包名匹配后交给指定出站 | 必须确认规则顺序、出站标签和客户端识别能力 |
route_exclude_address | inbounds[].tun | 排除目标 IP 或网段 | 它按地址工作,不是按应用工作 |
不要把 route_exclude_address 当成“排除某个应用”的字段。它处理的是目标地址范围;如果需求是让某个 Android 应用直连,应先使用 SFA 分应用代理,或核对 exclude_package。
应用包名怎么查?列表没有应用怎么办?
最可靠的做法是使用 SFA 分应用代理列表中的“复制包名”,避免把应用显示名称、桌面图标名称或网页搜索到的包名直接当成配置值。复制后可先粘贴到文本编辑器检查,再放入 exclude_package 或 package_name。
- 进入“分应用代理”,搜索目标应用。
- 长按或打开应用操作菜单,查找“复制包名”。
- 将复制结果保存到临时文本中,确认没有多余空格或换行。
- 把包名填入配置后保存,并重启 VPN 服务。
如果使用 Play 商店安装的版本,官方客户端文案提示:分应用代理可能需要 Shizuku;完整应用列表还可能需要 Root 或 Shizuku 权限,因为应用列表查询权限受到安装渠道限制。相关提示可在 SFA 官方中文资源中核对。
因此,列表缺失时按这个顺序处理:确认 SFA 已获得 VPN 权限;检查 Shizuku 是否已安装、运行并授权;如果设备已 Root,检查 Root 授权;重新打开分应用代理并刷新。不同 ROM、Android 版本和安装包渠道的表现可能不同,不能把某一种安装渠道的结果泛化到所有设备。
排除后仍然走代理:按四层检查
如果应用已经勾选排除但流量仍像是经过代理,先不要继续叠加规则,按“配置—权限—版本—日志”的顺序定位。
- 检查配置:确认选择的是“黑名单”,而不是“白名单”;JSON 中确认字段拼写为
exclude_package,并且位于 TUN 入站对象内。 - 检查保存与重启:保存配置后停止服务,再重新启动 VPN。只修改文本但没有重新加载配置,不能证明新字段已经生效。
- 检查安装渠道与版本:公开 Issue 中曾记录部分 SFA 版本和 Google Play 构建对
package_name识别异常的反馈;该反馈不能代表所有版本,但说明安装渠道和版本需要纳入排查。查看官方仓库 Issue #4623 - 检查日志:在 SFA 日志中搜索
package name、package_name、match或目标包名。若完全没有识别包名的记录,优先查权限、安装渠道和客户端版本;若已经识别包名但仍走代理,再检查规则顺序和出站标签。
路由规则还存在先后顺序问题:即使 package_name 写对,如果前面的规则已经匹配并决定了出站,后面的规则可能不会按预期处理。因此,手动使用 package_name 时要同时检查规则顺序、匹配条件和 outbound 标签,不能只看包名是否存在。
常见误区与验证清单
- 把“黑名单”理解成只代理选中的应用:实际界面文案显示,黑名单是排除选中应用;只代理选中应用对应的是白名单。
- 把应用名称当成包名:配置需要 Android 包名,优先从 SFA 应用列表复制。
- 把
route_exclude_address当成应用排除:该字段用于地址或网段范围,不是应用识别字段。 - 修改后不重启 VPN:应保存配置、停止服务并重新启动,再进行验证。
- 只用浏览器判断:最好在目标应用内执行一次明确的网络操作,并结合 SFA 日志检查是否识别到包名。
最短闭环:黑名单 → 勾选应用 → 复制并核对包名 → 保存 → 重启 VPN → 应用内测试 → 查看日志。
常见问题
sing-box 安卓排除应用应该选黑名单还是白名单?
如果目标是让某些应用不走 VPN,应选择“黑名单”,再勾选需要排除的应用;“白名单”表示仅允许选中的应用通过 VPN。
SFA 里找不到要排除的应用怎么办?
先确认 VPN 权限,再检查安装渠道。Play 商店版本的分应用代理可能需要 Shizuku;完整应用列表也可能需要 Root 或 Shizuku。权限处理后重新打开分应用代理并刷新。
exclude_package 和 package_name 可以随便选一个吗?
简单的应用整体排除优先使用 TUN 入站中的 exclude_package;package_name 位于 route.rules 中,属于路由匹配条件,还要结合规则顺序和 outbound 判断,不能把两者当成完全相同的字段。
为什么应用已经加入黑名单,仍然像是走代理?
先确认模式确实是黑名单,检查配置是否保存并重启 VPN;随后核对实际包名、安装渠道、Shizuku 或 Root 权限,并在日志中搜索 package name、package_name 或目标包名。
route_exclude_address 能不能排除某个应用?
不能直接按应用排除。route_exclude_address 面向目标 IP 或网段;按 Android 应用排除应使用 SFA 分应用代理或 exclude_package。