容量规划、高可用与会话亲和

在采购硬件和规划生产集群前,按文档规模与并发估算 CPU、内存与 SSD 容量;在多副本部署中正确配置统一网关会话亲和与反向代理客户端 IP 信任。

1. Docker Compose 单机资源起点

以下规格为整机容量(含应用、本地数据组件、索引峰值与升级余量)。业务数据盘必须使用企业级 SSD/NVMe,切勿将数据库与向量/全文索引落在机械硬盘上:

部署档位 CPU 内存 系统盘 业务数据盘 独立备份空间 索引工作器
功能验证 16 vCPU 32 GiB 200 GiB SSD 500 GiB SSD 500 GiB 起 1 个
正式单机部署(推荐起点) 48 vCPU 96 GiB 200 GiB SSD 1 TiB 起(云对象);本机 RustFS/MinIO 共盘则 2 TiB 起 1 TiB 起 初始 2 个
单机高负载评估 64 vCPU 128 GiB 200 GiB SSD 2 TiB 企业级 NVMe 2 TiB 起 初始 4 个

正式单机 48 vCPU / 96 GiB 的典型主机内预算分配:API(2–4C / 4 GiB)、2 × 索引工作器(各 1–2C / 4–8 GiB)、前端(1–2C / 2 GiB)、Parser(2–4C / 4–8 GiB)、元数据与图谱 PostgreSQL(合计 4–8C / 8–12 GiB)、Elasticsearch(2–4C / 4–6 GiB)、Qdrant(2–4C / 8 GiB)、Redis(1–2C / 2 GiB)、RustFS(1–2C / 4 GiB),并保留至少 16–24 GiB 给操作系统页缓存、检索峰值与滚动升级余量。

2. Kubernetes + KubeBlocks Enterprise 生产规划

生产集群建议从 3 台跨故障域节点起步(每节点 16 vCPU / 32 GiB 内存 / 200 GiB SSD 系统盘),业务数据卷通过企业级 SSD/NVMe StorageClass 独立供给,不与系统盘混用。

应用层起始副本与单副本配额

组件 起始副本 单副本 CPU(Requests / Limits) 单副本内存(Requests / Limits)
ApeMind 前端 2 0.1 / 0.5 核 256 MiB / 512 MiB
ApeMind API 2 0.5 / 2 核 1 GiB / 4 GiB
索引工作器 2 2 / 4 核 4 GiB / 8 GiB
独立 Parser 服务 1–2 2 / 4 核(OCR 属 CPU 密集型,每解析槽位建议 ≥2 核) 4 GiB / 8 GiB

数据组件单成员采购起点

下表为单成员(单副本)长期运行起点,集群总磁盘 ≈ 单成员容量 × 成员数,并在此之上按首年文档增长预留 6–12 个月空间(磁盘水位达 60%–70% 即应启动扩容评审):

组件 推荐生产拓扑 单成员 CPU / 内存 单成员 PVC 关键说明
PostgreSQL 元数据 主从 2 副本 1 核 / 2 GiB 100 GiB 持续承载会话、任务、审计与账本
PostgreSQL 图存储 独立库主从 2 副本 1 核 / 4 GiB 100 GiB 随文档实体与关系密度增长
Redis 1 主 1 从 + 3 Sentinel 1 核 / 2 GiB 50 GiB 索引队列、限流、分布式锁与缓存
Elasticsearch 3 Master + 3 Data Master 0.5C/1G;Data 1C/2G Master 50 GiB;Data 100 GiB 开启安全认证时需授予 manage_index_templates
Qdrant 向量库 3 副本 2 核 / 4 GiB 200 GiB 高维向量与大量分块是主要磁盘消耗源
对象存储 云 S3,或自托管 RustFS 单副本 1 核 / 2 GiB 1 TiB 起 生产多副本 Worker 必须使用 OBJECT_STORE_TYPE=s3;备份应存往独立故障域

可选:MinerU 本地 PDF 解析节点(独立核算)

如果需要使用本地 MinerU 解析复杂版式 PDF,其资源须独立于核心平台核算:单副本建议 1 张 24 GB 显存 GPU(如 NVIDIA A10 同档)、2–6 vCPU、16–32 GiB 主机内存与独立镜像/模型缓存盘。

3. 统一入口网关与多副本会话亲和

在多副本部署中,ApeMind 通过前置 Nginx 统一网关分流请求,使同一对话(chat_id)的执行与代码模式工作区文件读写尽量落在同一个 API 实例上,同时避免流式响应被缓冲:

Kubernetes 与 Compose 网关要点

4. 反向代理与客户端 IP 信任(FORWARDED_ALLOW_IPS)

公开链接与网站嵌入的匿名访客限流(单 IP 每分钟 60 次)依赖 API 进程解析真实客户端 IP。配置不当会导致限流失效或所有用户误共用同一个 IP 额度:

5. 监控指标与扩容触发信号

信号 建议动作
数据盘 / PVC 使用率持续达到 60%–70% 立即扩容对应存储卷或调整日志/账本保留期,避免磁盘写满触发 ES 只读或 PG 不可写
索引队列持续积压、Parser 频繁返回 429 增加 parser.replicaCount 与 indexingWorker.replicaCount(K8s 用安全扩容脚本检查 PG 连接池)
API Pod CPU 持续高于 70% 或对话延迟抖动 开启 API HPA 或增加副本数,并同步校验 postgres.maxConnections 预算
PostgreSQL 连接数逼近上限 核对总连接预算公式并调整数据库 max_connections,或评估启用 PgBouncer(Tier 3)

下一步