很多人第一次接触 NocoBase 是在“零代码平台”这个关键词框里搜到的。市面上的零代码产品很多但大多数是商业 SaaS要么按人头收费要么把数据锁在平台上想做二次开发非常困难。NocoBase 最大的不同在于它是一个开源的、数据模型驱动的零代码平台你既可以在界面上点点画画配出一套后台管理系统也可以在现有代码基础上继续扩展插件。本文是 NocoBase 系列教程的第 2 篇重点讲清楚两件事怎么把 NocoBase 2 跑起来以及怎么用它从零搭一个博客管理后台。文章会以 Docker 安装为主线配合数据表设计、区块配置和权限设置的完整案例尽量做到照着操作就能跑通。1. NocoBase 是什么开源零代码平台的定位1.1 零代码和低代码到底有什么区别在开始安装之前先理清一个概念。低代码平台通常还需要写少量代码来完成复杂逻辑而零代码平台的目标是让业务人员不写代码也能搭建系统。NocoBase 更准确的说法是“以零代码操作为主、同时保留开发能力的平台”。它有一个非常核心的设计理念数据模型驱动。传统后台管理系统开发流程通常是先建数据库表再写后端接口再写前端页面最后处理权限和菜单。而 NocoBase 把这一步浓缩成了三个操作创建集合Collection相当于创建数据表配置字段和关系相当于设计表结构添加区块Block相当于把数据用表格、表单、看板等形式展示到页面上。这三个操作全部在 Web 界面里完成不需要写 SQL、不需要写 Vue/React 页面代码系统会自动生成管理界面和 API。1.2 NocoBase 2 的核心特性NocoBase 2 是 NocoBase 团队在 1.x 基础上持续迭代的版本。从安装体验和功能覆盖上来看它有以下几个特点开源可自部署数据在自己服务器上不受 SaaS 平台限制商业版本和社区版都有明确的开源协议约束。数据模型驱动先有数据结构再生成页面和 API这一点和很多“表单驱动”的零代码平台思路不同。可视化配置界面集合、字段、页面、区块、角色权限都可以在图形界面完成。插件扩展机制如果内置功能不够用可以开发自己的插件这使得 NocoBase 不是封闭系统。自动生成 REST API每个集合创建后系统会自动提供对应的数据访问接口方便后续对接其他系统。1.3 适合做什么不适合做什么适用场景很清晰企业内部管理系统、运营后台、内容管理后台、项目管理工具、进销存、数据录入系统等。这些场景的共同特点是流程清晰、数据结构明确、页面交互不复杂。不太适合的场景也很明确高并发 C 端产品、非常复杂的实时协作编辑、对前端交互要求极高的定制页面。这类场景仍然需要专业开发团队用代码实现。不过你依然可以用 NocoBase 快速建立原型再导出或对接正式系统。2. 环境准备与版本说明2.1 安装方式选择NocoBase 2 官方提供了多种安装方式常见的有安装方式特点适合人群Docker Compose依赖少部署快一键启动大多数用户推荐create-nocobase-app需要 Node.js 环境灵活度高二次开发用户源码方式从 GitHub 拉取源码本地运行插件开发者本文重点演示 Docker Compose 方式。这种方式的好处是所有依赖都被容器管理不用在本地安装数据库和 Node.js环境隔离最彻底出问题的概率也最低。2.2 环境依赖清单在开始之前你需要准备一台能联网的服务器或本地电脑操作系统不限Windows/macOS/Linux 均可Docker 和 Docker Compose 插件确保 Docker 启动正常浏览器推荐 Chrome 或 Edge至少 8GB 内存避免数据库和应用同时运行时卡顿。版本方面需要提醒一句NocoBase 迭代比较快本文的配置示例以当前较常见版本为参考你在实际操作时如果遇到界面差异以你安装的版本和官方文档为准。2.3 示例项目结构为了后续维护方便建议单独创建一个目录存放 NocoBase 的配置文件nocobase-demo/ ├── docker-compose.yml ├── storage/ # 应用数据挂载目录 └── data/ # 数据库数据挂载目录这样可以保证容器删除后数据不丢失。3. 使用 Docker 部署 NocoBase 23.1 编写 Docker Compose 配置在nocobase-demo目录下新建docker-compose.yml内容如下services: nocobase: image: nocobase/nocobase:latest container_name: nocobase depends_on: - postgres environment: - APP_KEYyour-secret-key-change-me - DB_DIALECTpostgres - DB_HOSTpostgres - DB_PORT5432 - DB_DATABASEnocobase - DB_USERnocobase - DB_PASSWORDnocobase - TZAsia/Shanghai ports: - 13000:80 volumes: - ./storage:/app/nocobase/storage restart: always postgres: image: postgres:15 container_name: nocobase-postgres environment: - POSTGRES_DBnocobase - POSTGRES_USERnocobase - POSTGRES_PASSWORDnocobase - TZAsia/Shanghai volumes: - ./data:/var/lib/postgresql/data restart: always简单解释几个关键配置项APP_KEYNocoBase 用于签名和安全相关的密钥。生产环境务必修改为足够长的随机字符串不要使用默认值。DB_DIALECT数据库类型这里使用postgres。DB_HOST数据库地址Compose 内部可以直接使用服务名postgres。DB_PASSWORD建议修改为复杂度更高的密码。ports映射13000:80表示把容器内 80 端口映射到宿主机 13000 端口。你可以改成其他端口但后续访问地址也要跟着变。volumes挂载./storage和./data分别保存应用数据和数据库数据避免容器重建后数据丢失。3.2 启动命令与验证在docker-compose.yml所在目录执行docker-compose up -d如果 Docker 版本较新也可以使用docker compose up -d首次启动需要拉取镜像耗时取决于网络情况。启动完成后用以下命令查看容器状态docker-compose ps正常情况下nocobase和nocobase-postgres两个容器都应该是Up状态。如果启动失败推荐用以下命令查看日志docker-compose logs -f nocobase3.3 第一次访问创建管理员账号容器启动成功后浏览器访问http://localhost:13000如果你是安装在远程服务器上请将localhost替换为服务器 IP并确认防火墙和云安全组已经放行 13000 端口。NocoBase 首次访问时会进入安装引导界面。你需要按照界面提示设置管理员用户名、邮箱和密码。这里要特别提醒不要依赖任何“默认密码”NocoBase 不会给你预设一个 admin/admin123账号密码完全由你第一次安装时创建。设置完成后这个管理员账号就是整个系统的最高权限账号需要妥善保管。如果安装页面要求配置数据库则需要填写你在docker-compose.yml中定义的数据库名称、用户和密码。如果你完全按照上面的 Compose 文件配置数据库相关信息通常是数据库地址localhost或127.0.0.1端口5432数据库名nocobase用户名nocobase密码nocobase不过需要注意NocoBase 各版本在安装向导上略有差异有些版本会自动读取环境变量有些版本需要手动填写。遇到不确定的界面时可以回看docker-compose.yml里的环境变量。3.4 另一种方式create-nocobase-app 提示如果你不想使用 Docker也可以使用官方提供的脚手架创建应用yarn create nocobase-app my-nocobase-app这种方式需要先安装 Node.js且对 Node 版本有要求。相比 Docker它可以更方便地进行二次开发和调试但环境配置也更复杂。对于第一次接触 NocoBase 的读者建议先通过 Docker 跑通流程后续需要插件开发时再切换到源码方式。4. NocoBase 核心概念拆解在进入实战案例之前有必要先理解 NocoBase 的几组核心概念。这些概念贯穿整个使用过程理解之后配置起来会顺畅很多。4.1 集合 CollectionNocoBase 里的“数据表”集合是 NocoBase 中最基础的概念。你可以把它理解成数据库表也可以理解成 Excel 里的一个工作表。每个集合都有若干个字段字段定义了这个集合能存哪些数据。例如一个“文章”集合可以包含以下字段标题、正文、发布时间、状态、所属分类。NocoBase 会把这些字段映射到数据库表的列上并自动生成对应的增删改查接口。4.2 字段类型与关系字段NocoBase 内置了丰富的字段类型常见的有文本类单行文本、多行文本、富文本、Markdown数值类整数、小数、百分比、币种选项类单选、多选、下拉选择日期时间日期、时间、日期时间文件类附件、图片关系类关联字段比如一对多、多对一、多对多。关系字段是 NocoBase 比较强大的地方。例如一篇文章属于一个分类一个分类下有多篇文章这就是一对多关系一篇文章可以打多个标签一个标签也可以关联多篇文章这就是多对多关系。通过关系字段你可以把多个集合串联起来做出联动的数据界面。4.3 区块 Block页面的积木区块是 NocoBase 页面布局的最小单元。你可以把区块理解成积木页面就是拼好的积木组合。常见的区块类型有表格区块以表格形式展示数据支持分页、排序、筛选表单区块用于新增或编辑数据详情区块用于展示单条数据的详细信息看板区块适合任务管理、项目管理日历区块按日历形式展示带日期字段的数据。一个页面可以放多个区块区块之间可以通过关系字段联动。例如在“文章分类详情”页面里左边展示分类信息右边展示该分类下的文章列表这就是关系区块的典型用法。4.4 角色权限NocoBase 在安装完成后会自动创建一个管理员角色。管理员拥有全部权限可以创建其他角色并分配权限。角色权限通常包括对每个集合的查看、新增、编辑、删除权限对字段级别的访问控制对页面和菜单的可见性控制。在实际项目中我建议你给不同角色配置不同的权限范围避免普通用户直接看到或修改敏感数据。4.5 工作流与自动化除了基础的数据管理NocoBase 还内置了工作流插件可以用来实现简单的自动化操作比如提交审批、定时触发、数据变更通知等。工作流的配置方式也是图形化的不需要写代码。第一版可以先不深入使用工作流但如果你做的系统涉及审批流程这个是值得提前了解的扩展方向。4.6 API 能力提示NocoBase 每个集合创建后都会自动生成一套 REST API。这意味着你在界面上配置好的数据表本身就相当于一个后端服务可以给其他系统或前端页面提供接口。你可以把 NocoBase 看成一个“会生成后台管理界面的数据服务”这对快速搭建内部工具非常有价值。5. 实战用 NocoBase 搭建一个博客管理系统前面概念介绍得差不多了这一节我们走一个完整案例用 NocoBase 搭建一个最简单的博客管理系统。这个案例不会涉及复杂的前端代码所有操作都在 NocoBase 界面内完成。5.1 需求梳理与数据模型设计博客系统的核心数据通常包括文章标题、摘要、正文、状态草稿/已发布、发布时间、所属分类分类分类名称、排序标签标签名称评论昵称、邮箱、内容、状态待审核/已通过、关联文章。基于这些需求我们规划以下集合集合名主要字段说明posts标题、摘要、正文、状态、发布时间、分类、作者文章表categories名称、描述、排序分类表tags名称标签表comments昵称、邮箱、内容、状态、文章评论表关系设计如下一个分类下有多篇文章一篇文章属于一个分类categories 一对多 posts一篇文章可以打多个标签一个标签可以关联多篇文章posts 多对多 tags一篇文章下有多条评论一条评论属于一篇文章posts 一对多 comments。5.2 创建集合登录 NocoBase 后台后进入“设置”或“数据源管理”相关菜单找到集合管理入口。点击“新建集合”输入集合名称。以文章集合posts为例步骤如下填写集合名称posts填写集合标识通常系统会自动生成在字段列表中添加字段。字段建议如下字段名称字段类型说明title单行文本文章标题excerpt多行文本文章摘要content多行文本或富文本正文status单选草稿 / 已发布published_at日期时间发布时间category关联字段关联 categories 表tags关联字段多对多关联 tags 表按同样的方式创建categories、tags、comments集合。comments表里可以添加post关联字段指向posts表示这条评论属于哪篇文章。5.3 配置关系字段在创建字段时如果选择“关联字段”NocoBase 会要求你选择关联的目标集合并设置关系类型。例如在posts中创建category关联字段目标集合选择categories关系类型选择“多对一”含义是一篇文章对应一个分类。在posts中创建tags关联字段目标集合选择tags关系类型选择“多对多”含义是一篇文章有多个标签一个标签对应多篇文章。配置完成后你可以进入对应集合的数据管理页面手动新增几条数据来验证关系字段是否生效。5.4 创建页面与区块数据表和字段配置完成后接下来要把数据展示到页面上。NocoBase 的页面由区块组成你可以新建一个菜单叫“文章管理”。在文章管理页面中添加一个“表格区块”数据来源选择posts集合。表格中会显示所有文章字段你可以选择显示哪些列比如标题、状态、发布时间、分类。为了丰富页面你还可以再添加一个“看板区块”数据来源同样是posts看板的分组字段选择status这样文章可以按“草稿”和“已发布”分组展示方便管理内容发布状态。对于评论管理新建一个“评论管理”菜单页面添加comments表格区块显示昵称、邮箱、内容和状态字段。这样后台就基本成型了。5.5 配置权限在 NocoBase 中角色权限决定了谁能看到哪些内容、能操作哪些数据。默认管理员拥有全部权限。假设你希望给一位“内容编辑”开放部分权限可以这样配置进入角色权限管理新建角色“内容编辑”为该角色配置posts集合的查看、新增、编辑权限但不允许删除配置categories和tags的查看、新增、编辑权限评论的删除权限默认关闭只允许查看和审核状态更新。这样“内容编辑”角色登录后可以管理文章和分类但不能删除评论也不能进入系统设置。5.6 完善页面与发布预览为了让博客前台有一个“展示”视角你还可以配置一个访客角色。访客角色的权限通常只有查看posts中的已发布文章无法进入后台管理页面。通过 NocoBase 的权限配置这种“前后台分离”的体验可以在同一个系统里实现。完成以上步骤后你实际上已经用 NocoBase 搭出了一个可用的博客后台。你可以在后台发布一篇测试文章然后通过 NocoBase 生成的 API 或页面预览查看效果。5.7 案例小结这个案例本质上只用了 NocoBase 的四个基础能力集合、字段、区块和权限。如果你能独立完成这个过程说明你已经掌握了 NocoBase 的核心操作路径先设计数据结构再配置界面最后控制权限。后续所有复杂的系统基本都是在这些基础操作上叠加更多字段、区块和工作流。6. 常见问题与排查思路NocoBase 安装和使用过程中有不少读者会遇到一些重复性问题。这里整理一张排查表你可以先对照排查再结合官方文档处理。问题现象常见原因解决思路浏览器访问 13000 端口没有反应容器未启动或防火墙未放行端口执行docker-compose ps查看状态检查宿主机防火墙和安全组页面提示数据库连接失败数据库环境变量配置错误或数据库容器未启动检查docker-compose.yml中 DB_HOST、DB_USER、DB_PASSWORD 是否一致查看数据库容器日志第一次安装时不知道用户名密码安装向导中设置的账号密码忘掉或误以为存在默认密码NocoBase 没有默认密码如果忘记密码需要进入数据库重置或参考官方文档恢复流程容器反复重启端口冲突或磁盘权限问题查看日志docker-compose logs -f nocobase检查挂载目录是否有写入权限页面配置保存后看不到效果浏览器缓存或区块数据源选择错误清除浏览器缓存检查区块绑定的集合是否正确升级后部分插件不可用NocoBase 版本升级后插件未同步升级升级前先备份完整数据在测试环境验证插件兼容性后再应用到生产环境如果你遇到的是某个具体报错推荐先把完整报错信息贴到搜索引擎或官方 GitHub Issues 里搜索很多问题已经有解决方案。7. 最佳实践与工程建议把 NocoBase 部署起来并不难难的是把它用成一个稳定、可维护的生产系统。以下建议来自实际项目的经验总结。7.1 数据模型设计阶段多投入时间NocoBase 的优势之一是你不用写建表 SQL但这不代表可以随便建表。相反因为数据结构一旦被多个页面的区块引用后续修改字段类型会牵连较多地方所以在新建集合之前建议先整理一份数据模型文档明确每个集合的用途、字段、类型和关系。一个比较实用的做法是先在纸上画出实体关系图确定一对多、多对多关系再在 NocoBase 中落地。这样能减少后续反复调整结构的工作量。7.2 权限最小化原则在配置权限时默认建议“能不给权限就不给权限”。管理员账号只用于维护系统日常运营人员使用受限角色。特别注意文章删除权限不要随意开放给普通编辑评论审核和删除权限尽量分离系统设置菜单只对管理员可见。这样做的好处是即使某个账号被泄露损失范围也是可控的。7.3 定期备份数据库和应用目录NocoBase 的数据主要存在数据库里但应用目录下的storage目录也保存着附件、资源和部分配置。备份策略建议定期使用pg_dump备份 PostgreSQL 数据库备份整个storage目录在升级版本或修改重要配置前先手动备份一次。备份是性价比最高的安全性投入不要等出了问题再后悔。7.4 生产环境安全配置如果你的 NocoBase 要部署到公网需要注意将APP_KEY修改为足够复杂的随机字符串数据库不要暴露到公网端口仅在 Docker 内部网络环境使用使用 HTTPS 访问 NocoBase 页面为管理员账号设置高强度密码开启必要的登录限制。尤其不要直接把 5432 端口暴露到公网数据库一旦暴露攻击者可能会尝试暴力破解。7.5 版本升级前先在测试环境验证NocoBase 2 还处于持续迭代阶段版本升级可能带来新的功能和破坏性变更。上线前建议先在测试环境执行完整升级流程确认核心功能正常再更新生产环境。升级前一定先做数据库备份。8. 总结与下一步学习路线本文从零开始介绍了 NocoBase 2 的定位、Docker 部署、核心概念、博客后台实战以及常见问题的排查思路。现在你应该已经具备以下能力使用 Docker Compose 快速部署 NocoBase理解集合、字段、区块和角色权限之间的关联能在界面中完成数据表建模和页面配置知道如何规划权限避免生产环境权限失控。如果你已经把本文案例跑通下一步可以尝试这几个方向研究 NocoBase 的字段联动和条件显示做出更灵活的表单尝试配置工作流实现文章发布前的审批流程了解 NocoBase 的插件开发写一个满足自己业务需求的小插件使用 NocoBase 自动生成的 REST API对接一个简单的前端页面。NocoBase 的价值不在于替你写代码而在于把“数据管理后台”这类重复性极高的开发工作压缩成几天的配置工作。如果你在安装或使用过程中遇到任何问题可以把报错信息整理好发到评论区我们一起排查解决。动手跑一遍比看十遍教程都更有用。