---
title: "NocoBase 系统要求"
description: "NocoBase 部署硬件要求：单节点最低 1 核 2GB、推荐 2 核 4GB，集群模式配置，数据库/Redis 等第三方服务独立部署建议。"
keywords: "系统要求,硬件要求,CPU,内存,单节点部署,集群部署,生产环境,NocoBase"
---

# 系统要求

文中所述系统要求为 **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 应用，可以先看 [本地开发搭建](../ai/local-development-setup.md)。

## 单节点部署模式

单节点部署模式指 NocoBase 应用服务仅运行于单一服务器或容器实例中。

### 最低硬件要求

| 资源 | 要求 |
|---|---|
| CPU | 1 核 |
| 内存 | 2 GB |

**适用场景**：

- 微型业务
- 功能验证（POC）
- 开发 / 测试环境
- 几乎无并发访问的场景

:::info{title=提示}

- 该配置仅保证系统可运行，不保证性能体验。
- 当数据量或并发请求增长时，系统资源可能迅速成为瓶颈。
- 对于 **源码开发、插件开发或从源码构建并部署** 的场景，建议预留 **4 GB 以上空闲内存**，以确保依赖安装、编译及构建过程顺利完成。

:::

### 推荐硬件要求

| 资源 | 推荐配置 |
|---|---|
| CPU | 2 核 |
| 内存 | ≥ 4 GB |

**适用场景**：

适用于中小型业务及少量并发的生产环境。

:::info{title=提示}

- 在该配置下，系统可满足常规管理后台操作及轻量级业务负载。
- 当业务复杂度、并发访问或后台任务增多时，应考虑升级硬件规格或迁移至集群模式。

:::

## 集群模式

适用于中大规模和并发较多的业务场景，可以通过水平扩展来提升系统的可用性和业务吞吐量（详情请参考：[集群模式](/cluster-mode)）。

### 节点硬件要求

在集群模式下，每个应用节点（Pod / 实例）的硬件配置建议与单节点部署模式一致。

**单节点最低配置：**

- CPU：1 核
- 内存：2 GB

**单节点推荐配置：**

- CPU：2 核
- 内存：4 GB

### 节点数量规划

- 集群中的节点数量可按需扩展（2–N）
- 实际所需节点数量取决于：
  - 并发访问量
  - 业务逻辑复杂度
  - 后台任务与异步处理负载
  - 外部依赖服务的响应能力

建议在生产环境中：

- 结合监控指标（CPU、内存、请求延迟等）动态调整节点规模
- 预留一定的资源冗余以应对流量波动
