CloudBeaver 는 DBeaver 를 기반으로 만든 웹 데이터베이스 관리 도구다. 서버를 Docker 컨테이너로 띄우고 브라우저로 접속해 여러 데이터베이스를 조회·편집한다. Community Edition(CE) 은 Apache 2.0 라이선스의 오픈소스이고, Enterprise · Team 등 상용판은 DBeaver 사가 따로 판다.
DBeaver 데스크톱과 같은 드라이버 정의(plugin.xml)를 쓰지만 distributed/multiuser 모드로 동작하므로, 드라이버 정의에 supportsDistributedMode="true" 가 없는 드라이버는 목록에 나오지 않는다. Hadoop 계열(Hive · Impala · Phoenix)과 OpenSearch 드라이버가 여기에 해당하며, 쓰려면 이미지를 직접 빌드해야 한다.
CE 는 GitHub 에 릴리스를 올리지 않고 Docker Hub 이미지 태그로 버전을 낸다. 현행은 26.2 계열이다.[1]
| 계열 | 이미지 태그 | 비고 |
|---|---|---|
| 26.2 | dbeaver/cloudbeaver:26.2.0 · latest |
현행 |
| 26.1 | dbeaver/cloudbeaver:26.1.5 |
이전 계열 |
| 25.x | — | 커스텀 드라이버 가이드를 작성할 때 기준으로 삼은 계열 |
| 항목 | 최소 | 비고 |
|---|---|---|
| OS | Linux (RHEL/Rocky 9, Ubuntu 22.04 이상) | Docker 가 도는 환경 |
| Docker | 20.10 이상 | docker version 으로 확인 |
| 메모리 | 2 GB 이상 | 서버 실행용 |
| 디스크 | 2 GB 이상 여유 | 이미지 빌드 시 |
| 웹 포트 | 8978/tcp | 기본값 |
| 구성 요소 | 역할 |
|---|---|
| 서버 | DBeaver 플랫폼 번들을 OSGi 로 올리고 GraphQL API 를 제공한다 |
| 웹 프론트엔드 | SQL 편집기 · 데이터 그리드 · 연결 관리 화면 |
| workspace 볼륨 | /opt/cloudbeaver/workspace — 서버 설정 · 연결 정보 · 사용자 자격증명이 저장된다 |
| 드라이버 번들 | drivers/<name> 디렉터리의 JDBC JAR. io.cloudbeaver.resources.drivers.base 플러그인이 활성 목록을 정한다 |
커스텀 드라이버가 필요 없으면 공식 이미지를 그대로 쓴다.
docker run -d --name cloudbeaver \
-p 8978:8978 \
-v cloudbeaver-workspace:/opt/cloudbeaver/workspace \
dbeaver/cloudbeaver:latest
| 설정 | 기본값 | 설명 |
|---|---|---|
| 웹 포트 | 8978 | http://<서버IP>:8978 로 접속 |
| 데이터 볼륨 | cloudbeaver-workspace |
설정 · 연결 정보 영구 저장 |
| 관리자 계정 | 최초 접속 시 생성 | 웹 UI 의 설정 마법사에서 만든다 |
브라우저로 접속하면 첫 화면에서 언어와 관리자 계정을 정하고, 이후 New Connection 으로 데이터베이스를 등록한다. workspace 볼륨을 지우면 설정과 연결 정보가 모두 초기화된다.
docker run 으로는 잘 뜨는 이미지가 Kubernetes 에서…최신 버전 26.2.0 — 2026-09-20 확인. https://hub.docker.com/r/dbeaver/cloudbeaver/tags ↩︎