NocoBase开源低代码平台搭建指南

教程导读

一句话定位：这是一本带你把 NocoBase 当作装配现场来学的实操手册——从装平台、建数据表、拼页面区块，到接工作流、上权限、写插件、护生产，读完你能独立交付一个数据驱动的业务应用。

「先装底盘，再拼模块，最后一颗螺丝一颗螺丝地拧紧。」这是 NocoBase 老用户之间流传的行话。它说的正是这套开源低代码平台的用法：不是等着一栋盖好的楼拎包入住，而是走进装配现场，用数据表、页面区块、工作流、插件这些标准零件，把业务应用亲手拼出来。市面上不少材料喜欢把低代码讲成魔法，这本教程偏要把镜头对准车间：每个配置项是什么零件、拧在哪、拧多紧、拧错了会怎样，都摊开在操作台上看清楚。

为什么值得进这处现场

企业里的需求大抵如此：销售要一份能跟进的客户台账，人事要一条请假审批线，仓库想要一本进销存的流水账。找外包开发，报价单先到，功能上线要等下个季度；买现成 SaaS，字段是别人定死的，业务稍微拐个弯就卡住。NocoBase 把第三条路摆上桌——数据模型驱动加插件化架构的开源自托管平台，你既能在界面上拖拽配置，也能在需要时写代码扩展，部署在自己的机器上，数据不出门。

这套自由有代价：零件多、自由度大，意味着你得知道装配顺序。先建数据表还是先搭页面？权限什么时候上？插件装到什么程度该收手？这些问题回答不好，拼出来的应用三个月后就变成没人敢动的毛线团。本教程的全部章节，都在回答这一类问题。

适合谁读

零基础也能上手：装平台只需要会用命令行复制粘贴命令；数据库知识有最好，没有也不妨碍跟着第 2 章的案例把第一张表建起来。反过来，如果你已经写过几年代码，第 4 章的插件车间会让你发现 NocoBase 的另一副面孔——它骨子里是一套可编程的应用框架。

学完你能做什么

1. 独立完成一次从零到上线的装配：装好平台、建出数据模型、拼出页面、配好角色权限；
2. 用工作流引擎把重复的人工环节改成自动流转，比如报销审批、工单派发、库存预警；
3. 接入外部数据库与第三方服务，让 NocoBase 成为现有业务的车间调度台，而不是又一座孤岛；
4. 判断哪些需求用配置解决、哪些该写插件，避免把装配现场变成炼金炉；
5. 把一个试验台上的原型安全地迁到生产环境，并且知道备份、升级、排错分别该怎么做；
6. 拿出一份能说服预算方与安全部门的实施方案——成本、周期、合规，逐项对得上。

全册装配地图

六章的关系不是并列的目录，而是有先后依赖的装配工序：认识零件在前，动手装配在中，扩写插件与守护生产在后，交付复盘收尾。下图把这条工序链和各章的依赖画在一起，箭头指向「建议先学」的方向。

图 0-1 全册六章装配地图与依赖关系

学习路线与两条读法

主线读法按箭头顺序走完六章，适合从零开始、目标独立交付的读者。速通读法适合已经有明确任务的人：业务人员走第 1、2、3 章就能交付部门应用；开发者从第 2 章直插第 4 章；运维只看第 2 章的安装节加第 5 章。无论哪种读法，第 2 章都绕不开——那里是动手的起点，后面所有章节的例子都默认你已经把装配台搭起来了。

怎么用这本教程

环境上，准备一台内存不低于四 GB 的机器或一台云主机，装好 Docker 即可开跑第 2 章；源码安装路线需要 Node 环境与包管理器，教程会给出取舍建议。每章的节都遵循同一套现场节奏：先领零件（概念与配置项），再装配（带注释的操作与配置），后试运转（预期结果长什么样），最后翻返工记录（常见坑）。建议边读边动手，把每节的操作在自己的实例上过一遍——装配手艺从来不靠读，靠拧。

章节里的配置示例都给到可以直接照抄的粒度：数据表字段清单、工作流节点参数、角色权限矩阵，照着敲就能复现。示例里出现的客户管理、请假审批、进销存三组案例会在不同章节反复出现、逐步加厚，前后对照着看，你会看到同一条业务线怎样从一张表长成一个完整应用。