基于 AstrBot + NapCat / LLOneBot + Docker 的共享机器人框架托管平台，支持多用户独立实例、Web 管理面板，自动端口分配。每个用户拥有一套独立的 AstrBot + QQ Bot 容器环境。
- 👥 多租户管理 — 用户注册（支持邮箱验证码 + 邀请码）、登录、密码重置
- 🐳 Docker 容器编排 — 一键创建 AstrBot + NapCat / LLOneBot 实例，自动分配端口
- 🖥️ Web 管理面板 — 用户仪表板（实例状态、CPU / 内存统计）、管理员后台（用户管理、站点配置、公告管理等）
- 🔌 弹性端口 — 每用户可额外映射 7 个自定义端口，适配特殊插件需求
- 📮 邮件系统 — SMTP 配置、可自定义的邮件模板（注册验证、到期提醒等）
- 📢 公告系统 — 支持多类型公告（信息 / 价格 / 迁移 / 警告 / 封禁），可置顶、自定义样式
- 📋 邀请码系统 — 支持邀请码注册、生成限制（使用期限 / 每月配额 / 活跃上限 / 编码长度）
- 🌐 多节点 Hub 同步 — 邀请码和封禁用户跨节点自动同步
- 🔒 用户封禁 — 支持全局封禁 / 解封，自动同步到 Hub
- 💰 续期与支付 — 自助续期功能、微信 / 支付宝收款码展示、续期记录
- 📁 文件管理 — 在线浏览 / 编辑 / 上传容器内文件
- 🖥️ Web 终端 — 浏览器内直接连接容器终端
- 🚦 Traefik HTTPS — 内置 Traefik 反向代理，支持自有 SSL 证书
- 🔄 镜像多源拉取 — 自动尝试多个 Docker 镜像加速源，确保拉取成功率
┌─────────────┐
│ Traefik │ ← 反向代理 (80/443)
└──────┬──────┘
│
┌──────▼──────┐
│ Panel │ ← FastAPI 后端 + Jinja2 模板
│ (端口 3000) │
└──────┬──────┘
│ Docker API
┌──────▼──────────────────────────┐
│ 用户实例容器 │
│ ┌─────────┐ ┌───────────────┐ │
│ │ AstrBot │ │ NapCat/LLOneBot│ │
│ │ :6185 │◄─┤ :6099/:3080 │ │
│ └─────────┘ └───────────────┘ │
│ 端口范围: 20000 ~ 29999 │
└─────────────────────────────────┘
- Linux 服务器（推荐 Ubuntu 22.04+）
- Docker 24+（安装文档）
- Docker Compose v2
- 开放防火墙端口：
80、443、20000~29999
# 1. 进入项目目录
cd HiveDeploy
# 2. 配置环境变量
cp .env.example .env
nano .env # 修改 SECRET_KEY、管理员密码、域名等
# 3. 运行部署向导
bash scripts/setup.sh向导会引导你填入：
- 服务器公网 IP 或域名
- 管理员用户名和密码
完成后访问 http://你的IP/ 即可登录。
| 变量 | 默认值 | 说明 |
|---|---|---|
SECRET_KEY |
— | JWT 签名密钥，务必修改为随机长字符串 |
ADMIN_USERNAME |
admin |
管理员用户名（首次启动自动创建） |
ADMIN_PASSWORD |
admin123 |
管理员密码，务必修改 |
PLATFORM_HOST |
localhost |
服务器公网 IP 或域名（用于展示实例访问地址） |
INSTANCE_PORT_BASE |
20000 |
用户实例端口起始值 |
DATA_DIR |
/data/instances |
用户实例数据持久化目录 |
BOT_NETWORK |
bot_user_net |
用户容器所属 Docker 网络 |
SITE_NAME |
— | 节点名称（多节点 Hub 同步时标识当前节点） |
每用户分配 10 个端口（stride = 10）：
| 用户 ID | AstrBot WebUI (:6185) | Bot WebUI (:6099/3080) | AstrBot WS (:6199) | 弹性端口 (7 个) |
|---|---|---|---|---|
| 1 | 20000 | 20001 | 20002 | 20003 ~ 20009 |
| 2 | 20010 | 20011 | 20012 | 20013 ~ 20019 |
| N | 20000 + (N-1)×10 | +1 | +2 | +3 ~ +9 |
防火墙需开放
20000~29999端口段。
- 登录面板，进入 管理后台
- 配置 站点设置（注册开关、最大用户数、邮箱域名限制、邀请码策略等）
- 配置 SMTP（用于邮箱验证和到期提醒）
- 可选配置 支付信息（收款码、续期开关）
- 发布 公告（支持信息 / 价格 / 迁移 / 警告 / 封禁等类型）
- 管理用户（创建 / 封禁 / 删除 / 续期 / 重置密码）
- 查看续期记录和邀请码统计
- 注册账号（通过邮箱验证码 + 邀请码）或由管理员创建
- 登录后进入 仪表板
- 点击 「创建我的实例」，选择 NapCat 或 LLOneBot（首次需拉取镜像，约 1~3 分钟）
- 实例创建后可以：
- 打开 AstrBot WebUI 配置 AI 模型和插件
- 打开 NapCat / LLOneBot WebUI 扫码登录 QQ
- 使用 一键配置 自动完成 AstrBot 与 NapCat 的正向 WebSocket 连接
- 管理 弹性端口（额外映射 7 个自定义端口）
- 查看实时系统资源（CPU / 内存 / 磁盘）
- 管理容器文件（浏览 / 编辑 / 上传）
- 打开 Web 终端 直接操作容器
- 拉取最新镜像更新实例
- 自助续期（如管理员开启）
将证书文件复制到 traefik/certs/ 目录：
cp 你的证书.crt traefik/certs/cert.pem
cp 你的私钥.key traefik/certs/key.pem宝塔面板证书通常在
/www/server/panel/vhost/cert/你的域名/下，fullchain.pem为证书，privkey.pem为私钥。
编辑 docker-compose.yml，将 Traefik labels 中的 Host() 替换为你的域名。
编辑 traefik/tls.yml，取消注释 tls 配置块。
docker compose down && docker compose up -d
docker compose logs traefik --tail=15日志无 ERR 即成功，访问 https://你的域名.com。
# 查看面板日志
docker compose logs -f panel
# 重启面板
docker compose restart panel
# 重建并重启面板（代码更新后）
docker compose build --no-cache panel && docker compose up -d panel
# 重启 Traefik
docker compose restart traefik
# 停止所有服务
docker compose down
# 证书更新后重载 Traefik
docker compose restart traefik
# 备份所有实例数据
bash scripts/backup.sh
# 备份指定用户
bash scripts/backup.sh 用户名
# 重置管理员密码
bash scripts/reset_admin.shdocker cp bot_panel:/app/app/. panel/app/
docker cp bot_panel:/app/templates/. panel/templates/Q: 创建实例卡在「正在拉取镜像」很久？ A: 首次需下载 AstrBot 和 NapCat / LLOneBot 镜像，共约 500MB~1GB。面板会自动尝试多个镜像加速源，如遇超时请检查服务器网络。
Q: 忘记管理员密码？
A: 在服务器上执行 bash scripts/reset_admin.sh，选择管理员账号并输入新密码即可。
Q: 端口被占用？
A: 修改 .env 中的 INSTANCE_PORT_BASE，例如改为 30000，并确保防火墙对应开放。
Q: NapCat 扫码后连接不上 AstrBot？ A: 点击仪表板中的 「一键配置」，面板会自动配置 AstrBot 与 NapCat 的正向 WebSocket 连接。
Q: 如何彻底重置某用户实例？
A: 在管理后台删除用户后，数据目录保留在 /data/instances/用户名/，重新创建用户并创建实例即可复用数据（或手动删除该目录彻底清除）。
Q: 如何更换 QQ Bot 类型（NapCat ↔ LLOneBot）？ A: NapCat 和 LLOneBot 互斥部署，切换时旧容器会自动清除。在创建实例或管理实例时选择即可。
如果这个项目对你有帮助，欢迎请开发者喝杯咖啡 ☕
- Patreon — patreon.com/cw/YukiSoffd
- 爱发电 — ifdian.net/a/HiveDeploy
HiveDeploy/
├── .env.example # 环境变量模板
├── docker-compose.yml # Docker Compose 编排文件
├── panel/ # 面板后端
│ ├── Dockerfile
│ ├── requirements.txt
│ ├── app/ # FastAPI 应用
│ │ ├── main.py # 入口：挂载所有路由
│ │ ├── bootstrap.py # 应用初始化、DB 迁移、模板配置
│ │ ├── auth.py # 认证工具（JWT、密码哈希）
│ │ ├── database.py # SQLAlchemy 数据库连接
│ │ ├── models.py # 数据模型（用户、实例、配置等）
│ │ ├── docker_manager.py # Docker 容器编排（创建/启停/端口管理）
│ │ ├── email_service.py # 邮件发送与到期提醒
│ │ ├── hub_sync.py # 多节点 Hub 同步
│ │ ├── filemanager.py # 容器文件管理
│ │ ├── routes_auth.py # 认证路由（登录/注册/密码重置）
│ │ ├── routes_user.py # 用户路由（仪表板/续期/统计）
│ │ ├── routes_instances.py # 实例管理路由
│ │ ├── routes_files.py # 文件管理路由
│ │ ├── routes_admin.py # 管理后台路由
│ │ ├── routes_invites.py # 邀请码路由
│ │ ├── routes_nodes.py # 服务器节点路由
│ │ └── routes_terminal.py# Web 终端路由
│ ├── templates/ # Jinja2 前端模板
│ └── static/ # 静态资源
├── traefik/ # Traefik 配置
│ ├── tls.yml # TLS 证书配置
│ └── certs/ # 证书文件目录
├── scripts/ # 运维脚本
│ ├── setup.sh # 部署向导
│ ├── backup.sh # 数据备份
│ └── reset_admin.sh # 管理员密码重置
└── docs/ # 前端文档页面