MBE 云部署指南

概述

将 MBE 从本地 64GB 精简到云端 2-3GB 部署方案。

存储优化对比

部署步骤

方式一：导出镜像文件上传

# 1. 在本地构建并导出
.\scripts\deploy_to_cloud.ps1 -Action export

# 2. 上传到服务器 (使用 scp 或其他工具)
scp mbe-docker-image.tar user@server:/home/user/

# 3. 在服务器上加载
ssh user@server
docker load -i mbe-docker-image.tar

方式二：推送到镜像仓库

# 1. 登录阿里云镜像仓库
docker login registry.cn-hangzhou.aliyuncs.com

# 2. 构建并推送
.\scripts\deploy_to_cloud.ps1 -Action push -Registry registry.cn-hangzhou.aliyuncs.com/your-namespace

# 3. 在服务器上拉取
docker pull registry.cn-hangzhou.aliyuncs.com/your-namespace/mbe:latest

服务器端配置

# 1. 创建工作目录
mkdir -p /opt/mbe && cd /opt/mbe

# 2. 复制配置文件
# docker-compose.cloud.yml
# .env (从 env.example.txt 复制并修改)

# 3. 创建 .env 文件
cat > .env << 'EOF'
OPENAI_API_KEY=your-api-key
OPENAI_API_BASE=https://api.deepseek.com/v1
OPENAI_MODEL=deepseek-chat
LOG_LEVEL=INFO
EOF

# 4. 启动服务
docker-compose -f docker-compose.cloud.yml up -d

# 5. 查看日志
docker logs -f mbe-cloud

Cloudflare 配置

DNS 设置

类型: A
名称: mbe-cloud (或 mbe)
内容: 服务器公网IP
代理状态: 已代理 (橙色云朵)
TTL: 自动

SSL/TLS 设置

• 模式: Full (严格)
• 始终使用 HTTPS: 开启
• 自动 HTTPS 重写: 开启

防火墙规则 (可选)

# 只允许 Cloudflare IP 访问 443 端口
# 服务器防火墙配置

与本地服务并存

本地: mbe.hi-maker.com     → 本地服务器 (开发/备份)
云端: mbe-cloud.hi-maker.com → 云服务器 (生产)

数据同步

向量数据库同步

# 导出本地数据
docker cp mbe-local:/app/knowledge_bases ./backup_kb/

# 上传到云服务器
scp -r backup_kb/ user@cloud-server:/opt/mbe/

# 导入到云容器
docker cp backup_kb/ mbe-cloud:/app/knowledge_bases/

模型文件同步

# 只同步最终模型
rsync -avz --include='*_best.pt' --include='*_final.pt' \
    --include='*_inference.pt' --include='expert_*.pt' \
    --exclude='*' \
    ./training/checkpoints/ user@server:/opt/mbe/models/

健康检查

# 检查服务状态
curl http://localhost:8000/health

# 测试 API
curl -X POST http://localhost:8000/api/chat \
    -H "Content-Type: application/json" \
    -d '{"message": "你好"}'

监控和日志

# 查看实时日志
docker logs -f mbe-cloud

# 查看资源使用
docker stats mbe-cloud

# 进入容器调试
docker exec -it mbe-cloud /bin/bash

常见问题

Q: 镜像构建失败

# 清理 Docker 缓存
docker builder prune -f
docker system prune -a

Q: 服务启动失败

# 检查日志
docker logs mbe-cloud

# 检查环境变量
docker exec mbe-cloud env | grep -E 'OPENAI|MBE'

Q: 知识库数据丢失

# 检查数据卷
docker volume ls | grep mbe

# 备份数据卷
docker run --rm -v mbe-knowledge:/data -v $(pwd):/backup \
    alpine tar czf /backup/knowledge_backup.tar.gz /data

推荐云服务器配置

国内云服务商推荐

1. 阿里云 ECS - 镜像仓库完善
2. 腾讯云 CVM - 价格实惠
3. 华为云 ECS - 企业级稳定