# 北京测试环境清单 本文用于第一轮真实模型联调,不代表最终生产架构。当前约定为:应用服务器放在阿里云北京地域,RDS、Tair 和 OSS 优先复用北京资源。 ## 推荐规格 本次测试环境采用 **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:会话、限流、并发、队列状态、幂等 └─ 北京 OSS:图片、视频、3D 结果文件和上传文件 ``` 应用服务器、RDS、Tair 尽量放在同一地域和同一 VPC。RDS 和 Tair 的白名单只允许应用服务器的内网地址;安全组只开放 80/443,8787 不对公网开放。生产阶段再补域名、HTTPS、备案、备份和高可用。 ## 现在必须确认 - 轻量应用服务器的操作系统、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 建议使用 RAM 子账号或云凭据注入,不要提交到 Git。 ## 真实联调前再提供 - 测试域名或临时访问地址,以及 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/.env.cloud.example` 为服务器上的 `.env.cloud`,填写连接配置和随机密钥。 3. 启动 `docker compose -f docker-compose.cloud.yml up -d --build`,确认 `/health`、登录、Key 创建和模型目录。 4. 先用一个同步文本/多模态模型验收输入、输出、额度和调用记录,再验收 Tripo/VAST 异步任务、队列、OSS 文件和失败重试。