企业官网建设流程全解析

NocoBase 部署完整指南：从 5 分钟上线到生产运维

【免费下载链接】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 是一套开源的 AI + 无代码业务系统构建平台。本文聚焦 NocoBase 部署与安装：先讲清楚三种路径的适用场景，再按检查清单、操作步骤、上线验证、常见坑逐项展开，帮你把环境一次搭稳。

部署能带来什么

• 一条命令拉起「应用 + 数据库」，5 分钟内可在浏览器访问管理控制台
• 默认内置用户、权限、工作流等基础插件，无需额外配置即可建表、建页面
• 支持 MySQL、PostgreSQL 等主流数据库，环境可在不同机器间快速复制

对团队的价值很直接：演示环境半天就能搭好；正式环境按同一套流程放大规模即可。

三类场景，选对 NocoBase 安装路径

不用纠结技术细节，先对号入座：

• 轻量试用：想快速看看平台长什么样、跑个演示给同事看——用 Docker Compose 一键部署，仓库根目录的编排文件把应用和数据库一起拉起来，最省事。
• 正式生产：要长期跑、多人访问——用 Dockerfile 方式构建镜像（见 docker/ 目录下的构建脚本），插件可预装进镜像，启动更快，也便于统一升级。
• 二次开发：要改核心逻辑或深度定制插件——用create-nocobase-app脚手架生成独立应用（见 packages/core/create-nocobase-app/），本地 Node 环境里跑，自由度高。

一个实用的进阶顺序：先用 Compose 跑通，摸清控制台；要上生产再切 Dockerfile 构建。

部署前检查清单

动手前花两分钟核对，能避开后面 80% 的报错。

系统要求

• 操作系统：Linux / macOS / Windows（带 Docker 的环境均可）
• 内存 ≥ 2GB，磁盘可用空间 ≥ 10GB（源码安装需额外预留依赖安装空间）

软件依赖

• Docker Compose 路径：Docker Engine 20.10+，Compose 2.0+
• 源码安装路径：Node.js 16+ 与 Yarn

另外确认 13000（应用）及数据库端口未被本机其他服务占用。

部署实操：三条路径

路径一：Docker Compose 三步启动

git clone https://gitcode.com/GitHub_Trending/no/nocobase cd nocobase docker-compose up -d

编排文件已包含应用与数据库服务，容器名和端口冲突时，改 compose 里的端口映射即可。首次启动会执行初始化（建表、写默认管理员），稍等一两分钟再刷新页面。

路径二：Dockerfile 生产构建

用仓库 docker/ 目录的 Dockerfile 构建镜像，核心动作三件：构建带预装插件的镜像、把storage目录挂成持久化卷、注入生产环境变量（APP_ENV=production、数据库连接信息）。相比开发态编排，生产镜像启动后不再现场安装依赖，重启和扩容都更可控。

路径三：源码安装本地开发

npx create-nocobase-app@latest my-nocobase cd my-nocobase yarn install yarn start

生成的应用自带packages插件目录，把自研插件放进去即可被加载。这条路径的启动最慢（首次依赖安装耗时明显），换来的是断点调试和任意改动的自由。

部署后验证：三步确认服务健康

1. 页面访问：浏览器打开http://localhost:13000，应出现登录页。首次初始化后，用.env中INIT_ROOT_EMAIL/INIT_ROOT_PASSWORD对应的默认账号登录（示例值见 .env.example）。

2. 数据库连接：登录成功本身就说明 ORM 连通正常；进一步可在控制台创建一张测试集合，看字段是否立即写入。数据文件落在storage/db，有内容即代表读写链路打通。

3. 插件加载：进入插件管理页，确认内置插件数量正常、可启可停。若某插件显示异常，先看storage/logs下对应时间点的报错日志，再对照插件版本兼容性。

常见坑与处理

• 现象：端口被占用，页面打不开。原因：13000 或数据库端口已被占用。处理：改 compose 文件中的端口映射，或用lsof -i:13000找到并停掉占用进程。
• 现象：应用起来了，但登录时报数据库错误。原因：数据库容器未就绪或账号密码不匹配。处理：先单独重启数据库容器，核对DB_HOST、DB_USER、DB_PASSWORD与容器实际配置一致，再重启应用。
• 现象：首次启动长时间无响应。原因：初始化阶段在执行建表和默认数据写入。处理：耐心等 2-3 分钟，观察容器日志到出现started字样再刷新页面。
• 现象：插件安装后不生效或页面报错。原因：插件与当前 NocoBase 版本存在 peer 依赖不匹配。处理：回看安装时的 peer 依赖警告，换用匹配版本的插件，必要时降级插件。

长期运维建议

• 备份：定期打包storage/db与storage/uploads两个目录；数据库侧建议另配定时导出任务，双保险。
• 安全：上线当天改掉默认管理员密码并设置强APP_KEY；对外暴露前配置反向代理 + HTTPS，只放开必要端口。
• 性能：数据量上来后，调大数据库连接池（DB_POOL_*系列变量）；多实例部署时把缓存切到 Redis，避免各节点各存一份内存缓存。

写在最后

跑通第一条路径只是起点。建议把部署流程沉淀成一份可重复执行的脚本（含环境检查与备份步骤），后续升级版本时直接复用，而不是每次临时拼命令。

【免费下载链接】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