全新安装

CloudDM 单机模式（Alone）将 Web 控制台、数据访问能力和内置元数据库运行在同一个容器中，适合试用、小规模使用和单节点自托管。

本页提供 Docker Run 和 Docker Compose 两种安装方式。每种方式均可选择海外镜像或国内镜像，两者的产品功能相同，请根据部署主机的网络环境选择其中一种。

前置条件

开始前请确认：

• 部署主机为 x86_64/amd64 或 arm64 架构。
• 已安装 Docker Engine；使用 Compose 时还需安装 Docker Compose v2。
• 8222 端口未被占用，并已在防火墙或云安全组中放行。
• 当前主机上不存在名为 cgdm-alone 的容器。

Docker 启动

海外镜像

docker run -d --name cgdm-alone \
  --restart always \
  -p 8222:8222 \
  -v cgdm_alone_conf:/root/cgdm/alone/conf \
  -v cgdm_alone_logs:/root/cgdm/alone/logs \
  -v cgdm_alone_data:/root/cgdm/alone/data \
  -v cgdm_mysql_data:/var/lib/mysql \
  bladepipe/cgdm-alone:latest

国内镜像

docker run -d --name cgdm-alone \
  --restart always \
  -p 8222:8222 \
  -v cgdm_alone_conf:/root/cgdm/alone/conf \
  -v cgdm_alone_logs:/root/cgdm/alone/logs \
  -v cgdm_alone_data:/root/cgdm/alone/data \
  -v cgdm_mysql_data:/var/lib/mysql \
  cloudcanal-registry.cn-shanghai.cr.aliyuncs.com/clougence/cgdm-alone:latest

Docker Compose 启动

海外镜像

services:
  dm_alone:
    image: bladepipe/cgdm-alone:latest
    container_name: cgdm-alone
    restart: always
    ports:
      - "8222:8222"
    volumes:
      - cgdm_alone_conf:/root/cgdm/alone/conf
      - cgdm_alone_logs:/root/cgdm/alone/logs
      - cgdm_alone_data:/root/cgdm/alone/data
      - cgdm_mysql_data:/var/lib/mysql

volumes:
  cgdm_alone_conf:
  cgdm_alone_logs:
  cgdm_alone_data:
  cgdm_mysql_data:

国内镜像

services:
  dm_alone:
    image: cloudcanal-registry.cn-shanghai.cr.aliyuncs.com/clougence/cgdm-alone:latest
    container_name: cgdm-alone
    restart: always
    ports:
      - "8222:8222"
    volumes:
      - cgdm_alone_conf:/root/cgdm/alone/conf
      - cgdm_alone_logs:/root/cgdm/alone/logs
      - cgdm_alone_data:/root/cgdm/alone/data
      - cgdm_mysql_data:/var/lib/mysql

volumes:
  cgdm_alone_conf:
  cgdm_alone_logs:
  cgdm_alone_data:
  cgdm_mysql_data:

启动

执行如下命令启动即可：

docker compose up -d

环境变量

环境变量	默认值	说明
APP_WEB_PORT	8222	Web 服务端口；修改后需同步调整容器端口映射。
APP_WEB_JWT	镜像内置值	Web 登录使用的 JWT 签名密钥。
APP_SERVE_NAME	127.0.0.1	CloudDM 内部服务地址。
APP_SERVE_PORT	8008	CloudDM 内部服务端口。
MYSQL_EMBEDDED	true	是否启用容器内置 MySQL；使用外部 MySQL 时设置为 false。
MYSQL_ROOT_PASSWORD	123456	内置 MySQL 的 root 密码。
MYSQL_DATADIR	/var/lib/mysql	内置 MySQL 的数据目录。
MYSQL_SOCKET	/run/mysqld/mysqld.sock	内置 MySQL 的 Socket 文件路径。
MYSQL_PID_FILE	/run/mysqld/mysqld.pid	内置 MySQL 的 PID 文件路径。
MYSQL_INIT_MARKER	$MYSQL_DATADIR/.clouddm_mysql_initialized	内置 MySQL 的初始化标记文件路径。
DB_HOST	127.0.0.1	元数据库地址。
DB_PORT	3306	元数据库端口。
DB_DATABASE	cdmgr	元数据库名称。
DB_USERNAME	root	元数据库账号。
DB_PASSWORD	与 MYSQL_ROOT_PASSWORD 相同	元数据库密码。
WAIT_DB_TIMEOUT_SECONDS	120	等待元数据库就绪的超时时间，单位为秒。
WAIT_MYSQL_STOP_SECONDS	30	等待内置 MySQL 停止的超时时间，单位为秒。

信息

• 所有环境变量均为可选。
• Docker：启动时通过 -e 变量名=值 配置。
• Docker Compose：启动时在 environment 中配置。