184 KiB
Changelog — luci-app-substore
All notable changes to this project will be documented in this file.
[2.7.3-r3] - 安装命令改用通配文件名,翻译包并入对应包管理器代码块(仅文档)
README.md / README.en.md 的安装步骤不再写死版本号:opkg 用
luci-app-substore_*.ipk,apk 用 luci-app-substore-*.apk,避免每次升
PKG_RELEASE 后文档里的文件名立刻过期。简体中文翻译包的安装命令移入同一代码块,
用注释标明「中文界面需额外安装翻译包」;原先单独的翻译包安装代码块随之删除,
只保留 PKG_PO_VERSION 的说明。
影响
仅文档,无代码、无测试变更。 PKG_RELEASE 按版本约定 2.7.3-r2 → 2.7.3-r3,
README 与 docs/INSTALL.md 的版本号同步更新。全套 59 个测试文件、179 条断言、
0 失败(未改动被测代码,跑一遍确认无意外)。
[2.7.3-r2] - README 章节重排:安装提前,构建并入「从源码编译」(仅文档)
README.md / README.en.md 的「安装」整体移到「功能特性」之前,让拿到包的人先看到
安装方式、再看能力清单;「安装」末尾新增 从源码编译 小节,原先独立成节的
「构建」并入其中并删除。
合并时修正了原「构建」段里一条不存在的 make 目标:
make package/luci-i18n-substore-zh-cn/compile —— make 的目标按目录生成、不按包名,
.github/workflows/build.yml 与 docs/BUILD.md 均已写明这一点。新小节改为经 CI
验证过的做法:翻译包与主包同属 package/luci-app-substore,随同一条 compile
命令产出;它是 HIDDEN 包(无 Kconfig prompt),编译前需显式打开语言符号:
echo "CONFIG_LUCI_LANG_zh_Hans=y" >> .config
make defconfig
同时把 README 与 docs/INSTALL.md 中滞后的版本号 2.7.2-r1 同步为 2.7.3-r2。
影响
仅文档,无代码、无测试变更。 PKG_RELEASE 按版本约定 2.7.3-r1 → -r2。全套
59 个测试文件、179 条断言、0 失败(未改动被测代码,跑一遍确认无意外)。
[2.7.3-r1] - 结清「附:P2 修复范围」:改写为历史范围定义(仅文档)
docs/LEGACY_ISSUES.md 末尾的「附:P2 修复范围」一节,是 P2 开工时写下的范围
定义(2d29250,即 P2 批次一那次提交),原文用「例如 … 等」,本身即带示例
性质。它此前读起来像一份待办清单,容易让人以为还剩一批中危 / 低危项没修。
本轮核对后的结论:P2 已全部结清。范围区间共 38 项,其中 35 项能逐一对到
CHANGELOG 落点 —— 批次一~批次七([2.6.3-r1]~[2.6.9-r1]),M26 更早在
P0 批次四([2.6.0-r5])就已修复。该节现在补了一张 ID → 落点的索引表。
三项查无实据:M6 / L15 / L19。 原始 70 项审计表(高危 14 / 中危 30 / 低危 26)
从未落盘(见该文件开头的「编写纪律」):M6 只在那一行范围定义里被提及过一次,
L15 / L19 连提及都没有、是被 L8~L26 区间顺带覆盖进去的。编号不指向任何模块,
无从复核当时指的是什么 —— 按「不猜」原则不为它们补写描述,也不假装它们已被
评估过,只在该节如实写明「无据可查」。区间外的 L2(死代码,P4 已删)与同样查无
记录的 L7 一并备查。
影响
仅文档,无代码、无测试变更。 PKG_RELEASE 按 Makefile 的版本约定滚动:
2.7.2 已用到 r9,达到 r10 触发 PKG_VERSION 末位 +1、PKG_RELEASE 重置为 1,
故本轮为 2.7.3-r1。
全套 59 个测试文件、0 失败(未改动任何被测代码,跑一遍确认无意外)。
[2.7.2-r9] - Loon 引号包裹的位置参数放行逗号(LEGACY_ISSUES 7.9 e 修订)
第五轮把 7.9(e) 判为「含英文逗号就整条丢弃」,理由里有一句是错的。本轮复核后 只推翻其中的位置参数那一半。
修复 — 7.9(e) 修订:Loon 引号包裹的位置参数放行逗号
第五轮 surge_line 的注释写着「Loon 的那对引号只是标记,值里的逗号照样是分隔符」。
Loon 官方文档(nsloon.app/docs/Node/)的原文是「参数值中含有英文逗号时,请使用
双引号包裹」—— 这句话只在客户端解析是引号感知的前提下才成立,也就是说那对
双引号确实能保住值里的逗号。原注释把引号当成了纯装饰,据此推出的「引号救不了
逗号」不成立,整条丢弃的代价(极少见的「密码里带逗号」的节点在 Loon 上被丢弃)
也就失去了依据。
判据改成「这个值是不是引号完整包裹的」(v:match('^".*"$')),不是 is_loon:
- Loon 位置参数(
loon_positional无条件加引号)→ 放行含逗号的值; - Loon 的裸位置参数(无引号,如加密方式)→ 仍丢弃(无引号语义);
- 具名参数(Surge 家族,以及 Loon 的
sni=/ws-path=等)→ 仍丢弃:Surge 家族的 引号语义未获文档证据,且解析端不对具名值 unquote,加引号会直接断掉回环; - Surfboard 的裸位置参数(anytls)→ 仍丢弃。
判据选「是否引号包裹」而非「是否 Loon」,让上述四种情形自动分开,不必再分叉一次。
安全性来自 loon_positional 的两条既有保证:它无条件把 Loon 的位置凭据包成
"…"(引号是 Loon 语法的一部分),且值里含 " 时直接返回 nil(整条丢弃,走不到
这一行)—— 于是引号包裹的值内部不可能出现落单引号,
parser_surge.split_fields 的「奇数引号回退」分支不会被本行的输出触发。
具名参数检查原样不动。
测试
tests/output_formats_test.lua:第五轮那条loon comma password drops node翻转成loon comma password kept (quoted positional),并补loon rt comma password/loon rt comma method两条回环断言(放行的前提就是能原样回环);surge comma password drops node保留为反向护栏。tests/anytls_reality_test.lua:新增surge_line comma in quoted positional password kept、loon comma password round-trips、surge_line comma in loon vless uuid kept;保留具名密码、裸位置密码两条护栏。- 断言先取
local line = fmts.surge_line(...)再判type(line) == "string":直接在nil上调:find会抛错、吞掉同文件后续断言,反向验证就只剩「崩了」。 - 反向验证:把谓词改回无条件丢弃 → 6 条 FAIL 全部指向本轮改动,4 条护栏断言 始终绿;还原后全绿。
- 全套 59 个测试文件、0 失败。
[2.7.2-r8] - Surge / SurgeMac 一并丢弃 Hysteria v1(LEGACY_ISSUES 7.9 j)
第六轮把 Loon 的 Hysteria v1 丢弃了,本轮把同一条证据链延伸到 Surge 家族。
修复 — 7.9(j):Surge / SurgeMac 丢弃 Hysteria v1
第六轮新发现 (j):Surge 家族的手册协议清单里写的也是 "Hysteria 2",
manual.nssurge.com/policies/hysteria.html 是 404 而同目录的 hysteria2.html
存在 —— 与 Loon 同一情形,而本生成器仍会给这两家输出 hysteria, ... 行。
FAMILY_CAPS.surge / FAMILY_CAPS.surgemac 各加 hysteria = false,整条丢弃。
被丢的仍然只有上一代 v1:Hysteria 2 三家都支持,不受影响。
Surfboard 不在其中:getsurfboard.com 的 profile-format/proxy/external-proxy
一节及其无斜杠形式都返回 404,无法证实它读不懂 v1。既然没有证据,就不替它丢弃 ——
能力表对 Surfboard 保持沉默(caps[p] == nil 一律保留)。测试里有一条断言钉住这点,
防止日后有人「顺手统一」。
测试
tests/protocol_registry_test.lua:hysteria的丢弃表加surge/surgemac两条。tests/output_formats_test.lua:(j) 新增 5 条断言(surge 丢/留、组不含 v1、 surgemac 丢、surfboard 留),并删去第六轮那条finding j pending的占位断言。- 反向验证:把
hysteria = false从 surge / surgemac 撤掉,确认测试变红 (output_formats 3 条 + registry 1 条),且 surfboard 那条始终绿(本就无关)。 - 全套 59 个测试文件、0 失败。
[2.7.2-r7] - Loon 丢弃 Hysteria v1、skip-cert-verify 改写 true(LEGACY_ISSUES 7.9 g/h)
第五轮新发现里经决策要实施的两条。第三条(协议名大小写)决定保持现状。
修复 — 7.9(g):Loon 丢弃 Hysteria v1
Loon 的节点类型清单里只有 Hysteria2(nsloon.app/docs/Node/),本生成器却会把
统一模型里的 hysteria v1 节点也输出成一条 Loon 读不懂的行。现在
FAMILY_CAPS.loon 加 hysteria = false,整条丢弃 —— 与丢弃 wireguard / ssr
同一约定。hysteria 2 是各家通用的,被丢的只有上一代 v1。
顺带把 surge_config 的过滤逻辑改成数据驱动:此前是逐协议写死的
elseif p == "ssr" and not caps.ssr / elseif p == "vless" and not caps.vless,
每加一个维度就要再加一条分支,漏掉的那条默认是「保留」 —— 这正是本条缺陷的
成因(hysteria 从没进过这张表)。现在是 elseif caps[p] == false,标一个键即可。
修复 — 7.9(h):skip-cert-verify 写 true 而不是 1
Loon 文档的示例就是 skip-cert-verify=false,直接证明 false 是合法字面量、
true 同理;而 Surge 手册的 TLS 页只写「Optional, boolean, default: false」,
两家的文档里都找不到 1 这个取值。解析端两种都认,回环不受影响。
保持现状 — 7.9(i):协议名大小写
Loon 文档写 VMess / Hysteria2(首字母大写),本生成器用小写。无证据显示小写会
失败(Loon 定位是兼容 Surge 配置,Surge 手册的语法行就是小写),改动面却覆盖全部
协议 —— 不改。
测试
tests/protocol_registry_test.lua:hysteria的丢弃表加loon一条。tests/output_formats_test.lua:新增 (g) 5 条 / (h) 4 条断言(含回环)。- 反向验证:两条改动各自改回旧行为,确认测试变红。
- 全套 59 个测试文件、0 失败。
本轮新发现(未实施,记录在 LEGACY_ISSUES)
(j) Surge 家族同样没有 Hysteria v1 —— manual.nssurge.com/policies/hysteria.html
返回 404 而 hysteria2.html 存在,手册的协议清单写的也是 "Hysteria 2"。也就是
Surge / SurgeMac 的 hysteria 行同样读不懂。本轮没有顺手改 —— (g) 的决策只
点名了 Loon。测试里有一条断言如实钉住当前行为,实施 (j) 时一并翻转。
Surfboard 未获证据(其 external-proxy 文档页本轮返回 404)。
[2.7.2-r6] - Loon / Surge 家族写法按官方文档对齐(LEGACY_ISSUES 7.9)
docs/LEGACY_ISSUES.md 第七节 2.7.2 审计新发现的第五轮修复:(a)(b)(c)(d)
全部实施,(e) 保持保守。改动集中在 output_formats.surge_line(生成端)与
parser_surge.parse_surge_line(解析端)—— 两端必须成对,否则导出的配置再导入
回来会静默丢字段。
修复 — 7.9(a):Loon 的 TLS 开关是 over-tls,Trojan 例外
Loon 文档(nsloon.app/docs/Node/)通篇用 over-tls=true,从没把 tls 列为
它的别名;本生成器此前对 Loon 也写 Surge 的 tls=true。若 Loon 忽略它,vmess /
vless / trojan 会按明文连 —— 包括 Reality 节点(公钥写了、TLS 标志却没生效)。
local tls_flag = is_loon and "over-tls=true" or "tls=true"
Trojan 反过来:Loon 文档的明文与 Reality 两条示例都没有任何 TLS 键
(Trojan 本身建立在 TLS 之上),所以 Loon 的 trojan 行整个不写 TLS 参数。
Surge 家族的 tls=true 是文档要求的,保持不变。
修复 — 7.9(b):Loon 的 UDP 参数是 udp
Loon 文档每个示例都写 udp=true,udp-relay 一次都没出现。Surge 家族仍用
udp-relay=true。
修复 — 7.9(c):Surge 家族补上 vmess 的 encrypt-method
Surge 手册的 vmess 页有具名参数 encrypt-method,取值只有 aes-128-gcm
(默认)与 chacha20-ietf-poly1305。本生成器此前只写 username=,于是 cipher 是
chacha20 的节点被 Surge 按默认的 aes-128-gcm 去连 —— 静默用错算法。新增
SURGE_VMESS_CIPHER 做拼写映射(模型写 chacha20-poly1305,客户端写
chacha20-ietf-poly1305)。映射不到的取值(zero / none / auto /
aes-128-cfb)不写该参数、节点保留。
修复 — 7.9(d):Loon 的 ss / ssr / hysteria2 凭据是位置参数
Shadowsocks,服务器,端口,加密方式,"密码"
ShadowsocksR,服务器,端口,加密方式,"密码",protocol=…,obfs=…
Hysteria2,服务器,端口,"密码"
此前一律写具名的 encrypt-method= / password= —— 落在 Loon 的语法里就是第 4、
5 个位置参数各拿到一串 key=value 文本,加密方式解析不出来、密码也不再是密码,
节点必然连不上。ssr 的 protocol= / obfs= 及其参数仍是具名。
同步修改解析端(并修掉一个既有缺陷)
parse_surge_line 补上位置参数提取,保住「Loon 输出 → 导入」回环。其中
SSR 此前根本没有取字段的分支 —— 不论哪种写法导入,加密方式、密码、协议插件、
混淆方式全是 nil,节点带着空凭据进入统一模型,导出时再被静默丢掉。这是本轮顺带
修掉的既有缺陷,不是 (d) 引入的。
保持保守 — 7.9(e)
值里含英文逗号时仍按「整条丢弃」处理。Loon 的引号按文档确实能保住逗号,但本行的 具名参数一律不带引号,同一行混用两种约定会让「哪个值被包裹」变成依赖客户端实现的 行为。已加断言钉住这个选择。
测试
tests/ssr_test.lua:loon encrypt-method一条改为断言位置参数写法,新增 9 条 Loon 输出 → 导入回环断言。tests/output_formats_test.lua:新增 7.9 专节 24 条断言。- 反向验证:逐条把代码改回旧行为,确认测试变红(3 / 2 / 2 / 2 / 5 / 1 / 1 条 FAIL), 还原后全部 PASS。
- 全套 59 个测试文件、0 失败。
本轮新发现(未实施,记录在 LEGACY_ISSUES)
(g) Loon 的节点类型清单里没有 Hysteria v1,本生成器仍会输出 hysteria 行;
(h) skip-cert-verify=1 这个取值两家文档都没写;(i) 协议名大小写(Loon 文档用
首字母大写,本生成器用小写)。三条都只记录、不动代码。
[2.7.2-r5] - 后端错误串 msgid 化(LEGACY_ISSUES 7.7)
docs/LEGACY_ISSUES.md 第七节 2.7.2 审计新发现的第四轮修复。
修复 — 7.7-A:后端不再有中文字面量
root/usr/share/substore/*.lua 里的失败原因会经两条路到达用户 —— 控制器
back_to_list / back_to_nodes 的 ?err=,以及 meta.error(视图里的
msg.translate)。这些串此前硬编码成中文:英文界面下冒出中文,而且它们
永远进不了翻译表。现在全部改为语言中立的英文 msgid,翻译只发生在显示边界。
这是硬约束不是风格选择:后端模块不能 require("luci.i18n") ——
substore-cron.sh 会在独立的 lua 进程里跑 core.sync,那里没有 LuCI 环境。
新增 msg.lua —— 组合消息的拼接与还原
「msgid 前缀 + 动态值」这类消息("Invalid proxy config: " .. reason)整体查表
必然落空,前缀那半句就永远翻译不了。msg.lua 用分隔符 "\1" 把各段拼起来,
显示边界按分隔符逐段查表:
msg.compose("Target actually connects to a private/reserved address (", ip, ")")
msg.join("Unsupported proxy protocol: ", scheme) -- compose 的两段简写
msg.compose_list(names, " + ")
msg.translate(s, translate) -- 逐段查表
分隔符选 "\1"(SOH)有两个依据:它不会出现在任何合法取值里(URL / 主机名 /
User-Agent / 端口 / 协议名在 http.lua 里都校验过);util.json_encode 会把控制
字符转义成 \u0001,所以组合消息存进 meta.error 再读回来仍然完好。
拆分只按第一个分隔符切、剩下的递归处理,嵌套天然成立 —— 全程精确,没有
启发式匹配。对已翻译过的串幂等(不含分隔符 → 整串查表落空 → 原样返回)。
顺带修掉的一个既有缺陷
控制器此前把已翻译的串写进持久化的 meta.error —— 中文管理员触发的失败原因
会泄漏到英文管理员的界面上。现在存的是 msgid,读它的会话按自己的语言翻译。
顺带修正的三条用户可见文案
扫描时发现它们已经会到达用户、却漏在翻译表之外(中文界面下显示英文):
| 位置 | 此前 | 现在 |
|---|---|---|
parser.lua |
"bad wireguard conf: no [Peer]" |
"A WireGuard .conf file has no [Peer] section" |
parser.lua |
"bad wireguard conf: no usable [Peer] endpoint" |
"A WireGuard .conf file has no [Peer] with a usable Endpoint" |
output.lua / output_formats.lua |
"unsupported format: " .. fmt |
msg.join("Unsupported output format: ", fmt) |
其余 "bad ss" / "no scheme" 之类不动 —— 它们只用于决定「这一行要不要丢」,
原因串被 parse_lines 丢掉,不是用户可见文案。
保留的中文字面量(唯一一处)
node.lua 的 "[^,%s,]+":这是正则字符类,全角逗号是模式的一部分,翻译它
会破坏「香港,日本」这类全角分隔写法的关键词拆分。测试里按字面量内容列为显式
例外,并断言例外必须仍存在于源码中。
翻译表
po/zh_Hans/substore.po 新增 81 条。其中 "JSON" / "Clash YAML" /
"WireGuard .conf" 是恒等译文(格式专名,中文界面下原样显示)—— 写成显式
条目是为了让「每个 msgid 都有译文」这条不变式保持机械可检。
回归测试
新增 tests/backend_i18n_test.lua(15 条断言):A 扫全部后端源码不得含 CJK;
B 只认三种语法位置(return 语句 / error = 字段 / msg.* 的参数,外加
FORMAT_LABELS 的表值)来核对译文齐全,不靠猜;B2 用调用 util.human_duration
的方式断言其返回值逐段可译;B3 单独查控制器里裸写、会被持久化的 error = "…"。
两条反腐烂断言:排除表 NOT_MESSAGES 里每一项都必须仍能在源码里找到;
po 的后端段里不能有死条目。另有非空性断言(checked >= 70,当前约 80),
防止正则写错时静默变成假绿。排除表逐条列举(30 条:17 条逐行解析诊断 +
5 条 shell 片段 + 8 条 YAML/INI 模板片段)而不是按模式匹配 —— 新增一条就得做一次
有意识的判断。
同步修改的既有测试(9 个):此前断言旧中文字面量的
core_userinfo_test / data_integrity_test / dns_fallback_test / list_lock_test /
network_security_test / p1_fixes_test / p2_batch7_test / parser_mixed_format_test /
wireguard_conf_test 改为断言 msgid 形态。其中 p2_batch7_test 的改名规则断言改为
对渲染后的串断言 —— 组合消息在 "line " 与数字之间插了分隔符,断言用户真正
看到的东西才是对的。
反向验证:临时在 probe.lua 末尾加一条 return nil, "A brand new untranslated message" 后跑 tests/backend_i18n_test.lua,得到 1 条 FAIL,确认扫描面不是
空转;还原后 15 条全 PASS。全套 59 个测试文件、0 失败。
文档
docs/LEGACY_ISSUES.md:状态表 7.7 → 已实施;新增「第四轮修复记录」。
[2.7.2-r4] - 真正实现 Egern 的 YAML 生成器(LEGACY_ISSUES 7.2)
docs/LEGACY_ISSUES.md 第七节 2.7.2 审计新发现的第三轮修复。
修复 — 7.2-A:Egern 不再输出 Surge 逗号行,改为真正的 YAML
选 Egern 格式导出的内容此前是 Surge 的逗号行(output_formats.to_egern 就是
surge_config(nodes, name, "egern")),而 Egern 的配置是 YAML —— 用户拿到的东西
Egern 根本读不了,且导出时没有任何提示。
新增 root/usr/share/substore/output_egern.lua,并删除 output_formats.to_egern
与其 M.generate 分支;output.lua 的分发改走新模块,下载后缀由 .conf 改为
.yaml。结构逐字段对照官方示例(egernapp.com/docs/configuration/example/)与
协议字段表(.../configuration/proxies/),无推测项:
proxies:是顶层列表,每项是单键映射,键名即小写协议名(- shadowsocks:), 字段名一律 snake_case(user_id/peer_public_key/skip_tls_verify/udp_relay/obfs_password/service_name/local_ipv4/udp_relay_mode)。- vmess / vless 的传输层是
transport:子映射,键名是传输类型本身 (tls/ws/wss/grpc/http2)。TLS 也是其中一种,没有顶层tls:开关 —— 「明文 tcp」就是完全不写transport。 - Reality 的嵌套位置按协议分叉:vmess / vless 在
transport.<类型>.reality里, trojan / anytls 是节点顶层的reality:对象;键名public_key/short_id。 policy_groups:同为顶层列表,select用policies:;空列表兜底DIRECT。
顺带修正的两处既有行为(都由 protocol_registry_test 的 DROPPED 表锁定):
| 协议 | 此前 | 现在 | 原因 |
|---|---|---|---|
| wireguard | 丢弃 | 保留 | Egern 的 WireGuard 有独立协议块,YAML 能完整表达(Surge 的单行 [Proxy] 表达不了) |
| hysteria (v1) | 保留 | 丢弃 | Egern 的协议清单里只有 Hysteria2;v1 的 obfs 是普通字符串、没有 obfs_password,拿 v2 的键去顶会让客户端按错误的协议去连 |
YAML 标量转义从 output_clash_meta.lua 导出为 M.esc_yaml 共用(另抄一份必然
漂移 —— 「未加引号的 password: %foo 会让客户端拒绝整份配置」是同一个坑)。
Content-Type 保持 text/plain; charset=utf-8,与同类的 clash / clashmeta / stash
一致;FAMILY_CAPS 里的 egern 行删除(能力判定搬进 EGERN_KEY)。
未做的一处(不猜):vmess 的 legacy 只在节点显式带该字段时输出。官方文档
没有给出「alterId > 0 ⇒ legacy: true」的对应关系,本仓库也没有 alterId 字段,
不臆测映射。
回归测试
新增 tests/output_egern_test.lua(63 条断言):顶层结构、逐协议字段名、
transport 嵌套(ws / wss / grpc / http2)、Reality 的两种嵌套位置、SSR 与
Hysteria v1 的整条丢弃、名字唯一性与重命名、YAML 转义、端口兜底、格式注册。
tests/protocol_registry_test.lua 的 DROPPED 表按上表改(删 wireguard.egern、
加 hysteria.egern);tests/anytls_reality_test.lua 的 egern 断言从「具名密码、
无 reality」改为 YAML 形态。
反向验证:把 output.lua 与 output_formats.lua stash 掉(保留全部新测试)
后跑 tests/output_egern_test.lua,得到 53 条 FAIL(旧代码走 to_egern,
输出的是逗号行);git stash pop 后 0 条 FAIL,全套 58 个文件、0 失败。
文档
docs/LEGACY_ISSUES.md:状态表 7.2 → 已实施;新增「第三轮修复记录」含反向 验证;「实测探针」的修复后段更新为[2.7.2-r4]的真实 Egern YAML 输出。README.md/README.en.md:协议清单的出处补充EGERN_KEY(Egern 的清单 不在FAMILY_CAPS里)。
[2.7.2-r3] - 按客户端协议清单过滤,并按各家文档修正 Loon / QX 的 Reality 与凭据写法(LEGACY_ISSUES 7.1 / 7.3 / 7.4)
docs/LEGACY_ISSUES.md 第七节 2.7.2 审计新发现的第二轮修复。改动全部落在
输出侧 output_formats.lua,解析侧一行未改 —— 三处新写法早就有对应的读取实现,
往返由新增的回归测试锁定。本轮同时把为实施 7.4 而核对 Loon 文档时新发现的一批
不一致记为 7.9(未实施,待决策),其中 (a) 会直接影响 Reality 在真机 Loon 上的
收益,见下。
修复 — 7.1:按客户端的协议清单过滤(FAMILY_CAPS)
此前 surge_config 的调用点各传一个 supports_ssr 布尔量,于是 Surge 格式会为
VLESS 节点生成代理行 —— 而 Surge / Surfboard / SurgeMac 的官方协议清单里都没有
VLESS。新增一张能力表,只记录各家不一致的 vless / ssr 两个协议:
| flavor | vless | ssr | 依据 |
|---|---|---|---|
| surge / surfboard / surgemac | ✗ | ✗ | manual.nssurge.com 的 Proxy Protocols、getsurfboard.com 的 external-proxy |
| loon | ✓ | ✓ | nsloon.app/docs/Node/ 有独立的 VLESS 与 ShadowsocksR 两节 |
| egern | ✓ | ✗ | egernapp.com/docs/configuration/proxies/ 有 Vless、无 ssr |
surge_config(nodes, group_name, flavor) 改为查表丢节点;五个调用方传格式名。
用表而不是再加一个布尔参数:加一个维度就要再加一个参数,调用点一多必然漏传,
而漏传的默认值是「支持」—— 症状正是本轮要修的这个(导出里多出客户端读不懂的行,
且不报错)。
修复 — 7.3-C:QX 带 Reality 公钥的 vmess / vless 改用 obfs= 形式的 TLS 标志
QX 官方 sample.conf 的注释把「该行带 TLS 标志」列为 reality-base64-pubkey
生效的前提,而 QX 里 vmess / vless 的 TLS 标志写作 obfs=over-tls(纯 TLS)/
obfs=wss(ws + TLS),trojan / anytls 才写 over-tls=true + tls-host=。
此前一律走 qx_tls()(tls-host= + tls-verification=),QX 会忽略公钥,
节点静默退回普通 TLS。新增 qx_obfs_reality(),只对带 public-key 的
vmess / vless 生效 —— 不带公钥的完全不动,既有 QX 节点的输出形态不变,
风险面只落在本次新加的 Reality 功能上。
修复 — 7.4-A:Loon 的凭据改为带引号的位置参数,公钥按文档加双引号
Loon 文档的节点行是 Trojan,h,p,"密码"、VLESS,h,p,"UUID"、
VMess,h,p,加密方式,"UUID"(nsloon.app/docs/Node/),而本生成器一律写具名
password= / username=。新增 loon_positional() 改写 Loon 的
trojan / vmess / vless;Reality 的 public-key 加双引号、short-id 不加。
Surge / Surfboard / SurgeMac 维持具名写法 —— 复核确认它们本来就是对的:
getsurfboard.com 的 vmess 页示例与 Surge 手册的 vmess / trojan 页都写
username= / password=(LEGACY_ISSUES 的 7.4 行原先把 Surfboard 与 Loon
并列,是误判,已更正,详见 7.9 的 (f))。
实施中一并修掉两个本轮改动自身会引入的问题:
- Loon 的 VMess 加密方式拼写不同:模型的
chacha20-poly1305在 Loon 里写作chacha20-ietf-poly1305,模型的zero是 Xray 专用(Loon 清单里没有)。 照抄会让这两类节点在 Loon 上加载失败 —— 新增LOON_VMESS_CIPHER映射, 未列出的取值退回auto。这是位置参数化必须配套的一步。 - 带引号的位置参数遇到值里的双引号:
'"'..v..'"'在v含"时产出"pa"ss",怎么切没有文档依据 —— 这种值整条丢弃。顺带修掉了既有的同类 缺陷:anytls 的 Loon 位置参数(7.4 之前就带引号)此前没有这层防护。
文档
docs/LEGACY_ISSUES.md:状态表更新;新增 7.9 明细(Loon 的over-tlsvstls、udpvsudp-relay、Surge 家族 vmess 缺encrypt-method、Loon 其余 协议的位置参数、以及「Loon 的双引号其实能保住逗号」这一更正); 新增「第二轮修复记录」含反向验证表。README.md/README.en.md:SSR 可输出的客户端清单里删掉 Egern (其协议清单只有 Shadowsocks,没有 SSR),并补 VLESS 的同类说明。- 更正
output_formats.lua里「Loon 的那对引号只是标记,值里的逗号照样是分隔符」 这句 —— 与 Loon 文档相反,实际是能保住的;实现仍按「含逗号就丢弃」处理(保守, 理由写在该处注释里)。
回归测试
tests/anytls_reality_test.lua 由 110 条扩到 143 条:Loon 位置参数与公钥引号、
Surge 家族整体丢 vless、QX obfs= 分叉与「不带公钥维持原样」的对照、QX 往返、
Loon 端到端往返(生成的配置用本仓库自己的解析器读回来,含「[Proxy Group]
段不得被当成节点」)、加密方式映射、双引号边界。tests/protocol_registry_test.lua
的 DROPPED 表补 vless(surge/surfboard/surgemac) 与 ssr(egern);
tests/output_layer_fixes_test.lua 的 F6 改挂在 Loon 上(surge 侧该节点已被整体
丢弃,传输层已无从观察)。
反向验证:把 output_formats.lua stash 掉(保留全部新测试)后跑三个受影响的
文件,得到 20 条 FAIL(anytls_reality_test 16 / output_layer_fixes_test 2 /
protocol_registry_test 2),症状与预测逐条对应(QX 写的是 tls-host 而非
obfs=;Loon 公钥无引号、凭据是具名;surge/surfboard/surgemac 仍输出 vless 节点;
want dropped got true)。git stash pop 后 0 条 FAIL,全套 57 个文件、0 失败。
待决策(7.9)
7.9 (a):Loon 的 TLS 开关文档写作 over-tls=true,本生成器写 tls=true
(Surge 的写法)。Loon 文档没有把 tls 列为 over-tls 的别名,也没说会被
拒绝 —— 若被忽略,Loon 上的 vmess / vless / trojan 会按明文连,包括本轮
Reality 节点(公钥写了、TLS 标志却没生效)。这条不修,7.4-A 与 Reality 支持
在真机 Loon 上的收益都要打折。
[2.7.2-r2] - 修复 Surge 系 / Loon / QX 行解析的字段级缺陷(LEGACY_ISSUES 7.5 / 7.6)
docs/LEGACY_ISSUES.md 第七节 2.7.2 审计新发现的第一轮修复。两项都在
parser_surge.lua,即「导入别人的 Loon / Surge / QX 配置」这条路径上。
修复 — 行拆分改为引号感知(7.5)
Loon 把凭据写成双引号包裹的位置参数(nsloon.app/docs/Node/):
Trojan = Trojan,trojan.example.com,443,"password",transport=tcp,...
密码里含逗号时,旧的 rest:gmatch("[^,]+") 会把它切成两段 ——
"pa,ss" 静默变成 "pa(多一个引号、少掉后半段),用户拿到的不是他填的凭据,
而且没有任何提示。生成端早就有「值里含逗号就整条丢弃」的防护
(output_formats.surge_line),解析端此前没有对应处理。
新增 split_fields(),parse_surge_line 与 parse_qx_line 的切分都改走它:
- 引号个数为奇数时不做引号感知,退回旧的按逗号切分。订阅内容不可信,落单的
引号若被当成「开引号」,会把后面的
sni=/over-tls=全吞进同一个字段, 比按逗号切更糟。 - 偶数时按引号开合切分,引号内的逗号不再是分隔符;引号本身保留在字段里,
由既有的
unquote()(Loon 位置参数)或原样(QX 的 kv 值)处理。 - 无引号的输入与旧实现逐字符等价:同样按逗号切、同样丢弃空字段、同样 trim。
修复 — Loon 的 transport= / path= / host= 未映射(7.6)
Loon 文档的传输写法是 transport=<tcp|ws|http> + path= + host=,旧参数
ws=true / ws-path / ws-headers=Host: 只是兼容别名(nsloon.app/docs/Node/)。
此前只认旧写法,于是别人给的 Loon ws 节点导入后 net 保持默认 tcp、
path / host 全丢 —— 导出到任何格式都按 tcp 去连一个只开了 ws 的端口,
握手失败且不报错。
parse_surge_line 增加这三个映射(transport=http 按 Loon 文档「会按 WebSocket
处理」落成 ws),放在旧写法之后:同一行两种写法都出现时以新写法为准。
测试
新增 tests/parser_surge_fields_test.lua(36 条断言):两个缺陷的修复点、旧写法
回归、无引号输入的逐字符等价、空字段边界、奇数引号边界、「新写法优先」,
以及 Reality 参数不受影响的回归。
反向验证:把 parser_surge.lua stash 掉后跑该文件得到 12 条 FAIL,症状与
预测完全一致(被截断的凭据、net=tcp、path / host 为 nil、旧写法胜出);
恢复后 0 条 FAIL。全套 57 个文件、0 失败(age_test.lua 随 7.8 一并删除,故为 57)。
文档 / 构建
- 更正未经证实的结论:
output_formats.lua、tests/anytls_reality_test.lua与LEGACY_ISSUES.md里写的「Surge 遇到无法解析的代理行会拒绝加载整份配置」 没有官方依据 —— Surge 官方只说明过无法识别的 section 会原样保留且不报错。 相关注释改为「不输出客户端读不懂的东西」,与本仓库丢弃 wireguard / ssr 同一约定。 - CI 修复:编译前写入
CONFIG_LUCI_LANG_zh_Hans=y再make defconfig。luci-i18n-substore-zh-cn是 HIDDEN 包(无 Kconfig prompt),luci.mk 给它的 唯一默认值是LUCI_LANG_zh_Hans||(ALL&&m),而 SDK 默认ALL=n—— 不显式打开 这个符号,翻译包就不会被编译出来,Collect artifact的守卫会失败。 (CONFIG_PACKAGE_luci-i18n-substore-zh-cn=m对无 prompt 的符号是空操作。) docs/BUILD.md:更正不存在的make package/luci-i18n-substore-zh-cn/compile目标(make 目标按目录生成),补上语言符号的说明。
[2.7.2-r1] - 新增 AnyTLS 与 Reality 支持;控制器文案接入 i18n;简体中文翻译拆成独立包
core.lua M.version 由 2.7.1 升至 2.7.2。本节包含 2.7.1-r5 之后未发布的两批
改动:上一批(uTLS 指纹键名与协议清单唯一来源)已在提交 3651f67 落地但未记入
日志,一并补记。
新功能 — AnyTLS
- 解析:
anytls://分享链接;Surge / Surfboard / Loon / QX 四种行格式; Clash YAML 与 sing-box JSON 出站。 - 输出:clashmeta、sing-box、v2rayuri、QX、Surge 家族。AnyTLS 密码的位置
按各家文档分别输出 —— Surge / SurgeMac 具名
password=,Surfboard 端口后的 裸位置参数,Loon 端口后的带引号位置参数(anytls, host, port, "pwd", …)。 - 表单:
node.PROTO_FIELDS.anytls与nodeform.js的字段清单同步更新。
新功能 — Reality(完整参数集 public-key / short-id / spider-x / fingerprint)
- 解析:
vless://…security=reality&pbk=&sid=&spx=&fp=;Loon 节点行的public-key/short-id;QX 的reality-base64-pubkey/reality-hex-shortid; sing-box 的tls.reality;Clash 的reality-opts。 - 统一模型:
node.REALITY_PROTOS = { vless, vmess, trojan, anytls };normalize见到public-key即把security置为reality(判据是公钥而非security字段 —— Loon 的行只写over-tls=true+public-key,没有security=reality)。 - 输出:
- clashmeta:
reality-opts: {public-key, short-id},仅 vless / vmess / trojan 三个出站(mihomo 的RealityOptions只挂在这三个结构体上;AnyTLSOption里没有任何 reality 字段,写了会被静默忽略)。 - sing-box:
tls.reality,并强制输出tls.utls(sing-box 的newRealityClient在 utls 未启用时直接报uTLS is required by reality client)。 - v2ray(Xray):
realitySettings(camelCase)。 - v2rayuri:
pbk/sid/spx(仅 VLESS ——anytls://链接规范没有 reality 参数)。 - QX:
reality-base64-pubkey/reality-hex-shortid。 - Surge 家族:只有 Loon 输出
public-key/short-id(REALITY_FLAVORS); Surge / Surfboard / SurgeMac / Egern 写这两个键是「客户端不认识的参数」。 (本行原文写的是「Surge 遇到无法解析的代理行会拒绝加载整份配置」—— 该说法无官方依据,已在[2.7.2-r2]更正,见上一节「更正未经证实的结论」。)
- clashmeta:
修复(本轮代码级审计发现)
output_clash_meta:reality-opts此前只写在vless分支。mihomo 的vmess.go/trojan.go出站同样声明了RealityOpts,一并补上;anytls不写 (见上)。output_v2ray:security == "reality"但没有public-key时,原样输出realitySettings会让 Xray 拒绝加载整份配置(REALITYConfig.Build()客户端分支在公钥为空时报empty "password",而StreamConfig又要求security == "reality"必须配realitySettings)。改为降级成普通 TLS —— 与 sing-box / mihomo / QX 三个输出端「只在有 public-key 时才写 Reality」一致。node.PROTO_FIELDS.anytls:补public-key/short-id。core.merge_form_node会把「在清单里但表单没提交」的字段当作清空处理,不列入的话用户在界面上编辑 一次就把 Reality 凭据抹掉。output_formats(Loon / QX):Loon 文档有 VMess-Reality 示例,QX 官方sample.conf的 Reality 条目覆盖 vmess / vless / trojan / anytls —— 此前 Loon 只给 vless / trojan / anytls 输出公钥,QX 只给 vless / anytls 输出, vmess 与 QX-trojan 的 Reality 配置被静默丢弃。- 上一批(
3651f67):output_clash_meta写出的 uTLS 指纹键名是fp,而 mihomo 的键是client-fingerprint(全仓库没有任何结构体声明proxy:"fp,…"), mihomo 对未知键静默忽略 —— 配置看起来有指纹、握手实际用默认指纹;parser_clash_yaml又只读p.fp,而 mihomo 从不写fp,指纹双向全断。 两端一并修正,解析端保留fp兜底以兼容旧版本导出的配置。同时收敛协议清单 为唯一来源(node.PROTOS/node.TLS_ONLY),nodes.htm下拉不再内联第三份副本。
变更 — i18n 与打包
- 控制器文案接入翻译层:
controller/admin/substore.lua里所有用户可见文案 (经?err=回显的失败原因等)改为_("English"),msgid 一律英文,中文译文 放po/zh_Hans/substore.po。此前这些是硬编码中文字面量,英文界面下原样显示中文。 po/zh-cn/→po/zh_Hans/:luci.mk只对LUCI_LANG里有条目的目录名 生成翻译包。LUCI_LANG.zh-cn不存在(只有LUCI_LANG.zh_Hans,经LUCI_LC_ALIAS.zh_Hans=zh-cn映射到语言码zh-cn),所以目录叫zh-cn时 luci.mk 会静默跳过、不生成任何翻译包 —— 这正是此前译文被硬编译进主包的原因。- 简体中文翻译不再硬编译进主包:删除
Makefileinstall 步骤里的po2lmo(原先把substore.zh-cn.lmo直接塞进luci-app-substore的 ipk/apk), 改由 luci.mk 按po/zh_Hans/自动生成的独立包luci-i18n-substore-zh-cn提供。 该包自己调po2lmo,并写 uci-defaults 把zh_cn加进luci.languages。 翻译包的版本号取 LuCI 的PKG_PO_VERSION(由po/的提交时间推导),与主包的2.7.2-r1不同名。 - CI(
.github/workflows/build.yml):同时编译package/luci-i18n-substore-zh-cn/compile, 产物收集通配luci-i18n-substore*,Release 说明里注明该包为可选安装。
测试
- 新增
tests/anytls_reality_test.lua(110 项断言):URI / 行格式解析、normalize的 Reality 推导与误判防护(wireguard 的顶层public-key是对端 公钥、与 Reality 无关)、各输出端逐格式断言、PROTO_FIELDS与merge_form_node保留凭据、surge_line的边界(未知协议 →nil;密码含逗号 →nil)。 tests/view_i18n_test.lua新增 B2 段:控制器里_()包裹的每个 msgid 都必须在po/zh_Hans/substore.po有条目,防止 msgid 与译文表再次漂移。tests/controller_local_test.lua的断言改为英文 msgid(控制器文案已接入 i18n, 测试用的luci.i18nstub 是恒等翻译)。- 全量 Lua 测试 56 个文件与
tests/cron_result_test.sh全部通过。
[2.7.1-r5] - 订阅列表页组合订阅行的「[组合]」徽标移到「订阅地址」列
纯模板改动,无 Lua 逻辑改动(core.lua M.version 不变,仍为 2.7.1)。
变更
subscriptions.htm:组合订阅行的[组合]徽标从名称列移到订阅地址列, 放在来源订阅列表之前。- 名称列此前渲染成
[组合]Test123,现在只显示名称Test123; - 订阅地址列显示
[组合] Fatiao + Feijiyundu,与同一列里[本地]徽标的呈现 方式一致(徽标同为<span style="color:#0066aa">,来源列表用灰色#808080); - 徽标是移走而非复制 —— 全页仍只出现一次。
- 名称列此前渲染成
测试
- 新增
tests/subscriptions_combo_row_test.lua(20 项断言),真实渲染模板后断言:- 组合行名称列只含名称,且不含
Combination、不含任何[; [组合]徽标在订阅地址列,且位置在来源列表之前;- 徽标全页只出现一次(
count_of计数,另配一条非空对照断言); - 回归:普通订阅行(名称 / URL / 无徽标)与本地订阅行(
[本地]徽标)不受影响; - 反面对照:
save_combo改名后名称列跟随数据变化,渲染结果确实随数据变化。
- 组合行名称列只含名称,且不含
- 覆盖缺口:本文件新增前,渲染
subscriptions.htm的三个测试 (subscriptions_format_gate_test/subscriptions_bulk_delete_test/view_i18n_test)fixture 全是普通订阅,组合行与本地行的渲染此前零覆盖。 - 全量 Lua 测试 54 个文件与
tests/cron_result_test.sh(14 项)全部通过。
[2.7.1-r4] - 修复英文界面下订阅表单仍显示中文(界面文本全部接入 i18n)
纯模板/翻译改动,无 Lua 逻辑改动(core.lua M.version 不变,仍为 2.7.1)。
修复
- 系统语言为英文时,「添加订阅」页的「订阅代理」「订阅客户端类型」「启用定时更新」 「启用规则」及配套说明文字原样显示中文。
- 根因:这些标签在模板里是硬编码的中文字面量,从不进入翻译表。LuCI 的
<%:msgid%>按当前语言查.lmo,查不到就回退显示 msgid(英文);而直接写在 HTML 里的中文既没有 msgid 也没有 msgstr,任何语言下都只输出中文。 r3 只改了「重命名」提示块,这些标签没动。 - 改法:全部改为
<%:…%>,msgid 复用 po 里已有的英文条目 (Enable rules/Keyword include/Keyword exclude/Dedup/Protocol filter/Rename),缺的补英文 msgid + 中文译文。
变更
form.htm:订阅代理(Subscription proxy/Proxy address+ 说明)、 客户端类型(Client type/Default (not set)/Custom+ 三段说明 /Custom User-Agent)、定时更新(Enable scheduled update/Scheduled update time/MinuteHourDayMonthWeek)、 规则区标签,共 17 处接入 i18n。combo.htm:规则区 6 个标签接入 i18n;「启用规则」的说明改用与另两个表单 同构的 msgidWhen enabled, apply keyword include/exclude and dedup rules to the merged nodes(作用范围措辞为「合并后的节点」)。subscriptions.htm:订阅名下方的定时:改为<%:Schedule:%>。- HTML 标记必须留在
<%:…%>之外:LuCI 把标签内的文本按 XML 规则转义 (<>&'"全部变成数字实体),标记写在里面会当字面文本显示。form.htm的客户端类型说明原本用<code>强调示例值,为满足这条约束改为 整句一个 msgid、示例值直接写在句中。
翻译
po/zh-cn/substore.po:新增 20 条 msgid 的中文译文(122 条,无重复、无缺 msgstr)。
测试
- 新增
tests/view_i18n_test.lua,三组断言:- A 真实渲染:按 LuCI 的方式把模板重建成 Lua chunk,用恒等 translate
(= 英文界面,仓库只发布 zh-cn 一份
.lmo)渲染,输出里不得出现 CJK。 这条直接复现本缺陷 —— 中文字面量在输出里,<%:…%>输出的是英文 msgid。 - B po 覆盖:模板里每个 msgid 都必须在
po/zh-cn/substore.po有条目, 否则中文界面显示英文。 - C 静态扫描:抹掉
<% %>代码块与 HTML 注释后,字面 HTML 里不得有 CJK, 补上 A 覆盖不到的模板(nodes.htm/output.htm需要数据 fixture)。
- A 真实渲染:按 LuCI 的方式把模板重建成 Lua chunk,用恒等 translate
(= 英文界面,仓库只发布 zh-cn 一份
- 缺口说明:
p2_batch7_test.luaL1 的「无中文 msgid」断言只扫<%:…%>与luci.i18n.translate("…")内部,扫不到写在 HTML 里的中文字面量,本缺陷 正是从这个缺口漏过去的。 - 全量 Lua 测试 53 个文件与
tests/cron_result_test.sh(14 项)全部通过。
[2.7.1-r3] - 重写「重命名」提示并统一三个表单的规则说明
纯模板/翻译改动,无 Lua 逻辑改动(core.lua M.version 不变,仍为 2.7.1)。
变更
form.htm/local_form.htm/combo.htm:规则区的提示块此前三个模板各不相同 (form.htm、combo.htm是硬编码中文,local_form.htm是英文 msgid 但少了关键词 那一行),而且只列了三种写法的形式,没说清作用范围和叠加顺序 —— 最常被问到的「怎么重命名多个节点」在提示里答不出来。现统一为同一份分点说明:- 关键词用逗号分隔;包含 = 命中任一即保留,排除 = 命中任一即去除;
- 协议筛选全部不勾选 = 不筛选(保留所有协议);
- 重命名每行一条,
#开头为注释,规则自上而下逐条叠加(不是首个命中即停); - 三种写法的作用范围不同:
旧名称=新名称精确匹配,只改名字完全相同的节点;模式 -> 替换正则替换,改所有节点名字中的匹配部分(Lua 模式而非 PCRE,捕获 引用写$1);{server}_{port}_{proto}占位符模板无条件重命名所有节点; - 列出全部可用占位符:
{server}{port}{proto}{name}{uuid}{password}{group}。
- 提示块三处改为完全相同的文案,只保留一份 msgid 集,避免以后改一处漏两处。
修复
local_form.htm的提示块原本缺「关键词用逗号分隔」那一行(另两个模板有), 现三个模板一致。form.htm/combo.htm的提示块原为硬编码中文:英文界面下会原样显示中文, 现统一走<%:…%>i18n(p2_batch7_test.luaL1 断言覆盖)。
翻译
po/zh-cn/substore.po:新增 6 条 msgid 的中文译文;删除已废弃的One rename rule per line: OLD=NEW (exact), …。
测试
- 全量 Lua 测试 50 个文件与
tests/cron_result_test.sh全部通过。 - 模板改动后仍可被
template_escape_test.lua重建并loadstring通过。
[2.7.1-r2] - 修复 Argon 主题下「协议筛选」复选框压住「重命名」输入框
纯模板/样式修复,无 Lua 逻辑改动(core.lua M.version 不变,仍为 2.7.1)。
修复
form.htm/local_form.htm/combo.htm:「协议筛选」的协议复选框原先嵌在<label>内。Argon 主题有一条label > input[type="checkbox"] { position: relative; top: 0.4rem }, 把复选框视觉下移 0.4rem(6.4px)却不改变布局占位;而该行与下一行 (「重命名」)之间只有margin:0.25em(该处font-size:small→ ≈3.25px), 复选框于是探出所在行、盖住「重命名」输入框。原生 bootstrap 主题的label > input[type="checkbox"]只有vertical-align: text-top; margin: 0, 没有位移,故仅在 Argon 下复现。- 改法:用
<span style="white-space:nowrap">分组 +for/id关联,让input不再是label的子元素,从而不匹配该选择器;<span>上的white-space:nowrap保留原有的「复选框与协议名不被折行拆散」行为。 - 复选框显式补回
vertical-align:text-top;margin:0:移出label后不再命中主题 的label > input[type="checkbox"]规则,若不声明,浏览器 UA 样式会给复选框 加上约 3px 外边距并改用基线对齐,尺寸与对齐会与修复前不一致。
测试
tests/rules_fields_test.lua:新增静态断言 —— 三个模板的协议复选框块不得出现<label …><input,且必须带id="pf_*"/for="pf_*"关联。
[2.7.1-r1] - 许可证升级为 GPL-3.0-or-later,维护者邮箱更换
纯元数据变更,无代码改动(core.lua 仅同步版本号)。
变更
LICENSE:由 GPL-2.0-or-later 全文替换为 GNU GPL v3(2007-06-29)官方全文, 文件头版本声明同步改为GPL-3.0-or-laterMakefile:PKG_MAINTAINER邮箱由arthur97172@outlook.com改为Arthur97172@users.noreply.github.com;文件头许可证注释同步为 v3README.md/README.en.md:目录结构注释与许可证章节的GPL-2.0-or-later同步改为GPL-3.0-or-later- 版本号同步:
MakefilePKG_VERSION→ 2.7.1、core.luaM.version、README.md/README.en.md/docs/INSTALL.md三处安装文档包名
说明
许可证由 v2-or-later 升为 v3-or-later 属收紧(GPL-3.0 不可再按 v2 分发), 原 v2-or-later 授权下的已发布版本不受影响。项目自身版权归 Arthur97172 所有, 故此次升级无第三方授权障碍。
[2.7.0-r1] - ACL 设备实测通过(关闭 2.6.16-r1 遗留的「未实测」)
纯文档变更,无代码改动(core.lua 仅同步版本号)。
背景
[2.6.16-r1] 引入的 ACL 组(rpcd/acl.d/luci-app-substore.json + menu.d 的
depends.acl)当时只做到读上游源码核实:结论是 ucode dispatcher 在 dispatch()
里校验路径上累积的 depends.acl,不足即 403,因此这是入口级门禁而非仅菜单隐藏。
本机无 LuCI 运行环境,故在 docs/SECURITY.md、docs/TESTING.md 第 9 项、
docs/LEGACY_ISSUES.md 1.2 与两份 README 中都如实标注为「未在设备上实测」。
本轮变更
按 docs/TESTING.md 第 9 项在目标设备完成复核,三项断言全部通过:
| 断言 | 结果 |
|---|---|
非 root 且不在 luci-app-substore 组内的 LuCI 用户 |
看不到本应用菜单入口 |
| 把该用户加入组后 | 入口出现 |
该用户直接访问 /cgi-bin/luci/admin/services/substore/list |
返回 403 Forbidden |
其中第三项是此前唯一「仅有源码依据」的结论 —— 现已在真实设备上确认, 入口级 403 的语义成立,读源码得出的推断与实测一致。
同步更新的文件:
docs/SECURITY.md「访问控制」:末条改为「已在设备上实测通过」并写明三项结果; 「安全测试」小节从未验证清单中移除 ACL(模板渲染与 cron 落盘仍未验证,保持标注)docs/TESTING.md第 9 项:标记 ✅ 已实测通过docs/LEGACY_ISSUES.md1.2:将「仍未做的验证」改写为「设备实测(已完成并通过)」, 逐条列出三项断言README.md/README.en.md:安全小节的「未在设备上实测 / not measured on a device」 改为「已在设备上实测通过 / measured on a device」
未做
- 未记录实测固件版本 —— 用户未提供,不臆测填写
- LuCI 模板渲染、cron 落盘行为仍未在设备上验证(这两项与 ACL 无关,维持原标注)
历史条目说明
[2.6.16-r1] / [2.6.17-r1] 中「未在设备上实测」的记载是那两个版本当时的真实
状态,按惯例不改写历史条目;本条即为其后续结论。
[2.6.17-r1] - 明确最低支持系统为 OpenWrt / ImmortalWrt 23.05
纯文档变更,无代码改动(core.lua 仅同步版本号)。
背景
[2.6.16-r1] 引入的 ACL 组靠 menu.d 的 depends.acl 生效。核实上游源码后确认:
入口级 403 的语义只存在于 ucode dispatcher(23.05 起);旧版 Lua dispatcher
(≤ 22.03)里 menu.d 的 depends.acl 只影响菜单渲染,入口级拦截需另补
entry.acl_depends。
本项目的处置是明确支持边界,而不是为旧版补 entry.acl_depends:
最低支持 OpenWrt / ImmortalWrt 23.05,更早的版本不在支持范围内。这样 ACL 的
入口级语义在支持范围内始终成立,无需维护两套 dispatcher 分支。
变更
README.md/README.en.md/docs/INSTALL.md:安装小节新增最低支持版本声明docs/LEGACY_ISSUES.md1.2、docs/SECURITY.md「访问控制」:旧版 dispatcher 段落 改述为「不在支持范围内,故无需处理」,并注明依据(用户 2026-10-02 确认)- 版本号同步:
MakefilePKG_VERSION→ 2.6.17、core.luaM.version、 三处安装文档中的包名
未做
- 未新增
entry.acl_depends(按上述支持边界,无必要) - 未在设备上实测 ACL 拦截效果 —— 仍需按
docs/TESTING.md第 9 项复核
[2.6.16-r1] - 安全与数据完整性:wget SSRF 缺口、token 校验、ACL、静默失败
本轮按 docs/LEGACY_ISSUES.md「六」的处置优先级 1–8 实施。每项都补了自包含回归
测试,并对 HEAD 做了反向验证(新断言在修复前失败、修复后全绿)—— 只证明「修复后
测试通过」无法排除「这条断言本来就不会失败」。
1. wget 后端的 SSRF 缺口(安全)
[2.6.12-r1] 的「连接后复核对端地址」只对 curl 成立 —— 它靠 %{remote_ip}
拿到真实对端 IP。wget 后端没有任何等价物:busybox wget 拿不到对端 IP,-S 日志
里的重定向链也只能事后看。于是在「本机没有 DNS 解析手段」的设备上,预检
(check_public 的 fail-open 放行)之后不存在任何一处校验 —— 等于完全没有 SSRF
防护,而这条路径此前是静默的。
现按与 verify_peer_ip 相同的原则收敛:校验不了就拒绝。fetch_wget 在
opts.unverified 为真时直接返回错误并提示安装 curl。
影响面:仅「无任何解析手段 且 目标是域名 且 后端是 wget」的设备。字面 IP
目标不受影响(check_public 对 IP 提前返回,不产生 unverified)。
测试:tests/dns_fallback_test.lua 用例 H(含桩写入 evilbody,确保断言不是因
「内容为空」而误过)与对照组 H2。反向验证:修复前 3 条断言失败。
2. 删除订阅部分失败时漏写 cron
action_delete 原先只在全部删除成功时调用 core.write_cron(),部分失败时直接
返回、跳过了它。后果:被删订阅的 cron 行仍留在 crontab 里,substore-cron.sh 拿着
已不存在的 id 反复执行、每次非 0 退出,在日志里刷失败并让监控误报。
现改为只要有订阅真的被删掉(removed > 0)就重写 cron,与成功/失败分支无关。
测试:tests/controller_robustness_test.lua 增加部分失败仍写 cron、全部失败不写 cron
两条断言。反向验证:修复前 1 条断言失败。
3. 混合格式文本导入不再静默丢一半
本地粘贴的文本若混用多种格式,此前 detect() 只认优先级最高的一种,其余部分被
静默丢弃,而 parse 返回的是合法表 —— 同步报成功,用户以为整份都导进来了
(实测:「URI + WG conf」只剩 WG 节点,「URI + JSON」只剩 URI 节点,err 均为 nil)。
新增 M.detect_all() 收集文本中全部出现的格式,本地文本导入在多于一种时
明确报错并列出检出的格式。
实施中修正了两处会把合法配置拒之门外的误判:INI 段头 [Proxy] 被误判为 JSON
数组(加 is_ini_section_head() 排除);「URI + JSON」方向漏检(补行级
has_json_object_line())。
刻意限定范围:守卫只作用于本地文本导入,远程订阅路径(M.detect / M.parse)
未改动 —— 远程内容若混用格式仍是静默取一种,与修复前一致。
测试:新增 tests/parser_mixed_format_test.lua(70 条断言)。反向验证:修复前探针
显示「URI + WG conf」得到 nodes=1, err=nil。
4. 写盘失败被静默吞掉
core.lua 的 save() 返回 util.atomic_write(...) 的结果(失败时是 false, err),
而 M.remove / M.ensure_token 此前丢弃了返回值:写盘失败时 M.remove 仍报成功
(订阅文件已删、索引没更新 → 索引指向不存在的订阅);M.ensure_token 会把一个
没有落盘的 token 返回给调用方(页面显示 token,实际不存在)。现改为透传失败与原因。
测试:tests/data_integrity_test.lua 用 util.atomic_write 猴补丁注入写失败。
反向验证:修复前 5 条断言失败。
5. 表单 token 校验:空 token 此前可通过(M28)
post_ok() 只判 formvalue("token") ~= nil,空串也通过;且所有 entry 均未声明
post,框架的 test_post_security 从未执行(已从上游 luci/dispatcher.lua 核实)。
已从上游 luci/template.lua 核实:viewns 元表的 token 键返回
disp.context.authtoken —— 模板里的 token 就是 context.authtoken,因此
「提交的 token 与 authtoken 比对」正是框架自身的判据,不会误拒任何合法表单。
现要求 token 存在且非空,并在能取到 authtoken 时要求相等;取不到时退回「非空即
通过」(不因取不到值而拒绝全部请求)。失败原因通过 post_fail_msg 回显到列表页。
同时补齐原先 9 处忽略返回值的调用点(7 处 back_to_list()、2 处
back_to_nodes()),使校验失败必然被用户看到。
测试:tests/controller_robustness_test.lua M28 段 6 条断言。反向验证:修复前 7 条失败。
6. 新增 ACL:未授权的 LuCI 用户不再看到本应用(M29)
此前本应用没有任何 ACL —— 没有 acl.d 文件、菜单也没有 depends.acl,任意能登录
LuCI 的用户都能读写全部订阅(含凭据 URL 与下载 token)。
新增 root/usr/share/rpcd/acl.d/luci-app-substore.json 定义 luci-app-substore 组
(读写 uci: substore),menu.d 两个条目均声明 depends.acl 引用它,Makefile
增加对应的安装规则。ACL 结构已对照上游 luci-base 与 luci-app-commands 核实。
执行范围(已从上游源码核实):这是入口级门禁,不只是「菜单里看不见」。
ucode dispatcher(23.05+,现代目标机实际运行的那套)的 build_pagetree() 把 menu.d
与 Lua 控制器装进同一棵树,dispatch() 逐段 ctx_append 累积路径上每个节点的
depends.acl,ACL 不足即返回 403 Forbidden —— 直接访问 URL 同样被拦住。
又因 ACL 沿路径累积,挂在父节点 admin/services/substore 上的 ACL 已覆盖其下全部
18 个 entry(form / nodes / delete / save / update / probe …)。
旧版 Lua dispatcher(≤ 22.03)行为不同:menu.d 的 depends.acl 只影响菜单渲染,
入口级需另补 entry.acl_depends(本轮未做,理由见 LEGACY_ISSUES 1.2)。
未在设备上实测(如实记录):以上来自读上游源码,本机无 LuCI 运行环境。
需按 docs/TESTING.md 第 9 项复核 —— 未授权用户既看不到菜单入口,直接访问 URL
也应返回 403。
回滚:删除 acl.d 文件(及 Makefile 中对应两行)并移除 menu.d 两个条目的 depends 块。
测试:新增 tests/acl_menu_test.lua(19 条断言)固化跨文件接线 —— 接线上任何一环写错
都不会报错,只会静默失效(ACL 形同虚设),故必须由测试锁住。反向验证:修复前
13 条断言失败。
7 / 8. 确认为已知限制并写入文档(无代码改动)
- hysteria v1 导出 sing-box 需自行补
up/down(节点模型无带宽字段,补默认值属猜测) - hysteria v1 的 URI 只保证「本包导出 → 本包导入」不失真(上游规范站点持续 404)
http协议不可手工新建(权威协议表不含它;可导入可导出)- AmneziaWG 参数在界面上是单个 JSON 文本框
- wget 后端的体积与重定向检查是请求发出之后的(busybox wget 无
--max-filesize/--max-redirect;超限响应体被丢弃并报错、重定向链逐跳复检, 差别仅在于晚于请求发出;装 curl 可完全避免) - 无 DNS 解析能力的设备上 wget 后端拒绝域名订阅(见上文第 1 项)
已写入 README.md / README.en.md 新增的「已知限制 / Known limitations」小节、
docs/SECURITY.md 与 docs/LEGACY_ISSUES.md(逐项记录「为何不改」的依据)。
文档
docs/LEGACY_ISSUES.md:1.2(M28/M29)、2.1、2.2、2.3、2.4、3.1、3.2、3.4、3.5 更新为已实施/已确认;新增「六、本轮实施记录」含逐项回归测试与反向验证结果docs/SECURITY.md:新增「访问控制」小节、wget 后端处置、重定向逐跳复检、 更新「安全测试」为实际测试文件清单docs/TESTING.md:新增 4 个测试文件行与 3 项集成验证(混合格式、部分删除 cron、ACL、token)README.md/README.en.md:新增「已知限制」小节、安全小节更新、目录结构补 acl.d
[2.6.15-r1] - 修复:删除订阅后引用它的组合订阅不重算
缺陷
删除一个订阅后,引用它的组合订阅会继续输出该订阅的节点:
- 组合的节点物化在
nodes/<combo_id>.json,只有combo_refresh会重写它; - 会触发重算的路径只有
M.sync(源更新时)与三个节点级控制器入口 (action_node_save/action_node_delete/action_node_set_group), 删除订阅这条路径从未调用过; - 结果:删掉源订阅后,组合的下载链接
(
/substore/download?token=<combo>&target=...)继续吐已删订阅的节点, 直到别的源更新时才被动纠正 —— 看着改了,其实没修。
修复(core.remove)
在数据不变量层面修,而不是在控制器里补一次调用:与 add_combo / save_combo
在写入口内部调用 combo_refresh 的做法保持一致。
删除订阅时,在同一次 pairs(items) 遍历里处理每个组合的 sources:
- 摘掉死 id(不是留着),并记下受影响的组合 id;
- 与订阅列表同一次写盘落盘,不留下「列表已删、
sources还引用」的中间状态; - 写盘后对每个受影响的组合调用
combo_refresh,立刻重算物化节点。
摘掉死 id 而不是留着,有两个实际原因:列表页「来源」列用 name_by_id[sid] or sid
兜底,留着就会显示 s00000003 这种裸 id;而且当组合的来源被删光时,
combo_refresh 看到 #srcs > 0,不会给出「请选择至少一个订阅」,
组合会静默变成 0 节点。摘掉后能正确报错。
实现上的坑:不能先摘 sources 再调用 M.refresh_combos(id) —— 后者是按
「sources 里包含 src_id」来筛组合的,死 id 一旦摘掉就一个都匹配不到。
必须在同一趟里收集受影响的组合 id,再直接对每个调用 combo_refresh。
测试
tests/core_combo_test.lua 增加 13 项(23 → 36 项):
- 删除源后组合的
node_count立刻下降,物化节点里不再有已删源的节点 - 下载链接(真正被 Passwall / OpenClash 拉取的东西)不再含已删源的节点名, 且保留其余源的节点
- 死 id 已从
sources摘掉 - 来源被删光时报错(
error非空、node_count == 0、sources为空) - 只被某个组合引用的订阅被删后该组合被清空,无关组合不受影响
反向验证:拆掉本次改动后 8 项断言失败;只加刷新、不做剪除的变体恰好 3 项剪除断言失败 —— 两半都是承重的,不是恒真断言。
[2.6.14-r1] - 订阅列表页勾选批量删除 + 「自定义」User-Agent 用法说明
新增:订阅列表页的勾选批量删除
订阅一多,只能一条条点行内的「删除」。改成与节点页一致的勾选批量删除:
- 「名称」列之前新增选择框列:表头的选择框全选 / 全不选,每条订阅另有独立选择框
- 「添加组合订阅」之后新增「删除」按钮:勾选后删除单条或多条;
一个都没勾选时不删除任何东西(只提示,与节点页
substore_delete_selected同一套交互) - 批量删除走一个位于表格之外的隐藏表单(每一行已各有一个删除表单,HTML 不允许表单嵌套), 选中订阅的 id 以逗号拼接后写入
控制器 action_delete 的 id 参数改为支持「单个」或「逗号分隔多个」,与节点页
action_node_delete 的 idx 是同一套约定。订阅 id 形如 s%08x,不含逗号,切分不会切坏。
部分失败必须回显(§18):勾了 3 条只删掉 1 条时显示「已删除 1 个,另有 2 个删除失败」,
而不是显示成功 —— 否则用户不会再回头管剩下那两条。全部失败时回显 core.remove 给出的原因;
一个可用 id 都没有时报「未指定要删除的订阅」,不静默跳回。
优化:「订阅客户端类型」的提示补充「自定义」用法
原提示只说了「不确定就保持『默认』」,没说「自定义」该怎么填。补充说明:填要原样发送的
User-Agent 请求头,格式与预设里的值同形(客户端名/版本号,例如 clash-verge/v2.5.0、
v2rayN/7.22.0、mihomo.party/v2.0.0 (clash.meta));可含空格、括号、分号、下划线等可见字符
(整串原样发送,不解析、不改写),不能含换行等控制字符,最长 256 字符;版本号填机场要求的
最低可用版本;选「自定义」但留空 = 不发送 UA(等同「默认」)。以上均与
http.validate_user_agent / core.resolve_user_agent 的实际行为一致,不是另写一套说法。
测试
- 新增
tests/subscriptions_bulk_delete_test.lua(34 项):把subscriptions.htm按 LuCI 的 方式重建成 Lua chunk 真的渲染一遍,再对生成的 HTML 断言 —— 选择框列在「名称」之前、 每行一个且 value 是订阅 id、删除按钮在「添加组合订阅」之后、隐藏表单在表格之外且带 token/id、 空选时先alert且不提交、id 以逗号拼接、全选同步所有行、空列表colspan与表头列数一致 tests/controller_robustness_test.lua增加 7 项:多个 id 逐个删除、逗号两侧带空格、 成功后写一次 cron、部分失败回显且每个 id 都尝试过、全部失败回显原因、无可用 id 报错、 纯分隔符不得交给 core- 反向验证:拆掉本次改动后,视图侧 27 项、控制器侧 6 项断言确实失败(不是恒真断言)
文档
README.md / README.en.md / docs/INSTALL.md 同步版本号与批量删除说明,
docs/TESTING.md 补测试清单。
[2.6.13-r1] - 新增「订阅客户端类型」(User-Agent)支持
新增:按订阅指定下载用的 User-Agent
用户实测:同一机场(Allblue 加速器,8.217.0.49)的 4 个订单链接,
分别只有用 Clash Verge / v2rayN / Clash Party / FlClash 才解析得出节点;
本应用只能解析出 7 个「描述信息」节点:
- name: 当前更新的订阅链接 type: ss server: 127.0.0.1 port: 1080
- name: 与您使用客户端不兼容 type: ss server: 127.0.0.1 port: 1080
- name: 请复制 curl/8.22.0 类型 type: ss server: 127.0.0.1 port: 1080
...(共 7 条,密码均为 00000000-0000-0000-0000-000000000000)
根因:机场按请求的 User-Agent 决定返回真实节点还是占位内容。本应用此前
完全不发送 UA,curl 用的是自带的 curl/x.y.z,被机场判为「不兼容的客户端」,
于是返回一段把提示语写进节点名的占位内容 —— 服务器把请求方的 UA 回显进了那句
提示里(所以路由器上看到的是 curl/8.22.0,沙箱里看到的是 curl/8.18.0)。
占位内容本身是合法的 ss 节点,所以解析不报错,症状是「更新成功但节点全不可用」。
每个订单链接绑定唯一一种客户端:用错客户端的 UA 同样只拿到占位内容,
不存在一个通用 UA 能同时适配四种链接。
修复:新增按订阅的「订阅客户端类型」设置,下载时以 -A(curl)/ -U(busybox wget)
发送对应 UA。四个预设的 UA 字符串取自各客户端源码(非猜测),版本号取用户给出的
最低可用版本:
| 预设 | User-Agent | 来源 |
|---|---|---|
| Clash Verge | clash-verge/v2.5.0 |
clash-verge-rev src-tauri/src/utils/network.rs |
| v2rayN | v2rayN/7.22.0 |
v2rayN ServiceLib/Common/Utils.cs(无 v 前缀) |
| Clash Party | mihomo.party/v2.0.0 (clash.meta) |
Clash Party src/main/config/profile.ts |
| FlClash | FlClash/v0.8.93 clash-verge Platform/linux |
FlClash lib/common/package.dart(三段空格分隔) |
另可选「自定义」自行填写。默认「不设置」= 保持原行为(发送下载工具自带的 UA)。
验证:4 个链接各用对应预设,均解析出 310 个 vless 节点(Clash 系 UA 返回 Clash YAML,v2rayN 返回 base64 URI 列表);交叉验证用错预设仍是占位内容, 不设 UA 仍是 7 个假节点。
安全:UA 来自表单,属不可信输入。http.validate_user_agent 拒绝控制字符
(换行会让 curl 把它当成额外请求头拼进去)与超过 256 字符的值;进入命令行前经
util.shq 引用。与代理一致,非法值明确失败而非静默忽略(§12):静默忽略会让
用户以为 UA 已生效,实际拿到的仍是占位节点。
新增测试 tests/user_agent_test.lua(64 项,全部不触网):UA 取值校验、
-A/-U 确实进入命令行且经 shell 引用、重定向的每一跳都带 UA、预设解析与往返、
core.add/core.sync 的存储与透传、非法 UA 不发起下载、以及「表单 → 控制器 →
core」整条接线的端到端断言。已按反向验证确认:拆掉接线后对应断言确实失败
(http 侧 6 项、控制器侧 5 项)。
[2.6.12-r1] - 修复 [2.6.8-r1] 引入的「无法解析目标主机名」回归 + 格式下拉启用条件
修复:所有域名订阅在缺少 luci-lib-nixio 的设备上报「无法解析目标主机名」
用户实测:2.6.7-r1 能正常解析的订阅(update.glados-config.com 的 mihomo YAML、
s.feijiyunduijie999999.com 的 quantumult / quantumultx / shadowrocket 三种格式),
从 2.6.8-r1 起状态一律变成「无法解析目标主机名」。
根因(392c658,2.6.8-r1):http.check_public 里「解析不出 IP」被改成一律
fail-closed 拒绝,理由是「本包依赖 luci-lua-runtime,后者硬依赖 luci-lib-nixio,
所以解析失败只意味着真的解析不了,代价为零」。这个前提在用户设备上不成立:
resolve() 只有 nixio.getaddrinfo 一条路,nixio 取不到时恒返回 nil,
于是每一个域名都被判成「解析失败」——而 curl/wget 自带 libc 解析器,
照样能把域名解析出来并下载。真正的错误是把「本机没有解析手段」与
「这个域名解析不出来」合并成了同一个 nil。
修复:
resolve()改为多级回退:nixio.getaddrinfo→ busyboxnslookup(io.popen, 只取Name:段之后的Address:行,避免把 DNS 服务器自己的地址当解析结果)。- 返回值拆成
ips, have_resolver:有解析手段却解析不出来 → 仍 fail-closed (127.0.0.1.nip.io这类绕过口必须继续堵死);完全没有解析手段 → 放行, 但返回第三个值unverified = true。 - 新增连接时对端校验
verify_peer_ip:fetch_curl的-w同时取%{http_code}与%{remote_ip},用真正建立连接的那个 IP 复核。 这既补上了unverified放行路径的校验,也顺带免疫「预检时解析到公网、 连接时解析到内网」的 DNS rebinding。重定向的第一跳同样复核 (Location检查只能拦第二跳)。走代理时跳过(%{remote_ip}是代理地址)。 unverified且拿不到对端 IP → 拒绝:「无法校验」不等于「放行」。
验证:同一台机器上对上述真实主机名调用 check_public,
HEAD 返回 false / 无法解析目标主机名,修复后返回 ok = true。
新增 tests/dns_fallback_test.lua(36 断言,覆盖 nslookup 解析、Server 段误用、
NXDOMAIN fail-closed、无解析手段放行、连接时对端校验、代理跳过),
对 HEAD 反向验证 14 条失败,修复后全绿。
优化:订阅列表「订阅链接转换」的格式下拉,未解析出节点时禁用
刚添加还没点「更新」、更新失败、或解析结果为空的订阅,node_count 为 0,
此时格式下拉置灰不可选(disabled="disabled" + opacity:0.5 +
cursor:not-allowed + title 提示),下方说明文案同步切换为
「更新并解析出节点后才能选择格式」(新增 msgid,已补 po/zh-cn/substore.po)。
避免用户选出一个必然为空的订阅链接。
新增 tests/subscriptions_format_gate_test.lua(20 断言):把模板按 LuCI 的方式
重建成 Lua chunk 并用替身环境真实渲染,再对生成的 HTML 断言
(含「同一行在 node_count 变大后必须立刻变为可选」的反面对照)。
对 HEAD 反向验证 8 条失败。
[2.6.11-r1] - P4:遗留项决策后实施(1.1 / 1.3 / 1.4 / 1.5 / 2.5,3.3 补文档)
docs/LEGACY_ISSUES.md「五」的推荐方案中,除标记为暂缓的(2.1 / 2.2 / 2.4 /
3.1 / 3.2 / 3.5)与维持现状的(2.3)外,其余全部实施。每项都补了自包含回归
测试,并对 HEAD 做了反向验证 —— 新断言在修复前失败、修复后全绿:
| 项 | 回归测试 | HEAD 上失败断言数 |
|---|---|---|
1.1 mkdir 锁 |
tests/list_lock_test.lua(39 条) |
18 |
1.3 sing-box transport |
tests/singbox_transport_test.lua(28 条) |
18 |
1.5 QX tag= 逗号 |
tests/qx_tag_comma_test.lua(24 条) |
9 |
全量:44 个 Lua 测试文件 + tests/cron_result_test.sh,全部通过。
1.1 订阅列表读写加锁(load() → save() 丢更新)
- 读整表、改、写整表全程无互斥:LuCI 页面保存订阅、cron 定时更新、组合订阅自动 重算三者同时发生时,后写者整表覆盖先写者,订阅静默丢失且不报错。
- 本机没有
nixio(用不了flock),Lua 5.1 的io.open也没有O_EXCL, 因此用mkdir做锁(成功者唯一)。陈旧锁回收用锁目录自身的 mtime 判定, 而不是目录里的文件:mtime 由mkdir原子设好,不存在「目录已建、时间戳还没写」 的窗口。阈值util.LOCK_STALE = 60秒;持有者被 kill 后残留的锁最多 60 秒即可回收, 不会永久死锁(那比丢数据更糟 —— 订阅从此再也改不了)。 core.lua新增with_list_lock,把 7 个写入口(add/add_local/ensure_token/save_meta/remove/add_combo/save_combo)统一包一层, 而不是在每个函数体里手写 acquire/release —— 后者一旦有人中途return(if lerr then return nil, lerr end这种)就会漏掉释放。包在最外层则无论从哪条 路径返回都会释放。- 可重入:
save_combo内部会调save_meta,两者都要保护;不可重入的话第二次 取锁会把自己挡在门外,组合订阅永远保存不了。本进程已持锁时只加计数、不再取锁。 - 实施中修正了推荐方案本身的两处疏漏:① 锁目录最初写成常量
M.LOCK_DIR,而测试 普遍在require之后改写core.DATA_DIR,常量不会跟着变 —— 会去锁真实的/etc/substore;改为由M.DATA_DIR现算。② 全新安装时DATA_DIR尚不存在,mkdir <DATA_DIR>/.lock失败,而失败在lock_acquire眼里等同于「他人持锁」, 症状是第一次保存订阅就报「正被另一个进程修改」;已在取锁前先ensure_dirs()。 M.merge是只读的(只读各订阅节点、过滤排序后返回数组),包进锁后一旦取锁 失败会返回nil顶掉原本的数组,把「拿不到锁」变成调用方眼里的「没有数据」—— 比不加锁更糟。已移出包装列表。
1.3 sing-box 读取侧 transport 整层丢失
- 两个读取侧都不认 sing-box 的
transport对象:parser_json_config读的是outbound.network(sing-box 出站里根本没有这个字段),简易 YAML 解析器只展开tls:子块。于是 ws / grpc / h2 节点全部按 tcp 导入 —— 客户端拿明文 tcp 去连 只开了 ws 的端口,握手必然失败且不报错。这类节点在机场导出的 sing-box 配置里 占比很高。简易 YAML 侧更彻底:path/host连带都没带进node_data。 - 按上游
configuration/shared/v2ray-transport/的字段名补全(已核实,非推测): ws →path+headers.Host;grpc →service_name;http →path+host(数组,取首个);httpupgrade →path+host(单个字符串)。quic在本项目模型里没有对应传输方式,不猜映射。 - 顺带补上
tls.utls.fingerprint→fp:简易 YAML 侧早就读了这个字段,JSON 侧一直 漏着,同一条订阅走两条导入路径会得到不同的节点。
1.4 / 2.5 删除死代码
- 删除
converter.lua、node_converter.lua、parser_yaml.lua三个模块与四个对应 测试文件。三者均已确认无任何实际引用:前两者只被彼此与测试引用;parser_yaml.lua只被parser.lua一行require引入且从未使用(该行一并删除)。 tests/p2_batch7_test.lua中对已删模块的依赖改为直接验证util.uuid本身 —— 那才是唯一在用的实现,形状要求(36 字符、只含十六进制与连字符)与当初一致。tests/parser_yaml_test.lua保留:它实际require的是substore.parser(活跃路径),文件名有误导性但内容有效。
1.5 QX 节点名含逗号时整条丢弃
[server_local]行是逗号分隔的key=value序列,语法里没有引号 / 转义:节点名A,B输出成..., tag=A,B会被读成tag=A加一个悬空字段。QX 对这种行的实际 处置未经核实(本机没有 Quantumult X 可实测),但无论报错还是静默忽略,用户拿到的 都不是他填的那个名字。- 按推荐方案 B 整条丢弃:定义行与
[policy]成员一并去掉,与 Surge 家族丢 wireguard / ssr、Clash 原版丢不支持协议同一约定,也与names_of的排除条件 保持一致(判定用one_line之后的同一个字符串,两边不会再对不上)。 - Surge 家族不受影响:其
[Proxy]行是NAME = type, host, port, …,名字在=左侧,逗号不影响该行解析。
3.3 改名规则语法补文档说明
- Lua 模式无 alternation 语义。
|表示「或」但只在顶层生效:(a|b)不会展开成 「a 或 b」,而是按字面匹配;字符类[...]内的|同样是字面。已在README.md/README.en.md的「使用方法」补上说明。无代码改动。
[2.6.10-r1] - P3:输出层代码级复审(11 项)+ README 精简
对 8 个输出模块与 output.lua 做了逐行复审,按「生成的配置能否被目标客户端加载」
这一条标准筛出 10 项缺陷;另在复核 shadowsocks 数据通路时发现 SIP003 插件被全链路
丢弃,共 11 项。全部已修复、已补回归测试,并对 HEAD 反向验证:
tests/output_layer_fixes_test.lua(47 条断言)与 tests/ss_plugin_test.lua
(41 条断言)在修复前分别失败 30 / 25 条,修复后全绿。
共同特征与 P2 批次七一致 —— 都不报错:导出成功、客户端却拒绝加载或静默跑错。
输出层
- F1
ws-opts父键缺失(output_clash_meta):ws-opts:那一行写在if node.path里面,于是「有 host、无 path」的 ws 节点输出一个缩进 6 空格的headers:,而它的父键根本不存在 —— YAML 直接报mapping values are not allowed here,客户端拒绝整份配置。改为 path 与 headers 共用同一个ws-opts父键。 - F2 空传输层编码成数组(
output_v2ray):wsSettings/grpcSettings/httpSettings无参数时被json_encode的is_array判成空表,编码为[]。 Xray 用标准库json.Unmarshal解析,这些字段是结构体指针,解进数组直接UnmarshalTypeError拒绝启动。触发条件很普通:grpc 节点没填服务名、 ws 节点既没 path 也没 host。为JSON_EMPTY_OBJECT加元表标记,编码为{}; 解码出的空对象不带该标记,后续写入键仍照常编码。 - F3 节点重名不消解(
output_clash_meta):mihomo 的proxies里name是 主键,重名直接拒绝加载整份配置。节点之间重名、节点与生成的策略组 (Proxy/URL-Test/Load-Balance)或保留名(DIRECT/REJECT)撞名 都会触发。改用既有的util.unique_tags统一分配名字。 - F4 未引用的非法 YAML 标量(
output_clash_meta):esc_yaml的需引号字符类 漏了%(YAML 指令前缀)、!(标签前缀)与行首-(块序列项),这三种开头的 裸标量都是非法 YAML。 - F9
amnezia-wg-option子键未转义(output_clash_meta):子键来自导入的 YAML / JSON(不可信),键名里的:或引号会写坏映射。
Surge 家族 / Quantumult X
- F5 QX 的 vless 丢传输层(
output_formats):QX 的 vless 与 vmess 共用同一套 参数名,但只有 vmess 分支写了obfs/obfs-uri/obfs-host/tls-host/tls-verification。vless + ws + tls 的节点导出成明文 tcp 条目,客户端按 tcp 去连 只开了 ws 的端口,必然失败且不报错。 - F6 Surge 家族的 vless 丢传输层:同上,
ws=true/ws-path/ws-headers一个都没写。抽出add_ws()供 vmess / vless 共用。 - F7 参数值里的逗号静默截断凭据:
[Proxy]行与 QX 的[server_local]行都是 逗号分隔的key=value序列,语法里没有引号 / 转义机制 ——password=pa,ss会被 读成password=pa加一个悬空的ss。含逗号的整条丢弃,并同步从成员列表 ([Proxy Group]/[policy])剔除,避免引用不存在的代理。 顺带把to_qx从「边拼字符串边追加」改为「先把具名字段攒成列表再拼接」: 原先的实现无法区分行内本就有的,结构分隔符与值里的逗号,会把每一条合法行 都误判成非法。 - 多值 alpn 的处置:
tests/output_formats_test.lua原断言 tuic 的 alpn 数组 输出alpn=h3,h2。多值 alpn 在 Surge 家族的行语法里同样表达不了,而 F7 的通用 检查会因此丢掉整个节点。alpn 只是协商提示(缺省时客户端用服务端给出的列表), 不像凭据一旦截断就静默发错值 —— 所以只省略该参数、保留节点。断言已按此契约更新。
分享链接
- F8 IPv6 字面量未加方括号(
output_uri):RFC 3986 的 authority 里 IPv6 必须 写成[addr],否则::与端口分隔符无法区分。已是方括号形态的不重复包裹。
shadowsocks SIP003 插件(F11)
plugin 能被解析、能通过 node.normalize 存活,但三个输出模块全都静默丢掉它,
表单侧还会在保存时清空 —— 带 obfs / v2ray-plugin 的节点导出后以明文 SS 去连只接受
带插件握手的服务端,必然失败且不报错;在界面上编辑一次该节点,插件配置即永久消失。
处置依据均核对上游源码 / 文档(非推测):
- SIP002:
SS-URI = "ss://" userinfo "@" host ":" port [ "/" ] [ "?" plugin ] [ "#" tag ], 插件参数整体做百分号编码。新增util.parse_sip003_plugin(含\;\=反斜杠转义)。 - sing-box:
shadowsocks出站只有plugin(字符串,官方文档明确 "Only two are supported: obfs-local and v2ray-plugin")与plugin_opts(SIP003 原始参数串, 原样透传)。按白名单过滤,其余名字会被拒绝加载整份配置。 - mihomo:
plugin-opts是映射而非字符串,名称与参数名都要翻译 (obfs-local/simple-obfs→obfs,参数obfs→mode、obfs-host→host;v2ray-plugin的mode/host/path/tls)。adapter/outbound/shadowsocks.go对这两类插件是强校验的:obfs 的 mode 不在{tls,http}里报"ss %s obfs mode error",v2ray-plugin 的 mode 不是websocket同样报错 —— 都会让整个 outbound 构造失败,进而拒绝加载整份配置。因此参数不全时宁可整个不输出 插件,也不能输出一个必然被拒绝的组合。
模型与表单侧:node.PROTO_FIELDS.shadowsocks 补 plugin(不进这个清单,表单不渲染
它,且 core.merge_form_node 会在保存时把原值清掉)、core.FORM_KEYS 补 plugin
(不进这个表,用户在表单里清空输入框也删不掉旧值),两个视图补字段标签。
其他
- F10 空 target 的响应头与后缀落空(
output.lua):?target=传进来的是"", 而""在 Lua 里是真值,format or DEFAULT_FORMAT兜不住它 ——M.generate一直在做归一化,但content_type_for/extension_for漏了,同一请求里正文按 clashmeta 生成,Content-Type 变成nil(响应头缺失)、文件名后缀退回兜底的.txt。 抽出normalize_format三处共用。 parser.lua集中丢弃残缺节点:finish()统一做valid_hostport校验, YAML / JSON / Surge / wireguard-conf 路径与 URI 路径行为一致。core.cron_time_valid收紧:要求恰好 5 个空白分隔字段、无控制字符。controller的action_node_set_group补core.refresh_combos(id), 与node_save/node_delete对齐。util.json_decode深度上限 64,防止深嵌套输入耗尽栈。- README / README.en 的「功能特性」精简:删去逐字段罗列与「协议转换:任意协议 →
任意协议」的过度声明(实现侧并无该能力,见
docs/LEGACY_ISSUES.md1.4)。
文档
docs/LEGACY_ISSUES.md:新增「四、P3 输出层复审」逐项记录;新增「五、其余遗留项 的修复建议」给出推荐方案与理由;订正 2.6(AWG 3.0/3.1 九字段,[2.6.10-r1]复核 已收录)与 3.4(check_public已改 fail-closed)两处过期状态;1.3 补入已核实的 sing-boxtransport权威字段映射,供下一轮直接实施。
[2.6.9-r1] - P2 批次七:界面 / 探测 / 转换 / 权限(L1 / L5 / L6 / L8 / L9 / L23 / L24 / L25 / L26)
P2 最后一批,九项分布在界面、探测、转换与文件权限四处。共同点是问题都不报错: 界面显示错语言、探测悄悄漏节点、模板把名字吃掉一个字符、正则写错却毫无提示 —— 全部是「看起来正常,实际不对」的类型。
L1 中文 msgid 在英文界面原样显示(subscriptions.htm / nodes.htm / po/zh-cn/substore.po)
三个界面串用了中文当 msgid:<%:操作失败%>、<%:选择格式后生成订阅链接,格式可随时切换%>。
LuCI 的翻译方向是「msgid(英文)→ msgstr(当前语言)」,拿中文当 msgid 且 .po 里没有
对应条目时,英文界面会原样显示中文。
现在 msgid 一律用英文,中文只作为 po/zh-cn/substore.po 里的 msgstr。
新增条目:Operation failed、Pick a format to generate the subscription link; you can switch formats at any time,并补齐此前缺失的 Type。
L5 只转义 </ 挡不住 <!--(7 个视图模板)
注入到 <script> 里的 JSON 此前只做 :gsub("</", "<\\/")。这挡得住 </script> 提前闭合,
但挡不住 <!--:HTML 词法阶段遇到 <!-- 会进入 script data escaped 状态,
其后的 </script> 不再结束脚本块,页面剩下的部分全被当成脚本文本吞掉。
节点名来自订阅内容,一个叫 <!--x 的节点就能把整页搞坏(是页面破坏,不是 XSS)。
现在改为 :gsub("<", "\\u003c") —— HTML 词法阶段再也看不到任何 <,两个坑一并堵上;
而 < 在 JSON 与 JS 字符串字面量里都还原成 <,取值不受影响。
L6 批量探测的进程/fd 无界占用(probe.lua)
M.probe 原来是「先把全部节点的 io.popen 起完,再统一读取」。并行度最高,但代价无界:
每个节点占 1 个进程 + 1 个管道 fd,而节点数由订阅内容决定(上千个很常见)。
路由器上 fd 与进程数都是硬上限,打满之后 io.popen 直接失败 —— 表现是一大片节点
探测不出来,而不是报错。
改为分批:一批最多 M.MAX_PARALLEL(16)个进程,读完并关闭这一批再起下一批。
并发度封顶,总耗时仍是「批数 × 单节点超时」。
L8 空 format 绕过默认格式(output.lua)
?target= 会传进来空串 "",而 "" 在 Lua 里是真值,format or DEFAULT_FORMAT
兜不住它,于是一路落到 return nil, "unsupported format: " —— 冒号后面什么都没有。
用户拿到的是一个说不出原因的错误页(控制器只在 nil 时兜底,覆盖不到空串)。
现在 M.generate 先归一:非字符串按 "" 处理,再去掉首尾空白,为空则用默认格式。
空白串(" ")同样归为「未指定」。
L9 两行安装指令挂错块(Makefile)
output.htm / combo.htm 的 INSTALL_DATA 挂在 /www/luci-static 的 INSTALL_DIR
块下面。目标路径本身是对的,但归错了块 —— 一旦有人调整块顺序就会被装到错误的目录。
现已移入 view 块。
L23 trojan → vmess/vless 生成的不是合法 UUID(converter.lua / util.lua)
原实现取 base64(seed) 的前 36 字符当 uuid。base64 只产出 24 个字符,
sub(1,36) 是空操作,且结果里可能带 + / = —— 根本不是 UUID。
客户端的 uuid 字段按 16 字节解析,格式不对时多数客户端直接拒绝该节点。
新增 util.uuid() 生成 RFC 4122 v4 UUID(8-4-4-4-12,第 13 位固定 4,
第 17 位取 8/9/a/b),转换时用它。
L24 gsub 替换串里的 % 未转义(converter.lua / node.lua)
gsub 的替换串里 % 有语义:%1 是捕获引用,裸 % 会被吞掉,结尾的 % 会注入 NUL 字节。
节点名与服务器地址都来自订阅内容,直接当替换串用会把用户的内容改掉。
新增 util.gsub_literal() 把 % 转义成 %%,converter.apply_template({{name}} 等四个
占位符)与 node.apply_rules 的 {server} / {port} / {uuid} / {name} 模板全部改用它。
node.expand_template 里原有的局部 esc 也统一到同一实现。
L25 非法正则被静默吞掉(node.lua / 控制器)
rename_with_rules 用 pcall 包住 gsub,用户写出非法 pattern(未闭合的 [ 等)时
错误被吞掉,结果是「规则明明写了却完全不生效,页面上没有任何提示」。
新增 M.validate_rename_map():在保存时逐条校验(含 split_alternatives 展开的每个
备选分支),失败返回「重命名规则第 N 行:正则表达式无效(pattern)」。
控制器在 read_rules_fields 这个唯一入口处调用,5 个保存动作全部回显该错误。
parse_rename_rules 同时补记 line_no,让行号指向真正出错的那一行。
L26 数据文件 0644 世界可读(util.lua / core.lua)
io.open 按 umask 创建文件(通常是 0644),而 /etc/substore 下的
subscriptions.json 含订阅 URL 与公开下载 token,nodes/*.json 含 uuid / 密码 / 私钥。
同机任何用户都能读到。
util.atomic_write(path, content, mode)新增可选 mode,在os.rename之后 chmod (先 chmod 再 rename 的话,临时文件名可猜,中间窗口里仍能读到)util.ensure_dir(path, mode)新增可选 mode,走mkdir -p -mcore.ensure_dirs建目录带700,并对已存在的目录补一次chmod 700(从旧版本升级上来的机器上目录已存在,mkdir -m不生效);每进程只做一次, 因为load()每次读列表都会调用它- 两个数据写入点传
"600";cron 文件不传,权限语义保持不变
Lua 5.1 标准库没有 os.chmod(那是 nixio/posix 才有的),实现走 busybox chmod,
路径经 util.shq 引用。
测试
新增 tests/p2_batch7_test.lua(56 项,全离线):
- L1 扫全部视图模板的
<%:...%>与luci.i18n.translate(),断言 msgid 不含 CJK (按 UTF-8 三字节区间判定),并断言.po里新条目齐全 - L6 替换
io.popen为记录桩,统计同时存活的句柄峰值,断言== MAX_PARALLEL且 100 个节点全部关闭、顺序不变 - L8 断言
""/" "/"\t\n "/nil四种写法输出一致,非法名仍报错 - L9 按行号断言两行
INSTALL_DATA落在 view 块与 luci-static 块之间 - L23/L24/L25 断言 UUID 形状、
%字面保留、非法正则报错并指出行号 - L26 替换
os.execute为记录桩,断言 chmod 600 出现在 rename 之后、 不带 mode 时不 chmod、ensure_dirs只 chmod 一次
tests/view_injection_test.lua 的转义断言更新为「转义全部 <」,并新增两条反向对照:
只转 </ 时 <!-- 仍然留存(证明放宽转义范围的理由成立),转全部 < 后
</script 与 <!-- 都不复存在。
tests/controller_robustness_test.lua 的 substore.node 桩补上 validate_rename_map
(控制器新增的依赖;缺失会让整条保存路径 nil 调用 500 —— 是桩缺口,不是产品缺陷)。
反向验证:新断言在修复前的 HEAD 上 34 条失败
(L1×5 / L6×3 / L8×4 / L9×2 / L23×5 / L24×6 / L25×5 / L26×4),
修复后全绿;全量 43 个测试文件 + cron_result_test.sh 全部通过。
[2.6.8-r1] - P2 批次六:网络安全与健壮性(L10 / L11 / L12 / L14)
P2 批次六,四项都围绕「检查的强度不能低于被检查者」这条线: 前两项让校验真正拦得住,后两项让失败路径不再留下副作用。
L10 DNS 解析失败改为 fail-closed(http.lua)
M.check_public 在 resolve() 返回 nil 时放行,理由写的是「无 DNS 解析能力时
尽力而为」。那是一个 SSRF 绕过口:
- 检查侧:
resolve()返回 nil → 跳过全部私网判定 → 放行 - 实际连接侧:curl 自己做解析,
127.0.0.1.nip.io这类公网可解析到内网的域名 会被它解析到127.0.0.1并连上去
只要本机这一刻解析不出来(nixio 缺失、解析器临时故障、超时),两者就分叉。 检查的强度不能低于被检查者,现在解析失败一律拒绝。
代价为零:本包依赖 luci-lua-runtime,后者在 Makefile 里硬依赖 +luci-lib-nixio
(已核对上游),所以 resolve() 返回 nil 只意味着「真的解析不了」——
那种情况下 curl 同样解析不了,下载本来就会失败,只是错误信息会从「连接失败」
变成「无法解析目标主机名」,反而指对了方向。
L11 parse_url 补端口范围校验(http.lua)
hostport:match("^([^:]+):(%d+)$") 只保证端口是数字,http://host:99999/ 与
http://host:0/ 都能通过。这两个端口连不出去,下载必然失败,却会先经过一轮
DNS/SSRF 检查,最终报出「连接失败」这种指错方向的原因。parse_proxy 早已做了
同样的 1–65535 校验,这里对齐。
IPv6 字面量分支([::1]:port)走的是另一条赋值路径,同样纳入校验。
L12 探测目标拒绝以 - 开头的主机名(probe.lua)
命令形如 ping -c 1 -W 2 <host>,host 若为 --help / -c,会被 busybox 的
getopt 当成选项而不是参数。util.shq 的单引号由 shell 剥掉,getopt 看到的
仍然是 -x —— 引号挡不住这一层。
合法主机名(RFC 1123 要求首字符为字母或数字)与 IP 都不会以 - 开头,所以直接拒绝。
ping / tcping / url_test / 批量 probe 四条路径共用 safe_host,一处收口。
L14 下载临时文件在每一条退出路径上清理(http.lua)
fetch_curl 此前只在「本轮开始」和「2xx 成功」两处 os.remove,其余失败路径
(curl 报错、超过大小限制、重定向无 Location、重定向目标无效/不安全、
HTTP 4xx-5xx、重定向次数过多)都把 /tmp/substore_dl_*.tmp{,.hdr,.err} 留在原地。
OpenWrt 的 /tmp 是 tmpfs —— 占的是内存。订阅更新失败后 cron 会定时重试,
于是一轮轮往内存里堆文件,其中 .tmp 可能是部分下载的响应体,最大到 max-size。
现在收敛成一个 cleanup() 闭包,在每一条 return 之前调用。
测试
- 新增
tests/network_security_test.lua(38 条断言):L10 的 fail-closed 与 「公网字面量仍放行」对照;L11 的:0/:65536/:99999拒绝与:1/:65535/ 默认端口接受(含 IPv6 分支);L12 用io.popen替身断言 「以-开头的主机名一个子进程都不启动」,并用合法主机名反向确认替身有效; L14 用模拟 curl 写盘的替身,逐条验证三条失败路径后/tmp无残留 - 全部用例不触网
tests/http_proxy_test.lua的重定向链用例改用公网 IP 字面量而非cdn.example.com:check_public现在解析失败即拒绝,用域名会让 「公网目标应放行」变成「取决于本机有没有 DNS」,测试不可复现- 反向验证:新断言在修复前的
HEAD上 19 条失败(L10×2 / L11×4 / L12×4 / L14×9), 在修复后全部通过
[2.6.7-r1] - P2 批次五:控制器健壮性(L3 / L4)
P2 批次五,修控制器的两项缺陷:一类是未登录可达的 500,一类是 点了按钮却什么都没发生。两者都属于「静默」——不报错、看起来正常。
L3 重复表单字段让 formvalue 返回 table,直接崩在 :gsub 上
-
LuCI 的
formvalue不保证返回字符串。依据上游luci/http.lua的urldecode_message_body:elseif what == parser.VALUE and name then local val = msg.params[name] if type(val) == "table" then val[#val+1] = ... elseif val ~= nil then msg.params[name] = { val, ... } -- ← 第二次出现变成 table而
formvalue原样返回msg.params[name];上游 luadoc 也写着@return HTTP input value or table of all input value。 -
控制器有 ~30 处直接对返回值做
:gsub/util.trim/urlencode, 遇到 table 会抛attempt to call method 'gsub'→ HTTP 500。 实测复现:action_create/action_save/action_local_create/action_local_save/action_combo_save/action_node_set_group/action_probe/action_download共 8 个 action 崩溃。 -
攻击面不限于已登录用户:
/substore/download是无需登录的入口 (供 Passwall / OpenClash 拉取),对它 POST 一个重复的token字段即可触发。 -
现新增
fv(http, key)统一取值:table 取最后一个(与「同名参数后者覆盖 前者」一致),nil保持nil(post_ok依赖它区分「无 token」与 「空 token」)。全部调用点收敛到这一处。 -
更正审计表的表述:触发条件是 POST 重复字段,不是 GET。GET 查询串 走的是
urldecode_params,它只做params[name] = ...覆盖、不建表。 -
顺带清理:
action_node_delete里if type(idx_param) == "table"的兜底 在fv之后已成为死代码,移除。
L4 combo_save / delete / update / node_delete 静默失败
违反项目 §18(失败必须让用户看见,不能「失败了却看起来像成功」):
action_delete:core.remove的返回值被整个丢弃。非法 ID / 订阅不存在时 返回false,页面照常跳回列表 —— 用户点了删除,订阅还在。action_combo_save:名称留空、或一个来源都没勾选时整段跳过直接跳回列表;add_combo/save_combo的返回值同样被丢弃(非法 ID、未选来源、写入失败 一律静默)。action_update:订阅不存在(ID 拼错 / 已被删除)时静默跳回列表。action_node_delete:下标解析不出数字、或下标全部越界时静默跳回列表;write_nodes失败也不提示。- 现四处全部补上原因回显。
测试
- 新增
tests/controller_robustness_test.lua,27 项断言:- 12 个 action 逐个在「所有字段都重复提交」下调用,断言不抛错;
- 重复字段取值语义(取最后一个);
- L4 四处的失败回显 + 成功路径不带
err的守卫。
- 反向验证:指向
HEAD版控制器重跑,27 项中 18 项失败, 崩溃点正是审计表标注的行(substore.lua:90/118/146/170/321与util.lua:9),确认测试覆盖的是真实缺陷而非恒真。 - 全量回归:41 个 Lua 测试文件(1809 项断言)+
cron_result_test.sh(14) 全部通过。 - 版本号 2.6.6-r1 → 2.6.7-r1。
[2.6.6-r1] - P2 批次四:核心数据层(代理解析 / 去重 / cron 退出码 / 规则字段)
P2 批次四,修四项缺陷(审计表 M16 / M17 / M18 / M30)。前三项在数据通路上, 症状都是「静默失效」——不报错、看起来正常,但结果不对或故障无人知晓; M30 则是「字段读得到、界面写不了」的静默数据丢失。
M16 未加方括号的 IPv6 代理地址被拼成非法代理串
M.parse_proxy用^([^:]+):(%d+)$拆 host:port。IPv6 字面量里全是冒号, 这个模式必然失配,于是整个::1:1080落进「无端口」分支当作主机名, 再原样拼回去得到http://::1:1080—— 冒号歧义,curl -x与http_proxy=都解析不了(curl 会把::1:1080整个当主机名),代理静默失效。 更糟的是走[::1]:1080这条正确写法时,为做主机校验把方括号拆掉后 没有拼回去,同样得到http://::1:1080。- 现分三处修正:① 记录是否带方括号;② 未加方括号却含多个冒号时明确报错
并给出正确写法(
::1:1080到底是「地址 ::1 + 端口 1080」还是地址::1:1080,语法上无法判定 —— 与其猜一个再拼一条解析不了的串,不如让用户 补方括号);③ 拼回代理串时,主机含冒号就补上方括号。
M17 去重键不含凭据,同入口的多账号被误删
M.dedup此前只按proto|server|port去重。同一台服务器上的多账号是 极常见的形态(同一入口不同 uuid / 不同密码),这些节点会被判为重复而 只剩第一个 —— 用户看到节点数莫名变少,且丢的是哪个不可预期。- 现抽出
identity_key(),按协议取各自的凭据参与去重键: vmess/vless → uuid;shadowsocks → method+password;ssr → method+password+ protocol+obfs;trojan/hysteria/hysteria2 → password;tuic → uuid+password; socks/http → username+password;wireguard → peer 公钥(沿用原有逻辑)。 凭据完全相同的节点仍然照常去重。
M18 cron 脚本把「Lua 根本没跑完」当成成功
substore-cron.sh的退出码判定是''|0) exit 0。结果行缺失被和 「0 个失败」归为一类 —— 而结果行缺失的真实含义是 Lua 没跑到最后: 模块加载失败、core.list()抛异常(它在pcall之外)、解释器中途死掉。 于是一次彻底失败的订阅更新在 cron 与外部监控看来与成功无异, 故障永远不会被发现。- 现把空结果行单列:写 stderr 诊断并
exit 1。
M30 「协议筛选 / 重命名」字段读得到、界面写不了
- 控制器
read_rules_fields一直在读proto_filter_*与rename_map, 但三个表单(form.htm / local_form.htm / combo.htm)都没有提交它们的控件。 后果有两层:① 功能不可达,用户永远设不了这两项;② 更严重的是 静默数据丢失 —— 控制器每次把formvalue的nil落成"", 于是通过 UCI 手工设过的值在下一次保存时被抹掉。 - 现三个表单补齐控件(协议勾选框 + 重命名文本域),并把协议清单收敛到
core.RULE_PROTOS单一来源,由控制器与三个模板共用:两边各写一份的话, 一旦漂移,勾选框就会生成一个永远匹配不到任何节点的proto_filter, 而症状是「勾了没用」——不报错,最难查。清单用的是node.normalize产出的 规范协议名(socks5在解析阶段已归一成socks,故不在清单内)。 已有值在编辑页回填,避免「打开编辑页看不到当前设置,一保存就被覆盖」。
测试
- 新增
tests/rules_fields_test.lua,42 项断言:RULE_PROTOS的形态 / 唯一性 / 规范性,三个模板与控制器的静态检查,以及「控制器收集逻辑产出的 CSV 真的能被node.apply_rules用来筛选、rename_map真的生效」的行为检查。 反向验证:指向HEAD版模板与控制器重跑,17 项失败。 tests/node_extended_test.lua扩充 dedup 段(6 项新断言)。原有用例 「两个 uuid 不同的 vmess 应合并成 1 个」正是 M17 要修的错误行为, 已改为断言修复后的正确结果。 反向验证:指向HEAD版node.lua重跑,6 项失败。tests/cron_result_test.sh增加两项用例(core.list()抛异常、 模块加载失败),共 14 项。反向验证:指向HEAD版脚本重跑,3 项失败。tests/controller_local_test.lua的substore.corestub 补上RULE_PROTOS(控制器现在会遍历它)。- 全量回归:40 个 Lua 测试文件(1782 项断言)+
cron_result_test.sh(14) 全部通过。 - 版本号 2.6.5-r1 → 2.6.6-r1。
[2.6.5-r1] - P2 批次三:输出层合法性(配置能否被目标客户端加载)
P2 批次三,修输出层七项缺陷(审计表 M19 / M23 / M24 / M25 / M27 / L21 / L22)。 共同判据只有一条:生成的文件/链接必须能被目标客户端真正加载, 而不是「看起来像那么回事」。
M23 wireguard 数组字段以字符串形态原样透传
- 节点模型里
allowed-ips/reserved/dns的形态取决于来源:Clash YAML 的 嵌套列表解析后是 table,表单导入 / URI 导入 /.conf导入后是"0.0.0.0/0, ::/0"这样的字符串。输出层此前不看类型直接透传,于是 sing-box 出"allowed_ips":"0.0.0.0/0"、"reserved":"1,2,3", clash-meta 出allowed-ips: 0.0.0.0/0这个标量。 - 而 mihomo 的
allowed-ips/dns是[]string、reserved是[]uint8, sing-box 同名字段亦然 —— 标量反序列化失败,整份配置拒绝加载。 - 现统一归一为列表:clash-meta 的
yaml_value改为「数组或逗号分隔字符串 → YAML 列表」;sing-box 的allowed_ips/dns走as_list,reserved走as_num_list(sing-box 要求[1,2,3]数字,字符串数组同样失败)。 空值不输出该键(allowed-ips: []也是非法值)。
M27 未加引号的 YAML 标量里反斜杠被静默翻倍
esc_yaml先无条件执行gsub("\\", "\\\\")再判断是否需要引号。而反斜杠 不在need_quote的触发集里,所以pa\ss走的是「不加引号」这条路: 输出password: pa\ss的字面文本是pa\\ss,YAML 按 plain scalar 回读 得到两个反斜杠 —— 密码 / 路径直接错。- 现把转义链移进
if need_quote分支:未加引号时反斜杠就是字面反斜杠, 加引号时才需要转义。pa\ss→pa\ss;pa\ss: x(含:,需引号) →"pa\\ss: x"。
M24 hysteria2/hysteria 分享链接丢掉「跳过证书校验」
- 该分支只读
n.insecure。但按parser.lua自身的注释,模型里的权威字段是skip-cert-verify(sing-box JSON 的tls.insecure也映射到它), 而insecure只是 URI 参数名、只有 URI 解析器会写它。 - 于是 Clash YAML / sing-box JSON / 表单导入的节点在导出分享链接时, 「跳过证书校验」被整个丢掉,客户端按严格校验握手直接失败。
- 现按
skip-cert-verify→skip_cert_verify→insecure的优先级读取, 统一归一为insecure=1/insecure=0(falsy 判定与output_singbox.lua的bool()一致:false/"false"/0/"0"视为否)。
M25 trojan/tuic 分享链接的 alpn 数组未归一
- 这两个分支把
n.alpn直接交给url_encode,而url_encode会tostring()—— alpn 为 table 时(Clash YAML 的 alpn 列表、sing-box JSON 的tls.alpn导入后都是 table)链接里出现alpn=table%3A%200x..., 客户端解析失败。vless 分支早已做了归一,这两处漏了。 - 现抽出
alpn_str()统一处理,三处共用。
L21 成员列表里含逗号的名字被当成两个成员
- Surge 家族
[Proxy Group]与 QX[policy]的成员列表是NAME = select, X, Y, DIRECT,语法里没有引号 / 转义机制。名字里的逗号 会被当成成员分隔符:A,B被读成两个成员A与B,两个都不存在 —— Surge / QX 会因「引用不存在的代理」拒绝加载整份配置。 - 现
names_of()排除含逗号的名字(节点定义仍留在[Proxy]/[server_local]中,只是不进成员列表),并统一先过util.one_line():定义行本就经过one_line(换行→空格),成员列表若用原始名就对不上定义行,同样是悬空引用。
M19 QX [policy] 引用未定义的服务器
- QX 的
[server_local]只输出 shadowsocks / vmess / vless / trojan 四类协议, 而[policy]用未过滤的names_of(nodes)收集全部节点名 —— hysteria2 / tuic / socks / wireguard 等没有定义行,列进static=就是 悬空引用。 - 现按「真正写出了
[server_local]行的节点」收集成员。
L22 非数字 port 原样输出
port: abc/port: 443/tcp这类非数字值会让 mihomo 拒绝加载整份配置。 sing-box / v2ray 输出一直用tonumber() or 0兜底,clash-meta 漏了。 现对齐。
已核实无需修改
- M26(hysteria/hysteria2/tuic 缺
security时不输出 TLS)已在 P0 批次四 修复(fb51e6e为三者补了node.normalize的security默认值), 经探针复核:raw 节点经normalize后 sing-box / clash 均正确输出 TLS。
测试
- 新增
tests/output_legal_test.lua,39 项断言,覆盖上述七项, 并对「本就正确的行为」加了守卫(数组形态不被破坏、字符串 alpn 不受影响、 数字端口不被改写、无insecure时不输出该参数)。 - 反向验证:把测试指向
HEAD版输出模块重跑,39 项中 28 项失败, 确认它们覆盖了缺陷而非恒真;其余 11 项是行为守卫,本就应当通过。 - 全量回归:41 个 Lua 测试文件(1786 项断言)+
cron_result_test.sh(11) 全部通过。 - 版本号 2.6.4-r1 → 2.6.5-r1。
[2.6.4-r1] - P2 批次二:wg-quick 导入健壮性与 IPv6 内网判定
P2 批次二,修 parser.lua 的五项缺陷(审计表 M9 / L20 / L16 / L17 / L18)。
每项均先复现、后修改,并新增回归测试。
M9 wg-quick .conf 一个坏 [Peer] 废掉整份文件
- 首个失败对端即中止:
if not host … then return nil, … end位于for _, p in ipairs(peers)循环体内,于是第一个缺Endpoint(或Endpoint解析不出端口)的[Peer]会让整份.conf返回nil, 同文件里其它完好的对端全部丢失。现在只跳过该对端;若一个可用对端都没有 (#peers > 0已保证走不到「没有 [Peer]」分支),返回错误而不是空列表 —— 空列表会被上层当成「解析成功但 0 节点」的静默失败。 - 不剥行内注释:行扫描只跳整行
#/;注释,而 wg-quick 的parse_options用stripped="${line%%\#*}",即从第一个#起全部丢弃 (不要求#前有空白)。于是Endpoint = 1.2.3.4:51820 # 备用会把# 备用当成值的一部分,split_hostport取不到端口,同样整份作废。 现对齐 wg-quick 语义做行内剥离;;按上游行为不作注释符, 仅保留本实现原有的整行容忍。
L20 多 [Peer] 时数组字段被所有节点共享
for k, v in pairs(common) do out[k] = v end是浅拷贝,而common.dns(多值时为数组)与common.reserved(恒为数组)是 table,于是所有生成的 节点指向同一个表 —— 按节点编辑 DNS 会同时改到全部节点。紧邻的amnezia-wg-option子块本就做了副本(注释还专门说明了这个隐患),这两个漏了。 现统一走一层表拷贝。
L16 parse_local_link 丢掉 query 与 userinfo
- 无路径时 query 全丢:authority 用
^([^/]*)切分,?不在排除集内, 于是http://host:port?target=ClashMeta&name=Foo的 authority 变成host:port?target=ClashMeta&name=Foo——host被污染,target/name/uid全部丢失。现改为^([^/?]*)。 - 不剥 userinfo:
detect_local_link一直会剥user@,此处漏了。 现同样剥离(按最后一个@,与 M10 的约定一致)。
L17 is_private_host 的 IPv6 判定可被等价写法绕过
- 旧实现拿字符串比前缀(
^::/^f[cd]/^fe[89ab])并只对^0*做一次 去零,于是[0::1]、[0000::1]、[0:0:0:0:0:0:0:1](同一个回环地址的 不同写法)全部被判成公网,而[::ffff:8.8.8.8]反被判成内网。 现先把 IPv6 字面量展开成 8 组 16 位数值(含::压缩、zone id、 嵌入式 IPv4 写法)再判定:::/::1、IPv4 映射地址按 IPv4 规则递归判定、 ULAfc00::/7、链路本地fe80::/10。该函数目前未被生产代码接线 (仅detect_local_link调用,而后者只被测试引用),属潜在 SSRF 缺口, 非当前可利用路径。
L18 纯空白 / 只有 BOM 的内容报「无法识别的订阅格式」
M.detect会 trim 并去 BOM 后判为empty,而M.parse只挡住了完全空串 (content == ""),format == "empty"不匹配任何分支,于是掉到末尾报 「无法识别的订阅格式」。内容确实是空的,不是格式不认识 —— 提示误导。 现返回与空串一致的{ nodes = {}, format = "empty" }。
测试
tests/wireguard_conf_test.lua新增 23 项断言(行内注释、坏[Peer]跳过、 全部对端不可用报错、多对端数组字段不共享)。tests/parser_local_link_test.lua新增 28 项断言(无路径 query、userinfo、 IPv6 内网判定的 16 种写法与 4 种公网反例、空白 / BOM 内容)。- 反向验证:把两个测试文件指向
HEAD版parser.lua重跑, 新增断言分别失败 16 项 / 13 项,确认它们确实覆盖了缺陷而非恒真。 - 全量回归:40 个 Lua 测试文件(1747 项断言)+
cron_result_test.sh(11) 全部通过。 - 版本号 2.6.3-r1 → 2.6.4-r1。
[2.6.3-r1] - P2 批次一:JSON 编解码保真与主机名拆分
P2 批次一,修 util.lua 的三项缺陷(审计表 M13 / M14 / L13)。
每项均先复现、后修改,并新增回归测试。
M14 json_decode 永不返回错误串
- 错误被丢弃:结尾写成
local v = parse(); return v——parse的第二返回值 (错误串)被直接丢掉。后果是所有调用方的local data, err = util.json_decode(...)里err判断全是死代码, 畸形输入一律表现为「解出来是 nil」,与「内容本来就是null」无法区分。 现在parse的错误逐层透出(对象、数组、键、值四处),顶层再判一次。 - 内层错误被吞:数组循环里无条件
if val == nil then val = JSON_NULL end, 于是[1,]这种畸形输入被静默接受(parse报错后游标不前进,下一轮读到]就当作数组结束),解出{1, <null占位>}。现在内层错误直接上抛。 - 尾部脏数据被忽略:
parse只消费一个值,"1 2"/"[1] junk"/"1.2.3"(数字模式只吃1.2)都被当成合法值,尾部内容凭空消失。 现在解析后必须确认无剩余内容(尾随空白仍允许)。
M13 数组 null 与空对象往返被改写
- 数组里的
null变成[]:解码时用JSON_NULL占位保留位置,但json_encode没有对应的编码分支,占位符落进is_array判定(空表判为数组) 被编成[]——[null,1]往返变成[[],1],结构被悄悄改写。已补分支还原为null。 - 空对象变成空数组:
{"tls":{}}解出的裸{}会被is_array判成数组、 编码回[],于是{"tls":{}}往返变成{"tls":[]}。sing-box / Xray 里要求是 对象的字段(tls/settings)会因此被客户端拒绝。现在解码空对象时返回 既有的M.JSON_EMPTY_OBJECT占位(该常量的注释本就说明了这个用途), 空数组仍编码为[]。
L13 split_hostport 把尾随冒号当成主机名
"example.com:"原样返回host="example.com:"(端口匹配失败后直接返回整串)。 调用方拿这个带冒号的串当主机名去解析 DNS 必然失败,而失败点离此处很远、 很难定位。现在剥掉结尾的冒号;"::1"这类不带方括号的裸 IPv6 不受影响, 剥完为空则返回nil, nil。
测试
- 新增
tests/util_json_test.lua(29 项断言):错误上报、尾部脏数据、null/ 空对象 / 空数组往返、以及既有行为的回归(转义、unicode、数字、字符串)。 tests/run_tests.lua的split_hostport段扩 4 项(尾随冒号、[::1]:、 裸::1、裸:)。- 全量回归:40 个 Lua 测试文件 +
cron_result_test.sh(11) 全部通过,0 失败。 - 版本号 2.6.2-r1 → 2.6.3-r1。
[2.6.2-r1] - 更新日志补记与遗留缺陷汇总
文档批次,无代码改动。
- 补记 P0 四次推送的更新内容:
[2.6.0-r2]~[2.6.0-r5]四个条目对应提交12ab1a7/46fe3b6/2b9934e/fb51e6e。这四次推送当时未提升版本号 (Makefile始终为2.6.0-r1),因此本文件原先没有对应条目;现按推送顺序补记, 使更新日志与实际推送一一对应。包版本号未回改,历史提交未被重写。 - 新增
docs/LEGACY_ISSUES.md:汇总截至 2.6.1-r1 审计中 已确认但尚未修复的问题,每项给出代码级依据、影响面与候选修复方案,供决定后续 修复优先级。原始 70 项审计表未落盘,该文件自本次起作为「未修复项」的权威清单。 - 修正一处遗留项的描述:
[2.6.1-r1]中记录的「sing-box YAML 读取侧不读传输参数」 经实测确认比原描述更严重——两个读取侧都不把transport.type映射到net, ws / grpc / h2 节点导入后整层传输丢失(退化为 tcp 直连),而非仅丢 path/host。 详见docs/LEGACY_ISSUES.md第 3 节。 - 版本号 2.6.1-r1 → 2.6.2-r1。
[2.6.1-r1] - P1 批次缺陷修复(解析保真 / 输出合法性)
本轮修复 2.6.0 审计表中 P1 批次的 13 项缺陷,另修复审计过程中实测确认的
4 项新缺陷。所有修改均先做代码级审计、再用临时探针复现缺陷、修改后复测,
并补齐回归测试(新增 tests/p1_fixes_test.lua,97 项断言)。未做任何推测性改动。
解析保真(节点导入)
- trojan 密码未做 URL 解码:
trojan://p%40ss%3Aword@host:443的密码被当成 字面量p%40ss%3Aword存下,认证必然失败。已补util.url_decode。 - vmess classic JSON 忽略
host/path:vmess://base64({...})里的host(ws Host 头)与path(ws 路径)被静默丢弃,服务端按默认路径匹配失败。 现已保留;未提供时不会凭空造出字段。 - SSR 密码 base64 回退不可达:密码字段的 base64 解码走了不可达分支, 明文密码会被解成乱码并写盘下发。已改用往返一致性判据的解码器。
ssr://外层不接受 base64url 字母表(新发现):util.base64_decode会把-/_当非法字符直接剔除,于是外层用 base64url 编码的ssr://链接 少掉若干字符、整串解成乱码——server / port / 密码全错,且不报错。 已改用base64_url_decode(对标准 base64 输入逐字节等价,严格更宽容)。- userinfo 按首个
@切分:密码含未转义的@时(hysteria2://p@ss@host:443) 密码被截断、host 变成ss@1.2.3.4。trojan / hysteria2 / hysteria / tuic 改为按最后一个@切分。 - vless / trojan / vmess / hysteria2 / tuic / ss 缺 host·port 校验:残缺节点会
被写成
server:/port: 0,mihomo 与 sing-box 会拒绝加载整份配置—— 一个节点废掉整个订阅。解析阶段即丢弃(port 必须落在 1..65535)。 - sing-box YAML 的嵌套
tls:map 被跳过:tls: {enabled, server_name, insecure}整层丢失,导出的 trojan/vmess/vless 静默退化成明文,hysteria2/tuic 更让客户端 以C.ErrTLSRequired拒绝启动。现已展开为security/sni/skip-cert-verify/alpn/fp。 - 简易 YAML 解析器不支持嵌套序列(新发现):
tls.alpn:后跟- h2会让 映射收集器在该行立刻中断,不只 alpn 丢失,排在它后面的utls.fingerprint也一并消失。已新增序列收集逻辑(声明顺序置于映射收集器之前, 避免 Lua 局部函数 upvalue 捕获陷阱)。 - 通用 JSON 节点忽略
type字段、无协议白名单:type不再被忽略,改为按 权威映射表转成协议并消费掉;未知类型(snell/ssh/shadowtls等) 直接丢弃,而不是兜底成 vmess 造出字段全错的假节点。 - Surge 段名大小写敏感:
[PROXY]/[Server_Local]全大写段名不被识别, 而[开头的内容会被判成 JSON 数组,整份订阅报「JSON 解析失败」,一个节点都 拿不到。段名判定改为大小写不敏感。 - Surge / QX 未知协议无白名单(H6 的 Surge 侧):
A = snell, …会把proto="snell"透传进模型,输出端变成 sing-box 的type: "snell"/ Xray 的protocol: "snell"这类非法取值。现与 Clash YAML 走同一张权威表。 - 订阅列表文件含非法条目时崩溃:
core.list()的pairs(meta)会抛table expected, got string,订阅列表页直接 500;cron 路径更糟—— 异常让整轮同步在打印统计前中断,而substore-cron.sh据此判为成功。 现在过滤坏条目、返回可用条目并带上损坏错误,写路径据此拒绝落盘 (避免下次保存把坏条目永久抹掉)。
输出合法性
output_v2ray协议白名单:原判定是「不等于 ssr」,于是 hysteria2 / hysteria / tuic / wireguard 被写成 Xray 根本不认识的"protocol": "hysteria2", 凭据还被塞进无意义的users字段——Xray 解析到未知 protocol 会拒绝整份配置。 改为白名单(vmess / vless / trojan / shadowsocks / ss / socks / socks5 / http)。- clashmeta 从不写
flow:vless 的xtls-rprx-vision丢失,mihomo 按普通 vless 处理,服务端要求 vision 时握手失败。surge / v2ray / URI 三个输出都写 flow,只有 clashmeta 漏了;而 Clash YAML 解析器明确会回读 flow。 - clashmeta 丢弃 grpc / h2 传输参数:只写
network: grpc,不写grpc-opts.grpc-service-name,客户端用默认服务名去连、握手失败——与 ws 丢 path 同类。h2 同理,现按上游文档写h2-opts.host(列表)与h2-opts.path(标量)。服务名取自node.path,与 v2ray 的serviceName、 sing-box 的service_name同源。
健壮性
- 改名替换串里的
%未转义:%后接非数字字符会被 gsub 静默吞掉 (50%off→50off),结尾的%会注入一个 NUL 字节 (100%→100\0)——节点名会写进节点文件并下发给所有客户端。 现已把字面%转义为%%,$1仍按捕获引用处理。 - 修复自身引入的
and/or三元陷阱:(cond) and nil or x在 cond 为真时得到nil,再被or x兜回x,等于没生效(正是代码里已注释警告过的坑)。 已改为显式if。
测试
- 新增
tests/p1_fixes_test.lua:97 项断言覆盖上述全部修复, 每项都先在修改前复现缺陷、修改后断言修复行为。 - 全量回归:39 个 Lua 测试文件 +
run_tests.lua(47) +cron_result_test.sh(11) 全部通过,0 失败。 - 版本号 2.6.0-r1 → 2.6.1-r1。
已知未修复(待确认,本轮未改)
汇总已迁移至
docs/LEGACY_ISSUES.md,含各项的代码级 依据、影响面与候选修复方案。此处保留索引:
- H10 的丢更新(lost update):
load()→save()之间无任何锁,并发写会 互相覆盖。Lua 5.1 没有可用的原子锁原语(os.rename覆盖语义无法 CAS、 无flock、io.open无"x"模式、无link()),mkdir方案有陈旧锁死锁 风险。建议作为已知限制记录,或引入nixio的 flock(本机无法验证)。 - M28 / M29(CSRF
post_ok()、ACL):依赖 LuCI 框架运行时行为 (test_post_security、ACL 解析),本机无 LuCI 运行环境,无法验证,故未改。 - sing-box 读取侧传输整层丢失:
parse_singbox_json不读transport.type/transport.path/transport.headers.Host/tls.utls.fingerprint, 简易 YAML 侧同样不处理transport。实测 ws 节点导入后net=tcp、path=nil、host=nil,即整层传输丢失(原记录为「不读 path/host」,实测更严重)。 converter.lua/node_converter.lua为死代码:应用中无任何转换入口, 但 README 声称「协议转换:任意协议 → 任意协议」。
[2.6.0-r5] - P0 批次四:表单编辑丢 TLS、注入 XSS 与协议字段清单漂移
补记条目,对应提交
fb51e6e。编号说明见下方[2.6.0-r2]末尾。
-
H2 节点页注入
<script>的 id 未转义</:json_encode不转义<, 而</script在 HTML 词法阶段就闭合脚本元素(与 JS 字符串上下文无关)。 id 直接来自查询串,构造</script><script>alert(1)</script>即可执行任意脚本。 与node_edit.htm/local_form.htm一致改为json_encode后转义</。 -
H3 表单编辑静默清空「表单没渲染的字段」:根因是
nodeform.js的PROTO_FIELDS与core.merge_form_node的FORM_KEYS是两份各自维护的清单, 前者决定渲染什么、后者决定清空什么,必然漂移。表单没渲染的字段提交不上来, 合并时一并清空等于用空值覆盖原值:- vmess 的 TLS 层字段是
security,表单却渲染tls—— 编辑一次就把security抹成nil,normalize再补成"none",启用 TLS 的节点静默变明文; - hysteria2 / hysteria / tuic 是 TLS-only,表单不渲染
security—— 编辑一次就丢 TLS,sing-box 因C.ErrTLSRequired拒绝启动; - WireGuard 的
dns、vmess 的flow同理被抹掉。
修法:字段清单收敛到唯一来源
substore/node.lua的M.PROTO_FIELDS,由 LuCI 页面渲染成window.SUBSTORE_PROTO_FIELDS注入(协议列表M.PROTOS同样处理),nodeform.js不再自带副本。core.merge_form_node只清空「本协议表单渲染过」的 字段,外加:FORM_ALIASES—— 解析器产出的下划线写法(skip_cert_verify、obfs_param…) 与tls/security、method/cipher互为别名,必须跟随规范名一起清空, 否则残留值「关不掉」(build_tls在security为"none"时还会退回n.tls);- 协议被改过时把旧协议的字段一并清空(vmess 改 trojan 不该留 uuid);
- 协议未知时退回旧的「清空全部表单字段」行为。
- vmess 的 TLS 层字段是
-
顺带修掉审计中发现的两个同类问题:
node.lua的DEFAULTS补 hysteria2 / hysteria / tuic 的security="tls"—— TLS-only 是协议约束,属归一化该保证的不变量(与 trojan 同理)。Clash YAML / sing-box JSON 导入的这两个协议原先没有security,导出的是客户端起不来的配置;FIELD_LABELS补"protocol"(SSR 表单原先显示英文键名)。
测试:core_merge_node_test.lua 扩到 28 项;新增 view_injection_test.lua
(38 项,静态检查注入转义与字段清单一致性);全套 38 个测试文件通过。
[2.6.0-r4] - P0 批次三:列表文件损坏抹除订阅、原子写失效与 token 可预测
补记条目,对应提交
2b9934e。编号说明见下方[2.6.0-r2]末尾。
- H8
core.load不再把「解析失败」当成空列表:原先json_decode失败即return 0, {},而M.add/M.add_local/M.add_combo会在这个空表上追加 一条再整表写回 —— 一次损坏就抹掉用户全部订阅,且_seq归零后重新发出s00000001这类已用过的 ID。现在load返回第三个值err,写入路径据此拒绝 操作;M.list也把err透出给调用方。 - H9
atomic_write检查 write / close / rename 的返回值:磁盘写满时f:write失败但os.rename仍会成功,等于原子地换上一个残缺文件而调用方以为写入成功。 失败路径统一清理临时文件并返回false, err。 - H10 临时文件名唯一化:原先固定为
"<path>.tmp",两个进程同时写同一路径会 交错写进同一个临时文件,rename上去的是两者内容的混合体,各自的原子性都失效。 现改为"<path>.tmp.<8 字节随机 hex>"。 - H11
rnd_hex改用内核熵源:Lua 5.1 的math.random是 31 位 LCG,原实现每次 调用都重新播种,同一时钟刻度内给出相同序列:实测 20 万次调用约 9.7% 重复。 订阅下载 token 是访问控制的唯一凭据,重复即可被猜测。现优先读/dev/urandom, 仅在不可用时退回只播种一次的 PRNG。
新增 tests/data_integrity_test.lua(28 项断言)覆盖上述四项,
全套 37 个 Lua 测试文件全部通过。
[2.6.0-r3] - P0 批次二:解析器静默吞掉整份订阅
补记条目,对应提交
46fe3b6。编号说明见下方[2.6.0-r2]末尾。
- base64 里包着 YAML / JSON(
parser.lua):base64 分支原先一律把解码结果按 URI 列表解析。机场把整份 Clash 配置或 sing-box 配置 base64 后直接下发是常见做法, 这类订阅会得到 0 个节点且不报错,用户只看到「订阅为空」。现在解码后重新走一遍detect/parse复用既有分支;inner == "base64"时不再递归(避免 base64 套 base64 无限递归),外层容器格式仍报base64。 - 流式风格与行尾注释(
parser_clash_yaml.lua):- 新增
parse_flow_map/split_top:- {name: A, type: vmess, server: 1.1.1.1}是合法 YAML 但不是合法 JSON(键没加引号),util.json_decode必然失败, 原先整项被静默丢弃。现在 JSON 解失败后回落到 YAML 流式映射解析,并正确 切分{}/[]内部以及引号内的逗号(alpn: [h2, http/1.1])。 - 新增
strip_comment:YAML 规定内联注释的#前必须有空白,且引号内的#不是注释。原先proxies: # 说明会把注释文本当成值,proxies变成字符串, 整份配置被判定为「没有 proxies」。列表项同样处理(- {...} # 注释)。
- 新增
回归测试:新增 20 项断言(base64 包 YAML / JSON / 嵌套 base64、流式映射、流式数组值、
行尾注释、# 无空白与引号内 # 必须保留)。
[2.6.0-r2] - P0 批次一:sing-box TLS 失效、未知协议泄漏与输出格式注入
补记条目,对应提交
12ab1a7。
输出正确性:
output_singbox:tls 块补enabled=true。sing-box 的OutboundTLSOptions.Enabled是 bool +omitempty(option/tls.go),缺省即 false:只写server_name而不写enabled等于没配 TLS —— vmess/vless/trojan 退化为明文拨号,hysteria2/tuic 更会因C.ErrTLSRequired拒绝启动。顺带移除因此变成死代码的空表分支,并更正parser_json_config里「enabled 缺省即 true」的错误注释。parser_clash_yaml:未知 Clash 类型(snell / shadowtls / mieru 等)改为丢弃。 原先TYPE_MAP[p.type] or p.type or "vmess"会把它透传成 sing-box 的type:"snell"、 Xray 的protocol:"snell"这类非法取值,客户端会拒绝加载整份配置;缺失 type 时兜底成 vmess 则是凭空造出字段全错的假节点。parser.lua的简易 YAML 兜底解析(复用同一张TYPE_MAP)早已如此处理,此处对齐。output_clash_meta:sni与servername同时存在时只输出一个servername键。 Clash YAML 导入会同时填上两者,原先各写一行让 YAML 出现重复键。output_clash_meta:esc_yaml补\r/\t转义,并在转义前判断是否需要加引号 —— 转义后的"\t"落在 plain scalar 里会被 YAML 当成两个普通字符;未加引号的换行/回车 则直接破坏文档结构。output_formats:tuic 的 alpn 为数组时(sing-box JSON / Clash YAML 的 alpn 列表 导入后即为 table)不再attempt to concatenate a table value。
换行注入(节点名等来自订阅内容,属不可信输入):
- 新增
util.one_line:把值压成单行(换行/回车转空格,其余控制字符丢弃)。 output_formats:surge_line/ 代理组行 / Quantumult X 的server_local与policy行统一压平 —— 含换行的节点名会截断当前行并伪造出新的代理行。output_wireguard_conf:.conf注释行压平 —— 否则节点名里的"\n[Interface]"会注入出真正的配置段。
回归测试:新增 34 项断言覆盖以上全部缺陷(含 sing-box TLS 往返、surge/QX/wgconf 的 行数不变性、未知类型丢弃、控制字符转义)。
关于以上四条
-r2~-r5的编号:这四次推送(12ab1a7/46fe3b6/2b9934e/fb51e6e)当时未提升版本号,Makefile始终为2.6.0-r1, 因此本文件中原先没有对应条目。现按推送顺序补记为-r2~-r5,使更新日志与实际 推送一一对应。包版本号本身未回改,历史提交未被重写;从 2.6.1 起恢复 「每次推送提升一个版本号」的约定。
[2.6.0-r1] - 协议覆盖补全与导入/输出保真修复
本轮起因:用户报告「添加本地订阅 → 表单导入」的「类型」下拉框协议不全, 与 README 描述不符。审计后确认问题存在,且**「文本导入」存在更严重的同类缺口**, 并顺带查出若干静默数据丢失 / 非法输出问题。所有修改均经代码或测试确认, 未做任何推测性改动。
协议覆盖(本次报告的主问题)
- 表单导入缺
hysteria(v1) 与socks:nodeform.js的下拉框只有 8 个协议, 而node.lua的M.PROTOS、节点页协议筛选、规则proto_filter都认 10 个。 用户因此无法用表单录入这两类节点。 - 文本导入(URI)缺
hysteria(v1) 与socks/socks5,且这是导出→导入回环断裂:output_uri.to_share_uri会生成hysteria://与socks5://链接,但parser.parse_uri对二者一律返回unsupported proto。含这两类节点的订阅文本会被整行静默丢弃。 已新增parse_hysteria/parse_socks并补齐SUPPORTED分发表。 - 简易 YAML 兜底解析的协议表漂移:该处自维护一份映射,缺
hysteria2/hysteria/tuic/wireguard,且socks5未归一,更严重的是 对认不出的type用or "vmess"兜底 —— 一份 sing-box YAML 里的 hysteria2/tuic/wireguard 出站会变成数个字段全错的假 vmess 节点(静默数据损坏)。 现改为复用parser_clash_yaml.TYPE_MAP(单一事实来源),未知协议直接丢弃。 - 简易 YAML 兜底解析的
outbounds:分支从不生效:该分支同时接受 Clash 的proxies:与 sing-box 的outbounds:段名,却只读 Clash 的port/name, 而 sing-box 用server_port/tag。结果是 sing-box YAML 出站全部被静默丢弃 (识别了段名却解析出 0 个节点)。现按parser_json_config.parse_singbox_json读取的键名逐字补齐别名:server_port/tag/auth_str/auth/tls.server_name/tls.insecure/security(vmess 加密方式) /network。
归一化
socks5→socks归一:两者是同一协议的不同写法(Clash 写socks5、 sing-box 写socks、分享链接写socks5://)。输出模块本来就同时认两种写法, 但node.filter与rules.proto_filter是精确比较,两种写法互相看不见 —— 节点页按协议筛选与规则过滤都会漏。现统一为规范名socks。
输出保真
- clashmeta:hysteria(v1) 的 SNI 丢失。此前统一输出
servername,而 mihomo 的 hysteria 系列没有该字段(写servername会被忽略),SNI 丢失会导致客户端 以 IP 校验证书、握手直接失败。现按协议区分:hysteria / hysteria2 输出sni, vmess / vless / trojan 仍输出servername。同时补上 v1 的obfs(普通字符串)。 - clashmeta:socks5 的
password被输出两次(通用字段段 + 协议专属段), 在 YAML 里形成重复键,属非法/歧义配置。现协议专属段只补username。 - clashmeta / singbox / surge:
http的用户名丢失,只输出密码。现按上游文档 补齐username(mihomo 的 http / socks5 用username+password; Surge 家族用username=/password=具名参数)。 - singbox:hysteria(v1) 字段名错误。此前输出
password与obfs = { type, password },但 sing-box 的 hysteria 出站认证字段是auth_str,obfs是普通字符串(对象形式是 hysteria2 的 salamander 专属)。 该修正与本项目parser_json_config自身的回读逻辑一致 (其按outbound.password or outbound.auth_str or outbound.auth读取)。 output_uri/output_clash_meta:hysteria(v1) 不应出现obfs-password。 该字段是 hysteria2 的 salamander 专属,写到 v1 上是非法参数/非法键。
表单
core.FORM_KEYS缺username:merge_form_node先按FORM_KEYS清空原节点 再套用提交值,不在表里的字段会保留旧值 —— 用户在表单里清空用户名也删不掉 (collectNodes会略过空值)。已补入。
已知限制(本轮不修,均有明确原因)
- 混合格式文本导入不支持。README 称可粘贴「YAML / URI / JSON / wg-quick
.conf混合」 文本,但parse_local → parse → detect只识别一种格式,其余部分被静默丢弃 (已实测:「URI + WG conf」只剩 WG 节点;「URI + JSON」只剩 URI 节点)。 这是功能缺失而非小缺陷,需要重新设计 parser 的分段架构(规格 §22 明确警告 不要直接采用未经验证的逐行算法),故留待专门版本处理。 - sing-box 的 hysteria(v1) 出站还要求
up/down(带宽),本项目的节点模型 不承载该字段。凭空填默认值属于猜测,故不输出;用户需在自己的配置里补上。 - hysteria(v1) 的上游 URI 规范未能核实(上游文档站点持续 404,无法取得权威定义)。
因此
parse_hysteria只保证解析本项目output_uri自身生成的链接形态 (回环已验证),认不出的查询参数一律忽略而不报错,不臆造参数语义。 http不加入任何 UI 协议列表:规格 §25 的权威协议表恰好是 10 个协议、不含http。 它可由 Clash YAML / JSON 配置导入并正常导出(凭据已修),但不作为表单可选项。parser_yaml.lua为死代码(parser.lua顶部 require 后从未调用), 其中留有同样未归一的socks5映射,仅记录,不影响运行。parse_tuic/parse_hysteria2按第一个@切分 userinfo,与parse_socks修复前同类(密码含裸@会被切坏)。本轮只修了 socks,其余留作观察项。
测试
- 新增
tests/protocol_coverage_test.lua(110 项断言),覆盖上述全部修复: hysteria / socks 的 URI 导入与导出→导入回环、混合文本不再丢行、 兜底解析不再造假日 vmess、sing-box YAML 出站别名、socks5归一后筛选/规则命中、 clashmeta / singbox / surge 的输出字段、FORM_KEYS的username。 - 全量测试:
tests/*_test.lua逐文件运行,0 个失败文件;tests/cron_result_test.shrc=0。
版本
- 版本号 2.5.1-r1 → 2.6.0-r1(协议覆盖为功能增强,走 minor);
README.md/README.en.md/docs/INSTALL.md同步。
[2.5.1-r1] - 安全加固与数据保真修复
本轮为缺陷修复版本,重点是命令注入 / SSRF 绕过 / 静默数据丢失三类问题。 所有修改均经代码或测试确认,未做任何推测性改动。
安全
- 修复命令注入(可被远程触发):此前拼 shell 命令行时使用
string.format("%q")做转义。%q生成的是双引号字符串,而/bin/sh在双引号内仍然执行$(...)与`...`命令替换——已实测确认format("%q", "$(touch /tmp/x)")会真的创建文件。新增util.shq()改用单引号转义('→'\''),并应用于所有 拼接外部数据的位置:http.lua:curl / wget 命令行、临时文件路径、-x代理参数、错误输出文件http.lua:http_proxy/https_proxy环境变量赋值core.lua:logger -t luci-app-substore <msg>(msg 含下载失败原因等外部内容)probe.lua:探测命令util.lua:ensure_dir的mkdir -p
- 修复 SSRF 检查绕过(fail-open):
http.parse_url只按/截断主机部分, 于是http://127.0.0.1?a=1的「主机」是127.0.0.1?a=1——既非合法主机名也非 数值型 IPv4,DNS 解析必然失败,而解析失败是放行的,curl实际连的是回环地址 (路由器上正是 LuCI 的:80)。现按 RFC 3986 截断到第一个/?#, 并额外剥离 userinfo(http://evil@127.0.0.1/同理可绕过)。 - 修复 curl 后端接受 3xx:
code:match("^[23]%d%d$")会把 3xx 当成成功。 重定向应由-L跟随并由validate_redirect_chain逐跳校验,而不是靠 3xx 直接放行; 现只接受2xx。 - 修复 wget 后端不检查退出码:
os.execute的返回值此前被忽略, 下载失败但残留部分内容时会当成成功解析。现要求退出码为 0。
数据保真(静默丢字段)
- 修复从 LuCI 表单编辑 WireGuard 节点会丢掉全部 AmneziaWG 参数:
amnezia-wg-option在表单里是 JSON 文本框,提交上来是字符串, 而output_wireguard_conf/output_clash_meta/output_uri三处都要求它是table——字符串被静默忽略。现于表单模式统一解码;JSON 非法时明确报错 而不是留个字符串让它在导出时无声消失。 - 修复表单里的数组字段被写成标量:
allowed-ips/reserved/dns在统一模型中 是数组(见.conf解析),但表单输入框只能给字符串,导出到 mihomo / sing-box 时字段类型非法(这两个客户端的对应字段是列表)。现于表单模式拆分为数组; 单值dns仍保持字符串,与.conf解析保持一致。 - 修复 AmneziaWG 3.0 / 3.1 字段在
.conf导入时被丢弃:.conf键名白名单只到 1.5 版,HeaderProtectionKey/ContentPaddingAddition/RekeyAfterTime/RekeyTimeout/RejectAfterTime/KeepaliveTimeout/MaxHandshakeAttempts/RandomTrailers/DisableCookies九个字段在导入时被丢掉,而同样的配置走 Clash / JSON / URI 路径却能通过——同一份配置换个格式就丢参数。键名核对自 amneziawg-toolssrc/config.c;布尔字段按parse_bool的规则只认on/off/ 数字。 - 修复多个
[Peer]的.conf只产出部分节点:现每个[Peer]各生成一个节点 并共享[Interface]设置;AmneziaWG 参数表按节点复制,避免多个节点共享 同一个 table 而互相影响。 - 修复节点改名规则中的 Lua 模式陷阱(
node.lua):-在 Lua 模式里是惰性量词,于是Node-(\d+)被解释成Nod+e-+ 数字, 永远匹配不上且不报错。现于字符类外转义为%-|在 Lua 模式里没有「或」语义,整个规则静默不匹配。现按顶层|拆成多个 候选依次替换;括号内与字符类[...]内的|不拆(拆开会得到残缺模式,比不拆更糟)\b/\B原被映射成%b——那是 Lua 的「成对匹配」模式,语义完全不同。 现按无操作处理(Lua 模式无词边界)- 模板改名的替换值现在转义
%,否则[50% OFF]这类名字会产生 NUL 字节
- 修复 Clash YAML 的
type字段泄漏进节点:type是协议判别字段(已被映射为proto),原样拷进来会让output_uri把它当成 vmess 的 header type 写出 ("type":"vmess"),生成客户端无法识别的vmess://链接。 - 修复订阅流量信息无法清空:
save_meta用pairs遍历补丁,而pairs永远 不会给出nil值,调用方无法表达「把这个字段删掉」,导致过期的流量/到期时间 一直显示。新增core.CLEAR哨兵表达清除。
界面
- 修复节点保存失败无反馈:
action_node_save此前只在成功分支做事, 其余情况一律静默重定向——用户提交了坏数据却看到「已保存」的样子(违反 §18)。 现所有失败路径(下标无效 / 内容为空 / 解析失败 / 写入失败)都经?err=回传, 并在节点页渲染为可见的错误提示。 - 修复存储型 XSS:节点页的分组下拉与组合订阅页的名称用
<%= %>原样输出 (未转义),恶意订阅里的分组名/名称可注入脚本。现统一走luci.util.pcdata()。
Cron
- 退出码现在反映本轮结果:
substore-cron.sh此前无论成败一律exit 0, cron 的MAILTO/ 外部监控无法据此判断。现只要有订阅更新失败即返回非 0; 找不到 lua 解释器(整条链路不可用)同样返回非 0,而不是静默成功。
解析器补齐
vless://补path/host/flow;vmess://(新格式)补host/path/headerType/fp/alpn;trojan://补type→net/path/host/fp;hysteria2://补security与skip-cert-verify;经典 vmess JSON 的aid正确映射为alterIdb64u_decode增加 round-trip 校验:合法 base64url 解码后重新编码必然一致, 明文则不一致——以此区分「这是 base64」和「这就是明文」,避免把明文 误当 base64 解出乱码M.detect调整判定顺序:Surge 配置在 URI 兜底分支之前判定,避免被误判成 URI
测试
- 新增
tests/security_fixes_test.lua(37 项):shq用真实sh -c验证命令替换 不发生;parse_url的 query / fragment / userinfo 剥离;save_meta的CLEAR语义;改名的-/|/%行为 tests/cron_result_test.sh增加退出码断言(含缺解释器、无订阅文件两种边界), 并验证该测试确实能捕获修复前的行为(对旧脚本跑会失败 3 项)tests/controller_local_test.lua增加action_node_save的 6 条失败路径断言, 同样验证对旧控制器会失败 6 项tests/wireguard_conf_test.lua增加表单路径断言(AWG JSON 解码、数组归一、 非法 JSON 报错、单值 DNS 保持字符串),并覆盖 AWG 3.0 / 3.1 字段导入与多[Peer]- 全量:33 个
tests/*_test.lua共 1286 项断言全部通过;shell 测试 11 项通过
已知限制(未在本轮修复)
- LuCI 里
amnezia-wg-option仍是单个 JSON 文本框,没有逐字段的表单控件。 数据已能正确往返(见上),但录入体验不佳。逐字段化属于新功能,按版本约定 应进入 minor 版本,故不在 2.5.1 中改动。 - wget 后端的下载体积上限仍是下载后判断(busybox wget 没有「下载前限流」的选项)。
- 括号内的「或」
(a|b)在改名规则中不支持(Lua 模式无此语义,按字面处理)。
版本
- 版本号 2.5.0-r1 → 2.5.1-r1;README.md / README.en.md / docs/INSTALL.md 同步
[2.5.0-r1] - 订阅可靠性、错误反馈与 WireGuard 去重修复
- 修复严重缺陷(订阅更新可能「看起来成功其实失败」):
core.sync失败时是 「返回nil, err」而不是抛异常,而调用方只判断了pcall的第一层返回值。pcall返回true只说明没有抛错,第二个返回值才是sync自身的结果—— 于是「同步返回nil, err」被统计成成功。root/usr/bin/substore-cron.sh:改为local ok, res, err = pcall(core.sync, id), 并要求ok and res才算成功;失败时打印真实原因。同时把脚本输出同时写 stdout 与 syslog(原先只进 syslog,cron 邮件里看不到)root/usr/lib/lua/luci/controller/admin/substore.lua:action_update同样处理两层结果
- 修复严重缺陷(代理静默失效,属 silent fallback):
core.sync原先在「代理已启用但代理地址无效」时只记一条日志就直连下载, 用户会以为流量走了代理、实际暴露真实 IP。现改为明确失败并把原因写入订阅状态- wget 后端原先在遇到它不支持的代理协议(
socks*)时丢掉代理继续直连。 现改为明确报错并提示安装 curl 或改用 http 代理(busybox wget 只能通过http_proxy/https_proxy环境变量使用 http(s) 代理)
- 修复严重缺陷(wget 后端重定向绕过 SSRF 预检):curl 路径逐跳校验重定向目标,
wget 路径完全不校验,可被重定向到
127.0.0.1/ 内网而绕过check_public。 现 wget 改用-S输出响应头日志,由新增的http.validate_redirect_chain按出现顺序解析整条重定向链并逐跳复检,任一跳不安全即整体失败并丢弃响应体。 另修复协议相对地址(//host/path)被误当成同主机路径而漏检的问题 - 修复严重缺陷(界面失败无反馈):订阅的新建 / 保存 / 本地订阅新建 / 保存
失败时,控制器只静默跳回列表页,用户看到的是「什么都没发生」,与成功无法区分。
现失败原因经
?err=回传到列表页并渲染为可见的错误提示 - 修复严重缺陷(WireGuard 节点被错误去重合并):去重键为
proto+server+port, 而同一 endpoint 上的不同 peer 公钥是不同节点,会被错误合并而丢节点。 现 WireGuard /wg节点的去重键并入 peer 公钥(兼容public-key/public_key/peer-public-key/peer_public_key四种写法);其余协议去重行为完全不变 - 修复严重缺陷(多个 WireGuard 节点被拼进一个
.conf):一个.conf文件只能包含 一个[Interface],拼接会产生客户端无法导入(或只取首段)的畸形配置。 现多于一个 WireGuard 节点时明确报错(错误信息含节点数与「一条隧道」提示), 而不是静默拼接 - 修复 AmneziaWG
.conf导出键名靠猜测:原先用「首字母大写」由内部键名推导.conf键名,多词键会被写错(header-protection-key→Header-protection-key, 正确为HeaderProtectionKey),未知键可能让客户端拒绝整份配置。 现改为显式映射表,只输出能确定键名的键(Jc/Jmin/Jmax/S1–S4/H1–H4/I1–I5/J1–J3/Itime), 映射不到的键一律不输出;已支持键集合零变化 - 修复模板注入(HTML / JS):7 个模板把用户可控数据(订阅名、URL、代理、节点字段、
解析错误信息)直接以
<%= %>原样输出。现按上下文分别转义: HTML 用luci.util.pcdata,注入 JS 的字符串用json_encode(并转义</防止提前 闭合script),URL 用urlencode - 修复日志/错误信息泄漏凭据:新增
http.redact_proxy(代理地址去凭据)与http.scrub_credentials(抹掉 URL 中的//user:pass@),用于日志与订阅错误信息 - 修复失败路径污染
node_count:同步失败时不再把node_count清零—— 磁盘上的旧节点仍在、订阅链接仍在下发,清零会让界面显示与实际不符 - 新增测试:
tests/controller_local_test.lua(22 项)、tests/template_escape_test.lua(21 项)、tests/cron_result_test.sh(5 项);tests/wireguard_conf_test.lua扩至 93 项、tests/node_extended_test.lua扩至 28 项、tests/http_proxy_test.lua扩充代理矩阵与 重定向链复检。全部测试共 1174 项断言通过 - 版本号 2.4.0-r2 → 2.5.0-r1;README.md / README.en.md / docs/INSTALL.md 同步
- 已知限制(本次未修改,另行处理):
check_public在无 DNS 解析能力时放行 (fail-open)且解析与下载之间存在 TOCTOU 窗口;wget 路径的重定向校验是事后的 (busybox wget 无--max-redirect),响应体虽被丢弃但请求已经发出,且无法限制下载体积; AmneziaWG 3.0 / 3.1 新增的 9 个字段(HeaderProtectionKey、ContentPaddingAddition、RekeyAfterTime、RekeyTimeout、RejectAfterTime、KeepaliveTimeout、MaxHandshakeAttempts、RandomTrailers、DisableCookies)不被.conf解析器接受 (白名单外,导入即丢弃),但会从 Clash / JSON /wireguard://导入路径原样透传; sing-box 本身不支持 AmneziaWG,其输出会丢弃 AWG 参数
[2.4.0-r2] - 修复 vmess 加密方式与 TLS 层混淆
- 修复严重缺陷:经典 vmess 分享链接
vmess://base64(json)的scy是加密方式 (auto/aes-128-gcm/chacha20-poly1305/none/zero),tls才是 TLS 层 ("tls"启用,""不启用)。解析器此前把scy写进了统一模型的security字段, 而该字段在项目其余各处一律表示 TLS 层(node.luaDEFAULTS、vless/trojan URI 的security=、XraystreamSettings.security、Clashtls: true)- 后果:一个不启用 TLS 的节点被三个目标同时误判为启用 TLS,而这是机场订阅最常见的形态
- sing-box 多出
"tls": {},同时security被写成加密方式 - V2Ray
streamSettings.security: "auto"—— 非法取值,Xray 会拒绝启动 - Clash.Meta 多出
tls: true;Surge 家族多出tls=true
- sing-box 多出
- 统一模型新增
cipher字段专表 vmess 加密方式,security回归纯 TLS 层语义 - 解析侧:
parser.lua经典 vmess JSON 改为cipher = scy、security由tls推导;parser_json_config.lua的 sing-box 导入改为 vmess 的security→cipher, TLS 由tls对象表达(并补齐alpn/insecure→skip-cert-verify的反向映射);parser.lua简易 YAML 回退路径同步修正 - 输出侧:
output_singbox.lua/output_v2ray.lua/output_uri.lua的 vmess 加密方式 改取cipher;output_clash_meta.lua原本就取cipher,此前因cipher从未被写入而 恒回退到auto(cipher: aes-128-gcm这类非默认值会被静默丢弃,本次一并修复)
- 后果:一个不启用 TLS 的节点被三个目标同时误判为启用 TLS,而这是机场订阅最常见的形态
- 修复
tls字段的真值陷阱:空串""在 Lua 中为真值,tls: ""(经典 vmess JSON 表示 「不启用 TLS」的标准写法)会被output_formats.lua/output_clash_meta.lua的if node.tls then误判为启用 TLS。node.normalize现将""/"none"/"false"归一为nil、"true"(简易 YAML 解析器的字符串布尔)归一为true,并把tls统一 落到权威字段security - 非法加密方式不再写入配置:新增
node.VMESS_CIPHERS白名单,非白名单取值 (如被第三方工具误写成"tls"的)在归一化时丢弃,输出端回退到auto, 避免生成客户端拒绝加载的配置 - 新增测试
tests/vmess_cipher_test.lua(47 项),覆盖上述全部路径与分享链接回环 - 版本号 2.4.0-r1 → 2.4.0-r2;README.md / README.en.md / docs/INSTALL.md 同步
[2.4.0-r1] - sing-box / V2Ray 输出完整配置
- ⚠️ 破坏性变更:
target=singbox与target=v2ray由「仅含outbounds的片段」 改为「outbounds+ 分流的完整可用配置」。2.3.x 的片段需粘进已有配置使用; 2.4.0 起可直接作为单文件配置启动。已粘进客户端的老链接会拿到不同结构,请重新导出。 - sing-box 完整配置(
output_singbox.lua)- 节点出站 +
selector(tagselect,供手工切换)+urltest(tagauto,自动测速)direct/block
route.final指向select;内置ip_is_private→direct私网直连规则;auto_detect_interface开启- 刻意省略 route 规则的
action字段:该字段自 sing-box 1.11.0 起才存在,其默认值 即"route"。sing-box 会拒绝未知字段,而省略默认值在 1.10 与 1.11+ 上都能工作 - 无可用节点时不生成
selector/urltest(其outbounds不允许为空),final退回direct
- 节点出站 +
- V2Ray / Xray 完整配置(
output_v2ray.lua)- 节点出站 +
freedom(tagdirect) /blackhole(tagblock) +log observatory(subjectSelector/probeUrl/probeInterval)+routing.balancers(tagauto,leastPing)——leastPing必须依赖 observatory 的探测结果才会生效routing.rules:geoip:private→direct,其后tcp,udp兜底 →balancerTag: auto;domainStrategy为IPIfNonMatch- 无可用节点时改为
outboundTag: direct兜底,且不生成balancers/observatory
- 节点出站 +
- 两者均不含
inbounds/dns:会绑定本地监听端口、覆盖用户既有 DNS 设置,交由用户维护 - 修复
util.json_encode无法表达空对象:Lua 空表经is_array判定会被编码成[], 而 sing-box 的tls、Xray 的settings必须是对象。新增util.JSON_EMPTY_OBJECT占位符- 由此修复一处既有缺陷:sing-box 节点
security=tls但无sni/alpn时会产出非法的"tls":[]
- 由此修复一处既有缺陷:sing-box 节点
- 新增
util.unique_tags(nodes, reserved):sing-box 与 Xray 均要求 outbound tag 唯一, 节点重名(订阅里很常见)或与保留 tag(direct/block/select/auto)同名时 自动追加#2、#3- Xray 的 balancer / observatory
selector按前缀匹配 tag,因此额外把保留 tag 的 所有真前缀也登记为冲突——否则名为d的节点会让direct出站被误纳入负载均衡
- Xray 的 balancer / observatory
- 导出结果可重新导入:完整配置里的
selector/urltest/direct/block/freedom/blackhole会被解析器正确跳过,只取真实节点(已加往返测试) - 新增测试
tests/output_full_config_test.lua(82 项) tests/output_formats_test.lua/tests/ssr_test.lua更新为断言「不含 ssr 出站」 而非「outbounds 为空」,适配完整配置语义- 版本号 2.3.0-r2 → 2.4.0-r1;README.md / README.en.md / docs/INSTALL.md 同步
[2.3.0-r2] - 新增 Clash 原版与 WireGuard .conf 输出,输出层清理
- 新增输出格式 WireGuard / AmneziaWG
.conf(target=wgconf,别名wg/wireguard/amneziawg/amnezia/conf)- 与
parser.parse_wireguard_conf互为逆操作:输出[Interface]/[Peer]标准 wg-quick 配置 [Interface]:PrivateKey / Address(IPv4 + IPv6 合并)/ ListenPort / MTU / DNS / AmneziaWG 参数(键名首字母大写,按键名排序保证可 diff)[Peer]:PublicKey / PresharedKey / AllowedIPs / Endpoint / PersistentKeepalive- IPv6 Endpoint 自动加方括号(
[2001:db8::1]:51821) - 仅输出 wireguard 节点;无 wireguard 节点时明确报错(而非下载到空文件)
- 已知有损项:
Reserved不是 wg-quick 标准键,导出时不写出(reserved仍保留在 clash.meta / sing-box / URI 输出中) - 新增模块
root/usr/share/substore/output_wireguard_conf.lua
- 与
- 新增输出格式 Clash 原版(
target=clash),面向 Dreamacro Clash / ClashX / Clash for Windows- 过滤原版不支持的协议(vless / hysteria2 / hysteria / tuic / wireguard),其余复用 Clash.Meta 的 YAML 生成
- 采用排除法而非白名单,避免误丢原版其实支持的协议
- ⚠️ 行为变更:
target=clash语义由「Clash.Meta」改为「Clash 原版」。原先使用?target=clash拉取 Clash.Meta 配置的用户请改用target=clashmeta(或yaml/mihomo) - ⚠️ 行为变更(无感):未指定
target时的默认格式显式固定为clashmeta,与历史默认行为一致 - 输出层清理(
output.lua)- 删除死代码
to_clash_yaml/to_json/to_base64(无任何调用点;且to_clash_yaml会把type:写成原始协议名,产出非法 YAML) - 删除随之失效的
util/noderequire - 新增
M.FORMAT_OPTIONS作为格式清单的唯一数据源,subscriptions.htm与output.htm两处硬编码<option>列表改为遍历生成,避免新增格式时漏改模板 - 默认格式提取为
DEFAULT_FORMAT常量,供 content-type / 扩展名 / 生成三处共用
- 删除死代码
- 新增测试
tests/output_new_formats_test.lua(66 项):格式注册表一致性(每个 UI 选项都有别名、content-type、扩展名与分发分支)、Clash 原版协议过滤、.conf结构与 AmneziaWG 键排序、IPv6 方括号、无 wireguard 报错、.conf导出 → 重新导入的完整往返 tests/core_link_test.lua的目标格式列表改为从output.FORMAT_OPTIONS派生,新增格式自动纳入覆盖- 版本号 2.3.0-r1 → 2.3.0-r2;README.md / README.en.md / docs/INSTALL.md 同步(输出格式 13 → 15 种)
[2.3.0-r1] - wg-quick / AmneziaWG .conf 导入与导出修复
- 新增 wg-quick / AmneziaWG
.conf文本导入:解析[Interface]/[Peer]分段[Interface]:PrivateKey / Address(自动区分 IPv4 与 IPv6)/ ListenPort / MTU / DNS[Peer]:PublicKey / PresharedKey / AllowedIPs(拆分为数组)/ PersistentKeepalive / Endpoint(拆出 server + port,支持[v6]:port)- AmneziaWG 参数(Jc/Jmin/Jmax/S1–S4/H1–H4/I1–I5/J1–J3/Itime)按白名单映射到
amnezia-wg-option,未知键丢弃(不猜语义) - 键名大小写不敏感,支持
#/;注释;缺少 Endpoint 时明确报错而非产出半成品节点 - 本地订阅文本导入与远程订阅下载同时生效(无需改 sync 流程)
- 修复 P1 引入的数组输出缺陷:clash.meta 的
allowed-ips/reserved/dns值为数组时改用 YAML 列表输出,不再产生table: 0x... - 修复 sing-box
local_address:同时有 IPv4/IPv6 时输出数组,不再逗号拼接(非法值) amnezia-wg-option子块按键名排序输出,同一节点每次导出结果一致,便于 diff- 修复
parser_clash_yaml列表项误判:- "::/0"等引号标量含冒号时不再被解析成 table - 补全 sing-box / Clash JSON 导入:
local_address数组拆分、persistent_keepalive_interval、listen_port、amnezia-wg-option - 新增
listen-port字段贯通全链路(表单 / FORM_KEYS / clash.meta / sing-box / URI 输出) - 新增测试
tests/wireguard_conf_test.lua(61 项)、tests/amnezia_wg_test.lua(67 项) - 版本号 2.2.0-r5 → 2.3.0-r1;README.md / README.en.md / docs/INSTALL.md 同步
[2.2.0-r5] - WireGuard 完整字段与 AmneziaWG 支持
- WireGuard 节点补全字段:public-key/pre-shared-key/ip/ipv6/allowed-ips/reserved/persistent-keepalive/mtu/dns/amnezia-wg-option
- Clash Meta 导出字段名修正为 public-key/pre-shared-key,补齐 ip/allowed-ips 等必填项,支持 amnezia-wg-option 子块全量输出
- sing-box 导出修正 pre_shared_key,补齐 local_address/reserved/persistent_keepalive_interval
- parser 补读 WireGuard 扩展字段,兼容旧名 peer-public-key/preshared-key
- core FORM_KEYS 补入 WireGuard 扩展字段,避免表单编辑后丢失
- nodeform.js PROTO_FIELDS.wireguard 扩充,表单显示完整字段
- local_form.htm / node_edit.htm FIELD_LABELS 补入 WireGuard 扩展字段标签
- parser_clash_yaml 补内联数组解析,支持 reserved/allowed-ips
- output_clash_meta esc_yaml 修复 find 平文匹配 bug
- 版本号 2.2.0-r4 → 2.2.0-r5;README/INSTALL 同步
[2.2.0-r4] - 节点协议标签统一为 Type / 类型
- 节点列表页筛选标签与表头由
Protocol / 协议统一改为Type / 类型 - 节点编辑 / 本地订阅表单导入的协议选择标签由
Protocol改为Type,中文显示为“类型” nodeform.js标签键由protocol改为type,与下拉框data-k="type"一致local_form.htm/node_edit.htm的FIELD_LABELS由"protocol": "<%:Protocol%>"改为"type": "<%:Type%>"- 版本号 2.2.0-r3 → 2.2.0-r4;README.md / README.en.md / docs/INSTALL.md 版本同步
[2.2.0-r3] - 节点表单导入字段语言混合优化
- 「添加本地订阅」表单导入 /「编辑节点」页:名称 / 分组 / 协议保持系统语言(中/英切换),其余技术参数字段固定为英文(Server / Port / Password / Cipher / Method / Security / Network / Header Type / Path / Obfs / Obfs Param / Obfs Password / Protocol Param / Skip Cert Verify / Private Key / Peer Public Key),与 Clash YAML / 分享链接字段名保持一致,提升可对照性
[2.2.0-r2] - 节点页按钮顺序调整
- 「节点」页「筛选」后的「刷新」「删除」按钮位置互换(现为:筛选 | 删除 | 刷新)
[2.2.0-r1] - 节点页批量选择与操作
- 「节点」页关键词搜索框缩短为原长度的 3/5(
size默认 20 → 12) - 节点表格最左新增复选框列:表头复选框全选 / 取消全选,行复选框单独勾选
- 「筛选」后新增「刷新」按钮(重载页面,筛选参数随 GET URL 自动保留)与「删除」按钮(勾选批量删除,confirm 确认,返回保留筛选参数)
- action_node_delete 的 idx 参数支持逗号分隔多值,倒序 table.remove 避免下标偏移;行内单删路径不变
- po/zh-cn 新增 Refresh / Delete selected nodes? / Please select nodes first 三条
- 版本号 2.1.3-r6 → 2.2.0-r1;README.md / README.en.md / docs/INSTALL.md 版本与功能描述同步
[2.1.3-r6] - 节点分组与单节点编辑
- 表单导入节点行新增「分组」输入框(
data-k="group",parse_local 透传入模型) - 节点页「关键词:」前新增「分组:」下拉筛选(选项为当前订阅节点的去重分组,精确匹配走 node.filter);排序新增按分组
- 节点页「名称」后新增「分组」列:单元格内嵌输入框,onchange 经 XHR 提交 node_set_group 无刷新保存(成功绿闪/失败红闪提示)
- 节点页行尾新增「操作」列:编辑(新页面 node_edit.htm,复用协议动态字段,可改名称/分组/服务器/端口/协议全字段)与删除(confirm 确认,返回保留筛选参数)
- 单节点标识:渲染前标注原始数组下标 __idx(filter 保留表引用、sort 原地排序,下标穿透筛选排序)
- core.lua 新增 merge_form_node:表单字段整体替换(可清空),raw/tags 等非表单字段保留;删除/编辑后刷新引用该订阅的组合
- 动态字段 JS 抽取为 /luci-static/resources/substore/nodeform.js,local_form.htm 与 node_edit.htm 共用(翻译字典留模板内服务端渲染)
- 控制器新增 node_edit / node_save / node_delete / node_set_group 四路由
- 已知语义:单节点编辑/删除/分组在订阅下次「更新」或本地订阅重新保存后被覆盖(用户已确认接受)
- po/zh-cn 新增 分组/编辑节点/删除确认 等 6 条;tests/core_merge_node_test.lua 新增(17 断言)
[2.1.3-r5] - 本地订阅表单全面接入系统语言
- local_form.htm 规则区硬编码中文(启用规则/关键词包含/关键词排除/去重/提示语)改为
<%:...%>可翻译字符串,随 OpenWrt 系统语言自动切换中英文 - po/zh-cn 新增 Enable rules / Keyword include / Keyword exclude / Dedup 等 5 条
- 至此 local_form.htm 页面无任何硬编码中文(剩余中文均为代码注释)
- 说明:旧 form.htm(订阅链接表单)存在同样的硬编码中文存量问题,未在本次改动范围内
[2.1.3-r4] - 表单导入枚举字段下拉化 + hysteria2 混淆闭环
- 表单导入枚举字段改为下拉框(选项以模型/输出模块实际支持的值为准,对齐 PassWall 式交互)
- 传送方式 net:tcp/ws/h2/grpc;伪装类型 headerType:none/http(vmess/vless/trojan/shadowsocks 新增该字段)
- vmess 加密方式 cipher:auto/aes-128-gcm/chacha20-poly1305/none/zero;新增 TLS 开关(修复表单无法生成 TLS vmess 节点的缺口)
- vless 新增 flow(默认/xtls-rprx-vision);security:none/tls/reality
- shadowsocks 加密方式 method:常用 11 种枚举
- hysteria2 新增混淆类型 obfs(无/salamander)+ 混淆密码 obfs-password
- 下拉选项按协议区分(hysteria2.obfs),不影响 ssr 的 obfs 自由文本
- hysteria2 混淆导入导出闭环:output_uri 补 obfs/obfs-password 参数输出;output_clash_meta 补 obfs/obfs-password 行;output_singbox 补 obfs 对象;parser 的 hy2 URI 解析回读 obfs 参数
- po/zh-cn 新增 伪装类型 / 混淆密码 翻译
- tests/parser_local_form_test.lua 扩至 39 断言:hy2 混淆透传/URI 回环/双输出、vmess headerType/tls 透传
[2.1.3-r3] - 表单导入字段中文化并扩充协议字段
- 表单导入动态字段标签支持简体中文(server/port/password/cipher/net/path/sni 等,po/zh-cn 新增 13 条)
- 扩充各协议字段集合,覆盖 Clash 风格节点常见字段:vmess/vless/trojan 新增 path、host、udp、skip-cert-verify;vmess 新增 alterId、cipher;ssr/shadowsocks/tuic/wireguard 新增 udp
- udp / skip-cert-verify 改为下拉框(默认/true/false),不再手填文本
- parser.lua
parse_local表单模式改为全字段透传 + 类型修正(port/alterId 转数字,udp/skip-cert-verify 字符串转布尔,network→net、method↔cipher、obfs-param/protocol-param 别名同步),不再因白名单丢字段
[2.1.3-r2] - 修复本地订阅表单导入跳回列表
- 修复「添加本地订阅」页选择「表单导入」直接提交表单并跳回订阅列表的问题
- local_form.htm:模式切换下拉框原为
onchange="this.form.submit()",改为纯 JS 切换显示,不再提交 - 移除重复的 hidden
local_mode字段;文本/表单两个content字段通过 disabled 互斥,保证只提交一个 - 提交前(onsubmit)表单模式将节点序列化为 JSON 写入隐藏 content 字段
- 编辑页初始内容由
util.json_encode注入 JS(不再 pcdata 转义,避免破坏 JSON.parse)
- local_form.htm:模式切换下拉框原为
[2.1.3] - 新增本地订阅功能
- 新增本地订阅:支持文本导入与表单导入双模式,本地订阅不走网络更新,Update 按钮禁用
- 首页按钮调整:
添加订阅→添加订阅链接,新增添加本地订阅 - 数据模型扩展:
local、raw_content、local_mode字段,core.add_local/parser.parse_local - 控制器新增
localform/local_create/local_save路由 - 视图新增
local_form.htm,表单导入支持 vmess/vless/trojan/shadowsocks/ssr/hysteria2/tuic/wireguard 动态字段
[2.1.2] - 完善协议列表
- 补齐节点列表和规则配置中缺失的协议选项
- nodes.htm:补齐 ssr、hysteria、wireguard、socks 四个协议
- substore.lua:补齐 ssr、hysteria、wireguard、socks 四个协议
[2.1.1] - 修复延迟显示 Bug
- 修复「节点」页面延迟列显示异常问题
- 修正 innerHTML 与 textContent 的差异,确保失败时正确显示红色 "Fail" 文本
- 之前版本中由于使用 textContent,HTML 标签被显示为纯文本
[2.1.0] - 网络探测优化
- 优化「节点」页面的网络探测(Ping/TCPing/URL Test)显示
- 在节点列表表格中新增「延迟」列,直接显示每个节点的测速结果
- 移除独立的探测结果弹窗,结果直接展示在表格内,查看更加直观
- 使用 data 属性进行节点匹配,提高稳定性
[2.0.0] - 组合订阅
- 新增「组合订阅」(选择性合并多个订阅 + 组合订阅链接)
- core.lua:新增 add_combo / save_combo / combo_nodes / combo_refresh / refresh_combos / is_combo; 组合订阅物化为自身节点文件,无 URL、无 cron/代理,可叠加关键词包含/排除与去重规则; sync 遇组合走重算而非下载,源订阅更新后自动 refresh_combos 重算依赖它的组合
- controller:新增 combo / combo_save 路由与 action_combo_save(复用 read_rules_fields)
- view:新增 combo.htm(名称 + 来源复选框 + 规则显隐);subscriptions.htm 增「添加组合订阅」 按钮、组合行徽标与来源显示、编辑路由区分
- Makefile:安装 combo.htm;版本号 1.0.0 → 2.0.0(2.0.0-r1)
- i18n:po/zh-cn 新增 添加/编辑组合订阅、组合、来源订阅
- tests/core_combo_test.lua 新增(23 断言)
[1.0.0] - 正式版
- 修复 Clash 订阅(机场常见「流式 JSON 节点」写法)解析为 0 节点的问题
- 部分机场生成的 Clash/Mihomo 配置把每个代理节点写成单行流式 JSON:
- {"name":"…","type":"vmess","server":"…","port":443,…}(含嵌套ws-opts),而非缩进块风格;原解析器只认块风格,导致name/server/port全部读空、节点被丢弃 - parser_clash_yaml.lua
read_list:识别- {…}流式 JSON 对象并util.json_decode解析 - parser_clash_yaml.lua
map_clash_node:把 Clash 的ws-opts.path/ws-opts.headers.Host映射到统一模型的path/host(此前 ws 节点丢失 path) - tests/parser_clash_yaml_test.lua 新增流式 JSON 节点用例(vmess ws + ssr,含 path/host 映射,+14 断言)
- 部分机场生成的 Clash/Mihomo 配置把每个代理节点写成单行流式 JSON:
- 修复 Shadowrocket 订阅(base64url / BOM)无法解析、内部 vmess 节点读不出的问题
- parser.lua
detect:base64 检测接受 URL-safe base64url(-_无 padding)与 UTF-8 BOM 前缀; 对「纯字母数字且长度非 4 倍数」的去 padding base64url,尝试解码并校验是否含 vmess/vless/trojan/ss/ssr 节点再判定 - parser.lua
parse/parse_vmess:改用util.base64_url_decode(兼容标准 base64 与 base64url) - tests/run_tests.lua 增补 base64url / BOM 订阅检测与解析用例(+4 断言)
- parser.lua
- 补齐协议能力矩阵的四项缺口(hysteria2 / tuic / wireguard 全链路导入导出 + JSON 配置导入放开 + Surge 家族输出)
- parser.lua:SUPPORTED 增加 hysteria2 / tuic / wireguard;新增 parse_hysteria2 / parse_tuic /
parse_wireguard(wireguard 采用本项目自定义 scheme
wireguard://base64(json)#name,因 wireguard 无统一 URI 标准) - parser_json_config.lua:proto_map / SUPPORTED 从 4 协议扩到 11(补 hysteria/hysteria2/tuic/wireguard/ socks/http/ssr);sing-box 解析补 hysteria2/tuic/wireguard/socks/http 分支,V2Ray 解析补 socks/http 分支, Clash 解析补 hysteria2/tuic/wireguard/socks/http/ssr 分支(ssr 读 cipher/protocol/obfs/obfs-param/protocol-param)
- output_uri.lua:新增 wireguard 输出(
wireguard://base64(json)#name),与 parser 回环一致 - output_formats.lua:Surge 家族新增 tuic 行(username=uuid/password/sni/alpn);surge_config 统一丢弃 wireguard(Surge 需专用多段 [WireGuard] 配置,单行无法表达),ssr 仅 Loon/Egern 保留
- output_singbox.lua:wireguard 输出读取 kebab-case 字段(private-key/peer-public-key/preshared-key, snake 回退),导入后经此输出字段不再丢失
- node.lua:PROTOS 已含 hysteria2/tuic/wireguard,无改动
- tests/protocol_support_test.lua 新增(58 断言):hy2/tuic/wireguard URI 导入、base64 订阅、 sing-box/Clash JSON 导入、Surge tuic 输出 + wireguard 丢弃、sing-box wireguard kebab 输出
- parser.lua:SUPPORTED 增加 hysteria2 / tuic / wireguard;新增 parse_hysteria2 / parse_tuic /
parse_wireguard(wireguard 采用本项目自定义 scheme
- 新增 SSR(ShadowsocksR)订阅源支持
- parser.lua:SUPPORTED 增加 ssr;新增 parse_ssr 解析 ssr:// 分享链接(外层 base64、 密码/参数 base64url 兼容标准 base64,remarks/obfsparam/protoparam/group)
- util.lua:新增 base64_url_encode / base64_url_decode(RFC 4648 base64url)
- node.lua:PROTOS 注册 ssr
- output_clash_meta.lua:ssr 输出完整字段(cipher/password/protocol/obfs/obfs-param/protocol-param)
- output_uri.lua:新增 to_ssr_uri 生成 ssr:// 分享链接(Shadowrocket / V2Ray URI 输出)
- output_formats.lua:Loon / Egern 输出 SSR 行;Surge/Surfboard/SurgeMac 跳过 ssr(不支持)
- output_singbox.lua / output_v2ray.lua:跳过 ssr(不支持 SSR,丢弃而非输出非法配置)
- SSR 仅能原样输出到支持它的客户端,不能与 vmess/vless 等其它协议互转(协议不兼容)
- view/form.htm:「订阅 URL」输入框宽度与「代理地址」对齐(70% → 60%)
- tests/ssr_test.lua 新增(41 断言)
- 编辑订阅页新增「订阅代理」:开启后通过代理地址下载订阅(解决国内直连失败)
- http.lua:新增 parse_proxy(http/https/socks4/socks5/socks5h,含 user:pass@,防注入);download/curl/wget 支持代理
- core.lua:订阅元数据新增 proxy_enable/proxy;sync() 开启且地址有效时经代理下载
- controller:create/save 读取并持久化 proxy_enable/proxy
- view/form.htm:订阅 URL 下方新增「订阅代理」复选框,开启时显示「代理地址」输入框(默认关闭)
- tests/http_proxy_test.lua 新增
- 编辑订阅页展示剩余流量 / 剩余时长(仅编辑页,首页不显示)
- http.lua:下载时捕获响应头,download() 返回值改为 body, headers, err;新增 read_headers
- core.lua:新增 parse_userinfo;sync() 解析 subscription-userinfo 头并持久化 upload/download/total/expire
- util.lua:新增 human_bytes / human_duration
- view/form.htm:统计行新增「剩余流量 / 剩余时长」
- po/zh-cn:新增 Remaining traffic / Remaining time 翻译
- tests/core_userinfo_test.lua 新增
- 简体中文 i18n(运行时语言 zh-cn 时自动显示中文,英文时保持英文;24.10 / 25.12 实机均已验证)
- po/zh-cn/substore.po 新增(菜单/按钮/列头/探测结果等全部 UI 字符串)
- Makefile: install 步骤用 po2lmo 编译为 substore.zh-cn.lmo 并打包到 /usr/lib/lua/luci/i18n/
- Nodes 页新增节点网络探测(Ping / TCPing / URL 测试)
- probe.lua 新增:Ping(ICMP 解析 time=)、TCPing(nc -z 测连接耗时)、URL 测试(curl time_total / wget uptime 差值);并行探测,总耗时≈单节点超时;主机名/IP 白名单校验防命令注入
- controller: action_probe 端点(POST id/mode/proto/keyword,返回 JSON),按当前 proto/keyword 过滤后逐个探测
- view/nodes.htm: 筛选按钮后新增三按钮 + 结果表格(延迟/失败 + 成功数与平均延迟);Desc 复选框与下拉框间距、复选框与文字间距修正
- tests/probe_test.lua 新增(18 断言)
- 规则编辑页简化与对齐(form.htm)
- 「定时更新时间」与「关键词包含/排除」改为与其它行一致的 cbi-section-descr + min-width:10em 标签,左对齐;cron_time_row 由 display:flex 改为 block + inline-flex
- 移除「协议过滤」「重命名规则」字段;底部新增多关键词备注
- node.lua: 关键词包含/排除支持逗号(含中文逗号)/空白分隔的多关键词,命中任一即保留/去除
- tests/core_rules_test.lua 增补多关键词用例(14 断言)
- 规则下沉到订阅(per-subscription),更新订阅时直接生效;移除全局「设置」页
- core.lua: 订阅元数据新增 rules_enable / proto_filter / keyword_include / keyword_exclude / dedup / rename_map;新增纯函数 apply_rules();sync() 解析后按订阅规则过滤/去重/重命名再落盘;移除 load_rules()(不再依赖 luci.model.uci)
- controller: read_rules_fields();create/save 读取并持久化规则;移除 settings/settings_save 路由与 action_settings_save
- view/form.htm: 新增「启用规则」复选框 + 规则字段(协议过滤/关键词包含/排除/去重/重命名),随复选框显隐
- 删除 view/settings.htm、menu.d 的 Settings 条目、UCI config rules 'default';uci-defaults 清理旧 substore.default
- tests/core_rules_test.lua 新增(11 断言)
- Stage 4: 定时更新、规则、错误处理、安全加固、多版本兼容
- substore-cron.sh: 重写为独立 cron 可运行(显式 package.path、自动探测 lua5.1/lua、pcall 保护、输出走 logger)
- node.lua: 重命名规则统一三种形式——精确
旧=新、正则pattern -> replacement、模板{server}_{port}_{proto}(parse_rename_rules / rename_with_rules / apply_rules) - view/settings.htm: 重命名规则 hint、协议过滤/关键词/去重规则配置
- controller: action_update 用 pcall 兜底,解析/写入异常不 500,错误落库并在列表页状态列展示
- controller: action_download 文件名白名单化,防 HTTP 头注入
- Makefile: LUCI_DEPENDS 显式 +luci-lua-runtime +luci-compat(23.05/24.10 兼容)
- docs/UCODE_MIGRATION.md:
.htm→.ut(ucode)迁移评估与对照(未执行,需 25.12 构建环境验证) - tests: node_rename_test.lua 增补精确匹配重命名用例(27 断言)
- Stage 3: 订阅转换 + 订阅链接(核心功能)
- output.lua: 统一分发全部 13 种目标格式(FORMAT_ALIASES 别名映射)
- output_uri.lua: vmess/vless/trojan/ss/hysteria2/tuic/socks 分享链接、Shadowrocket(base64)/V2Ray URI
- output_singbox.lua: sing-box JSON outbounds
- output_v2ray.lua: V2Ray/Xray JSON outbounds
- output_formats.lua: Surge/Surfboard/SurgeMac/Loon/Egern/QX/Stash/Plain JSON
- core.lua: 每订阅随机 token、generate_link(token, target)
- controller: 公开下载端点 /substore/download?token=&target= (token 访问控制)
- view: output.htm 13 格式下拉、subscriptions.htm 展示可复制的订阅链接
- Makefile: 通配安装新增 .lua 模块
- tests: output_formats_test.lua、core_link_test.lua
- Stage 1: subscription CRUD + download/parse core
- util.lua: JSON/Base64/URL/file helpers, atomic_write
- node.lua: protocol normalize
- parser.lua: vmess/vless/trojan/ss URI parse
- http.lua: curl/wget download with SSRF check
- core.lua: subscription meta/nodes persistence, sync()
- LuCI: subscriptions list & form, controller actions
- tests/run_tests.lua added
- Stage 0 skeleton: package scaffolding, LuCI menu placeholder, docs.
[0.1.0] - not yet released
- Initial package skeleton (in development).