路由器配置不只由管理网关修改,定时更新、安装和命令行脚本也会接触同一份状态。新配置启动失败时,恢复一个文件也未必能让界面与实际运行重新一致。
本篇以 singbox-merlin 0.5.42 为例,讲跨进程锁的保护范围和回滚对象,并解释为什么代理内核停止后,管理面板仍然必须可用。保存与应用是两个阶段:应用失败可以恢复旧运行配置,同时保留已保存设置供修改。
一、进程内互斥锁挡不住定时更新
管理网关可以在 Go 进程里使用互斥锁,但定时更新、安装和其他 Shell 操作不在同一个进程中。
此前保存路径存在一个空隙:DBus 已开始写入,脚本却还没有取得更新锁。与此同时,定时任务可能读到正在变化的设置,用它生成另一份配置。
修复后,设置写入与脚本执行共用跨进程更新锁,并在脚本运行期间交接锁所有者。安装流程也要检查停止结果,不能在停止失败后继续覆盖文件。
需要保护的是整个共享状态修改过程:读取设置、写入设置、生成候选配置、切换文件和应用配置。只锁最后的重启命令,前面的输入仍然可能互相覆盖。
这次让我重新确认了一点:判断锁是否有效,要先列出所有会修改同一份状态的入口。
internal/gateway/operation.go 的函数顺序直接体现了保护范围,以下保留原实现中的关键调用:
release, err := g.acquireUpdateLock()
if err != nil {
return "", err
}
defer release()
if prepare != nil {
if err := prepare(); err != nil {
return "", err
}
}
return g.executeScript(action, timeout, env)
prepare 包含设置修改,因此它必须在取得跨进程锁之后执行。defer release() 让正常返回和错误返回都走释放逻辑。
这个锁使用共享目录,并记录拥有者 PID。目录创建是竞争入口,PID 用来判断已有锁的进程状态。代码还保护刚创建但尚未写入 PID 的空目录,避免另一个进程把“正在初始化的锁”误当成废弃锁删除。
学习这类实现时,除了互斥本身,还要看获得锁到登记拥有者之间的空隙,以及释放时是否仍然属于本进程。
二、回滚需要同时恢复配置和元数据
新内核启动失败后恢复旧配置文件,是必要动作,但还不够。
项目还保存订阅信息和生成报告。如果只恢复主配置,页面可能展示新订阅的节点数量,内核却在运行旧节点。用户看到的状态与实际运行状态就会分离。
这次在切换候选配置前备份相关元数据,失败后同时恢复主配置、订阅信息和报告,并检查候选文件换入是否成功。启动、重启以及成功回滚后,也会同步定时更新任务,让设置与 cron 保持一致。
回滚的对象需要按运行状态整理,而不是只盯住最显眼的配置文件。凡是页面和脚本用来解释“当前在运行什么”的数据,都需要检查恢复关系。
三、内核停止后,管理面板还得打开
之前的一条依赖链是:面板资源经过 sing-box 内核提供。内核停止或重启后刷新页面,管理页面也跟着无法打开。
这会直接阻断恢复操作。用户想重新启动内核,却先失去了启动入口。
改造后,管理网关直接提供安装包内的 /ui/ 资源。代理内核停止,管理入口仍然可以工作。入口还需要避免引用已经失效的旧资源文件。
同时,在线更新器不能直接下载上游 Zashboard 覆盖定制面板。当前面板包含路由器配置、节点地区编辑和任务恢复能力,更新它需要通过插件安装包完成。
这两项处理共同明确了管理界面和代理内核的关系:管理界面需要在代理故障时继续提供恢复能力。
四、回归验证与真机边界
仓库记录包含网关竞态测试、跨进程锁与任务测试,以及 ARM64 打包和隔离安装回归。安装回归通过 QEMU 执行 ARM64 网关与真实核心配置检查,运行阶段使用模拟核心和防火墙命令,本轮没有连接路由器部署。
因此,这些记录可以支撑文件切换、元数据恢复和停机面板等路径的判断,真实 TUN、TPROXY 转发、固件或磁盘错误和实际断网恢复仍需真机验证。
读代码时先从 internal/gateway/operation.go 的 executeOperation 确认锁先于设置修改,再沿脚本检查候选配置与备份恢复。完整边界记录在 docs/review-save-start-2026-10-03.md,不能用项目其他功能的历史真机记录替代本轮验收。
本系列对应仓库目前为私有,代码片段取自已核对的实现;删去的字段或流程已在相关段落注明。