exoplatform/cloudbeaver

Cloudbeaver (托管/验收环境版) Docker镜像文档

镜像概述

Cloudbeaver是一款Web-based数据库管理工具，本Docker镜像针对托管环境（Hosting）和验收环境（Acceptance）优化，提供开箱即用的数据库访问与管理能力。支持多类型数据库统一管理，通过Web界面实现便捷的查询执行、数据可视化及团队协作，适用于团队在应用部署前对数据库进行验证、配置与协作管理，简化跨环境数据库操作流程。

核心功能与特性

• 多数据库兼容：支持MySQL、PostgreSQL、Oracle、SQL Server、MongoDB等主流数据库系统，满足多样化数据管理需求。
• Web化访问：无需安装本地客户端，通过浏览器即可访问，支持跨平台（Windows/macOS/Linux）及移动设备使用。
• 团队协作与权限控制：支持多用户角色配置，可按职责分配数据库操作权限（如只读、读写、管理员），确保数据安全。
• 高效查询工具：集成SQL编辑器（语法高亮、自动补全）、查询执行计划分析及结果导出（CSV/Excel/JSON）功能。
• 环境隔离设计：针对托管/验收环境优化，支持与生产环境数据隔离，避免验证操作影响实际业务数据。
• 数据持久化：支持通过数据卷挂载保存配置信息、用户数据及数据库连接配置，确保容器重启后数据不丢失。

使用场景与适用范围

• 托管环境数据库集中管理：在云托管或服务器托管场景中，统一管理多实例数据库，简化远程访问与维护。
• 验收测试阶段验证：部署前通过验收环境验证数据库结构、数据完整性及查询性能，降低上线风险。
• 团队协作操作：支持开发、测试、运维团队协同操作数据库，便于问题排查与数据验证。
• 跨平台数据库访问：为不同操作系统用户提供统一Web入口，消除客户端适配成本。
• 临时环境快速部署：可快速启动实例用于临时验证或演示，使用后便捷销毁，资源占用低。

使用方法与配置说明

基本部署（Docker Run）

通过以下命令启动容器，映射默认端口并挂载数据卷持久化配置：

bash
docker run -d \
  --name cloudbeaver-acceptance \
  -p 8978:8978 \
  -v cloudbeaver_data:/opt/cloudbeaver/workspace \
  docker.xuanyuan.run/dbeaver/cloudbeaver:latest

• -d：后台运行容器
• --name：指定容器名称（示例：cloudbeaver-acceptance）
• -p 8978:8978：映射容器内8978端口至主机，用于Web访问
• -v cloudbeaver_data:/opt/cloudbeaver/workspace：挂载数据卷保存配置、用户数据及数据库连接信息

Docker Compose配置

创建docker-compose.yml实现更灵活的部署：

yaml
version: '3.8'
services:
  cloudbeaver:
    image: docker.xuanyuan.run/dbeaver/cloudbeaver:latest
    container_name: cloudbeaver-acceptance
    ports:
      - "8978:8978"  # Web访问端口映射
    volumes:
      - cloudbeaver_data:/opt/cloudbeaver/workspace  # 持久化数据卷
    environment:
      - CB_SERVER_PORT=8978  # 自定义Web服务端口（默认8978）
      - CB_AUTH_TYPE=local    # 认证类型：local（本地用户）或ldap（LDAP集成）
      - CB_SESSION_TIMEOUT=3600  # 会话超时时间（秒，默认3600）
    restart: unless-stopped  # 容器退出时自动重启（除非手动停止）

volumes:
  cloudbeaver_data:  # 声明持久化数据卷

启动服务：

bash
docker-compose up -d

配置参数说明

环境变量

数据持久化

容器工作区目录（/opt/cloudbeaver/workspace）存储用户配置、数据库连接信息、查询历史等关键数据，必须通过数据卷或主机目录挂载持久化，避免容器重建后数据丢失。

访问与初始化

1. 启动容器后，通过浏览器访问 http://<主机IP>:8978 进入Web界面。
2. 首次登录使用默认管理员账户：用户名 admin，密码 admin，登录后建议立即修改密码（路径：设置 > 用户管理）。
3. 添加数据库连接：点击连接 > 新建连接，选择数据库类型（如MySQL），填写连接信息（主机、端口、用户名、密码），保存后即可开始管理数据库。

注意事项

• 安全性：验收环境建议限制访问IP（如通过防火墙），生产环境需启用强认证（如LDAP）并定期更新密码。
• 性能优化：大数据量查询场景可通过--memory参数调整容器内存限制（如--memory=2g）。
• 版本控制：生产环境建议指定具体版本号（如dbeaver/cloudbeaver:23.2.4），避免自动更新导致兼容性问题。