# Bifrost Anywhere 基于 Web 的 AWS EC2 实例管理平台,支持通过 Apache Guacamole 进行浏览器内 RDP 远程桌面连接。 ## 技术栈 - 前端:React 19 + TypeScript + Vite + Ant Design - 后端:Express + TypeScript + better-sqlite3 - 远程桌面:guacamole-lite + guacamole-common-js - AWS SDK v3 ## 项目结构 ``` ├── client/ # React 前端 │ └── src/ │ ├── components/ # UI 组件 │ ├── pages/ # 页面 │ ├── api/ # Axios 配置 │ └── utils/ # 工具函数 ├── server/ # Express 后端 │ └── src/ │ ├── routes/ # API 路由 │ ├── services/ # 业务逻辑 │ ├── middleware/ # 中间件 │ └── utils/ # 工具函数 └── Dockerfile ``` ## 快速开始 ### 环境要求 - Node.js >= 18 - npm ### 本地开发 ```bash # 安装依赖 cd server && npm install cd ../client && npm install # 配置环境变量 cp .env.example .env # 编辑 .env 填入 AWS 凭证等配置 # 启动后端 (端口 3000) cd server && npm run dev # 启动前端 (端口 5173,自动代理 API 到后端) cd client && npm run dev ``` ### Docker 部署 ```bash # 1. 启动 guacd(Guacamole 代理守护进程,用于 RDP 连接) docker run -d --name guacd guacamole/guacd # 2. 构建应用镜像 docker build -t bifrost-anywhere . # 3. 运行应用容器(链接 guacd) docker run -d \ -p 3000:3000 \ -v bifrost-anywhere-data:/app/server/data \ --link guacd:guacd \ --env-file .env \ --name bifrost-anywhere \ bifrost-anywhere ``` ## 环境变量 | 变量 | 说明 | 默认值 | |------|------|--------| | `PORT` | 服务端口 | `3000` | | `JWT_SECRET` | JWT 签名密钥 | - | > AWS 凭证(Access Key、Secret Key、Region 等)通过管理员页面配置,加密后存储在数据库中,无需设置环境变量。 ## API - `GET /api/health` — 健康检查 - `/api/auth` — 认证相关 - `/api/instances` — 实例管理 - `/api/admin/*` — 管理员接口 - `ws://host/ws/rdp` — RDP WebSocket 连接