Files
douyi_guaji_main/docs/security/full_security_audit_2026-06-28.md
T

14 KiB
Raw Blame History

全量安全审计报告(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 转发策略。

证据:

  • 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 修复版本。

参考资料