3种部署方案：从个人测试到企业集群的NocoBase实施路径

NocoBase作为极易扩展的无代码/低代码开发平台，提供了灵活的部署选项以适应不同用户需求。本文将通过"场景分析→方案匹配→实施指南→深度优化"的四段式框架，帮助运营人员快速选择并完成适合自身场景的部署方案。

一、场景分析：选择适合你的部署路径

在开始部署NocoBase之前，需要根据使用场景、团队规模和资源条件选择合适的部署方案。以下是三种主要部署方式的适用规模评估：

部署方式	适用规模	典型场景	技术门槛
Docker Compose	个人/小团队	功能测试、演示环境、小型内部系统	低
Dockerfile构建	团队/部门级	生产环境、定制化部署、中等规模应用	中
create-nocobase-app	企业级/开发者	二次开发、功能扩展、大型应用集群	高

[!TIP] 对于初次接触NocoBase的用户，建议从Docker Compose开始，快速体验平台功能后再根据需求升级部署方案。

二、方案匹配：三种部署方式的核心差异

2.1 Docker Compose容器编排部署

Docker Compose是一种容器编排工具，可定义多服务应用，通过YAML文件配置应用的服务、网络和卷等。这种方式适合快速部署包含NocoBase应用、数据库和管理工具的完整服务栈。

环境需求：

• Docker Engine 20.10+
• Docker Compose 2.0+
• 至少2GB内存和10GB可用磁盘空间

适用规模评估：个人/小团队（最多10人同时使用）

资源消耗：

• CPU：1核以上
• 内存：2GB（建议4GB）
• 存储：10GB（含数据库和上传文件）

扩展性评分：★★☆☆☆

部署流程图：

实施指南：

📌 步骤1：克隆代码仓库

git clone https://gitcode.com/GitHub_Trending/no/nocobase
cd nocobase

📌 步骤2：启动服务

# 使用默认配置启动（MySQL数据库）
docker-compose up -d

📌 步骤3：访问应用 在浏览器中访问 http://localhost:13000，使用默认账号 [e-mail] 和密码 admin123 登录。

关键配置项说明：

# docker-compose.yml 核心配置
version: "3"
services:
  mysql:
    image: mysql:8
    environment:
      MYSQL_DATABASE: ${DB_DATABASE:-nocobase}  # 数据库名称，默认nocobase
      MYSQL_USER: ${DB_USER:-nocobase}          # 数据库用户，默认nocobase
      MYSQL_PASSWORD: ${DB_PASSWORD:-nocobase}  # 数据库密码，默认nocobase
    ports:
      - "${DB_MYSQL_PORT:-3306}:3306"           # 数据库端口映射
  nocobase:
    image: node:16-stretch-slim
    command: ["yarn", "start"]
    ports:
      - "${APP_PORT:-13000}:${APP_PORT:-13000}" # 应用端口，默认13000
    volumes:
      - ./:/app                                 # 代码目录挂载
      - ./storage:/app/storage                  # 数据持久化目录

2.2 Dockerfile自定义构建部署

Dockerfile构建方式允许用户根据需求定制NocoBase镜像，包括预安装插件、配置环境变量和优化运行参数，适合生产环境部署。

环境需求：

• Docker Engine 20.10+
• 至少4GB内存和20GB可用磁盘空间
• Git 2.30+

适用规模评估：团队/部门级（10-50人同时使用）

资源消耗：

• CPU：2核以上
• 内存：4GB（建议8GB）
• 存储：20GB（含数据库和上传文件）

扩展性评分：★★★★☆

部署流程图：

实施指南：

📌 步骤1：克隆代码仓库

git clone https://gitcode.com/GitHub_Trending/no/nocobase
cd nocobase

📌 步骤2：构建自定义镜像

# 使用完整依赖版本构建（推荐生产环境）
docker build -t nocobase:custom -f docker/nocobase/Dockerfile-full .

📌 步骤3：运行容器

docker run -d \
  -p 8000:8000 \
  -v ./storage:/app/storage \
  -e DB_HOST=mysql \
  -e DB_PORT=3306 \
  -e DB_DATABASE=nocobase \
  -e DB_USER=nocobase \
  -e DB_PASSWORD=nocobase \
  --name nocobase \
  nocobase:custom

关键配置项说明：

# Dockerfile-full 核心配置
FROM node:20-bookworm as builder
WORKDIR /tmp
COPY . /tmp
RUN yarn install && yarn build --no-dts  # 安装依赖并构建应用

FROM node:20-bookworm-slim
COPY --from=builder /tmp/packages/core/server/dist /app
COPY --from=builder /tmp/yarn.lock /app/
WORKDIR /app
ENV NODE_ENV=production  # 生产环境标识
ENV PORT=8000            # 应用端口
EXPOSE 8000
CMD ["node", "bin/server.js"]  # 启动命令

2.3 create-nocobase-app源码安装部署

create-nocobase-app是官方提供的源码部署工具，适合需要进行二次开发和功能扩展的场景，允许开发者自定义插件和修改核心代码。

环境需求：

• Node.js v16.14+
• Yarn v1.22+
• Git 2.30+
• 至少8GB内存和40GB可用磁盘空间

适用规模评估：企业级/开发者（50人以上同时使用）

资源消耗：

• CPU：4核以上
• 内存：8GB（建议16GB）
• 存储：40GB（含源代码、数据库和上传文件）

扩展性评分：★★★★★

部署流程图：

实施指南：

📌 步骤1：创建项目

npx create-nocobase-app@latest my-nocobase-app
cd my-nocobase-app

📌 步骤2：安装依赖

yarn install

📌 步骤3：启动开发环境

yarn dev

📌 步骤4：构建生产版本

yarn build
yarn start

关键配置项说明：

// .env 核心配置
NODE_ENV=development           // 环境类型：development/production
PORT=13000                     // 应用端口
DB_DIALECT=mysql               // 数据库类型：mysql/postgres/sqlite
DB_HOST=localhost              // 数据库主机
DB_PORT=3306                   // 数据库端口
DB_DATABASE=nocobase           // 数据库名称
DB_USER=root                   // 数据库用户
DB_PASSWORD=password           // 数据库密码
NODE_OPTIONS=--max-old-space-size=4096  // 内存限制配置（4GB）

三、深度优化：提升部署质量的关键策略

3.1 资源消耗对比与优化建议

部署方式	CPU需求	内存需求	存储需求	优化建议
Docker Compose	1核	2-4GB	10GB	关闭不必要的服务组件，限制容器CPU使用率
Dockerfile构建	2核	4-8GB	20GB	使用多阶段构建减小镜像体积，配置容器内存限制
create-nocobase-app	4核	8-16GB	40GB	启用代码分割，使用PM2进行进程管理

3.2 数据持久化配置

为确保数据不丢失，三种部署方式都需要配置数据持久化：

# Docker Compose数据持久化配置
volumes:
  - ./storage/db:/app/storage/db         # 数据库文件
  - ./storage/uploads:/app/storage/uploads # 上传文件
  - ./storage/logs:/app/storage/logs     # 日志文件

3.3 性能优化配置

# 调整Node.js内存限制
export NODE_OPTIONS=--max-old-space-size=8192  # 8GB内存限制

# 使用PM2进行进程管理（源码部署）
yarn global add pm2
pm2 start packages/core/server/dist/bin/server.js --name nocobase

四、问题诊断矩阵：常见问题与解决方法

问题现象	可能原因	排查步骤	解决方案
服务启动失败	端口冲突	1. 执行 netstat -tulpn 检查端口占用 2. 查看日志 docker logs nocobase	修改配置文件中的端口号，如APP_PORT=13001
数据库连接失败	数据库服务未启动	1. 检查数据库容器状态 `docker ps	grep mysql<br>2. 查看数据库日志 docker logs mysql`
页面加载缓慢	内存不足	1. 执行 free -m 检查内存使用 2. 查看应用日志中的内存溢出信息	增加内存资源或调整NODE_OPTIONS参数
插件安装失败	网络问题或版本不兼容	1. 检查网络连接 2. 查看插件安装日志 yarn add @nocobase/plugin-ai	使用国内镜像源，确认插件与NocoBase版本匹配
文件上传失败	存储卷权限问题	1. 检查存储目录权限 ls -la ./storage/uploads 2. 查看应用日志中的权限错误	调整目录权限 chmod -R 775 ./storage

五、部署决策总结

选择NocoBase部署方案时，应综合考虑团队规模、技术能力和业务需求：

• 快速体验或小团队使用：优先选择Docker Compose，简单快捷且维护成本低
• 生产环境或定制化需求：推荐Dockerfile构建，可定制性强且资源占用合理
• 二次开发或企业级应用：选择create-nocobase-app源码部署，扩展性最强但技术门槛较高

通过本文提供的部署指南和优化建议，您可以根据实际需求选择合适的部署方案，并顺利完成NocoBase的实施工作。如需更详细的配置说明，请参考项目中的官方文档：docs/official.md。