2.7 KiB
2.7 KiB
AI SoulMate 后端本地部署
本阶段只启动平台后端。PostgreSQL 和 Redis 继续只监听服务器回环地址;后端也先监听 127.0.0.1:3001,等待统一网关接入。MinIO API 监听经批准的局域网地址,以便后续浏览器和农场工作站使用预签名 URL;MinIO 控制台继续只监听 127.0.0.1:9001。
前置条件
- 基础设施健康检查已通过。
- 应用数据库初始化和初始化后备份校验已通过。
- 源码位于
/srv/ai-soulmate/sources/ai-soulmate-server,分支为local-deployment,且没有未提交的受跟踪文件。 - 局域网地址已经固定或配置 DHCP reservation。地址变化后必须重新生成后端配置并重建相关容器。
生成配置
以下示例中的地址是当前 POC 样机地址:
cd /srv/ai-soulmate-local-deployment
./scripts/configure-backend-env.sh \
compose/.env \
/srv/ai-soulmate/sources/ai-soulmate-server \
192.168.3.102
脚本保留已有基础设施密码,补齐后端密钥,文件权限保持为 600,并且不会把密钥打印到终端。Tripo Key 默认留空;健康检查不依赖 Tripo,联调 Tripo 前再通过受控方式注入已轮换的新 Key。
重建 MinIO 配置
docker compose --env-file compose/.env \
-f compose/docker-compose.infra.yml \
up -d minio minio-init
./scripts/verify-infra.sh compose/.env
该操作不会删除 ai-soulmate-minio-data 数据卷。初始化任务会保留 Bucket,并创建无管理权限的应用账号;后端不使用 MinIO 管理员账号。
构建并启动后端
./scripts/build-backend-image.sh \
compose/.env \
/srv/ai-soulmate/sources/ai-soulmate-server
./scripts/start-backend.sh compose/.env
./scripts/verify-backend.sh compose/.env
构建脚本拒绝错误分支、受跟踪源码改动以及与源码提交不一致的镜像标签。启动和验证脚本显式使用独立的 Compose 项目名,防止基础设施被误判为后端的孤立容器。后端验证会检查 HTTP 健康状态,以及容器到 PostgreSQL、Redis 和 MinIO Bucket 的实际连接。
当前网络边界
| 服务 | 监听地址 | 当前用途 |
|---|---|---|
| PostgreSQL | 127.0.0.1:5432 |
宿主机维护和 Docker 内部访问 |
| Redis | 127.0.0.1:6379 |
宿主机维护和 Docker 内部访问 |
| 后端 | 127.0.0.1:3001 |
本机验收,后续由网关代理 |
| MinIO API | 192.168.3.102:9000 |
局域网预签名上传和下载 |
| MinIO 控制台 | 127.0.0.1:9001 |
仅 SSH 隧道管理 |
不要在路由器上为 3001、5432、6379、9000 或 9001 配置公网端口转发。正式交付应通过统一网关和 TLS 暴露业务入口,并按客户网络划分限制 MinIO API 来源。