簡介

在區塊鏈應用的開發與運維過程中，如何高效地管理鏈節點、智能合約以及權限配置，是開發者們普遍面臨的挑戰。為了解決這一問題，長安鏈（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

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 -d
# 或
podman-compose up -d

注：磁盤不足報錯（磁盤至少要留有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

• 查看容器日志

podman logs -f chainmaker-node

訂閱區塊鏈

部署合約

下載示例合約

部署示例合約

投票管理

文件哈希存證

查找存證信息

區塊鏈瀏覽器