# 本地部署目标架构 ## 第一阶段:中心适配服务器 ```text 浏览器 / 管理员 | HTTPS 443 | 统一网关(Nginx 或客户现有网关) |--------------------| 平台前端 AI SoulMate 管理端 |--------------------| 平台后端 |----------|----------| PostgreSQL Redis 本地 S3 兼容对象存储 平台后端 ---- HTTPS 出站 ---- Tripo API ``` 除 Tripo 调用外,数据库、缓存、对象文件、平台服务和管理端均位于客户局域网。默认只对业务网开放网关的 `443`;PostgreSQL、Redis 和对象存储管理端口不直接暴露。 ## 第二阶段:农场工作站 ```text 中心平台后端 -- HTTPS / 设备身份认证 --> 农场端工作站 | 本地任务缓存 / 客户端数据库 | 打印机 / Moonraker ``` 农场端主动发起心跳、拉取任务和上报状态,中心端不直接访问打印机网络。后续需要补齐设备级凭证、幂等任务、断网重试、升级和审计能力。 ## 服务职责 | 服务 | 第一阶段位置 | 说明 | | --- | --- | --- | | `ai-soulmate-server` | 中心服务器 | 前端与 FastAPI 后端 | | `mlkj-admin` AI SoulMate 部分 | 中心服务器 | 必须支持 AI-only 模式,不能强依赖其他业务库 | | PostgreSQL | 中心服务器 | 使用独立数据库/角色,定期备份 | | Redis | 中心服务器 | 只在容器网络开放,启用持久化与认证 | | 本地对象存储 | 中心服务器 | 通过统一存储接口接入,不继续绑定阿里 `oss2` | | 统一网关 | 中心服务器 | TLS、路由、上传限制、访问日志和基础限流 | | Tripo | 外部服务 | 当前为必要出站依赖,指标必须与本地容量分开 | | `ai-soulmate-client` | 后续农场工作站 | 靠近打印机,暂不纳入中心服务器 POC | ## 网关判断 网关能力需要保留,但不建议直接部署现有 `nginx-server`:它面向现有公网域名和固定容器名,目前也没有完整覆盖管理端与农场端。私有版应在本仓库维护环境无关的路由模板;如果客户已有负载均衡或企业网关,则由其替代 Nginx。 ## 安全边界 - 禁止把数据库、Redis 和对象存储管理端口映射到公网。 - Tripo、短信、支付等外部能力按现场需求逐项启用,默认关闭非必要集成。 - 平台用户、管理员和农场设备使用不同身份体系与凭证。 - 所有密码和 API Key 在部署时注入,不构建进镜像、不写入 Git。 - 管理端、备份和监控访问应限制到管理网或 VPN。