Skip to content

v4.23.0: 管理面独立凭据与不安全绑定拒启

Latest

Choose a tag to compare

@github-actions github-actions released this 12 Nov 14:59
· 8 commits to main since this release

安全

  • 管理面写操作一次性凭据(批次 B 回移植):/api/* 的写请求凭 x-admin-token(401 拦截),与 PROXY_API_KEY 权限分离——数据面密钥泄露不再等于管理面失守;token 由服务端注入 dashboard 页 <head> meta(前端 apiJson 自动携带),可用 ADMIN_API_TOKEN 固定供脚本使用。配套 B2 Host 回环白名单(防 DNS rebinding 页面连 token 一起读走,ADMIN_ALLOWED_HOSTS 可追加);新增 src/utils/admin-guard.ts 与纯函数测试,新增「无 token 401」守卫用例,既有集成/掩码测试同步带凭据。

    升级注意(脚本调用方):直接用 curl / 脚本打 /api/* 写接口的调用方现在必须带 x-admin-token,否则收到 401。取 token 的两种方式:读仪表盘页面 <head> 里的 meta,或设 ADMIN_API_TOKEN 固定值。/v1/* 数据面不受影响,仍只认 PROXY_API_KEY。

  • 非回环绑定且未设 PROXY_API_KEY 时拒绝启动(原为仅告警),与同源仓 multi-upstream-gateway 安全默认对齐;ALLOW_INSECURE_BIND=1 显式豁免。同批:补 pretest:coverage 钩子(test:coverage 先 build,防集成用例 spawn 过期 dist);新增 gitleaks 扫描 workflow;修复 tests/proxy-agent.test.ts 未使用的 dns import(此前连续挂 CI)。

文档

  • 新增仓库版接力开发文档 HANDOFF.md:面向 GitHub 协同的六模块接力文档(概况 / 技术栈 / 架构拓扑 / 最近变更 / 待办 / 避坑),覆盖 4.22.2-4.22.4 三轮网络链路演进;机器专属的部署运维细节拆分至本地 HANDOFF.local.md(.git/info/exclude 排除,不入库)。