系统要求
文中所述系统要求为 NocoBase 应用服务本身 的系统运行要求，仅涵盖应用进程所需的计算与内存资源。不包含依赖的第三方服务，包括但不限于：
- API 网关 / 反向代理
- 数据库服务（如 MySQL、PostgreSQL）
- 缓存服务（如 Redis）
- 消息队列、对象存储等中间件
除仅用于功能验证或试验性的场景外，强烈建议将上述第三方服务独立部署 于单独的服务器或容器中，或直接使用相关的云服务。
相关服务的系统配置和容量规划应根据 实际数据量、业务负载和并发规模 单独评估与调优。
操作系统
生产环境推荐使用 Linux 服务器，比如 Ubuntu LTS、Debian、Rocky Linux、AlmaLinux 等。Linux 上的 Docker、反向代理、进程管理、日志和备份方案更成熟，也更容易和常见云服务器环境对接。
NocoBase 也可以安装在 Windows Server 上。如果你选择 Windows Server，需要自行确认 Node.js、数据库、反向代理、进程守护 、备份、文件权限和防火墙等配置，并根据实际部署方式调整运维流程。
macOS 通常更适合本地开发和测试，不建议作为生产服务器。如果你是在本地搭建开发或 AI Agent 使用的 NocoBase 应用，可以先看 本地开发搭建。
单节点部署模式
单节点部署模式指 NocoBase 应用服务仅运行于单一服务器或容器实例中。
最低硬件要求
适用场景：
- 微型业务
- 功能验证（POC）
- 开发 / 测试环境
- 几乎无并发访问的场景
提示
- 该配置仅保证系统可运行，不保证性能体验。
- 当数据量或并发请求增长时，系统资源可能迅速成为瓶颈。
- 对于 源码开发、插件开发或从源码构建并部署 的场景，建议预留 4 GB 以上空闲内存，以确保依赖安装、编译及构建过程顺利完成。
推荐硬件要求
适用场景：
适用于中小型业务及少量并发的生产环境。
提示
- 在该配置下，系统可满足常规管理后台操作及轻量级业务负载。
- 当业务复杂度、并发访问或后台任务增多时，应考虑升级硬件规格或迁移至集群模式。
集群模式
适用于中大规模和并发较多的业务场景，可以通过水平扩展来提升系统的可用性和业务吞吐量（详情请参考：集群模式）。
节点硬件要求
在集群模式下，每个应用节点（Pod / 实例）的硬件配置建议与单节点部署模式一致。
单节点最低配置：
- CPU：1 核
- 内存：2 GB
单节点推荐配置：
- CPU：2 核
- 内存：4 GB
节点数量规划
- 集群中的节点数量可按需扩展（2–N）
- 实际所需节点数量取决于：
- 并发访问量
- 业务逻辑复杂度
- 后台任务与异步处理负载
- 外部依赖服务的响应能力
建议在生产环境中：
- 结合监控指标（CPU、内存、请求延迟等）动态调整节点规模
- 预留一定的资源冗余以应对流量波动