部署服务器资源规格参考
部署 qOntology 时，可根据使用场景、数据规模和预算，选择单机合并部署或组件分离部署。以下列出测试环境的最低建议配置和常规生产环境的推荐资源清单，供服务器选型与容量规划参考。
最低配置要求
适用于功能测试、演示及少量数据试用。使用默认 Docker Compose 编排，将 Nginx、qOntology API、MySQL、Redis、Neo4j 和 kkFileView 六个服务合并部署在一台服务器上。
本节为测试环境的最低建议起点，不是经过压测认证的最低运行门槛。 此配置不包含本地大模型推理和独立向量服务；使用 AI 功能时，接入另行配置的外部模型接口。
| 序号 | 服务器名称 | 用途描述 | 操作系统 | CPU规格 | 内存规格 | 硬盘配置 | 数量 |
|---|---|---|---|---|---|---|---|
| 1 | qOntology 综合服务器 | 部署 Nginx、qOntology API、MySQL、Redis、Neo4j、kkFileView | Ubuntu | 4 vCPU | 16GB | 200GB SSD | 1 |
合并部署时，各服务共享主机资源。批量抽取、图谱查询和文件转换同时运行会增加资源需求，测试时应控制任务并发，并观察整机内存与磁盘使用情况。使用 Docker Desktop 时，还需确认分配给 Docker 的资源配额，而不只检查宿主机配置。
推荐配置要求
适用于团队日常建模、图谱查询及适量抽取任务的常规生产规划。以下按组件分离部署列出采购清单示例，AI 功能使用外部模型接口，不计入本地 GPU 或大模型推理服务器。
表中 CPU、内存和硬盘均为每台服务器的建议规格。 各服务器应选择与实际组件版本及镜像架构兼容的 Ubuntu 环境。
| 序号 | 服务器名称 | 用途描述 | 操作系统 | CPU规格 | 内存规格 | 硬盘配置 | 数量 |
|---|---|---|---|---|---|---|---|
| 1 | 应用服务器 | 部署 Nginx、前端资源和 qOntology API | Ubuntu | 8 vCPU | 16GB | 200GB SSD | 1 |
| 2 | 关系数据库服务器 | 部署 MySQL，存储业务数据 | Ubuntu | 4 vCPU | 16GB | 500GB SSD | 1 |
| 3 | 图数据库服务器 | 部署 Neo4j，存储和查询图数据 | Ubuntu | 8 vCPU | 32GB | 500GB SSD | 1 |
| 4 | 缓存服务器 | 部署 Redis，提供缓存服务 | Ubuntu | 2 vCPU | 4GB | 100GB SSD | 1 |
| 5 | 文件预览服务器 | 部署 kkFileView，提供文件转换与预览 | Ubuntu | 4 vCPU | 8GB | 200GB SSD | 1 |
| 6 | 向量服务器（可选） | 部署 Weaviate，提供向量存储与检索 | Ubuntu | 4 vCPU | 16GB | 300GB SSD | 按需增加1台 |
基础清单合计 5台服务器、26 vCPU、76GB 内存、1.5TB SSD（硬盘按 1000GB = 1TB 汇总）。可选向量服务器另计；已有可用的 Weaviate 服务时，可直接规划接入，无需重复采购。向量服务实际需求还应结合向量数量、维度和索引配置评估。
分离部署说明
默认 Compose 用于单机部署，不会自动将服务分配到多台主机。采用上述分离方案时，需要调整 API 的数据库、缓存和图数据库连接地址，以及 Nginx 的代理地址，并确认服务间网络、认证和文件访问路径可用。
上述各角色均为单节点，组件分离用于隔离资源，不代表已经具备高可用能力。需要高可用时，应另行规划冗余节点、故障切换及备份恢复，并重新核算资源。
建议说明
- 磁盘与备份：优先使用 SSD。表中容量包含系统、应用和本机数据，独立备份空间另行规划。除业务数据外，还需计入图数据及索引、上传文件、预览缓存和日志，并根据增长速度与保留周期预留容量。
- 内存分配：当前后端镜像中 API 的 JVM 最大堆为 2GB，Compose 中 kkFileView 的最大堆为 1GB；堆上限不等于进程总占用或整机内存需求。还需为数据库、图缓存、文件转换进程和操作系统保留空间，避免各服务配置之和耗尽主机内存。
- 计算与扩容：根据查询复杂度、抽取任务并发和文件转换量调整 CPU 与内存。上线前覆盖日常操作及批量任务场景，持续观察 CPU、内存、磁盘容量与 I/O，再确定是否扩容或拆分服务。
- AI 与向量服务：调用外部模型接口不要求本机配备 GPU，但需要可用的网络、接口和凭据。本地大模型推理需按模型规模、量化方式及并发目标单独评估；Weaviate 不包含在默认 Compose 编排中，按需单独准备。
- 操作系统与架构：核对每个组件和镜像的版本、CPU 架构及运行条件。ARM、麒麟等国产化环境需在目标软硬件组合上完成适配与验证。
- 网络与数据持久化：应用与数据服务尽量通过受控内网通信，按需开放访问端口。确认数据库、图数据及上传文件的持久化位置，并验证备份能够恢复。