Skip to content

sing-box 苹果客户端服务日志在哪看 ​

在 iPhone、Mac 或 Apple TV 上跑 sing-box,碰到连接断开、VPN 开关自己弹回关闭、服务停止这类情况,第一步是找日志。苹果版的崩溃日志不在系统设置里,而在客户端自己的设置页。这一页讲入口在哪、看到之后怎么用。

入口:Settings 里的 View Service Log ​

结论:苹果版的崩溃日志在客户端的 Settings -> View Service Log。

sing-box 文档站在苹果平台功能页的 Chore 段写的是「Crash logs is located in Settings -> View Service Log」。这个入口对 SFI、SFM、SFT 三个客户端都适用,分别对应 iOS、macOS 和 Apple tvOS。服务日志页面的具体布局和按钮,文档没有配图说明,打开后以你看到的界面为准。

为什么叫服务日志 ​

结论:苹果版真正干活的是扩展进程,服务日志记录的就是它。

文档的描述是,转发流量的是 NetworkExtension 扩展,扩展可以是 Application Extension,也可以是 System Extension;TUN 由它提供,不需要额外权限,接口名交给 Darwin 管。换句话说,你点开的 App 界面和真正转发流量的部分并不是同一个进程。界面看起来一切正常、流量却不通,或者界面里开关自己弹回去,原因多半要到服务日志里找。

服务日志和配置里的运行日志 ​

结论:服务日志看崩溃,配置 log 段控制运行日志的详细程度。

日志详细程度由配置文件里的 log.level 决定,从最详细到最简略依次是 trace、debug、info、warn、error、fatal、panic;log.output 可以另外指定一个写入文件。我排查连不上时的习惯是:先把等级降到 debug,断开再连一次让问题重现,然后回到 View Service Log 翻看。看到的内容寥寥无几,多半是等级停在 error 这类偏高的档位。

macOS 版的日志文件具体落在磁盘哪个目录,本次查阅的文档没有提到。我不在这里给猜测的路径,能确定的入口就是设置页里的这一项。

先对照苹果版不支持的配置字段 ​

结论:电脑上能用的配置拿到苹果设备上异常,先查是不是用了苹果版没实现的选项。

文档的苹果平台功能表里,TUN 的 address 和 mtu 可用,而 auto_route、strict_route、include_interface、exclude_interface 等路由与接口过滤选项标为 Not implemented。规则匹配方面,凡是按进程名、进程路径、包名或系统用户来分流的条件,只有 macOS 独立版和 iOS 越狱版能用;按 Wi-Fi 名称和 BSSID 匹配的条件只在 iOS 上有效。

界面上还有几个和连接行为相关的开关:Always On,以及让局域网和蜂窝服务流量也走代理的 Include All Networks。Apple TV 上可以从 iPhone 或 iPad 导入配置。排查时把这些开关的状态一起记下来,提问时能省掉一轮来回。

要是连配置都没导进来、远程配置一直更新失败,那属于订阅环节,参考 订阅拉取失败的排查顺序。

装的是不是官方渠道的版本 ​

结论:先确认安装来源,再谈日志。

系统方面,文档要求 iOS 15.0 起、macOS 13.0 起、Apple tvOS 17.0 起,并且要用中国大陆以外的 Apple 账号。下载渠道有 App Store(iOS 与 Apple tvOS)、TestFlight(Beta,名额只给赞助者)、越狱 iOS 用的 deb 包,以及 macOS 独立版(brew install sfm,或者项目发布页下载)。各渠道版本的功能不完全一样,比如进程匹配只有独立版和越狱版才有。如果你在 iPhone 上用的其实是 Shadowrocket 而不是 sing-box 客户端,这一页的入口不适用,配置思路可以看 Shadowrocket 使用说明。

还解决不了:带上服务日志提 issue ​

准备三样东西再去 SagerNet 的仓库开 issue:服务日志里出错前后那一段、设备的系统版本号、能稳定重现问题的最小配置。贴配置前把节点地址、UUID 或密码这类信息抹掉。

常见问题 ​

sing-box 苹果客户端的崩溃日志在哪里看? ​

入口是客户端里的 Settings -> View Service Log,文档在苹果平台功能页的 Chore 段写明了这一点。

SFI、SFM、SFT 分别是什么? ​

文档把苹果平台客户端统称为 sing-box for Apple platforms,SFI、SFM、SFT 对应 iOS、macOS 和 Apple tvOS 三个平台。

Mac 上的日志文件存在哪个目录? ​

本次查阅的 sing-box 文档没有写 macOS 版日志文件的落盘路径,能确定的入口只有 Settings 里的 View Service Log。

服务日志里内容太少怎么办? ​

把 log.level 降到 debug 或 trace,断开重连让问题再出现一次,然后回到服务日志查看。

为什么同一份配置在电脑上能用,在 iPhone 上不行? ​

苹果版靠扩展进程转发,文档把 auto_route、strict_route 等多项 TUN 选项标为 Not implemented,进程匹配也只在 macOS 独立版和 iOS 越狱版可用。

安装苹果版客户端有什么前提? ​

系统要求是 iOS 15.0 起、macOS 13.0 起或 Apple tvOS 17.0 起,另需要中国大陆以外的 Apple 账号。

机场推荐排行榜 2026 · 便宜机场推荐 · 专线机场推荐 · 稳定机场推荐
本站内容仅供学习交流,请遵守当地法律法规。本站与部分服务商存在联盟推广关系,标注「站长主推」的栏目为商业推荐位;本站不做速度实测,收录名单中没有采集记录的字段显示「未采集」,详见「关于本站」的利益披露。发现内容有误欢迎通过「联系与反馈」指出。