192 lines
15 KiB
Markdown
192 lines
15 KiB
Markdown
# Tripo 零积分软硬件适配压测方案
|
||
|
||
## 1. 目的
|
||
|
||
本方案用于在不调用 Tripo 真实生成接口、不消耗 Tripo 生成积分的前提下,验证 AI SoulMate 用户端、管理端、中心服务器和 Client 农场端在当前软硬件环境中的性能、稳定性与任务排队行为。
|
||
|
||
本阶段使用后端内置的 `mock` 模式模拟 Tripo 任务生命周期。该模式不会向 Tripo 或其他 Tripo 地址发送网络请求,模拟任务的本地平台计费为 0,因此暂时不需要配置或更换 Tripo API key。只有进入真实 Tripo 联调阶段时才需要 API key,并应先用少量请求验证账户额度与实际限制。
|
||
|
||
部署时必须显式选择 `rate-limits-page` 或 `model-pages-conservative` profile,选择值和六类并发配置要随每次测试结果一起留档。当前实现只承诺生成提交与任务查询不会调用 Tripo;历史任务中的 Tripo 外链代理属于另一条读取链路,不能把“零生成计费调用”扩大解释成“容器绝无任何公网数据包”。正式压测会避开历史外链代理,并单独记录网络边界。
|
||
|
||
## 2. 测试边界
|
||
|
||
本轮包括:
|
||
|
||
- AI SoulMate 用户端、管理端及其后端接口。
|
||
- 中心服务器上的 PostgreSQL、Redis、MinIO 和 Docker 容器。
|
||
- Client 工作站上的前端、后端、独立 PostgreSQL,以及与中心服务器之间的心跳和任务同步链路。
|
||
- Tripo `mock` 模式下的任务提交、状态流转、结果落入 MinIO、并发拒绝及本地队列行为。
|
||
|
||
本轮不包括:
|
||
|
||
- Tripo 真实模型生成、真实计费、真实公网延迟和真实上游模型耗时。
|
||
- 阿里云提示词翻译、提示词优化等其他云服务。压测请求必须绕过或关闭这些外部调用,避免产生费用,也避免其网络波动污染本地基线。
|
||
- 快造 U1 的 PIN 配对、动态 IP 发现和真实打印。打印机接入在平台基线稳定后单独测试。
|
||
|
||
因此,本轮结果只能说明本地平台与当前硬件的承载能力,不能直接等同于 Tripo 的真实生成吞吐量。
|
||
|
||
## 3. Tripo 官方限制与本地配置
|
||
|
||
Tripo 的请求速率限制按 API key 计算;任务并发限制按账户及任务类别计算,不是整个系统共用一个固定并发数。根据 [Tripo 官方速率限制与并发控制文档](https://developers.tripo3d.com/zh/docs/rate-limits),专门限流页在 2026-08-12 显示的默认基线如下:
|
||
|
||
| 任务类别 | 官方页面当前公开并发数 | 本地 mock 配置项 |
|
||
| --- | ---: | --- |
|
||
| H 系列 3D 生成 | 10 | `TRIPO3D_MOCK_H_CONCURRENCY` |
|
||
| P 系列 3D 生成 | 5 | `TRIPO3D_MOCK_P_CONCURRENCY` |
|
||
| 图像生成 | 1 | `TRIPO3D_MOCK_IMAGE_CONCURRENCY` |
|
||
| 动画 | 10 | `TRIPO3D_MOCK_ANIMATION_CONCURRENCY` |
|
||
| 模型后处理 | 5 | `TRIPO3D_MOCK_POSTPROCESS_CONCURRENCY` |
|
||
| 网格操作 | 10 | `TRIPO3D_MOCK_MESH_CONCURRENCY` |
|
||
|
||
这些值只是本次 v2 POC 测试 profile 的默认基线,不是当前账户合同额度。官方 H3.1、P1 和 Animation 模型详情页又分别显示 `3` 个并行任务,并说明额度取决于用量层级;这可能涉及 API 版本、模型或套餐口径差异。正式联调时必须以当前官方文档、账户实际配额以及接口真实返回为准。本地 mock 的各类别并发配置均可调整,用于复现不同客户方案或账户等级,不能把某次配置值写成产品的永久上限;迁移到 v3 API 时应另建 profile,并优先用保守的 `3` 并发做首次验证。
|
||
|
||
Tripo 的“请求速率限制”和“运行任务并发限制”也不是同一概念。上游任务并发达到限制时,官方接口可能返回 HTTP `429`、业务码 `2000`,并可能携带 `Retry-After`。调用方应记录并遵循 `Retry-After`,采用有限次数、带抖动的退避重试,不能无间隔循环请求。
|
||
|
||
官方页面没有声明一个适用于所有账户的固定最大排队长度。因此,本方案不假设、不报告“Tripo 最多可排队 N 个任务”。如需得出真实账户的上游并发或排队结论,应在获准使用积分后做小规模实测,并保留响应码、响应头、任务状态和时间戳作为依据。
|
||
|
||
## 4. 两层并发与队列必须分开
|
||
|
||
系统中至少存在两层不同的容量控制:
|
||
|
||
1. **AI SoulMate 本地任务队列**:由本地应用、数据库和 Redis 管理。它决定平台能接收多少用户请求、任务等待多久、是否丢失或重复,以及 Client 农场端的同步速度。
|
||
2. **Tripo 上游运行并发**:由 Tripo 按账户和任务类别控制。它决定同一类别能够同时在 Tripo 侧运行多少任务,超过限制可能直接得到 HTTP `429`、业务码 `2000`。
|
||
|
||
本地队列可以容纳的任务数不等于 Tripo 并发数;Tripo 某类别仍有空闲槽位也不代表本地服务器没有瓶颈。报告必须分别给出:
|
||
|
||
- 本地接收量、队列深度、等待时间、出队速率和失败量。
|
||
- 模拟的各类别上游活动任务数、被拒绝量、`429/2000` 数量和 `Retry-After`。
|
||
- 两层之间的调度效率,例如上游有空位但本地任务未及时提交的时间占比。
|
||
|
||
## 5. Mock 模式的 POC 限制
|
||
|
||
当前 mock 任务状态保存在后端进程内存中,适合单进程 POC 和压测链路验证,但有以下限制:
|
||
|
||
- 后端容器或进程重启后,未完成的 mock 任务状态会丢失。
|
||
- 多后端副本之间不共享 mock 状态,不能据此验证正式集群的一致性。
|
||
- mock 的等待时间和运行时间是配置值,不代表 Tripo 真实模型耗时。
|
||
- mock 可以验证调度、结果上传和错误处理,但不能验证 Tripo 生成质量或公网服务稳定性。
|
||
|
||
正式多实例压测前,应把任务状态和并发租约迁移到 PostgreSQL 或 Redis,并增加幂等键、租约超时和崩溃恢复机制。在此之前,测试记录必须标记为“单后端进程 POC”。
|
||
|
||
## 6. 测试阶段
|
||
|
||
### 阶段 0:冻结环境与确认安全开关
|
||
|
||
- 记录三台设备的名称、IP、CPU、内存、磁盘、网络、操作系统、Docker/WSL 版本和源代码提交号。
|
||
- 确认后端为 `TRIPO3D_MODE=mock`,健康接口返回的模式也是 `mock`。
|
||
- 确认压测环境未配置可被当前流程使用的 Tripo API key,或通过网络日志确认没有 Tripo 外连。
|
||
- 确认阿里云提示词翻译/优化不在测试请求路径中。
|
||
- 保存数据库、Redis 和 MinIO 的可恢复备份。
|
||
|
||
在中心服务器部署新镜像后,必须按以下顺序启用并验证。`configure-backend-env.sh` 在 mode 已是 `mock` 时也会再次清空 API key 并恢复 loopback 阻断地址,避免重复配置误切回真实上游:
|
||
|
||
```bash
|
||
./scripts/enable-tripo-mock.sh compose/.env rate-limits-page
|
||
./scripts/configure-backend-env.sh compose/.env /srv/ai-soulmate/sources/ai-soulmate-server 192.168.3.102 farm-workstation-001
|
||
./scripts/enable-tripo-mock.sh compose/.env rate-limits-page
|
||
./scripts/build-backend-image.sh compose/.env /srv/ai-soulmate/sources/ai-soulmate-server
|
||
./scripts/build-frontend-image.sh compose/.env /srv/ai-soulmate/sources/ai-soulmate-server
|
||
./scripts/start-backend.sh compose/.env
|
||
./scripts/start-frontend.sh compose/.env
|
||
./scripts/verify-backend.sh compose/.env
|
||
./scripts/verify-frontend.sh compose/.env
|
||
./scripts/verify-tripo-mock.sh compose/.env
|
||
```
|
||
|
||
首次基线同时用 `model-pages-conservative` 再跑一次敏感性测试。切换 profile 只会修改 `.env`,不会自动改变已运行容器;切换后必须执行 `docker compose --project-name "$(sed -n 's/^BACKEND_COMPOSE_PROJECT_NAME=//p' compose/.env | head -n 1)" --env-file compose/.env -f compose/docker-compose.backend.yml up -d --force-recreate backend`,再运行 `verify-tripo-mock.sh`。每次执行都必须把实际 profile、六类并发、queue/run delay、源代码提交和镜像摘要写入运行元数据,不能直接沿用模板默认值。
|
||
|
||
### 阶段 1:空闲基线
|
||
|
||
- 在无业务流量状态连续采集至少 15 分钟。
|
||
- 记录各设备和容器的 CPU、内存、磁盘、网络、进程数、连接数、重启次数和健康状态。
|
||
- 得到后续负载测试的资源增量参照值。
|
||
|
||
### 阶段 2:基础接口与存储基线
|
||
|
||
- 分别测试用户端、管理端的健康检查、登录、列表查询、详情查询和静态资源。
|
||
- 单独测试 PostgreSQL 查询、Redis 读写及 MinIO 小文件和模型文件上传/下载。
|
||
- 先做单请求正确性检查,再逐级提升并发,避免错误请求形成无效高负载。
|
||
|
||
### 阶段 3:Tripo mock 单任务闭环
|
||
|
||
先运行公开用户端的零积分端到端冒烟测试。脚本只接受本机、私网或链路本地地址,禁用系统代理与 HTTP 重定向;它在内存中创建随机账号和密码,输出中不会写入密码或 Bearer token。测试会比较生成前后的用户积分、检查提交和完成结果的 `credits_used=0`,并确认模型和预览均指向本地对象存储:
|
||
|
||
```bash
|
||
./scripts/run-user-e2e-smoke.sh compose/.env
|
||
```
|
||
|
||
每次执行会保留一个带 `bench_` 前缀的隔离测试用户、一个本地 mock 资产和对应任务记录,以便管理端核对。原始 JSON 只记录随机用户 ID、任务 ID、状态转换、耗时、积分数值和脱敏后的存储位置摘要,不记录账号密码、访问 token 或带签名参数的完整 MinIO URL。
|
||
|
||
- 每个任务类别至少完成一次提交、排队、运行、完成和结果读取。
|
||
- 验证模拟模型/图片能够写入本地 MinIO,数据库任务状态、结果地址和本地积分均正确。
|
||
- 验证失败任务、超时任务、重复请求和容器重启后的 POC 限制表现。
|
||
|
||
### 阶段 4:分类并发和拒绝行为
|
||
|
||
- 逐项验证 H、P、图像、动画、后处理和网格操作的独立并发池。
|
||
- 在单类别内从 1 并发逐级增加到该类别配置上限,再增加 1 至 2 个请求验证 HTTP `429`、业务码 `2000` 和 `Retry-After`。
|
||
- 同时运行两个不同类别,验证它们不会错误地占用同一个全局并发池。
|
||
- 调整本地 mock 并发配置,复测不同客户配额场景并记录配置快照。
|
||
|
||
当前公开用户端可完整走通 H/P 3D 与图像生成路径;动画、后处理和网格操作尚无对应的公开业务提交接口。后 3 类只使用容器内 `tools/tripo_mock_benchmark.py` 验证分类池、状态时间、`429/2000` 和本地 MinIO 结果,不能表述为前端端到端能力。公开业务端到端报告应只统计实际可达的 H/P 3D 与图像链路。
|
||
|
||
### 阶段 5:本地排队与端到端链路
|
||
|
||
- 让进入平台的任务量高于模拟上游可运行量,观察本地队列深度、等待时间和退避重试。
|
||
- 验证中心服务器到 Client 工作站的心跳、任务同步、领取、状态回传和断线恢复。
|
||
- 检查任务是否出现丢失、重复领取、乱序完成或状态永久卡住。
|
||
- 此阶段仅模拟“任务到达农场端”,不向快造 U1 发起真实打印。
|
||
|
||
### 阶段 6:阶梯负载与稳定性
|
||
|
||
- 使用固定测试数据,按低、中、高和饱和负载逐级增加并发,每级保持足够时间达到稳定状态。
|
||
- 找出首次出现明显延迟陡升、错误率增长、队列持续积压或资源耗尽的负载点。
|
||
- 在安全负载下做长时间稳定性测试,并验证服务重启、网络短时中断和恢复后的数据一致性。
|
||
- 达到任一停止条件时立即停止增压,不以设备失去响应作为“极限值”。
|
||
|
||
当前自动 HTTP 套件只对用户后端与管理后端健康接口执行 `1/5/10/20/40` 阶梯并发,它用于测量框架、代理和基础数据库连通性开销,不代表登录、列表、生成或订单接口的业务容量。套件会把负载期间逐秒容器 CPU、内存、网络、磁盘 I/O、PID、主机 1 分钟负载和可用内存写入 `resources-during-load.csv`;最终客户容量结论仍必须补充带认证的业务接口和长时间稳定性测试。
|
||
|
||
### 阶段 7:打印机专项测试
|
||
|
||
平台基线和 mock 任务闭环稳定后,再接入快造 U1。打印机阶段单独记录 PIN 配对、IP 变化、发现机制、连接恢复、单机/多机并行打印和打印队列,不与本轮 Tripo mock 容量结论混合。
|
||
|
||
## 7. 必须采集的指标
|
||
|
||
| 层级 | 指标 |
|
||
| --- | --- |
|
||
| 请求 | 请求总数、成功数、吞吐量、错误率、超时率、HTTP 状态码分布、P50/P90/P95/P99/最大延迟 |
|
||
| 本地队列 | 入队速率、出队速率、当前/最大队列深度、平均/P95/最大等待时间、积压持续时间、丢失/重复任务数 |
|
||
| Tripo mock | 各类别活动任务数、配置上限、接受数、`429/2000` 数、`Retry-After` 值、重试次数、模拟运行时间 |
|
||
| 业务闭环 | 提交到完成总耗时、结果写入耗时、状态一致性、幂等命中、失败恢复、用户/管理端可见时间 |
|
||
| Client 链路 | 心跳成功率和延迟、任务同步延迟、领取/回传耗时、断线时长、恢复耗时、待处理任务数 |
|
||
| PostgreSQL | 活跃/等待连接、事务吞吐、查询延迟、慢查询、锁等待、死锁、缓存命中、数据库增长量 |
|
||
| Redis | 操作速率、连接数、内存、命中率、过期/淘汰键、阻塞客户端、队列相关键数量 |
|
||
| MinIO | 上传/下载吞吐、首字节和完成延迟、失败率、对象数、存储增长量、磁盘使用率 |
|
||
| 设备/容器 | CPU、内存、交换区、磁盘吞吐/延迟/空间、网络吞吐/丢包、容器重启、OOM、温度与降频(可获取时) |
|
||
|
||
所有指标必须带统一时区的时间戳,并关联测试批次、代码提交、镜像摘要、环境配置、并发模型、请求数据集和测试持续时间。平均值不能代替尾延迟,报告至少保留 P95 和 P99。
|
||
|
||
## 8. 停止条件与结论口径
|
||
|
||
建议在出现以下任一情况时停止继续增压:
|
||
|
||
- 持续错误率或超时率超过测试预先设定的阈值。
|
||
- P95/P99 延迟连续多个采样窗口恶化且不能恢复。
|
||
- 本地队列只增不减,已无法在合理时间内清空。
|
||
- CPU 长时间饱和、内存接近耗尽、发生 OOM、磁盘空间不足或磁盘延迟异常。
|
||
- 数据丢失、重复执行、状态不一致或关键服务反复重启。
|
||
|
||
最终报告应给出“稳定运行区间”“出现退化的起点”和“明确不可接受区间”,不要只给一个没有持续时间和错误率背景的最高并发数字。对外提供客户配置建议时,还应保留安全余量,并明确 Tripo 上游配额、真实生成耗时和打印机数量需要另行校准。
|
||
|
||
## 9. 进入真实 Tripo 联调的前置条件
|
||
|
||
只有在以下条件全部满足后才进入真实联调:
|
||
|
||
- 本地用户端、管理端、中心基础设施和 Client 链路的基线测试通过。
|
||
- mock 模式下的分类并发、拒绝、退避、本地排队和恢复行为符合预期。
|
||
- 已确认实际 Tripo 账户的模型权限、套餐、余额和各类别并发配额。
|
||
- 已设置严格的请求数量上限、预算上限和人工停止开关。
|
||
- 已准备专用 API key,并保证它不会写入 Git、日志或测试报告。
|
||
|
||
届时先做最小数量的冒烟请求,再逐步扩大;不能直接用真实 API 执行本方案中的饱和压测。
|