Linux下安装配置Budbase教程
2026-04-24 22:25:12
0浏览
收藏
本文详解在Linux系统上正确部署Budibase低代码平台的实战要点,直击新手易踩的四大陷阱:必须依赖Docker而非apt/yum或npm全局安装,避开Node.js版本冲突与SQLite并发瓶颈;精准配置docker-compose路径、权限与环境变量,规避日志丢失、容器退出和502错误;通过多容器状态诊断快速定位postgres、redis、budibase_server及envoy启动失败根源;并揭示首次登录后无法进入设计界面的元凶——Envoy反向代理中allowed_origins配置缺失HTTPS协议或具体域名。全文以问题驱动,每一步都对应真实生产场景中的“卡点”,助你一次成功跑通稳定可用的Budibase平台。

Budibase 在 Linux 上不能直接用 apt 或 yum 安装,必须走 Docker 部署路线;跳过 Docker 会卡在 Node.js 版本、依赖冲突、数据库初始化失败这三关。
为什么不用 npm 全局安装 @budibase/cli 做生产部署
本地开发时跑 budi hosting --init 看起来方便,但实际暴露两个硬伤:
budiCLI 默认绑定 SQLite,无法支撑多用户并发或真实业务数据量,上线后大概率触发SQLITE_BUSY错误- 它不自动拉起 PostgreSQL / Redis 容器,所有服务得手动补全,配置文件散落在
hosting/下多个子目录,改错一个路径(比如把postgres_data写成pg_data)就会导致docker-compose up启动后立即退出 - CLI 生成的
docker-compose.yaml缺少健康检查和重启策略,容器挂了不会自恢复,不适合长期运行
必须用官方 docker-compose.yaml 启动,但要注意三个路径陷阱
群晖、Ubuntu Server、CentOS Stream 这些环境执行 curl 下载配置时,容易因路径权限或拼写出错白忙活:
- 创建目录必须用
mkdir -p /volume2/docker/budibase(群晖)或mkdir -p ~/budibase(通用),不能漏掉-p,否则logs子目录建不成功,日志全丢进容器内部,docker logs查不到错误 docker-compose.yaml里volumes段写的路径必须和你cd进入的目录一致,例如你cd /home/user/budibase,那 YAML 里就不能写./logs:/app/logs,得写/home/user/budibase/logs:/app/logs,否则日志目录映射失效hosting.properties中的BUDIBASE_HOST必须填你实际访问用的域名或 IP,比如内网用http://192.168.1.100:10000,填localhost会导致前端请求 502,因为 Envoy 反向代理认不出这个 host
docker-compose up -d 启动后打不开页面?先查这三个服务状态
不是所有容器都叫 budibase,Budibase 的 Docker Compose 实际启了至少 4 个容器,缺一不可:
- 运行
docker ps -a,确认postgres、redis、budibase_server、envoy全部是Up状态;如果postgres显示Restarting,大概率是postgres_data目录权限不对(需chown -R 991:991 postgres_data) - 用
docker logs budibase_server查有没有Migration failed或connect ECONNREFUSED,前者说明数据库没初始化完就启动了 server,后者说明postgres容器根本没起来或端口被占 - 用
curl -v http://localhost:10000/healthz测试 Envoy 是否转发正常;返回200 OK但浏览器打不开,基本是浏览器缓存了旧的localhost重定向,换隐身窗口或清 DNS 缓存再试
真正麻烦的不是启动,而是第一次登录后进不去「设计」界面——这时候八成是 envoy.yaml 里 allowed_origins 没加你当前访问的协议+域名,比如用了 HTTPS 就必须显式写 https://your-domain.com,只写 * 在新版 Envoy 会被拒绝。
文中关于Linux的知识介绍,希望对你的学习有所帮助!若是受益匪浅,那就动动鼠标收藏这篇《Linux下安装配置Budbase教程》文章吧,也可关注golang学习网公众号了解相关技术文章。
Win11任务栏固定应用设置教程
- 上一篇
- Win11任务栏固定应用设置教程
- 下一篇
- HTML5通知开启方法及操作步骤
查看更多
最新文章
-
- 文章 · linux | 23小时前 | 命令行 · Linux · Linux util-linux lsclocks --noheadings 时钟列表
- Linux lsclocks --noheadings 怎样移除时钟列表的标题行
- 277浏览 收藏
-
- 文章 · linux | 23小时前 | Linux · Linux findmnt --list-columns --output
- Linux findmnt --list-columns 怎样查询当前版本支持的输出列
- 359浏览 收藏
-
- 文章 · linux | 1天前 |
- Linux find -ignore_readdir_race 怎样处理遍历期间被删除的文件
- 466浏览 收藏
-
- 文章 · linux | 1天前 | 命令行 · Linux · 运维排查 · Linux 文件描述符 Name util-linux lsfd --notruncate
- Linux lsfd --notruncate 怎样完整输出过长的文件描述符属性列
- 100浏览 收藏
-
- 文章 · linux | 1天前 | 命令行 · Linux · Linux 文件校验 cksum --tag --algorithm
- Linux cksum --tag 怎样输出带算法名称的校验记录
- 102浏览 收藏
-
- 文章 · linux | 1天前 | 命令行 · Linux · Linux 文本处理 cut 字段分隔符 --output-delimiter
- Linux cut --output-delimiter 怎样在输出列之间使用新的分隔符
- 128浏览 收藏
查看更多
课程推荐
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
查看更多
AI推荐
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1124次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1112次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1283次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1226次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1076次使用
查看更多
相关文章
-
- Linux vmstat 如何分辨内存抖动与磁盘等待:si、so、wa 与复测顺序
- 2026-08-30 501浏览
-
- Linux搭建vsftpdFTP服务器教程
- 2026-04-30 501浏览
-
- Shell脚本安装教程:.sh一键安装指南
- 2026-03-16 501浏览
-
- Linux清空文件内容的几种方法
- 2025-12-01 501浏览
-
- Linux命令行下载文件技巧
- 2025-11-23 501浏览
