Linux下安装配置Budbase教程

本文详解在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 看起来方便，但实际暴露两个硬伤：

• budi CLI 默认绑定 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学习网公众号了解相关技术文章。