# 北京测试环境清单 本文用于第一轮真实模型联调,不代表最终生产架构。当前约定为:应用服务器放在阿里云北京地域,RDS、Tair 和 OSS 优先复用北京资源。 已确认:Ubuntu 24.04 / 4C8G,RDS PostgreSQL 15,Tair 标准架构,域名 `moyi.soulofmodel.com`。当前执行手册以 [服务器测试部署手册](11-server-test-deployment.md) 为准。 ## 推荐规格 本次测试环境采用 **4 核 8 GiB 轻量应用服务器**,运行 Java Control Plane、Vue/Nginx、Docker Compose、日志和基础监控。RDS、Tair、OSS 在云上托管后,应用服务器不承担数据库和缓存的内存压力;这个规格可以为公开测试、构建镜像和异步任务突发保留更充足的余量。 2 核 4 GiB 也可以支撑低频内部联调,但当前已经选择 4 核 8 GiB,不需要再调整。模型推理和 3D 生成仍由上游供应商承担;后续是否扩容应根据 CPU、内存、队列长度和接口延迟监控决定。 ## 云资源拓扑 ```text 北京轻量应用服务器 ├─ frontend (Nginx,公网 80/443) └─ moyi-api (Java,仅内网 8787) ├─ 北京 RDS PostgreSQL:业务、Key、模型目录、用量审计 ├─ 北京 Tair/Redis:按 Key 限流、按模型并发租约 └─ 北京 OSS:预留,Java 结果文件落盘尚未接入 ``` 轻量服务器需要配置到 RDS/Tair 所属 VPC 的内网互通,并添加私网 IP 白名单。SSH 隧道测试仅需受限 22 端口;域名测试先配置 HTTPS 和受限 80/443。8787 不对公网开放。迁移前先备份,高可用留待生产设计。 ## 现在必须确认 - 轻量应用服务器的操作系统、CPU 架构、磁盘容量、Docker/Compose 版本和私网 IP。 - RDS **数据库引擎和版本**、北京地域/可用区、内网地址和端口、数据库名、应用账号,以及白名单配置。当前 Java 工程使用 PostgreSQL 驱动和 PostgreSQL Flyway 迁移;如果现有 RDS 是 MySQL,需要先做数据库适配,不能直接填连接串。 - Tair 实例的内网地址和端口、Redis 兼容模式、是否启用 TLS、账号/密码或 ACL、白名单。Tair 不需要创建“库表”;Redis 的逻辑 DB/Key 空间由应用使用,当前连接默认使用 DB 0。 - OSS 当前可后置;后续接入时再提供北京 Region、Bucket、内网 Endpoint、读写权限和生命周期,不要提前交付 AccessKey。 ## 真实联调前再提供 - 测试域名或临时访问地址,以及 HTTPS 证书方式。 - DeepSeek、Kimi、GLM、Seedance、Tripo/VAST 的测试 Key、Base URL、模型 ID、限额和回调/文件下载要求。密钥在服务器的 `.env.cloud` 或 Secrets Manager 中填写,不要发到聊天或 Git。 - 4--5 位验收账号、3--4 个项目的场景、额度和价格规则、失败扣费/退款规则、任务文件保留时间。 ## 关于境外模型 北京服务器可以先作为测试环境。是否需要香港中转,不由地域名称决定,而由每家供应商 API 的实际连通性、延迟、限流和文件回源结果决定;先从北京测试直连并记录指标,只有某个供应商持续不稳定时,再为该供应商增加独立中转/适配层。应用、RDS、Tair、OSS 不需要为了少数境外模型整体迁移到香港。 ## 验收顺序 1. 配置 RDS/Tair/OSS 白名单并从服务器验证内网连通。 2. 在 `infra/moyi` 执行 `python3 deploy.py init`,填写连接配置;脚本生成随机安全密钥。 3. 使用 `deploy.py check/up/smoke` 完成配置检查、启动与验收,参见最新手册。 4. 本次先验收同步调用、Key 和审计;真实异步任务、OSS、可靠重试及完整计费是后续节点。