 liuzhuohua
|
309be8b0a5
|
feat(snapshot): 快照可单独上锁 + 备注事后可改，全部并入紧急救援通道页
用户反馈的四件事一次做完：
1. 给快照加保护（单份上锁，自动清理一律跳过）
2. 说明「手动快照受保护不被清理」，并讲清它与上锁的区别
3. 快照备注事后可改（此前只能在创建时填，存下来就只能看不能改）
4. 列表从「配置快照与回滚」卡片搬进「紧急救援通道」，回滚入口不再弹残缺弹窗
protected 与 keep_manual 是两件事，必须分开：
- keep_manual 是全局策略，按 tag.startswith('auto') 猜来源
- protected 是用户对这一份的显式意图，跨策略生效
判据只能加在删除分支上，混进 auto 算法的话，受保护的自动快照
会开始占 keep_count 配额，把别的自动快照挤掉 —— 用户设「保留 5 份」
却只剩 4 份，且没有任何提示。
上锁不等于删不掉：删受保护的那份时后端回 needs_force，前端弹二次确认
后带 force 重试。审计里标注「受保护，已强制删除」，否则事后只看得到
「删了快照」，看不出删的是用户特意保下来的那份。
meta 用 .tmp + os.replace 原子写 —— meta 是 prune 唯一的判据来源，
写到一半被打断会留下解析不了的残文件，之后那份快照既不会被清理，
也上不了锁（读不到就当没保护）。
备注消毒：控制字符一律换成空格而不是删掉。删掉会把「甲 BEL 乙」
变成「甲乙」，两个词粘成一坨，而用户看到的备注莫名其妙。
真机验收（40 项全绿）当场抓到两个本地回归漏掉的真 bug：
- 备注消毒把制表符删掉而不是换空格：'a\\nb\\tc' 变成 'ab c'
本地判据只写「不含换行和制表符」，恰好放过 —— 「没有危险字符」
和「内容没被偷偷改掉」是两件事
- web 层无条件写 'protected': b.get('protected')，
payload 里这个键永远在（值可能是 None），helper 的
`if 'protected' in p` 恒成立，「不传就取反」从 HTTP 路上彻底失效
两个都补了反向验证（注入后必须观察到红）。
顺带修掉一个既存缺陷：t-107.py 里的 js_code_only 一直在吃 app.js
的真代码 —— 用 re.sub 块注释优先、再剥行注释，而 app.js 8222 行有一句
讲「怎么防止 CSS 注释被提前闭合」的行注释，注释里写着块注释的起止符
字面量，于是被当成真注释开头一路吃到文件尾。
证据：块注释起始 169 次而结束 170 次，数量不等就是配对错位一格。
HEAD 版同样中招（163/164），所以不是本轮引入。
换成 _dev/jsstrip.py 的词法扫描版（正确处理模板串的插值、正则字面量、
prev 记 token 尾词而不是一个字符），并加 node 侧 V8 交叉验证。
|
2026-10-03 14:22:14 +08:00 |
|
|
liuzhuohua
|
2f8f09604b
|
release: 1.0.8 — VPN 页把「模块没加载」误报成「内核不支持 WireGuard」
版本号 1.0.7 → 1.0.8（19 个文件 55 处，逐条过；历史陈述不动）。
顺带补上1.0.7 漏掉的更新日志小节（那一版只改了版本号）。
## 本轮修的缺陷
**先说结论：Debian 13 虚拟机上跑 drouter，KVM 不是容器，
内核里一直有 WireGuard —— 是面板自己判错了。**
原 _vpn_installed() 只看两件事：/sys/module/wireguard 在不在（模块当前
已加载）、/usr/bin/wg 在不在（工具已安装）。**从没查过 /lib/modules 下
有没有模块文件** → 「模块文件在但没加载」被压进「内核真没这个模块」。
而 Debian 走 udev 按需加载，/etc/modules 与 /etc/modules-load.d 默认都
不写 wireguard，模块在磁盘上但没进内存。本机实测：内核 6.12.107+deb13-amd64，
wireguard.ko.xz 在，未加载；wireguard-tools 也没装。
前端还配了一句写死的文案把它坐实：「通常说明跑在精简容器里」——
而这台是 PVE 上的 KVM 虚拟机。排查方向被这句话整个带偏。
修法：
- 判据扩到四态（ready / need_module / need_tool / unsupported），
每态给可执行的下一步。unsupported 明确说装不了且不给一键修复。
- 模块文件名覆盖 .ko / .ko.xz / .ko.zst（Debian 默认压成 .ko.xz，
只认 .ko 会把正常机器也判成 unsupported）
- 新增「一键修复」：modprobe → 写 /etc/modules-load.d/ 开机自启 →
缺工具则 apt-get install，确认弹窗写清三步并告知不动网络
- apply 改为先自愈再报错，不再直接弹「内核不支持」把人挡在门外
- 老后端兜底 unknown 而非把旧的 no 猜成 unsupported（猜错=复活本 bug）
- 页面新增「运行环境」行；改掉「不需要装任何第三方软件」这句误导
## 测试基建：这轮抓出 3 条恒绿断言 + 1 处死分支
反向验证（把 bug 注入回去看它变红）逮到三条永远不会红的断言：
把探测路径改成 /nonexistent 仍全绿（docstring 里就写着那句话）；
把 'env': _vpn_env() 注释掉仍全绿（我写的是 #注释，正则照样匹配）；
把 if (!confirm( 改成 if (false && confirm( 仍全绿（提示文案里有那句话）。
根因：习惯在注释里引用被删掉的旧代码来解释 bug 来历，这些字面量让
「这段代码还在吗」类的判据永远成立。修法：t-107 统一走 py_code_only() /
js_code_only()（先按ast 判语义剥 docstring，再剥行注释），16 个注入全部被抓住。
死分支：用小锚点 Edit 只替换 if (d.installed === 'no') { 这一行时，
旧 body 与它的 } else if (!d.has_systemd) { 原样留在原地，拼出一个
「没有 systemd → 报内核不支持」的假分支——语法合法、静态检查也过。
防线：断言 } else if ( 的数量恰好等于分支数。
另有 4 处判据写错导致假红，共同形态是「脚本假设了一个修好之后就不成立
的前提」——比如「模块必须未加载」这条，fix 一跑完就假红。
## 验证
- t-107：126 → 167 项
- 反向验证 16/16 被抓住
- 新增 devtools/check-vpn-render.js 36 项（挂进 sync.sh 预检链）
- 新增 _dev/live-108-wg.py 真机验收 43 项；真机 _vpn_env 从 need_module
修到 ready，wg 装上（v1.0.20210914），modules-load.d 已写入
- t-*.py 51 个全绿 / 静态检查器 39 个全绿 / 前端四查全绿 / md 0 死链
- 容器冒烟新增第 14 节：镜像里真跑 _vpn_env() 验四态判定
（不 grep 字面量——注释里也会写这些词）
- deb 内 helper 与 app.js sha256 与本地逐字节一致
|
2026-10-03 12:28:21 +08:00 |
|
|
liuzhuohua
|
e1125e3978
|
release: 1.0.7 — 备份/告警/配额三模块收尾 + 真机再抓 3 个真缺陷
版本号 1.0.6 → 1.0.7（13 个文件 55 处，逐条过；历史陈述不动）。
## 本轮又修的 3 个真缺陷（都是真机 API 验收才暴露的）
静态检查全绿、函数级测试 29/29 全过，接口一打就红：
1. 备份包名校验正则比命名规则窄 → 导出的包自己都认不出
命名 charset 是 [A-Za-z0-9_-]，校验只写 [a-z0-9]+，
而 Debian 默认主机名 debian-primaryrouter 带连字符
→ 导出了、界面显示「已导出」，但列表里看不到、永远还原不了。
修完才发现 _bk_list_entries 里还有第二份同样的正则（漏改），
已让它直接调用 _bk_safe_name()。
2. inspect 把 manifest 的 sha256 弄丢了→ 20 项全部标「已损坏」
重建 row 时没搬 sha256，下一行又拿 row.get('sha256') 比实际哈希
→ 恒为 None ≠ 哈希。还原也被「内容与清单不符」挡死。
3. 清单重叠 → 同一个文件进包两次
SNAPSHOT_ETC_FILES 含 rescue.conf、SNAPSHOT_ETC_DIRS 含整个
/etc/drouter → 同一 arcname 写两遍 tar（后者覆盖，不报错），
file_count / total_bytes 虚高一倍。真机证据：22 项 → 20 项。
## 测试防线（新增 7 条断言，全部做过反向验证）
把 bug 注入回去看它变红、还原后变绿 —— 没反向验证过的断言
可能因抽取失败而恒绿：
- 校验规则与命名规则同源（charset + 长度）
- 该正则在 helper 里只有一份（列表不再自抄）
- inspect 把 sha256 带进了 row / 比对的是 row 里那个 / 还原侧仍用 it.get
- 打包时按 arcname 跨组去重 + 清单确有「文件 ⊂ 目录」重叠项
- OK_NAMES 补真实主机名形态（原用例只有无连字符的 debian）
t-107：119 → 126 项。
## 真机验收
- 新增 _dev/live-107-api.py（26 项，HTTP 接口层）
- _dev/live-107.py 29 项、live-107-api.py 26 项，全绿
- 基线零变化：网关 192.168.7.2 / nft 0 行 / dnsmasq inactive+disabled
/ rescue inactive / ip_forward=1 / netavark 表已回收
- deb 511,624 B；解包抽查三个新守护在 backend/、helper sha 与本地一致
## 产物校验
- 离线包 sha256sum -c 238/238 通过
- 包内 deb 与独立产物 sha256 一致（c1ebcf17…）
- deb / 离线包 远端↔本地 sha256 逐一对齐
## 顺手
- README 体积数字按 stat 实算改成 500 KB（原文写的是 453 KB）
- smoke-docker-106.sh → smoke-docker-107.sh，新增第 12/13 节
（容器里三个新守护有不依赖 init 的拉起路径 + 镜像 Python 必须是 3.13）
- wireguard-tools 补进 DEPS 三处（helper / make-offline-deps / deb control）
|
2026-10-03 02:54:04 +08:00 |
|
|
liuzhuohua
|
249cc3d8c6
|
feat(backup/alert/quota/vpn): 新增四个模块 + 深度自查修7 个真缺陷
功能
- 配置备份与还原（backupd）：分级导出/预览/还原，敏感内容默认排除
- 告警中心（alertd）：WAN掉线/延迟/丢包探测，冷却期+ 免打扰
- 流量配额（quotad）：按 IP/服务/小时桶聚合，费用分摊
- VPN 页前端接线 + 前端字段契约补齐
自查发现并修复的缺陷（_dev/t-107.py，119 项）
1. 默认备份静默丢失大半配置（严重）
_bk_files 把整个 /etc/drouter 标为 sensitive，默认导出时被整目录排除，
而 BACKUP_SCOPE 恰恰宣称备份含 dcfg.json / kern.conf / vlans.json /
Docker 栈文件 / 自定义主题。界面全程显示「已导出」，用户换机还原才发现。
改为逐文件判定（_bk_is_sensitive）+ 敏感子树剪枝 + excluded 收集与展示。
2. VPN status 把全部客户端私钥明文送到浏览器
_vpn_status 返回 'raw': d（完整配置），前端 4 个渲染函数一个都没读过它。
3. Python 3.13 下保存 VPN 配置静默清空所有 peer（隐蔽）
'str' in ip_network() 在 3.12 静默 False，3.13 抛 AttributeError，
被紧邻的 except 吞掉 → 所有客户端无声消失。Debian 13 默认就是 3.13。
4. VPN 私钥在 _vpn_mask 里被连同其他字段一起抹掉
5. 14 处前端属性插值未转义（备份/告警/VPN/配额页）
type="number" 只过滤输入，不阻止 HTML 属性注入。
6. wireguard 未登记到 DEPS（VPN 有 5 处调 wg，自检页看不到缺失提示）
7. build-deb.sh 声明「后端 N 个」与实际清单不符 + ULOG_ARCHIVE 重复定义
测试基建
- _dev/t-107.py：字段契约双向对照 / op 三段对齐 / 高危路径端到端
（真跑 _bk_walk、_vpn_norm、配额聚合，不用正则假装测过）
- _dev/run-static.py + scripts/test-static.sh：统一静态回归入口
排除列表曾写成裸名导致交互脚本没被排除、长会话被 SIGTERM
- t-packaging 改为从 build-deb.sh 抽取模块清单，并反向校验无游离模块
|
2026-10-03 00:49:07 +08:00 |
|