使用 Docker 安装长安链管理平台 + 部署长安链

简介

在区块链应用的开发与运维过程中，如何高效地管理链节点、智能合约以及权限配置，是开发者们普遍面临的挑战。为了解决这一问题，长安链（ChainMaker）提供了管理平台（Management Platform），它集成了后端服务、Web 管理界面以及数据库存储，为用户带来可视化、便捷化的操作体验。

通过管理平台，用户不仅能够完成链节点的配置和监控，还可以轻松进行合约部署、调用和日志查看，从而提升链上业务的开发效率与稳定性。

本文将以 容器化部署 的方式，介绍长安链管理平台的安装步骤。主要包括以下内容：

• 准备环境：安装 Docker/Podman、配置 Compose 工具；
• 启动数据库（MySQL）与管理服务：通过 docker-compose.yml 一键启动所需容器；
• 访问管理平台：在浏览器中打开管理界面，完成初始配置；
• 常见问题排查：如数据库连接失败、容器依赖异常等解决方法。

通过本文，您将能够快速完成长安链管理平台的安装与运行，并顺利进入可视化的链上管理界面，为后续的区块链应用开发和运维工作打下坚实的基础。

登录官网

• https://git.chainmaker.org.cn/users/sign_in

Github

• https://git.chainmaker.org.cn/chainmaker/management-backend
• https://git.chainmaker.org.cn/chainmaker/chainmaker-go
• https://git.chainmaker.org.cn/chainmaker/chainmaker-tools
• https://git.chainmaker.org.cn/chainmaker/chainmaker-docs

Podman 配置（Docker 配置 registry 地址）

• 安装 podman 与 podman-compose

vim ~/.config/containers/registries.conf

unqualified-search-registries = ["docker.io"][[registry]]
location = "docker.io"
insecure = false
blocked = false
mirror = [{location = "registry.aliyuncs.com", insecure = false},{location = "hub-mirror.c.163.com", insecure = false},{location = "registry.docker-cn.com", insecure = false},{location = "hub-dev.cnbn.org.cn", insecure = false}
][[registry]]
location = "quay.io"
insecure = false
mirror = [{location = "quay-mirror.qiniu.com", insecure = false}
]

vim ~/.config/containers/storage.conf

[storage]
driver = "overlay"
runroot = "/tmp/$USER/containers"
graphroot = "/Users/wufengsheng/.local/share/containers/storage"[storage.options]
additionalimagestores = [][storage.options.overlay]
mount_program = "/usr/bin/fuse-overlayfs"
mountopt = "nodev,fsync=0"
ignore_chown_errors = "true"
# 可选：限制容器可用空间（默认 10G）
size = "20G"

安装长安链管理平台

• 长安链官方文档

下载源码

• https://git.chainmaker.org.cn/chainmaker/management-backend

git clone -b v2.3.4 --depth=1 https://git.chainmaker.org.cn/chainmaker/management-backend.git

podman 配置

cd ~/.config/containers

• registries.conf

unqualified-search-registries = ["docker.io"][[registry]]
location = "docker.io"
insecure = false
blocked = false
mirror = [{location = "registry.aliyuncs.com", insecure = false},{location = "hub-mirror.c.163.com", insecure = false},{location = "registry.docker-cn.com", insecure = false},{location = "hub-dev.cnbn.org.cn", insecure = false}
][[registry]]
location = "quay.io"
insecure = false
mirror = [{location = "quay-mirror.qiniu.com", insecure = false}
]

• storage.conf

[storage]
driver = "overlay"
runroot = "/tmp/$USER/containers"
graphroot = "/Users/wufengsheng/.local/share/containers/storage"[storage.options]
additionalimagestores = [][storage.options.overlay]
mount_program = "/usr/bin/fuse-overlayfs"
mountopt = "nodev,fsync=0"
ignore_chown_errors = "true"
# 可选：限制容器可用空间（默认 10G）
size = "20G"

docker-compose.yml

cd management-backend

vim docker-compose.yml

注： 文件中需要加上 container_name ，没加可能会导致部署时连不上 cm_db 。

version: "3.9"services:cm_db:image: mysql:5.7container_name: cm_dbvolumes:- db_data:/var/lib/mysqlrestart: alwaysenvironment:MYSQL_ROOT_PASSWORD: Baec&chainmakerMYSQL_USER: chainmakerMYSQL_PASSWORD: Baec&chainmakerMYSQL_DATABASE: chainmaker_devcommand: ['mysqld', '--character-set-server=utf8mb4', '--collation-server=utf8mb4_unicode_ci', '--max_allowed_packet=200M']cm_mgmt_server:depends_on:- cm_dbimage: chainmakerofficial/management-backend:v2.3.4container_name: cm_mgmt_serverports:- "9999:9999"cm_mgmt_web:depends_on:- cm_mgmt_serverimage: chainmakerofficial/management-web:v2.3.4container_name: cm_mgmt_webports:- "8080:80"volumes:db_data: {}

• 将 cm_mgmt_web 的 80 端口改为 8080

• 部署管理平台

docker-compose up
# 或
podman-compose up

注：磁盘不足报错（磁盘至少要留有30G可用空间）

• 清理删除 podman 未使用的卷

podman volume ls
podman volume prune -f

• 用到的 Docker 镜像

登录管理平台

注：账号/密码（admin/a123456）

• http://localhost:8080/login

• 快速引导

• 证书账户

• 新建区块链

• 下载链配置文件

部署长安链

注：本文采用 ubuntu 镜像部署长安链。

Dockerfile

FROM ubuntu:20.04RUN apt-get update && apt-get install -y \curl \bash \p7zip-full \&& rm -rf /var/lib/apt/lists/*WORKDIR /chainmakerCMD ["bash", "start.sh"]

构建镜像

podman build -t chainmaker .

部署长安链

• 让容器保持运行状态

注：在解压后的链配置文件 release 目录 start.sh 末尾添加如下两行

...echo "ChainMaker nodes started successfully!"
tail -f /dev/null

• 部署长安链

podman run -d --name chainmaker-node \
-p 12301:12301 \
-p 12302:12302 \
-p 12303:12303 \
-p 12304:12304 \
-v $PWD/release:/chainmaker \
localhost/chainmaker:latest

• 查看容器日志

订阅区块链