Repository navigation
v4.9.1
4.9.0 发布后的全仓复审(自审并发状态机全线 + 三个分模块深审,重要线索逐条实测或回上游源码核实)。修掉 15 项:入站/控制面安全边界(含复审末尾回上游 General 段补出的 tuic-server/external-doh-server)、一条热重载自愈缺口,其余是一致性收口。单测 599(+48)。
安全
- 订阅可偷偷开出第二个、无鉴权的 external-controller,甚至一个入站代理服务端。4.9.0 把
redir-port/tproxy-port补进锁定删除清单时,漏了整个入站/控制面家族:上游config.go的 General 键external-controller-tls(配合顶层tls:段给证书即可在0.0.0.0再开一个 TLS 控制器)、external-controller-unix(任意路径 unix socket 控制器,无前置条件)、-pipe/-routing-mark、external-controller-cors(直接放宽现有回环控制器的浏览器跨域)、external-doh-server(控制器上挂 DoH 端点)、tuic-server(完整入站代理服务端,配置内嵌证书/认证字段,订阅借此可把本机变成监听全网卡的开放代理——比透明端口严重)。订阅是远端不可信内容,而 CLI 又剥掉订阅自带的secret、默认不设密钥——机场可让同网段设备或任意网页直接操作内核,打破 README「控制器仅监听回环」「入站由 mixed/tun 托管」两条承诺。锁定项收成LOCKED_CONFIG_KEYS一张表(含顶层tls证书段),Mixed/TUN 共用;以后新增入站/控制器键只改这一处,不再零散 delete。每个键已对照上游MetaCubeX/mihomo源码确认内核识别,行为实测。listeners/tunnels两个通用入站声明与iptables(Linux 专用)本版不锁——前两者是否允许订阅投递是未定产品决策、须一起评估,已记入 CODE_REVIEW 并用测试锁住现状 - 锁定项告警源只对订阅、会对真实机场订阅刷屏。最初实现对订阅与覆写一视同仁地告警,但机场订阅几乎必带
mixed-port/socks-port等端口段,系统约束接管订阅入站本就是核心设计、用户没有行动手段——每个用户每次启动都会看到一条无法消除的黄字。改为剥除不看来源、告警只对生效的覆写文件(亲手写覆写的用户才会以为键生效),文案带文件名并识别+key/key!操作符形式;未命中当前订阅作用域的覆写不告警。热重载请求的 Authorization 头同步加字符串类型守护
修复
- 热重载探测的首个状态查询在兜底 try 之外:
tryHotReload里的getServiceStatus()(launchctl print/print-disabled,可能退 112/125 或超时)一旦抛错,不履行函数注释「返回 false 即回退 kickstart」的契约,而是让start/sub use/ow整体失败——launchd 病态时恰恰最需要 kickstart 自愈。探测全程(含getPorts)收入 try,桩 launchctl 计数场景(入口查询成功、热重载查询退 112、kickstart 后恢复 running)端到端验证回退并通过健康确认;反向验证:查询移回 try 外用例即红 - zsh/fish 补全卸载的身份指纹过弱:zsh 指纹是
#compdef mihomo——这是 compinit 对每个_mihomo补全要求的固定首行,用户手写或第三方分发的同名补全必然以它开头,completion uninstall zsh会误删别人的文件,与函数注释的保护承诺相反。指纹改为本工具独有的完整行#compdef mihomo mhm mh mihomo-cli;fish 同族收紧到四别名循环行。两条「弱指纹文件拒绝删除」用例锁死,反向验证旧指纹即红 - 非字符串
controller_secret绕过脱敏:settings.json 手误写成数字/布尔时,config两个出口的typeof === 'string'条件都不成立、明文上屏(config不跑内核校验)。buildConfig唯一消费点对齐getPorts的 fail-closed:非字符串直接报「配置错误」;展示侧脱敏也不再依赖类型判断 - 内核下载的 curl 没有
--fail-with-body:镜像/CDN 返回 404/500 的 HTML 错误页时退出码 0、错误内容落盘,最终只报「文件大小与 release 元数据不符」,真正的 HTTP 原因丢失(4.9.0 只修了 release API 查询通道)。下载通道对齐;退出码 22 翻译为「镜像或服务器返回 HTTP 错误」 - tar 解压无总量上限(压缩炸弹):
--max-filesize只卡压缩后体积,高压缩比 tar 可解压上千倍撑满磁盘,而镜像通道不可信、产物又以 root 运行。tar -tvzf列表阶段汇总条目字节(parseTarEntrySize同时认 bsdtar/GNU 两种列布局),超 512MB 拒绝解压;.gz单文件路径原有 256MB maxBuffer 兜底 - 内核校验超时分支的 hint 仍引导「修正订阅或覆写」:超时与配置内容无关,也不该附覆写清单;
buildKernelRejectHint加timedOut形态,尾行指向内核/系统异常 - 命令层空串与选项口径不齐:
ui ""、dir open ""(变量展开为空的笔误)此前静默走默认(打开 zash/根目录),改为未知名称/目标报错;UI 名称统一小写归一(ui DASH等价 dash,抽出resolveUiName纯函数与resolveStartMode同范式);sub update ""此前静默更新所有订阅(还可能触网),改为报「请指定名称」与无参区分;sub use/ow on|off的-u即使未运行、不触发重启也先校验(ow on -u缺值不再静默成功,新增assertRestartOptionValues);kernel --mirror x --mirror y显式报「只能指定一次」而非取第一个;裸ow -s/dir -x在子命令位置给「未知的选项」文案;Ctrl+C 的「正在退出...」改走 stderr,不再污染status --json/config --json的 stdout - settings.json/cache.json 损坏备份只有一份且会被覆盖:「损坏→备份原件→回退默认写回→再次损坏」会用默认内容/新损坏盖掉唯一的用户原件;
.bak已存在时保留更早那份,警告文案说明 - 补全词表/选项漂移:reset 补全只给主名不给命令实际接受的别名(
sub/log/ow/config/core),改为从同一别名表派生;三 shell 都漏了--yes;fish 把-y与--full错绑成一行(-s y -l full让 --full 的短写变成 y),拆为两个独立选项;fish 安装位置不认XDG_CONFIG_HOME,设了就落在其下的fish/completions
行为变更
config --json输出改为信封{ "config": {...}, "warnings": [...] }:4.9.0 把 warnings 铺在顶层,会顶替配置自身的同名顶层键(mihomo 无此键,危害仅限输出与 YAML 出口不一致),且让「JSON 内容 = start 写入内容」少了一半。信封与 YAML 出口的「配置正文 + 提示段」同构;无警告时warnings仍是空数组。4.9.0 同日发布,预计无下游消费者- 矛盾的覆写操作符组合显式报错:
+rules+(前插+追加)、~dns!(按名合并+整体覆盖,显式!被静默忽略)、<x>+!等此前按分支优先级静默取其一;裸+:/~:/!:产出空字符串顶层键(内核忽略,笔误零反馈),一并报错。~?仍是~的变体不算组合,<+key>!等合法单一操作符不受影响
复审排除项(实测后判定不是缺陷)
- 子审查报「
sudo pkill -f <PATTERN>会匹配自己的命令行杀掉 sudo 父进程」:对照实验证明真实 pattern 不自匹配——escapeRegExp把点转义成config\.yaml,命令行里出现的是带反斜杠的正则源码、正则却要匹配字面点(对照组把\.换回.立刻自匹配)。三个 root 脚本同此结论,不加行首锚 - 文件锁强夺/释放是 stat→unlink 两步、不复核 inode:仅在等待者被冻结(合盖/换出)且系统时钟前跳时可利用,微秒级窗口,记为已知理论缺口,不为此加机制
- 两个 start 互相并发的「假失败」窗口、矛盾的
start tun/start并发:不受支持的并发操作,终态仍由后执行者决定、doctor 可诊断,与已记录的 kickstart 交错同类