docs: add full security audit

This commit is contained in:
Your Name committed 2026-06-28 09:12:31 +08:00
1 parent 7745f9a57f
commit 7c6189fd5e
1 file changed
+272
@@ -0,0 +1,272 @@
# 全量安全审计报告(2026-06-28)
## 结论摘要
本次审计覆盖客户端授权、自动更新、差量更新、服务端卡密/API、后台发布、WebGUI、本地打包、CI/CD 和仓库敏感信息暴露面。总体判断:
- 授权与更新主链路已有基础可信链:服务端签名授权/更新 manifest,客户端只内置公钥并校验 manifest 签名与文件 SHA256 后再执行更新。
- 当前最需要优先修的是服务端发布面与分发面:后台 token 权限过大、上传包一次性读入内存、下载包直出服务端。
- WebGUI 默认本机监听、POST 有 CSRF、未授权时拦截运行类接口,基础边界合理;但安全响应头和 CSP 仍缺失。
- 打包已包含 Cython/分发清单/新环境冒烟测试,但依赖安装仍是浮动版本,正式发布需要锁版本、记录 SBOM,并加入签名校验。
## 审计范围
- 服务端:`license_server/api.py`、`license_server/core.py`、`license_server/requirements.txt`、`license_server/docker-compose.yml`、`license_server/Dockerfile`
- 客户端授权:`douyin/license/license_manager.py`、`douyin/license/public_key.py`
- 自动更新:`douyin/updater/force_update.py`、`douyin/updater/bootstrap.py`、`tools/update_delta.py`
- WebGUI:`gui/web_gui.py`、`gui/web_gui_pkg/*`、`webui/**/*`
- 打包与 CI:`packaging/pyinstaller/build_windows.ps1`、`.github/workflows/windows-package-ci.yml`、`tools/ci/fresh_install_smoke.ps1`
- 仓库敏感信息:源代码、文档、测试、配置模板,排除 `artifacts/`、`dist/`、`build/`、`output/`、`logs/` 等生成物。
## 高风险
### H1. 后台发布权限仍集中在单个 admin token
证据:
- `license_server/api.py:118-139` 中 `_admin_allowed()` 接受三种管理员凭据:Session Cookie、`Bearer <token>`、Basic Auth 密码。
- `license_server/api.py:823-873` 的全量包和差量包发布接口只要通过管理员鉴权和 CSRF 即可发布更新。
影响:
- 一旦 `DYGJ_LICENSE_ADMIN_TOKEN` 泄露,攻击者可以发布全量安装包或差量包。
- 现有 manifest 签名能防止“客户端绕过服务端伪造更新”,但不能防止“拿到后台权限后用合法服务端签名发布恶意更新”。
建议:
- 立即轮换历史 admin token,清理桌面、聊天临时目录、部署机器 shell history 中的明文 token。
- 将“登录后台”和“发布更新”拆成两级权限:普通后台 token 不能发布更新,发布更新需要短时一次性 publish token 或 TOTP。
- 发布接口加 IP 白名单、审计日志、版本回滚记录和人工确认。
- 正式包必须做 Authenticode 签名,客户端启动安装器前校验发行者证书指纹。
### H2. 后台上传全量包/差量包会一次性读入内存
证据:
- `license_server/api.py:835` 对安装包执行 `content = await installer.read()`。
- `license_server/api.py:862` 对差量包执行 `content = await delta_file.read()`。
- `license_server/core.py:555-588` 的 `publish_update()` 接收完整 `bytes` 后写盘。
- `license_server/core.py:590-624` 的 `publish_delta_update()` 同样接收完整 `bytes` 后写盘。
影响:
- 大文件或异常 multipart 请求会直接放大服务端内存压力。
- 管理员误操作、token 泄露或代理层限流配置缺失时,容易造成授权服务器不可用。
建议:
- 上传接口加显式大小上限,例如全量包 500MB、差量包 200MB,超限立即拒绝。
- 改成流式写入临时文件,并边写边计算 SHA256。
- 反向代理加 `client_max_body_size` / request body size limit。
- 发布前校验文件类型、扩展名、hash、版本号和可执行文件签名。
### H3. 更新包下载由授权服务直接 `FileResponse` 暴露
证据:
- `license_server/api.py:681-698` 使用 `FileResponse` 直接返回全量包或差量包。
- `license_server/api.py:686-690` 已限制只能下载当前 manifest 允许的文件名,这是正向控制。
影响:
- 安装包/差量包通常较大,未加下载鉴权、限速或 CDN 时,服务端可被下载流量拖垮。
- Starlette `FileResponse` 是真实攻击面。外部公告显示,历史上 Starlette `FileResponse` Range 处理出现过 CPU DoS(CVE-2025-62727,修复于 0.49.1),multipart/form-data 也出现过内存 DoS(CVE-2024-47874,修复于 0.40.0)。
- 当前本机 Starlette 为 `1.3.1`,不落在上述受影响范围内;但生产环境如果不锁版本,仍存在依赖漂移和部署不可复现风险。
建议:
- 更新包放对象存储/CDN,授权服务只签发短期下载 URL。
- 服务端保留 manifest 和授权 API,不承担大文件分发。
- 若继续直出文件,固定 `starlette>=0.49.1`,并在依赖扫描中阻断已知 CVE。
## 中风险
### M1. 生产环境 Host header 仍依赖配置自觉
证据:
- `license_server/api.py:245-249`:未设置 `DYGJ_LICENSE_PUBLIC_BASE_URL` 时,manifest 下载 URL 从 `request.base_url` 推导。
- `license_server/api.py:484-499`:创建 FastAPI app 时未添加 `TrustedHostMiddleware`。
影响:
- 如果生产代理透传恶意 Host,且未配置 `DYGJ_LICENSE_PUBLIC_BASE_URL`,生成的 manifest 下载链接可能被 Host header 污染。
- 客户端有 HTTPS、同源、签名和 SHA256 校验,能降低恶意包执行风险;但错误下载源仍会造成更新失败或服务可用性问题。
建议:
- 生产环境强制要求 `DYGJ_LICENSE_PUBLIC_BASE_URL`,缺失即启动失败。
- 加 `TrustedHostMiddleware`,只允许正式域名和本地健康检查域名。
- 在部署文档中明确 Nginx/Cloudflare 的 Host 转发策略。
### M2. 管理后台 Cookie 默认未开启 Secure
证据:
- `license_server/api.py:495` 中 `DYGJ_LICENSE_SECURE_COOKIES` 默认值为 `False`。
- `license_server/api.py:706-712` 和 `license_server/api.py:733-740` 根据该开关设置 CSRF Cookie 和后台 Session Cookie 的 `secure`。
影响:
- 生产 HTTPS 场景如果忘记设置环境变量,后台 Cookie 不带 Secure 标记。
- `HttpOnly` 和 `SameSite=Lax` 已存在,风险主要来自生产配置遗漏。
建议:
- 生产模式默认 Secure=true,开发模式才允许关闭。
- 启动时检测 `DYGJ_LICENSE_PUBLIC_BASE_URL` 为 `https://` 时强制 Secure Cookie。
### M3. 客户端执行安装器前缺少 Authenticode 校验
证据:
- `douyin/updater/force_update.py:143-158` 会校验 manifest 签名。
- `douyin/updater/force_update.py:556-566` 校验安装包 SHA256 后直接构造命令并启动安装器。
- 当前未看到对 Windows Authenticode 签名、发行者证书指纹或时间戳的校验。
影响:
- SHA256 只能证明“下载到的文件与签名 manifest 中声明一致”。
- 如果服务端私钥或发布后台被攻破,攻击者仍可能发布一个“合法签名 manifest + 恶意 exe”。
建议:
- 正式发布包使用 Authenticode 签名。
- 客户端在 `launch_installer()` 前验证 exe 签名主体和证书指纹。
- CI/CD 记录签名证书指纹、安装包 SHA256 和 SBOM。
### M4. 差量更新应用脚本缺少二次解包后校验
证据:
- `douyin/updater/force_update.py:318-356` 下载后会校验差量包 manifest、文件路径和每个文件 SHA256。
- `douyin/updater/force_update.py:434-463` 真正应用更新时,PowerShell `Expand-Archive` 后直接按 manifest 删除/复制文件。
影响:
- 主进程校验和应用更新是两个阶段,中间若本地文件被替换,应用脚本不会再次校验。
- 对普通用户机器来说攻击门槛较高,但对本地恶意软件或被篡改的更新目录仍是风险点。
建议:
- 在 PowerShell 应用脚本里二次校验 delta zip SHA256,解包后再校验 manifest 中每个文件 SHA256。
- 应用前将 `$root`、`$work`、目标路径做规范化并确认都在安装目录内。
### M5. WebGUI 缺少安全响应头和 CSP
证据:
- `gui/web_gui_pkg/static_handler.py:67-73` 只设置 `Content-Type`、`Content-Length`、`Cache-Control`、`ETag`。
- `gui/web_gui_pkg/routes.py:161-169` GET API 仅允许本机访问并暴露 CSRF token。
- `gui/web_gui_pkg/routes.py:389-399` POST API 有本机限制、CSRF 校验和授权门禁。
影响:
- WebGUI 默认 `127.0.0.1` 监听,且 POST 有 CSRF,基础边界是好的。
- 但没有 `Content-Security-Policy`、`X-Content-Type-Options`、`Referrer-Policy` 等安全头;一旦未来某个日志/接口字段进入 DOM 时漏转义,XSS 的后果会扩大到本机控制面。
建议:
- 给 HTML/JS 响应加安全头:`X-Content-Type-Options: nosniff`、`Referrer-Policy: no-referrer`、最小 CSP。
- 逐步减少内联脚本,或者使用 nonce/hash CSP。
## 低风险与观察项
### L1. 前端使用 `innerHTML` 较多,但核心动态数据大多已转义
证据:
- `webui/js/dom_utils.js:83-90` 提供 `escapeHtml()`。
- `webui/js/runtime_actions.js:318-325`、`360-372`、`441-454` 对直播间、内容、原因等 API 字段使用 `escapeHtml()`。
- `webui/js/dashboard_renderers.js:65-110` 对榜单 key、中奖内容、时间和值做了转义。
- `license_server/api.py:667` 的兑换页把 `data.card_key` 拼入 `innerHTML`,卡密格式由服务端生成,当前风险较低。
建议:
- 新增 ESLint/简单 grep 门禁:所有拼接 API 数据的 `innerHTML` 必须经过 `escapeHtml()` 或改用 `textContent`。
- 兑换页成功展示卡密可改为创建 `code` 节点并设置 `textContent`。
### L2. CI/CD 依赖安装未锁定 hash
证据:
- `.github/workflows/windows-package-ci.yml:42-44` 使用 `pip install -r requirements.txt` 和未固定的 `pyinstaller cython setuptools wheel`。
- `packaging/pyinstaller/build_windows.ps1:31-38` 本地打包也会安装浮动版本依赖。
- `license_server/requirements.txt:1-4` 使用 `>=` 范围。
影响:
- 复用缓存打包时结果可能随 PyPI 最新版本变化。
- 安全修复会自动进来,但也可能引入供应链回归或打包不一致。
建议:
- 增加 `requirements-lock.txt` / `constraints.txt`,正式打包用锁定版本。
- CI 增加 `pip-audit` 或 GitHub Dependabot,发现高危 CVE 直接失败。
- 发布产物附带 SBOM、SHA256 和构建日志。
### L3. 仓库未发现真实私钥明文,但历史 token 文档仍提示需要清理本机副本
证据:
- 敏感信息扫描未发现真实生产私钥 PEM;测试私钥仅在 `tests/` 中使用。
- `license_server/api.py:86-93` 生产私钥从环境变量或服务器文件读取。
- 旧审计文档中记录过桌面存在多个 admin token 明文副本,需要按运维动作清理。
建议:
- 本机和服务器执行 token 文件清理,并确认 `.gitignore` 覆盖 `secrets/`、`*.pem`、`admin_token*.txt`。
- 把生产 secret 全部放服务器 secret 管理或部署平台环境变量,不放桌面、微信临时目录和仓库。
## 已有保护点
- 授权文件签名:`license_server/core.py:872-889` 服务端签名授权,客户端使用公钥验签。
- 机器码只保存 hash:`douyin/license/license_manager.py:66-76` 本机指纹 hash 化。
- 在线复核:`douyin/license/license_manager.py:260-340` 使用服务器状态复核本地授权。
- 更新 manifest 签名:`license_server/core.py:656-658` 服务端签名,`douyin/updater/force_update.py:143-158` 客户端验签。
- 更新下载约束:`douyin/updater/force_update.py:212-237` 要求 HTTPS 和同源,除非配置允许跨源。
- 更新文件完整性:`douyin/updater/force_update.py:547-563` 校验全量包 SHA256,`318-356` 校验差量包路径和文件 SHA256。
- WebGUI 本机限制与 CSRF:`gui/web_gui_pkg/routes.py:57-62`、`389-399`。
- 首次授权门禁:`gui/web_gui.py:912-918` 未授权时不直接进入运行态,`tools/ci/fresh_install_smoke.ps1:180-239` 已覆盖新环境授权门禁冒烟。
- 打包分发清单:`packaging/pyinstaller/build_windows.ps1:55-63` 默认 Cython/PyArmor staging,`270-287` 执行 distribution manifest 检查。
## 依赖与外部公告核对
本机当前版本:
- `fastapi==0.137.2`
- `starlette==1.3.1`
- `uvicorn==0.49.0`
- `python-multipart==0.0.32`
- `cryptography==47.0.0`
- `PyInstaller==6.12.0`
外部公告核对:
- Starlette multipart/form-data DoS:GHSA-f96h-pmfr-66vw / CVE-2024-47874,Starlette `0.40.0` 修复。
- Starlette FileResponse Range DoS:GHSA-7f5h-v6xp-fcq8 / CVE-2025-62727,Starlette `0.49.1` 修复。
- 当前本机 Starlette `1.3.1` 高于上述修复版本;生产仍建议锁版本并加入自动漏洞扫描。
## 修复优先级
1. 轮换 admin token,清理本机和服务器明文 token,后台发布增加二次授权。
2. 上传接口改流式写入并加大小限制,反向代理同步限流。
3. 更新包改 CDN/对象存储分发,授权服务只发短期 URL。
4. 正式包 Authenticode 签名,客户端校验证书指纹后再启动安装器。
5. 生产强制 `DYGJ_LICENSE_PUBLIC_BASE_URL`、`TrustedHostMiddleware`、Secure Cookie。
6. WebGUI 加安全响应头和 CSP,继续收敛 `innerHTML`。
7. CI/CD 增加锁版本、SBOM、pip-audit/Dependabot。
## 本次验证
- `git status --short --branch`:工作区除用户本地 `config/config.json` 外无其他未提交改动。
- 静态证据扫描:授权、服务端 API、更新、WebGUI、打包、CI 均完成。
- 敏感信息扫描:未发现生产私钥 PEM;扫描到的 `secret` 主要位于测试用例和历史审计文档。
- 依赖版本核对:本机 Starlette/FastAPI 版本高于已核对 Starlette DoS 修复版本。
## 参考资料
- GitHub Advisory:Starlette multipart/form-data DoS,GHSA-f96h-pmfr-66vw,https://github.com/advisories/GHSA-f96h-pmfr-66vw
- GitHub Advisory:Starlette FileResponse Range DoS,GHSA-7f5h-v6xp-fcq8,https://github.com/advisories/GHSA-7f5h-v6xp-fcq8
- Starlette Release Notes,https://www.starlette.io/release-notes/
- Starlette Responses 文档:`FileResponse` 支持 Range 请求,https://www.starlette.io/responses/