mirror of
https://github.com/kiddin9/op-packages.git
synced 2026-11-16 21:43:33 +08:00
2.4 KiB
2.4 KiB
Security — luci-app-substore
SSRF 防护
http.lua下载前解析主机名,拒绝 localhost/内网/链路本地/保留地址- DNS 解析后二次校验,处理重定向
- 仅允许 http/https 协议;端口限定 1–65535
- 解析失败即拒绝(fail-closed):主机名解析不出 IP 时不放行。
检查的强度不能低于被检查者 ——
127.0.0.1.nip.io这类「公网可解析到内网」的域名, 若在本机解析失败的那一刻被放行,curl 自己仍会把它解析到 127.0.0.1 并连上去。 代价为零:本包依赖luci-lua-runtime,后者硬依赖luci-lib-nixio, 所以解析失败只意味着「真的解析不了」,此时下载本来也会失败
资源限制
- 订阅响应体最大 10MB,可配置
- 连接/总超时 20s
- 并发限制由系统调度
- 下载临时文件(
.tmp/.tmp.hdr/.tmp.err)在每一条退出路径上清理。 OpenWrt 的/tmp是 tmpfs,占的是内存;失败路径不清理会让 cron 定时重试 一轮轮往内存里堆文件,其中.tmp可能是最大到max-size的部分响应体
输入校验
- 订阅名/文件名白名单校验,禁止
..、/ - 解析时限制结构/大小/嵌套深度,防 YAML/JSON 资源耗尽
- URL 参数解码后二次校验
- 探测目标主机名拒绝以
-开头:probe.lua的命令形如ping -c 1 -W 2 <host>, 而--help/-c会被 busybox 的 getopt 当成选项。util.shq的单引号由 shell 剥掉,getopt 看到的仍是-x,引号挡不住这一层,必须在取值时就拒绝
凭据保护
- 订阅 URL 中的 token 不写入普通日志
- 输出/下载接口使用每订阅随机 16 位十六进制 token 鉴权(
core.ensure_token),不可猜测;/substore/download无登录态 - 日志使用
logger -t luci-app-substore,不记录敏感信息
安全测试
- 已验证 SSRF 私网拒绝
- Base64/JSON 解析异常处理
- 超大响应体截断测试
参见 docs/ARCHITECTURE.md 第 5 节安全设计。
Key requirements (from CLAUDE.md):
- Prevent SSRF (reject localhost / private / link-local / reserved addresses)
- DNS rebinding protection
- Limit subscription response body size and set request timeouts
- Prevent path traversal and command injection
- Never log subscription credentials / tokens
- Output interface requires access control or a random token
- Validate imported data; prevent malicious YAML/JSON resource exhaustion