chore: initialize local deployment baseline
This commit is contained in:
commit
9e2196d69f
30 files changed
+1436
No files matched your search
@@ -0,0 +1,58 @@
|
||||
# 本地部署目标架构
|
||||
|
||||
## 第一阶段:中心适配服务器
|
||||
|
||||
```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。
|
||||
Reference in new issue
Block a user