5分钟快速搭建私有区块链，基于Docker的轻量实操指南|欧逸web3下载-欧亿数字货币

对于区块链学习者、DApp开发者或者需要搭建内部区块链场景的企业来说，从零搭建一条私有链往往要处理版本兼容、环境依赖、配置冲突等一堆问题，原本简单的测试需求被繁琐的环境配置拖慢节奏，而Docker的容器化能力刚好解决了这个痛点：环境隔离、一键部署、数据可持久化，哪怕是新手也能快速跑出一条可用的私有区块链。

前期准备

你只需要提前在本地或服务器装好Docker即可,Docker Compose可用于后续多节点场景，也建议提前装好，安装完成后执行命令验证：

docker -v
docker compose version

输出版本号即代表环境准备完成,本文我们以目前最常用的以太坊私有链为例，基于Geth（Go-Ethereum）客户端搭建，全程不需要本地安装Geth，所有环境都由Docker镜像托管。

分步实操：单节点私有链搭建

拉取官方Geth镜像

直接从Docker Hub拉取官方维护的Geth镜像，省去编译打包的步骤：

docker pull ethereum/client-go:latest

编写创世块配置文件

私有链需要自定义创世块（链的初始状态），我们先在本地创建一个工作目录，再新建genesis.json配置文件：

mkdir -p ~/private-chain && cd ~/private-chain
vi genesis.json

填入以下配置,其中chainId自定义为不与公链冲突的数值，难度调到很低保证私有链出块速度，可提前给预留账户分配初始代币：

{
  "config": {
    "chainId": 12345,
    "homesteadBlock": 0,
    "eip150Block": 0,
    "eip155Block": 0,
    "eip158Block": 0
  },
  "difficulty": "0x20000",
  "gasLimit": "0x8000000",
  "alloc": {
    "你预留的账户地址": {
      "balance": "0x100000000000000000000"
    }
  }
}

初始化私有链

用Docker挂载本地工作目录,完成创世块初始化，数据会持久化保存在本地，容器删除也不会丢失：

docker run -it -v ~/private-chain:/root/.ethereum ethereum/client-go init /root/.ethereum/genesis.json

输出Successfully wrote genesis state即代表初始化完成。

启动私有链节点

执行以下命令启动节点,映射RPC端口供外部DApp、MetaMask连接：

docker run -d --name my-private-chain \
  -v ~/private-chain:/root/.ethereum \
  -p 8545:8545 -p 30303:30303 \
  ethereum/client-go \
  --networkid 12345 --http --http.addr 0.0.0.0 \
  --http.api eth,net,web3,personal --allow-insecure-unlock

验证节点运行

进入Geth控制台验证链是否正常运行：

docker exec -it my-private-chain geth attach http://localhost:8545

在控制台输入eth.blockNumber，输出当前块高度，再输入miner.start()开始挖矿，等待十几秒后再次查询块高度，数值上涨即代表私有链正常运行，后续你可以直接用MetaMask添加这个本地私有链，导入预留账户使用。

进阶：多节点私有链一键编排

如果需要测试多节点共识场景,只用写一个简单的docker-compose.yml就能一键启动多个节点：

version: '3'
services:
  node1:
    image: ethereum/client-go
    ports:
      - "8545:8545"
      - "30303:30303"
    volumes:
      - ./node1:/root/.ethereum
    command: --networkid 12345 --http --http.addr 0.0.0.0 --http.api eth,net,web3
  node2:
    image: ethereum/client-go
    ports:
      - "8546:8545"
      - "30304:30303"
    volumes:
      - ./node2:/root/.ethereum
    command: --networkid 12345 --http --http.addr 0.0.0.0 --http.api eth,net,web3

执行docker compose up -d就能一键启动两个节点，后续新增节点只需要修改配置文件即可，比原生部署效率提升数倍。