# 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 样机地址: ```bash 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 配置 ```bash 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 管理员账号。 ## 构建并启动后端 ```bash ./scripts/build-backend-image.sh \ compose/.env \ /srv/ai-soulmate/sources/ai-soulmate-server docker compose --env-file compose/.env \ -f compose/docker-compose.backend.yml \ up -d ./scripts/verify-backend.sh compose/.env ``` 构建脚本拒绝错误分支、受跟踪源码改动以及与源码提交不一致的镜像标签。后端验证会检查 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 来源。