Files
ai-soulmate-local-deployment/docs/BACKEND-DEPLOYMENT.md
T

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 来源。