Repository navigation
Releases
Releases · LianXia233/luci-app-mt5700
AT WebServer v1.32.10
权限门禁加固版 —— 修复 Shebang 校验放行 UTF-8 BOM 与前导空白的假阴性,把「执行入口目录内每个脚本都必须登记」变成反向断言,并让权限清单覆盖仓库真实可执行面。只改 CI 门禁、测试脚本与文档,运行时脚本与页面渲染不变。
为什么改
- #54 的人工审查确认门禁方向正确,但
isValidShebang对首行做.trim(),会把 UTF-8 BOM 和前导空格/Tab 一起吃掉。内核只认文件头两字节#!,BOM+LF 不含\r\n,原有 CRLF 断言与static-check第 3 项都拦不住;BOM 恰是 Windows 编辑器的典型产物,正落在门禁声称要防的威胁模型内。实测修复前script-mode-test与static-check双双放行,修复后均失败。 - 原 7 项白名单与仓库实际 11 个 100755 blob 不重合,清单外 4 个全在
tests/mock-modem/;本仓库执行位回退已多次发生,「新增时记得登记」的注释约束正是历史上失效的那一类,因此把登记完整性本身变成断言。
主要改动
- test(ci)
isValidShebang不再 trim 首行,显式拒绝 BOM 与前导空白,只去掉行尾 CR;hasUtf8Bom抽成共用函数(字符串 / Buffer 均可);static-check第 3 项由「行尾 LF」强化为「LF 且无 UTF-8 BOM」,覆盖全部 353 个文本文件;失败诊断用JSON.stringify输出原始首行。 - test(ci) 清单补齐至 12 项(含
run-sim.sh);新增EXEC_ONLY_DIRS反向断言并并入static-check第 5 项(含子目录递归,失败指名路径);检查项仍为五项,只增强不新增。 - test(ci)
NON_SHELL_EXECUTABLES标出两个#!/usr/bin/env node入口,SHELL_SCRIPTS由主清单 filter 派生,权限与 Shebang 职责解耦,漏登记例外会 fail loud。 - fix(test)
git ls-files -z --避免core.quotePathoctal 转义误判中文路径、只认 stage 0、保留 stderr 与spawnSyncerror;无 git 降级改为console.warn出声,不再静默 PASS。 - docs(ci)
checks.yml明确权限位 / 登记完整性归static-check、Shebang / LF / BOM 归tests/script-mode-test.js,同步 BOM 口径与符号链接说明;仅改注释与 step 名。 - chore(release) 版本号 1.32.9 → 1.32.10,按 AGENTS.md 清单同步全部版本引用与文档下载入口。
验证记录
- PR #55 的 3 项 CI(静态检查与单元测试 / 第三方依赖许可证审计 / Rust 单元测试)全部通过;合并前
mergeable_state=clean。 - 合并前独立复核:还原 PR head 后
node tests/static-check.js得ALL 5 PASSED,24 个零依赖tests/*-test.js全部通过(24 PASS / 0 FAIL);逐项核对 BOM 与前导空白拒绝、-z索引解析、执行入口目录反向断言、权限与 Shebang 清单解耦。 - PR 描述中的注入式反向验证:BOM + LF、前导空格、执行位回退、未登记新脚本、非 ASCII 路径、无 git 降级、跨 cwd、Windows Git Bash 均按预期触发;所有注入均已复原。
- 未验证项:BOM / 前导空白导致
execveENOEXEC的设备侧后果按内核语义推断,未上真机验证;本版不改运行时脚本,Rust 侧未触及。
升级提示
- 覆盖安装即可,无配置迁移、无接口变化。
MT5700_UI_VERSION1.32.9 → 1.32.10,浏览器模块缓存整体失效;若个别入口页仍是旧样式,按 compat.js 的兜底方案硬刷新一次(Ctrl+F5)。 - 本次发版后,Releases 中
v*组只保留 v1.32.10;历史版本的 git tag 仍在,可随时追溯对应提交。
安装(复制即用,v1.32.10)
先确认设备架构:cat /etc/apk/arch;opkg 系统用 grep OPENWRT_ARCH /etc/openwrt_release。
x86_64(x86 软路由 / 虚拟机)
国内加速(推荐,前缀 https://gh.acg2.mom/)
wget -O /tmp/mt5700.apk "https://gh.acg2.mom/https://github.com/LianXia233/luci-app-mt5700/releases/download/v1.32.10/x86_64-luci-app-mt5700-1.32.10-r1.apk" \
&& wget -O /tmp/mt5700-i18n.apk "https://gh.acg2.mom/https://github.com/LianXia233/luci-app-mt5700/releases/download/v1.32.10/x86_64-luci-i18n-mt5700-zh-cn-0.261113.67177.apk" \
&& apk add --allow-untrusted /tmp/mt5700.apk /tmp/mt5700-i18n.apk直连(不带前缀)
wget -O /tmp/mt5700.apk "https://github.com/LianXia233/luci-app-mt5700/releases/download/v1.32.10/x86_64-luci-app-mt5700-1.32.10-r1.apk" \
&& wget -O /tmp/mt5700-i18n.apk "https://github.com/LianXia233/luci-app-mt5700/releases/download/v1.32.10/x86_64-luci-i18n-mt5700-zh-cn-0.261113.67177.apk" \
&& apk add --allow-untrusted /tmp/mt5700.apk /tmp/mt5700-i18n.apkaarch64_cortex-a53(ImmortalWrt、OpenWrt mediatek-filogic)
国内加速(推荐,前缀 https://gh.acg2.mom/)
wget -O /tmp/mt5700.apk "https://gh.acg2.mom/https://github.com/LianXia233/luci-app-mt5700/releases/download/v1.32.10/aarch64_cortex-a53-luci-app-mt5700-1.32.10-r1.apk" \
&& wget -O /tmp/mt5700-i18n.apk "https://gh.acg2.mom/https://github.com/LianXia233/luci-app-mt5700/releases/download/v1.32.10/aarch64_cortex-a53-luci-i18n-mt5700-zh-cn-0.261113.67179.apk" \
&& apk add --allow-untrusted /tmp/mt5700.apk /tmp/mt5700-i18n.apk直连(不带前缀)
wget -O /tmp/mt5700.apk "https://github.com/LianXia233/luci-app-mt5700/releases/download/v1.32.10/aarch64_cortex-a53-luci-app-mt5700-1.32.10-r1.apk" \
&& wget -O /tmp/mt5700-i18n.apk "https://github.com/LianXia233/luci-app-mt5700/releases/download/v1.32.10/aarch64_cortex-a53-luci-i18n-mt5700-zh-cn-0.261113.67179.apk" \
&& apk add --allow-untrusted /tmp/mt5700.apk /tmp/mt5700-i18n.apkaarch64_generic(iStoreOS 25.x、Arm SystemReady 等)
国内加速(推荐,前缀 https://gh.acg2.mom/)
wget -O /tmp/mt5700.apk "https://gh.acg2.mom/https://github.com/LianXia233/luci-app-mt5700/releases/download/v1.32.10/aarch64_generic-luci-app-mt5700-1.32.10-r1.apk" \
&& wget -O /tmp/mt5700-i18n.apk "https://gh.acg2.mom/https://github.com/LianXia233/luci-app-mt5700/releases/download/v1.32.10/aarch64_generic-luci-i18n-mt5700-zh-cn-0.261113.67196.apk" \
&& apk add --allow-untrusted /tmp/mt5700.apk /tmp/mt5700-i18n.apk直连(不带前缀)
wget -O /tmp/mt5700.apk "https://github.com/LianXia233/luci-app-mt5700/releases/download/v1.32.10/aarch64_generic-luci-app-mt5700-1.32.10-r1.apk" \
&& wget -O /tmp/mt5700-i18n.apk "https://github.com/LianXia233/luci-app-mt5700/releases/download/v1.32.10/aarch64_generic-luci-i18n-mt5700-zh-cn-0.261113.67196.apk" \
&& apk add --allow-untrusted /tmp/mt5700.apk /tmp/mt5700-i18n.apk以上两套命令效果相同,按网络情况任选一条;加速版只是把 GitHub 原始 URL 前置了
https://gh.acg2.mom/。
全部软件包下载链接
每个架构都有 4 个包(主包 / 语言包 × apk / ipk),全部列出:
| 架构 | 包 | apk(加速 / 直连) | ipk(加速 / 直连) |
|---|---|---|---|
| x86_64 | 主包 | 加速 · 直连 | 加速 · 直连 |
| x86_64 | 语言包 | 加速 · 直连 | 加速 · 直连 |
| aarch64_cortex-a53 | 主包 | 加速 · 直连 | 加速 · 直连 |
| aarch64_cortex-a53 | 语言包 | 加速 · 直连 | 加速 · 直连 |
| aarch64_generic | 主包 | 加速 · 直连 | 加速 · 直连 |
| aarch64_generic | 语言包 | 加速 · 直连 | 加速 · 直连 |
另有 ARCH-GUIDE.txt(架构选择与报错对照)。
opkg 系统(OpenWrt 24.10 及更早):把
.apk换成.ipk,命令改为opkg install。
只想先验证不安装:在apk add后加--simulate。报错对照见资产ARCH-GUIDE.txt。
at-webserver debian-v2.3.1(Debian deb 包)
at-webserver(Debian 独立版)debian-v2.3.1
MT5700M 5G 模组管理服务的 Debian 二进制包。安装后 systemd 托管,
WebUI 与 HTTP API 默认监听 0.0.0.0:9000。
产物
| 文件 | 架构 |
|---|---|
at-webserver_2.3.1-1_amd64.deb |
amd64 |
at-webserver_2.3.1-1_arm64.deb |
arm64 |
安装
# 按架构选包(如 arm64)
sudo apt install ./at-webserver_*_arm64.deb安装后浏览器访问 http://<设备IP>:9000。
说明
- 包内
/etc/mt5700/config.json为 conffile,升级时保留用户修改。 - 服务默认已
systemctl enable;未接模组时自动启动可能失败,属预期,
接入模组后执行systemctl restart at-webserver即可。 - 完整变更说明见仓库
docs/release-notes/。