企业官网建设流程全解析

NocoBase 系统要求与硬件规划指南：单节点、集群模式与生产环境容量评估

【免费下载链接】nocobaseNocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobase

导读

本文基于 NocoBase 官方《系统要求》文档，系统梳理 NocoBase 应用服务本身的运行资源要求，覆盖操作系统选型、单节点部署的最低与推荐硬件配置、集群模式下的节点规划方法，并结合当前仓库源码（环境变量、CLI 配置、集群模式文档）给出可验证的部署依据。读完本文，你将能根据业务规模为 NocoBase 制定合理的服务器规格与集群扩容策略，并正确区分「应用自身资源」与「第三方依赖服务资源」的规划边界。

适用范围：仅针对 NocoBase 应用服务本身

文档中所述的系统要求，指的是NocoBase 应用服务本身的运行要求，仅涵盖应用进程所需的计算与内存资源。它不包含下列依赖的第三方服务：

• API 网关 / 反向代理
• 数据库服务（如 MySQL、PostgreSQL）
• 缓存服务（如 Redis）
• 消息队列、对象存储等中间件

除仅用于功能验证或试验性的场景外，强烈建议将上述第三方服务独立部署于单独的服务器或容器中，或直接使用相关的云服务。相关服务的系统配置和容量规划，应根据实际数据量、业务负载和并发规模单独评估与调优。

这一点是容量规划的起点：如果把数据库、Redis 与 NocoBase 应用挤在同一台小规格机器上，「应用自身 2 GB 内存够用」的结论会迅速失真，因为数据库缓冲池、Redis 内存占用会与 Node.js 进程争抢资源。

操作系统选择

生产环境推荐使用 Linux 服务器，例如Ubuntu LTS、Debian、Rocky Linux、AlmaLinux等。原因在于 Linux 上的 Docker、反向代理、进程管理、日志和备份方案更成熟，也更容易与常见云服务器环境对接。

NocoBase 也可以安装在Windows Server上，但需要自行确认 Node.js、数据库、反向代理、进程守护、备份、文件权限和防火墙等配置，并根据实际部署方式调整运维流程。

macOS通常更适合本地开发和测试，不建议作为生产服务器。如果你是在本地搭建开发或 AI Agent 使用的 NocoBase 应用，可以参考 本地开发搭建 一文，其中针对 Windows（推荐 WSL 2）、macOS、Linux 分别给出了 Node.js、Yarn、Docker 的环境准备清单。

单节点部署模式

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

最低硬件要求

适用场景：

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

需要注意：

• 该配置仅保证系统可运行，不保证性能体验。
• 当数据量或并发请求增长时，系统资源可能迅速成为瓶颈。
• 对于源码开发、插件开发或从源码构建并部署的场景，建议预留4 GB 以上空闲内存，以确保依赖安装、编译及构建过程顺利完成。这一点从仓库的构建规模也可以印证：NocoBase 采用 monorepo 结构（见 package.json 中workspaces覆盖packages/*/*与packages/*/*/*），仅核心包就包含@nocobase/client（1800+ 源文件）、@nocobase/database、@nocobase/server等，加上packages/plugins/@nocobase/下数千个插件文件，依赖安装与yarn build编译过程对内存有较高要求。

推荐硬件要求

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

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

集群模式

集群模式适用于中大规模和并发较多的业务场景，可以通过水平扩展来提升系统的可用性和业务吞吐量。NocoBase 自 v1.6.0 起支持集群模式运行，详细说明见 集群模式。

节点硬件要求

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

• 单节点最低配置：CPU 1 核，内存 2 GB
• 单节点推荐配置：CPU 2 核，内存 4 GB

也就是说，集群模式不是通过「把单个节点做大」来提升性能，而是通过「多节点分摊负载」实现横向扩展。

节点数量规划

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

建议在生产环境中：

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

集群模式下的资源相关要点

从 集群模式 · 准备工作 可以看出，集群部署除应用节点外还需要数据库、Redis/RabbitMQ 中间件、共享存储（storage目录）和负载均衡器等系统组件，这恰好对应本文开头「第三方服务独立部署」的规划原则。几个与资源评估直接相关的约束：

• 中间件版本建议：Redis ≥ 8.0（或包含 Bloom Filter 功能的 redis-stack 版本）、RabbitMQ ≥ 4.0。
• Worker ID 限制：NocoBase 部分系统表使用全局唯一 ID 作为主键（实现见packages/core/snowflake-id），Worker ID 范围为 0–31，即相同应用最多支持 32 个节点同时运行。
• 共享存储：多节点必须共享storage目录（上传文件、插件包、密钥文件、日志、备份产物等），生产集群建议改用对象存储承载高频附件。

与资源消耗直接相关的运行参数（源码印证）

了解以下运行机制，有助于理解「2 GB / 4 GB」这些数字背后的资源去向，并避免配置误区。

Node.js 运行时版本

NocoBase 的运行时对 Node.js 版本有明确要求：package.json 中engines.node为>=22，volta字段固定node: 20.16.0、yarn: 1.22.19。因此部署 NocoBase 的服务器需要预装 Node.js 22 及以上版本（或遵循官方镜像内置版本），这也是操作系统准备阶段必须核对的项。

多核 / 集群模式开关

仓库根目录 package.json 中的start脚本为nocobase-v1 start。多核（集群）启动由环境变量CLUSTER_MODE控制：配置后会透传至pm2 start命令作为-i <instances>参数，可选max（使用全部核数）、-1（核数减一）或指定数字，默认不开启。这意味着：即使在单台多核服务器上，也可以通过CLUSTER_MODE=max让一个节点利用多核能力，但该模式需要配合集群模式相关插件使用（详见 环境变量配置 中CLUSTER_MODE一节）。

日志与缓存对资源的影响

• 日志：生产环境默认LOGGER_TRANSPORT=console,dailyRotateFile、LOGGER_LEVEL=info，日志文件会持续占用磁盘，需按 环境变量配置 中的LOGGER_MAX_FILES、LOGGER_MAX_SIZE规划磁盘容量。
• 缓存：默认CACHE_DEFAULT_STORE=memory，内存缓存项上限CACHE_MEMORY_MAX=2000；集群模式下应改为redis并配置CACHE_REDIS_URL，以释放应用节点内存并保证多节点缓存一致。
• 数据库连接池：DB_POOL_MAX默认 5、DB_POOL_MIN默认 0，每个连接都会占用一定内存，高并发时可按需调大。

容量规划实践建议

综合原文档与仓库内容，推荐按以下步骤为 NocoBase 做容量规划：

1. 拆分资源预算：先按「应用节点规格 + 独立第三方服务规格」两部分分别规划，不要混在一起评估。
2. 从单节点起步：POC、微型业务按 1 核 / 2 GB 起步；中小型生产环境直接采用 2 核 / 4 GB 推荐配置。
3. 源码/插件开发额外预留：从源码构建（参考 package.json 的yarn build、yarn dev脚本）时，确保节点空闲内存 ≥ 4 GB。
4. 并发增长时优先横向扩展：业务增长后先考虑升级为集群模式（节点数 2–N，受 32 节点上限约束），而不是无限放大单节点规格。
5. 用监控驱动扩缩容：以 CPU、内存、请求延迟等监控指标为依据动态调整节点规模，并预留资源冗余应对流量波动。
6. 重视第三方服务容量：数据库、Redis、共享存储的容量规划依据实际数据量与负载单独评估，详见 集群模式 · 准备工作。

总结

NocoBase 的系统要求文档给出了清晰、保守的硬件基线：单节点最低 1 核 / 2 GB（仅保证可运行），推荐 2 核 / 4 GB（满足中小型生产负载）；集群模式沿用相同节点规格，通过 2–N 个节点水平扩展，并受 Worker ID 0–31 范围约束。实践中应严格区分应用自身与第三方依赖服务的资源规划，结合 Node.js ≥ 22 的运行要求、CLUSTER_MODE多核开关以及监控驱动的扩缩容策略，即可为 NocoBase 部署制定出既不过度配置、也不轻易触碰性能瓶颈的容量方案。

【免费下载链接】nocobaseNocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything from scratch, AI works on top of production-proven infrastructure and a WYSIWYG no-code interface, so you get both speed and reliability.项目地址: https://gitcode.com/GitHub_Trending/no/nocobase