私有化
私有化 · Docker 部署
单机 Docker Compose 部署 · 配置 · 健康检查
适合中小规模(< 200 用户)或非关键场景。生产推荐 Kubernetes + HA。
拓扑
步骤
1 · 准备
2 · 解压部署包
目录:
3 · 配置 .env
关键变量:
4 · 启动
5 · 反向代理 + HTTPS
部署 Nginx + Let's Encrypt(或公司证书):
强制 HTTPS:
常见运维操作
备份
恢复
逆向上面 dump。建议每天自动备份并存到独立机器/对象存储。
升级
→ 升级流程
扩容
Docker Compose 单机版扩容受限。如需:
- 加业务实例 → 给 Web/API service 加
replicas(同机内) - 跨机扩展 → 切到 Kubernetes
健康检查
| 端点 | 用途 |
|---|---|
GET /health | 应用层健康(返回 200 / 数据库连通) |
GET /readiness | 就绪检查(适合 K8s readiness probe) |
故障排查
| 现象 | 检查 |
|---|---|
| Web 502 | 看 evose-api 日志,数据库是否连通 |
| 模型 401 / 超时 | 在 模型平台 测连接;凭据是否正确 |
| 知识库写入慢 | PostgreSQL 内存配置(shared_buffers 至少机器内存 25%) |
| 启动报 secret 错 | 检查 SECRET_KEY 是否正确生成 64 字符 hex |
接下来
- 上规模 → Kubernetes
- 上 HA → HA
- 升级 → 升级