Files
ai-soulmate-local-deployment/docs/ARCHITECTURE.md
T

59 lines
2.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 本地部署目标架构
## 第一阶段:中心适配服务器
```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。