sing-box 安卓工作目录和崩溃日志在哪里
在安卓上用 sing-box 的官方安卓客户端(下面简称 SFA),偶尔会遇到应用闪退、VPN 图标突然消失、服务自己停掉的情况。这时候最有用的是崩溃日志,而它不在应用界面里,是工作目录下的一个文件。这一页把路径写清楚,再说怎么取、取到之后怎么用。
先确认你装的是 SFA
崩溃日志路径只对 SFA 成立,换成别的客户端不适用,包名见上面的路径。
sing-box 文档站把 SFA 列为 Android 端的图形客户端,系统要求 Android 5.0 以上,下载渠道有 Play Store、Play Store (Beta)、GitHub Releases 和 F-Droid 四个。如果你用的是其他以 sing-box 为内核的安卓软件,例如 NekoBox,目录和包名都不一样,下面的路径不适用。NekoBox 的情况可以看 NekoBox 是什么 那一篇。
工作目录:应用的外部文件目录
结论:SFA 的工作目录是 这个工作目录。
文档在 Chore 段写明,这个目录就是 Android 的 External files directory(外部文件目录)。它属于应用自己的存储空间,卸载应用时会跟着被删,所以要保留日志就别先卸载再去找。
图形客户端的 Core 区域还有一个「清理工作目录」的按钮,同一区域会显示当前 sing-box 版本号,并提供 memory limiter 开关。清理按钮动的就是上面这个目录。
崩溃日志:工作目录下的 stderr.log
结论:崩溃日志写在 $working_directory/stderr.log,展开就是 这个工作目录/stderr.log。
文档原文是「Crash logs is located in $working_directory/stderr.log」。哪些崩溃会写进去、文件里长什么样,文档没有给样例。我的做法是:遇到闪退后不要马上重开、不要点清理,先把这个文件复制出来,再看末尾几十行里有没有 panic 或 fatal 之类的字样。
取文件的办法取决于你的系统版本和文件管理工具。较新的 Android 对 Android/data 目录有访问限制,具体怎么取到这个目录里的文件,sing-box 文档没有说明,我也不在这里给猜测的步骤。能用数据线接电脑的话,从电脑端浏览手机存储取文件是比较直接的一条路。
运行日志和崩溃日志不是同一个东西
结论:stderr.log 记录崩溃,配置里的 log 段控制的是运行日志。
sing-box 配置的 log 段有四个字段:disabled、level、output、timestamp。level 可选 trace、debug、info、warn、error、fatal、panic,排查时调到 debug 或 trace 能看到更多细节。output 是输出文件路径,文档示例写的是 box.log,启用后日志不再写到控制台。timestamp 控制是否带时间戳。
所以排查顺序可以这样分:应用直接崩了,看 stderr.log;应用没崩但连不上,把 level 调高,看运行日志里的报错。运行日志的写入位置以你在 output 里填的路径为准,文档没有说明相对路径以哪个目录为基准,我建议直接写完整路径,免得找不到。
先排除配置里 SFA 不支持的字段
结论:同一份配置在电脑上能跑、在 SFA 上异常,先对照文档的功能表。
平时 SFA 以前台服务的形式跑 sing-box,要开 TUN 时才换成系统的 VPN 服务接口。它的 TUN 是借系统 VPN 服务实现的无特权 TUN,interface_name 由系统管理,strict_route 标为 Not implemented。路由和 DNS 规则里,process_name、process_path、process_path_regex 在 SFA 上没有权限,user 和 user_id 应改用 package_name,wifi_ssid 与 wifi_bssid 需要精确位置权限。
这些字段写进配置后具体会报什么错,文档没有逐条说明。把它们删掉或换成文档给的替代字段,再看问题还在不在,能少走不少弯路。订阅本身拉不下来的情况属于另一类,可以看 机场订阅问题排查。
还解决不了:带着日志去提 issue
把 stderr.log、Core 区显示的版本号和能复现问题的配置片段一起整理好,到项目 GitHub 页提 issue。配置里的服务器地址、密码、订阅链接要先删掉。只说一句「闪退了」,维护者基本无从下手;附上日志的末尾一段,问题才有被定位的可能。
常见问题
SFA 的工作目录在哪里?
sing-box 文档站写的是 这个工作目录,也就是应用的外部文件目录(External files directory)。
崩溃日志文件叫什么?
文件名是 stderr.log,放在工作目录下,完整路径为 这个工作目录/stderr.log。
stderr.log 和配置里 log.output 写出的文件是一回事吗?
不是。stderr.log 是文档写明的崩溃日志位置;log.output 是你在配置里自己指定的运行日志文件,启用后日志不再写到控制台。
手机上打不开 Android/data 目录怎么办?
不同 Android 版本访问这个目录的方法,sing-box 文档没有说明。可以换用能访问应用外部文件目录的文件管理方式,或者先接电脑再取。
点了清理工作目录还能找回日志吗?
官方没有说明清理范围之外的恢复办法。stderr.log 就在工作目录里,所以要留证据就先复制出来再点清理。
提 issue 时要附哪些信息?
附上 stderr.log、Core 区显示的 sing-box 版本号,以及能复现问题的配置片段,把订阅地址和密码等私人信息删掉。