CloudBeaver 快速搭建指南：Web 数据库管理平台部署

第二步：配置与启动

核心配置详解

CloudBeaver 的主要配置文件位于 config/core/cloudbeaver.conf，包含以下关键参数：

启动服务

根据你的部署方式选择相应的启动命令：

Docker 方式：

# 服务已在后台运行，直接访问即可

源码方式：

# 使用内置启动脚本
./deploy/scripts/run-cloudbeaver-server.sh

第三步：验证与使用

访问验证

1. 打开浏览器，访问：http://localhost:8978
2. 首次登录使用默认账号：admin / admin
3. 成功看到 Web 管理界面

首次使用指南

登录后，你可以开始：

1. 添加数据库连接：点击'新建连接'，选择数据库类型
2. 配置连接参数：输入主机、端口、用户名、密码
3. 开始管理：浏览数据库对象、执行 SQL 查询、导出数据

个性化配置

安全配置建议

为了保障系统安全，建议进行以下配置：

// 在 cloudbeaver.conf 中添加
sm: {
  enableBruteForceProtection: true,
  maxFailedLogin: 10,
  passwordPolicy: {
    minLength: 8,
    requireMixedCase: true
  }
}

性能优化配置

根据你的服务器配置调整性能参数：

database: {
  pool: {
    minIdleConnections: 4,
    maxConnections: 100
  }
}

常见问题解决

端口冲突

如果 8978 端口被占用，修改配置文件中的端口号：

server: {
  serverPort: "8080" // 修改为你可用的端口
}

内存不足

如果遇到内存问题，在启动脚本中添加 JVM 参数：

# 在启动命令中添加
java -Xmx2g -Xms1g -jar cloudbeaver-server.jar

使用技巧分享

高效工作流

1. 连接分组：按项目或环境对数据库连接进行分组管理
2. SQL 模板：创建常用的 SQL 查询模板，提高工作效率
3. 数据导出：定期导出重要数据，做好备份工作

最佳实践

• 定期备份：workspace 目录包含所有配置数据，建议定期备份
• 权限控制：生产环境务必修改默认密码，启用 HTTPS
• 监控日志：关注日志文件，及时发现并解决问题

开始你的数据库管理之旅

恭喜！通过以上步骤，你已经成功搭建了 CloudBeaver 云数据库管理平台。现在你可以：

• 添加多个数据库连接，实现统一管理
• 通过 Web 界面执行 SQL 查询，查看数据结果
• 导出导入数据，方便数据迁移和备份

CloudBeaver 将为你提供一个强大而便捷的数据库管理体验。