Budibase 开源低代码平台技术指南核心功能、自托管部署与 Lerna Monorepo 架构解析【免费下载链接】budibaseAI agents, automations and apps that run your operations. Model agnostic.项目地址: https://gitcode.com/GitHub_Trending/bu/budibaseBudibase 是一款开源的低代码平台面向开发者与 IT 专业人员目标是让团队在自有基础设施上、于几分钟内构建并自动化出定制化的业务工具。本文以仓库 i18n/README.kr.md项目主 README 的韩文版为核心骨架结合仓库内的部署配置与源码实现系统梳理 Budibase 的功能特性、五种自托管部署路径、核心环境变量以及其 Lerna 管理的单仓库Monorepo源码结构。读完本文你将掌握 Budibase 的选型判断依据、实际部署参数以及从源码层面理解Builder 设计 → Client 渲染 → Server 提供 API的完整运行链路。Budibase 是什么按 i18n/README.kr.md 的定位描述Budibase 是可以在自有基础设施上、几分钟内构建定制化业务工具的开源低代码平台。它与一般表单类工具的关键差异在于它面向开发者与 IT 专业人员不是纯业务人员玩具源码完全开放它不仅能搭界面还能构建**高性能单页应用SPA**并具备响应式设计能力它同时覆盖应用构建、流程自动化、AI Agent 与运维管理项目描述将其概括为 AI agents, automations and apps that run your operations, model agnostic模型无关的 Agent、自动化与应用。从仓库结构可以印证这一点builder设计器、client浏览器端渲染器、serverKoa 服务端、worker后台任务、automations自动化引擎等多个包协同组成一个完整平台而不是单一的前端模板工具。核心功能特性1. 构建真正的软件高性能 SPA 与响应式设计Budibase 构建出的应用是高性能单页应用且默认采用响应式设计可以为用户提供良好的跨设备体验。这一能力由 packages/client 承担——它是一个运行在浏览器中的模块负责读取应用的 JSON 定义并翻译成活生生的 Web 应用源码见 packages/client/package.json构建产物为dist/budibase-client.js入口指向 packages/client/src/index.ts。需要特别指出的是i18n/README.kr.md 中packages/client的描述与packages/builder相同包含 builder 客户端 Svelte 应用代码这属于翻译偏差对照英文主 README 的准确表述client 的职责是在浏览器端读取 JSON 定义并渲染出可交互的 Web 应用而 builder 才是设计时design-time的 Svelte 应用。2. 开源与可扩展GPL v3 许可下的完全掌控Budibase 以GPL v3许可证开源。这意味着你可以放心依赖它——源码永远伴随你不会被单方面收回你可以在 GPL v3 约束下自由 fork 源码进行修改或直接向项目提交贡献项目对开发者友好允许按需定制。仓库内各包的package.json也印证了许可证策略packages/builder/package.json 与 packages/server/package.json 均为GPL-3.0而 packages/client/package.json 为MPL-2.0详情见下文许可证一节。3. 连接现有数据或从零开始Budibase 支持从多种外部数据源接入数据README 中列出的包括MongoDB、CouchDB、PostgreSQL、MySQL、Airtable、S3、DynamoDB、REST API。如果你不想引入外部工具也可以完全不依赖外部数据源直接使用 Budibase 内置能力从零构建应用。这一清单在 packages/server/package.json 的依赖中可以得到完整印证——服务端为上述每种数据源都集成了对应的驱动/客户端数据源依赖说明MongoDBmongodb文档数据库CouchDBbudibase/nanoBudibase 主存储内置 CouchDB 镜像见 hosting/couchdbPostgreSQLpg关系型数据库MySQLmysql2关系型数据库Airtableairtable在线表格服务S3aws-sdk/client-s3等对象存储DynamoDBaws-sdk/client-dynamodbAWS 文档数据库REST API内置 HTTP 集成通用 REST 接口此外服务端还扩展支持了 MSSQL、Snowflake、Oracle、ArangoDB、Google Sheets、Elasticsearch、Firestore 等同一文件可查集成实现代码集中在 packages/server/src/integrations。4. 强大的内置组件与 CSS 定制Budibase 内置一组经过精心设计的组件可用于快速搭建 UI同时提供丰富的CSS 样式定制选项支持更自由的创意表达。组件体系的底层实现是 packages/bbui 组件库包含 Accordion、Table、Modal、Form、Tooltip 等几十类组件builder 与 client 均依赖它。5. 自动化、外部工具集成与 WebhookBudibase 可以把工作流和手动流程自动化从而节省时间。从 Webhook 事件连接到邮件自动化只要告诉 Budibase 要做什么它就会自动执行。仓库中对应的自动化引擎实现位于 packages/server/src/automations包含百余个自动化相关模块文件自动化逻辑定义则沉淀在 packages/shared-core/src/automations 与 packages/types/src/documents 中。6. 集成你偏好的工具Budibase 集成了多种工具让应用构建可以贴合团队已有工具栈——这部分对应上文表格中的数据源/外部服务集成体系。7. 管理员的乐园规模化自托管与统一治理Budibase 对任意规模的项目都保持弹性你可以在个人或组织的服务器上自托管并集中管理用户与入职onboarding流程SMTP 邮件服务应用与分组groups主题theming此外你还可以向用户/分组提供应用门户app portal并把用户管理权下放给分组管理员group manager——这是典型的租户化、多级授权治理模式。快速开始五种自托管方式与云托管Budibase 支持在自有基础设施上通过Docker、Kubernetes、Digital Ocean等方式部署也可以直接使用Budibase Cloud无需自托管、快速上手。仓库中为每种方式都提供了真实的部署文件以下逐一说明。Docker 单镜像ARM 兼容README 特别标注该镜像为ARM 兼容的单镜像这在根 package.json 的构建脚本中可以得到验证# 单架构构建 ./scripts/build-single-image.sh # 多架构构建arm64 amd64 docker buildx build --platform linux/arm64,linux/amd64 \ -f hosting/single/Dockerfile -t budibase:latest .单镜像的 Dockerfile 位于 hosting/single/Dockerfile其内部把 nginx反向代理、Redis、MinIOS3 兼容对象存储、LiteLLMLLM 网关、CouchDB作为基础镜像与pm2多进程托管整合进一个容器对外暴露端口80/443Web与4000LiteLLM 配置面板数据目录挂载到/data卷。因此单镜像适合小型团队或边缘节点一条docker run即可拉起完整平台。Docker Compose多服务编排仓库根目录提供了生产级编排文件 hosting/docker-compose.yaml将平台拆分为 8 个可独立伸缩的服务服务镜像职责proxy-servicebudibase/proxynginx 网关对外暴露${MAIN_PORT}:10000含 Webhook 限流默认 10 req/s与 API 限流默认 50 req/sapp-servicebudibase/apps主应用服务端口4002worker-servicebudibase/worker后台/任务服务端口4003couchdb-servicebudibase/database:2.1.0CouchDB 数据库含 SQS 插件端口5984minio-serviceminio/minioS3 兼容对象存储端口9000/9001redis-serviceredis缓存与队列litellm-servicelitellm/litellm模型无关的 LLM 网关端口4000litellm-dbpostgres:16LiteLLM 元数据存储开发环境的等价编排见 hosting/docker-compose.dev.yaml。从中可以看出 Budibase 的运行时依赖全貌CouchDB持久化 MinIO文件/对象存储 Redis缓存队列 LiteLLMAI 网关。KubernetesHelm ChartKubernetes 部署通过 Helm Chart 提供位于 charts/budibase。Chart 元数据charts/budibase/Chart.yaml将自身定位为 low-code 平台应用并把couchdbHelm 依赖版本 4.5.6作为可选依赖通过services.couchdb.enabled条件控制是否随集群部署数据库。Chart 内包含 app-service、worker-service、proxy-service、automation-worker-service、redis-service、minio-service、litellm-service 等完整 Deployment/HPA/Service 模板以及 Ingress、Secrets、PDB 等生产要素见 charts/budibase/templates对应模板均有测试用例charts/budibase/tests。Digital Ocean仓库提供了 Digital Ocean 市场的镜像模板 hosting/digitalocean/template.json可通过 One-Click 方式在 Digital Ocean Droplet 上创建 Budibase 实例。Portainer仓库提供了 Portainer 应用模板 hosting/portainer/template.json可在 Portainer 面板中一键部署 Budibase 栈。Budibase Cloud如果不需要自托管、希望快速开始构建应用可以直接使用官方托管的 Budibase Cloud无需关心上述任何基础设施细节。自托管关键环境变量无论是 Docker Compose 还是单镜像部署启动前都需要准备一组环境变量在.env文件中定义。以下是 hosting/docker-compose.yaml 中出现的关键变量及默认行为变量用途默认值/说明MAIN_PORT对外访问端口映射到代理容器10000COUCH_DB_USER/COUCH_DB_PASSWORDCouchDB 凭据必填MINIO_ACCESS_KEY/MINIO_SECRET_KEYMinIO 对象存储凭据必填INTERNAL_API_KEY服务间内部 API 认证必填API_ENCRYPTION_KEY敏感数据加密密钥必填用于加密存储JWT_SECRETJWT 签名密钥必填REDIS_PASSWORDRedis 访问密码必填LITELLM_MASTER_KEYLLM 网关主密钥必填AI 功能BB_ADMIN_USER_EMAIL/BB_ADMIN_USER_PASSWORD初始管理员账号首次启动创建PASSWORD_MIN_LENGTH用户密码最小长度12PASSWORD_MAX_LENGTH用户密码最大长度512OFFLINE_MODE离线部署模式空关闭ENABLE_ANALYTICS匿名使用统计trueLOG_LEVEL日志级别info上述密钥类变量属于敏感配置务必妥善保管更换API_ENCRYPTION_KEY、JWT_SECRET等值会导致既有数据无法解密或会话失效应作为不可变部署参数处理。学习、社区与行为准则学习资料Budibase 的官方文档是学习入口仓库的 i18n 目录还提供了德、西、法、印尼、意、日、韩、葡、俄、中等多种语言的 READMEi18n/README.zh.md 为中文版便于非英语用户快速了解项目。社区用户可以通过 GitHub Discussions 提问、帮助他人、与其他 Budibase 用户交流。行为准则项目采用 Contributor Covenant v2.0全文见 docs/CODE_OF_CONDUCT.md要求社区成员保持相互尊重、包容无骚扰的环境。参与贡献从提交 Bug 报告到创建 Pull RequestBudibase 欢迎一切形式的贡献。README 给出两条关键指引先建 Issue 再动手如果你计划实现新功能或改动 API请先在 Issue 中提出以便维护者评估避免你的工作白费环境搭建指南完整的环境配置步骤见 docs/CONTRIBUTING.md。不知道从何开始README 推荐从First time issues这类入门级 Issue 入手。README 还提示若 builder 更新后遇到环境问题可参考 CONTRIBUTING 文档中的 Troubleshooting 部分清理环境。仓库结构Lerna 管理的单仓库Budibase 是一个由Lerna 管理的单仓库Monorepo。Lerna 负责各包的构建与发布并在每次变更时同步处理。仓库根目录的 lerna.json 采用independent版本策略包管理器为 yarn根 package.json 通过workspaces.packages声明packages/*为工作区并要求Node.js 22.18.0 且 23.0.0。README 从高层给出了构成 Budibase 的三大核心包包职责packages/builderBuilder设计器客户端侧 Svelte 应用代码即用户可视化设计应用的界面packages/client运行在浏览器端的模块读取 JSON 定义并渲染出可交互的 Web 应用packages/serverBudibase 服务端Koa 应用负责向 Builder 提供创建应用所需的支撑同时提供与数据库、文件存储交互的 API从源码看packages/server/src/index.ts 是服务端入口启动时先做开发环境校验再加载 packages/server/src/app.ts其依赖koa、koa-router、koa-body、socket.io、bull、ioredis等也印证了它作为 API 服务、实时通信与任务队列承载者的角色。除三大核心包外仓库还包含worker后台任务服务、backend-core共享后端基础设施、frontend-core前后端共享逻辑、shared-core类型与工具、bbui组件库、pro付费功能含独立 packages/pro/license.md 商业源码许可、cli、sdk、types、string-templates等包共同构成完整生态。许可证Budibase 本体以GPL v3开源客户端与组件库即你最终构建出的应用的运行时与 UI 组件部分采用MPLMozilla Public License 2.0授权——这意味着主平台代码遵循 GPL v3可 fork、可修改、可参与贡献见 packages/builder/package.json、packages/server/package.json你用 Budibase 构建出来的应用其许可证由你自行决定不会被 GPL 传染性条款束缚client 侧 packages/client/package.json 即标注为MPL-2.0。这一平台 GPL 产物友好的双许可证设计是 Budibase 在开源可扩展与用户应用自由之间取得平衡的关键也是评估其作为内部业务工具基座时的核心优势。总结Budibase 的价值主张可以概括为一句话在自有基础设施上用低代码方式同时获得应用构建、流程自动化和 AI Agent 能力且核心代码完全开源可控。从部署视角看它提供了单镜像、Docker Compose、Kubernetes、Digital Ocean、Portainer 五条自托管路径适配从单机到集群的各类规模从源码视角看Builder设计→ Client渲染→ ServerAPI 与数据的三层结构清晰配合 CouchDB MinIO Redis LiteLLM 的运行时组件构成了一个可深度定制、可水平扩展的业务自动化平台。【免费下载链接】budibaseAI agents, automations and apps that run your operations. Model agnostic.项目地址: https://gitcode.com/GitHub_Trending/bu/budibase创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考