14 KiB
14 KiB
全量安全审计报告(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是真实攻击面。外部公告显示,历史上 StarletteFileResponseRange 处理出现过 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真正应用更新时,PowerShellExpand-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-169GET API 仅允许本机访问并暴露 CSRF token。gui/web_gui_pkg/routes.py:389-399POST 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.2starlette==1.3.1uvicorn==0.49.0python-multipart==0.0.32cryptography==47.0.0PyInstaller==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高于上述修复版本;生产仍建议锁版本并加入自动漏洞扫描。
修复优先级
- 轮换 admin token,清理本机和服务器明文 token,后台发布增加二次授权。
- 上传接口改流式写入并加大小限制,反向代理同步限流。
- 更新包改 CDN/对象存储分发,授权服务只发短期 URL。
- 正式包 Authenticode 签名,客户端校验证书指纹后再启动安装器。
- 生产强制
DYGJ_LICENSE_PUBLIC_BASE_URL、TrustedHostMiddleware、Secure Cookie。 - WebGUI 加安全响应头和 CSP,继续收敛
innerHTML。 - 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/