Budibase 一体化 Docker 镜像文档

1. 镜像概述和主要用途

Budibase 一体化 Docker 镜像是一个集成了所有必要服务的单镜像解决方案，旨在提供便捷的 Budibase 部署体验。该镜像预装了运行 Budibase 所需的全部组件，无需单独配置和部署各个服务，简化了从环境搭建到应用运行的全流程。

2. 核心功能和特性

2.1 预装服务组件

• CouchDB：单节点部署，作为 Budibase 核心服务的数据存储引擎，负责存储应用元数据、用户信息等核心数据。
• MinIO：轻量级对象存储服务，用于 Budibase 应用的文件存储需求，如附件、图片等资源管理。
• Redis：高性能缓存数据库，用于提升 Budibase 服务的响应速度和整体性能，优化数据访问效率。
• Budibase 服务：包含 Budibase 应用服务和工作节点服务，提供应用构建、运行及任务调度等核心功能，与 Kubernetes 和 Docker Compose 部署模式中的服务组件一致。

3. 使用场景和适用范围

3.1 适用场景

• 快速部署测试：无需复杂配置，快速搭建 Budibase 测试环境，验证功能特性。
• 个人/小型团队使用：适合个人开发者或小型团队，简化基础设施管理，专注于应用开发。
• 简化部署需求：对于无需分布式架构或多节点扩展的场景，提供开箱即用的单镜像解决方案。

4. 使用方法和配置说明

4.1 Docker CLI 快速部署

通过以下命令可快速启动 Budibase 一体化镜像：

docker run -d -t \
  --name=budibase \
  -p ***:80 \
  -v /local/path/data:/data \
  --restart unless-stopped \
  budibase/budibase:latest

参数说明：

• -d -t：后台运行容器并分配伪终端，确保服务持续运行。
• --name=budibase：指定容器名称为 budibase，便于管理。
• -p ***:80：端口映射，将主机的 *** 端口映射到容器的 80 端口（Budibase 服务默认端口）。
• -v /local/path/data:/data：数据卷挂载，将主机的 /local/path/data 目录（需替换为实际绝对路径）挂载到容器的 /data 目录，用于持久化存储 CouchDB 数据和 MinIO 文件。
• --restart unless-stopped：容器重启策略，除非手动停止，否则容器退出时自动重启。
• budibase/budibase:latest：使用 Budibase ***最新版本镜像。

4.2 访问方式

容器启动后，通过浏览器访问 http://localhost:*** 即可进入 Budibase 应用界面。

4.3 数据持久化注意事项

• 数据卷路径：/local/path/data 必须替换为宿主机器的绝对路径（如 /home/user/budibase-data），确保数据在容器重启或重建后不丢失。
• 权限配置：若宿主机器目录权限不足，可能导致容器无法写入数据，建议提前创建目录并赋予适当权限（如 mkdir -p /local/path/data && chmod 777 /local/path/data，生产环境需遵循最小权限原则）。

4.4 更多配置参考

如需高级配置（如自定义端口、环境变量调整等），请参考 Budibase 文档：[]