安全修复面向仓库 最新公开稳定版,不再按固定 minor 系列声明支持范围。旧版本用户应先升级到该 Release;如果问题仍然存在,报告时请注明实际版本和复现条件。尚未公开发布的修复只有进入新的稳定 Release 后才视为对用户可用。
请通过仓库的 Security Advisories 提交私密漏洞报告。不要在公开 Issue、Discussion、提交记录或日志附件中包含以下内容:
- 订阅地址、访问令牌、口令或后台凭据;
- 用户、设备标识及设备密钥;
- 未脱敏的日志、数据库、配置文件或抓包内容;
- 可以直接复现生产环境访问权限的安装包或链接。
报告建议包含受影响版本、复现条件、预期与实际结果、影响判断,以及已经完成脱敏的最小复现材料。维护者会优先确认可复现性和影响范围,并在修复可用后协调披露时间。
如果敏感值已经进入公开提交、Actions artifact 或 Release,应先在对应服务中撤销或轮换;删除文件或重写 Git 历史不能恢复已经暴露的凭据。
resources/default-subscription.txt必须为空。resources/default-subscription.in.txt、.dev.vars*、.wrangler/、release/、release-archive/、team-builds/、遗留的local-subscription-builds/和resources/generated/不得提交。- 公共三通道资产必须由
npm run dist:win:release生成,并通过空内置订阅校验。 - 推送前应运行
npm run validate:repo;正式发布还需完成 发布检查清单。 - 发现历史敏感内容时,按 历史净化流程 完成凭据处置、离线备份、历史改写、远端校验和缓存清理申请。
- 常规 Worker 生产变更只通过
.github/workflows/deploy-worker.yml的手动固定 SHA 流程准备:必须从main触发,输入 SHA 必须等于定义该次 workflow run 的精确maincommit,并由仅允许main的受保护production-workerEnvironment 审批;仓库推送、Pull Request 和本地质量门槛不会自动部署。 - Cloudflare 凭据只作为受保护 Environment 中的最小权限 secret 注入远端 schema、migration 和 deploy 步骤。
REGISTRATION_PASSPHRASE、ADMIN_TOKEN等 Worker 运行时 secret 不复制到 GitHub workflow,也不通过该流程写入。 - D1 migration apply 由多个远端命令组成,不应假定具备跨文件原子性。批准生产 apply 前必须核对 dry-run、固定目标和恢复方案;失败时停止后续部署,不用自动重试掩盖部分完成状态。
- Actions 日志、artifact 和审计摘要不得包含 token、环境变量转储、D1 数据行或未脱敏的 Wrangler 响应。
REGISTRATION_PASSPHRASE 是受信团队选择和切换已有姓名档案的共享授权,不是每个姓名独立的账号密码。持有该口令的人可以为已有姓名登记设备,并读取该用户适用的远程配置、累计用量和当日用量。只应在受信团队内分发;疑似泄露时应立即轮换 Cloudflare Secret,并避免在日志、截图、安装包说明或聊天记录中发送。