Files

2.7 KiB
Raw Permalink Blame History

本地部署目标架构

第一阶段:中心适配服务器

浏览器 / 管理员
       |
     HTTPS 443
       |
统一网关(Nginx 或客户现有网关)
       |--------------------|
平台前端          AI SoulMate 管理端
       |--------------------|
             平台后端
       |----------|----------|
   PostgreSQL   Redis    本地 S3 兼容对象存储

平台后端 ---- HTTPS 出站 ---- Tripo API

除 Tripo 调用外,数据库、缓存、对象文件、平台服务和管理端均位于客户局域网。默认只对业务网开放网关的 443;PostgreSQL、Redis 和对象存储管理端口不直接暴露。

第二阶段:农场工作站

中心平台后端 -- 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。