部署

部署前准备

生产环境还应准备固定域名或 IP、时间同步、HTTPS 证书、备份位置和访问控制策略。

下载安装

git clone https://github.com/beizhu-1209/AIHelms.git
cd AIHelms
cp .env.example .env

先编辑 .env，再启动：

docker compose pull
docker compose up -d
docker compose ps

首次启动需要拉取镜像并初始化数据，请等待服务进入 running 或 healthy 状态。

必须确认的配置

完整字段和示例值以当前版本随附的 .env.example 为准。环境密钥不要提交到代码仓库。

访问地址

默认部署通常提供：

如果服务器位于公网，建议只允许公司出口、VPN 或受控反向代理访问。启用 HTTPS 后，确认模型广场显示的 Endpoint 与客户端实际使用的地址一致。

首次登录

1. 打开 http://<host>/admin。
2. 用户名填写 admin。
3. 使用部署配置中的超级管理员初始密码。
4. 登录后立即修改密码。
5. 打开 Dashboard，确认页面可以正常加载。

初始密码只用于第一次创建管理员。平台已有 admin 后，修改部署文件不会自动重置现有密码。

部署验证

先检查服务：

docker compose ps
docker compose logs --tail=100 aihelms
docker compose logs --tail=100 nginx

再完成页面检查：

1. 管理后台可以登录。
2. 用户端可以登录并显示“我的 AI 身份”。
3. 管理 API 健康检查正常。
4. 管理员可以创建一个测试用户。
5. 完成供应商、凭证、模型和部署配置后，测试用户可以调用模型。

网页能打开不代表模型已经接入成功。模型必须在管理后台完成凭证测试和模型连通性测试。

备份

备份至少要包含：

• 业务数据库。
• 上传的 Skill、图片和导出文件。
• .env 及其中的加密密钥。
• 当前平台版本和部署文件。

备份文件应加密保存，并定期在独立环境验证能否恢复。不要等升级失败后才第一次检查备份。

升级

1. 记录当前平台版本。
2. 完成数据库、文件和环境配置备份。
3. 阅读目标版本的更新说明。
4. 修改版本并拉取新镜像。
5. 重新启动服务。

docker compose pull
docker compose up -d
docker compose ps

升级后检查：

• 管理员和普通用户登录。
• 供应商、凭证、模型和部署。
• AI 身份和资源授权。
• 模型真实调用。
• 调用记录、成本和审批。

不要在没有备份和回退方案的情况下跨多个版本升级。

常见问题