Bifrost 是一个企业私有 Web 服务访问网关。
第一阶段聚焦于通过以下能力，受控访问企业内部 HTTP/HTTPS 服务：
- Go Gateway 服务端
- Electron 桌面客户端
- React 管理后台
- 共享设计系统与 API 契约
- 基于 Docker 的本地多容器测试环境
桌面客户端刻意保持轻量：它是一个卡片式访问入口，不是 VPN，不是系统代理，也不是管理后台。
建议先阅读 docs/00-overview/README.md。
项目实现清单维护在 docs/08-roadmap/development-checklist.md。已完成事项需要记录完成时间。
corepack enable
corepack prepare pnpm@10.33.0 --activate
pnpm install --frozen-lockfile项目依赖统一使用 pnpm 安装；npm install、yarn install 和 bun install 会被 preinstall 守卫拒绝。
首次安装会自动执行 Electron、esbuild 等桌面端必需的构建脚本。如果你之前看到过 Ignored build scripts 或启动时报 Electron uninstall，拉取最新配置后重新执行 pnpm install --frozen-lockfile 即可修复。
| 目标 | 启动命令 | 默认访问地址 | 停止命令 |
|---|---|---|---|
| 检查远端 dev 后端 | pnpm dev:backend |
Gateway：http://142.171.208.80:18080 |
无常驻进程 |
| 启动后台管理页面 | pnpm dev:admin |
Admin Web：http://127.0.0.1:5173 |
Ctrl+C |
| 启动本机 Docker 后端 | pnpm dev:backend:local |
Gateway：http://127.0.0.1:18080 |
pnpm dev:backend:local:down |
| 启动桌面客户端 | pnpm --filter @bifrost/desktop dev |
Electron 开发服务：http://127.0.0.1:22473 |
关闭 Electron 窗口，必要时再停后端 |
本地默认不再拉起 Docker 后端。后端由 dev 分支推送后通过 GitHub Action 自动部署到远端服务器，本地只检查远端 Gateway 和私有上游代理是否可用。
检查：
pnpm dev:backend默认地址：
Gateway: http://142.171.208.80:18080
健康检查：
curl http://142.171.208.80:18080/healthzpnpm dev:backend 只检查远端后端，不会启动后台管理页面，也不会启动 Docker。
如需本机 Docker 后端：
pnpm dev:backend:local
pnpm dev:backend:local:down后台管理页面是 apps/admin 的 Vite 应用。它默认读取根目录 .env，接口地址走远端 dev 后端 http://142.171.208.80:18080。
pnpm dev:admin默认地址：
Admin Web: http://127.0.0.1:5173
Gateway: http://142.171.208.80:18080
后台登录账号：
用户名：admin
密码： ChangeMe123!
停止：
Ctrl+C注意：pnpm dev:backend 只检查远端后端连通性，不启动后台管理页面。如果你要看后台页面，请使用 pnpm dev:admin。
桌面客户端是 Electron 应用。它可以单独启动，但要完成登录、拉取服务列表和打开受控服务，需要先确认远端 dev 后端可用。
先检查后端：
pnpm dev:backend另开一个终端，启动桌面客户端：
pnpm --filter @bifrost/desktop dev桌面客户端开发服务器固定监听 http://127.0.0.1:22473，不会再使用 Vite 默认的 5173/5174。如果你的机器上 22473 临时被占用，可以显式指定另一个空闲端口：
BIFROST_DESKTOP_DEV_PORT=22474 pnpm --filter @bifrost/desktop dev客户端登录信息：
Server URL: http://142.171.208.80:18080
Username: alice
Password: ChangeMe123!
登录成功后，客户端会在 127.0.0.1:18080 到 127.0.0.1:18099 中选择一个可用端口启动 Bifrost 专用本地回环代理；实际服务入口以客户端界面显示的地址为准。
如果你只是想跑一遍完整回归，不需要手动打开页面或客户端，执行：
pnpm test:e2epnpm test:e2e 会自动清理旧容器、启动 Docker Compose 测试环境、运行 Playwright E2E，并在结束后回收容器。
- 远端 dev Gateway 健康检查：
http://142.171.208.80:18080/healthz - 本地后台管理页面：
http://127.0.0.1:5173（由pnpm dev:admin启动） - 本地 E2E Admin Web：
http://127.0.0.1:15173（由pnpm test:e2e/pnpm test:e2e:up启动） - 本地 E2E PostgreSQL：
127.0.0.1:15432
pnpm build:gateway:image
pnpm build:admin:image
pnpm --filter @bifrost/desktop build
CSC_IDENTITY_AUTO_DISCOVERY=false pnpm --filter @bifrost/desktop exec electron-builder --config electron-builder.yml --dir三端桌面安装包由 desktop-packages.yml 在 macOS、Windows 和 Linux runner 上构建并上传构建产物。
- 服务端运行参数说明
- Admin Web 启动说明
- Desktop Client 启动说明
- 数据库 Migration 执行说明
- 数据库备份与恢复说明
- TLS 与证书配置说明
- 日志与监控接入说明
- 第一版内部试用发布说明
- 已知问题列表
- 回滚方案
- requestId 排障入口
当前实现工作在 dev 分支推进。Phase 9 验收已完成，Phase 10/11 的发布与 CI 工作仍在推进中。