云上使用 Bifrost

iaun 0cb96a0ac9 fix: 调整userdata,使用内嵌浏览器 hai 7 meses
.kiro 6fea387450 first commit hai 7 meses
client 6fea387450 first commit hai 7 meses
server 0cb96a0ac9 fix: 调整userdata,使用内嵌浏览器 hai 7 meses
.env.example 6fea387450 first commit hai 7 meses
.gitignore 6fea387450 first commit hai 7 meses
Dockerfile 6fea387450 first commit hai 7 meses
README.md 6fea387450 first commit hai 7 meses

README.md

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

本地开发

# 安装依赖
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 部署

# 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 连接