NocoBase开发环境搭建：5步跑通最小闭环+企业级配置思路

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你刚把仓库拉下来终端一片空白面对满屏的 package 和插件第一反应是懵的。NocoBase 是一个开源的 AI 无代码平台它的价值不在于从零生成代码而是把 AI 能力叠在已经过生产验证的基础设施上再给你一套所见即所得的界面。下面我们花十分钟把它跑起来再看懂它怎么转最后按你大概率要做的顺序去改配置。三步命令跑通最小闭环别急着看源码先让它在浏览器里动起来。下面这条命令把代码拉到本地注意用的是 gitcode 的仓库地址git clone https://gitcode.com/GitHub_Trending/no/nocobase cd nocobase克隆完成后你就有了整个 monorepo 的目录。接下来安装依赖NocoBase 用 Yarn 管理所有包一条命令搞定所有子包的依赖yarn install跑完之后你会看到所有 workspace 的依赖装好node_modules在各子包里生成。依赖装好后直接起开发服务器。这一步会同时拉起前端和后端省得你手动分两条进程yarn dev启动成功后访问http://localhost:13000你会看到初始化页面填个账号密码就能进入。端口 13000 是默认值来自 .env.example 里的APP_PORT。如果本地只写前端可以先单独构建客户端再启动构建产物会放到packages/app/client下供服务读取。看懂它怎么转从集合到 API到了这一步你会发现界面上每个列表、表单背后都对应一个集合collection。数据流是这样的你在前端建一个集合字段NocoBase 就同步在数据库里建一张表和对应的列每个集合自动暴露一套 REST API增删改查前端再通过 block、field 把这条 API 渲染成表格或表单。上图是数据源管理界面右侧能看到主数据源和各类扩展。你改一个集合字段实际影响的是三处数据库表结构、自动生成的 API、以及引用这个字段的界面组件。所以建模时别只盯着界面要清楚这条链路。需要接入外部系统时可以在这里挂一个联邦数据源把别的数据库的表借过来而不必真正搬数据。关联关系一对一、一对多、多对多也是在这条链路上配置的。比如多对多会通过一张中间表连接两个集合这是 packages/plugins/ 里数据建模能力的一部分。让它适应你的业务下面这几件事是你接下来大概率要做的按发生顺序排。用 MySQL 或 PostgreSQL 替换默认数据库NocoBase 默认示例配置用的是 PostgreSQL开发阶段你也可以用 SQLite 起步。真正切换数据库不用改代码只动 .env.example 里的 DATABASE 段落。下面这段在干什么把方言改成 MySQL并配上连接信息注释标了每个字段的作用DB_DIALECTmysql # 方言postgres | mysql | mariadb | kingbase DB_HOSTlocalhost # 数据库地址 DB_PORT3306 # MySQL 默认端口 DB_DATABASEnocobase # 库名 DB_USERroot # 用户名 DB_PASSWORD # 密码改完重启yarn dev你会看到它用 MySQL 重新初始化表结构。生产环境再考虑把DB_POOL_MAX等连接池参数放开避免默认池在高并发下打满。把缓存从内存切到 Redis单机开发时缓存默认走内存CACHE_DEFAULT_STOREmemory多节点部署就必须换 Redis否则各节点状态不一致。配置里加一行就行CACHE_DEFAULT_STOREredis # 存储后端 CACHE_REDIS_URLredis://localhost:6379 # Redis 连接串重启后会话和临时缓存就落到 Redis 了你改任意一个节点的缓存其他节点也能读到。写第一个自定义插件插件是 NocoBase 扩展的核心一个插件就是一个独立子包独立加载、独立测试。最小骨架长这样load里做你的初始化这里注册一个集合import { Plugin } from nocobase/server; export default class MyPlugin extends Plugin { async load() { // 插件加载时执行在这里扩展集合 this.app.collectionManager.add({ name: orders, fields: [{ type: string, name: title }] }); } }把插件放进 packages/plugins/ 后重新yarn dev你就能在数据库里看到新建的orders表界面上也能建对应界面。插件的详细写法建议去读 docs/docs/cn/plugin-development/index.md 的入门章节。注入自定义中间件处理日志或鉴权想在每个请求前后塞逻辑打日志、校验 token、限流直接挂一个中间件即可不用碰框架内部app.use(async (ctx, next) { console.log(${ctx.request.method} ${ctx.request.url}); // 请求前打日志 await next(); // 放行 });跑起来后打开浏览器任意页面终端里会实时打印请求方法加 URL方便你定位接口调用。踩过的坑替你记着启动后访问首页报Not Found这个报错大概率是APP_ENVproduction了。生产模式下静态文件不走开发服务器得用 nginx 代理.env.example 注释里也写了这一点。开发阶段保持development就行。数据库连不上、报连接拒绝多半是DB_DIALECT和DB_PORT不匹配。PostgreSQL 默认 5432、MySQL 是 3306方言写错端口就会挂两个地方一起核对。装依赖反复失败先清缓存再强装yarn cache clean yarn install --force初始化账号没生效注意INIT_ROOT_EMAIL、INIT_ROOT_PASSWORD这类字段只在首次建库时读取改库名或删库重来才会重新应用改已存在的库不会覆盖管理员。收个尾到这里你应该能本地起服务、看懂集合到 API 的链路、并动手改数据库和插件了。接下来去读 docs/docs/cn/plugin-development/index.md 的写第一个插件章节照着把插件真正跑起来比继续看文档更有收获。【免费下载链接】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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考