Repository navigation
安全
-
管理面写操作一次性凭据(批次 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排除,不入库)。