okooooooo/drouter
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
38 Commits 1 Branch 0 Tags
main
Commit Graph
4 Commits
Author SHA1 Message Date
liuzhuohua 6df3a94b90 适配 arm64 Debian（Armbian 26.8.1 trixie）：去掉架构假设 
有用户要在 arm64 的 Debian 上跑 drouter。这一轮只对一个发行版做了适配
—— Armbian 26.8.1 trixie（Debian 13.6）/ aarch64 / 内核 6.18.35-ophub
（Amlogic S912 板），别的 arm64 发行版未验证，验证范围与实测数据全部
写在 docs/07-arm64-适配说明.md。

改掉的四处 x86 假设：

1. helper._read_bios()：ARM 板既无 /sys/firmware/efi 也无 /sys/class/dmi，
   原代码把它们一律落到 else 分支，系统概览显示「传统 BIOS」（错的，
   这类机器根本没有 BIOS）。新增设备树分支，判据顺序 EFI → 设备树 → BIOS
   （树莓派 4 这类两可的机器要优先认 EFI）；读 /proc/device-tree 与
   /sys/firmware/devicetree 两个候选路径，compatible 按 NUL 切开取第一条；
   没有 DMI 厂商时拿设备树板名顶上，厂商格不再空白。返回结构加 fw_type
   / is_dt / compat，旧字段一个没动。

2. update.py：离线包资源名原先写死 -offline-amd64，arm64 机器点一键更新
   会下载 x86 离线包，传几十 MB 才在装包阶段炸依赖。改为按
   dpkg --print-architecture 拼名（_deb_arch / build_assets），并为带架构
   后缀的附件在下载前先拿官方 SHA256SUMS 核对存在性，没有就明确报错。

3. packaging：离线包说明里两处写死的 amd64 换成 $ARCH（包名早就是变量拼的，
   但包里那份 README 还在教用户核对 amd64）；build-docker.sh 新增可选的
   第 2 个参数 [arch]，交叉构建时加 --platform 并给标签加 -<arch> 后缀，
   不传第二参数时行为与改动前逐字节一致。

4. web/i18n.js：给新增的「设备树 (Device Tree)」展示串登记英文，
   否则英文界面漏中文。

配套：
- _dev/t-arch.py（31 条判据）+ _dev/t-arch-inject.py（20 例反向验证）。
  反向验证抓出一条假绿：i18n 词条的 n/d 判据用了 300 字符松弛窗口，
  会跨到下一条词条，删掉本词条的 d 之后照样绿 —— 已收紧为本词条花括号内。
- _dev/run-static.py 的 EXCL 补上 t-update-inject —— 它名字也是 t- 前缀，
  之前一直被全量回归自动执行，会在回归过程中反复改写 backend/ 与 web/。
- devtools/verify-arm64.py：只读验收脚本，方便他人在自己的板子上复验。
- README 支持矩阵里 arm64 从「理论可用」改为「已实测 1 个发行版」。

本机全量静态回归 71 个检查器 / 0 失败；目标机上只读验证 12 条全通
（构建 753 396 字节的 deb / depcheck 73 项 / 8 个渲染模块 / 架构感知清单）。
目标机未安装 drouter，未启用任何服务，未改动网络。
 2026-10-16 06:16:31 +08:00
liuzhuohua b7ca9c89e8 feat(i18n/layout): 全站中英双语 + 四轮排版修复收官 + 修 boot_id 重启检测 
v1.0.10 两件大事：

1. 界面中英双语（英文界面无中文残留）
   - 新增 web/i18n.js（约 4200 条词条），零依赖零构建
   - 后端下发中文数据走 bt4() 查表翻译；独立模块（upstream/netdetail/
     realtime/update）纳入翻译并注册切语言重绘钩子
   - 后端「状态/聚合」接口只回稳定枚举+原始数值，不下发中文文案
   - 顺带修一个真实 XSS：顶层 const 不挂 window，独立脚本 esc 静默退化成零转义

2. 修掉「文字竖着排/错位」（多分辨率反复暴露）
   - 单元格 min-content 只有 1 字宽 → word-break:keep-all + 表头 nowrap
   - 依赖卡片正文被标签/按钮挤成 27px → .dep-body{flex:1 1 200px} + flex-wrap
   - 裸 flex:1（下限为0）给正文 → 一律改 flex:1 1 <px>
   - .dep-item 横向容器直接塞块级子项 → 退回块级
   - 关键陷阱：auto-fill 布局屏越宽列数越多单卡越窄，窄屏反而测不出来，
     真机审计推进到「逐视图点按钮 + 1920/2560 宽视口 + 中英双语」
   - 守卫 t-layout.py 扩到 35 条，12 处反向验证全红

3. 修真缺陷：_link_since() 重启检测被误改成 if False:（注释还写着「已修」），
   uptime 归零后相减得负数 → 恢复比对 boot_id

附带：新增 25 个检查器（t-*.py）、排版审计工具链（shot-*/ocr-*/live-*）、
版本号兜底值同步到 1.0.10、.gitignore 收纳 i18n/排版排查的一次性脚本。
 2026-10-10 04:50:32 +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 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