65 lines
2.7 KiB
Markdown
65 lines
2.7 KiB
Markdown
# 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 来源。
|