Linux环境下搭建以太坊私有链完全指南

搭建Linux以太坊私有链前的准备工作

1. Linux系统：推荐使用Ubuntu 20.04/22.04 LTS等稳定版本,本文以Ubuntu为例。
2. 安装必要工具：

   sudo apt update
   sudo apt install -y build-essential curl git software-properties-common

3. Go环境：以太坊客户端（如Geth）是用Go语言开发的，需要安装Go，建议安装1.19或更高版本。

   # 下载Go（以1.21.0为例，请根据实际情况选择版本）
   wget https://go.dev/dl/go1.21.0.linux-amd64.tar.gz
   sudo tar -C /usr/local -xzf go1.21.0.linux-amd64.tar.gz
   # 配置环境变量
   echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
   source ~/.bashrc
   # 验证安装
   go version

4. 安装Geth：Geth（Go-Ethereum）是最常用的以太坊客户端之一。

   # 通过PPA安装（推荐，方便后续更新）
   sudo add-apt-repository -y ppa:ethereum/ethereum
   sudo apt update
   sudo apt install -y ethereum
   # 或者从源码编译（获取最新功能）
   # git clone https://github.com/ethereum/go-ethereum.git
   # cd go-ethereum
   # make geth
   # 验证安装
   geth version

初始化创世区块

私有链的第一个步骤是创建创世区块（Genesis Block）,它定义了私有链的初始参数和规则。

1. 创建创世区块配置文件： 在你的用户目录下创建一个名为private_chain的文件夹，并在其中创建一个genesis.json文件。

   mkdir ~/private_chain
   cd ~/private_chain
   nano genesis.json

2. 编写创世区块配置内容： 在genesis.json文件中填入以下内容（这是一个简单的PoA（权威证明）创世配置示例）：

   {
     "config": {
       "chainId": 12345,               // 私有链ID，确保与公有链不冲突
       "homesteadBlock": 0,
       "eip150Block": 0,
       "eip155Block": 0,
       "eip158Block": 0,
       "byzantiumBlock": 0,
       "constantinopleBlock": 0,
       "petersburgBlock": 0,
       "istanbulBlock": 0,
       "berlinBlock": 0,
       "londonBlock": 0,
       "mergeNetsplitBlock": 0,
       "ethash": {},
       "clique": {                     // 使用Clique共识算法，适合私有链
         "period": 15,                  // 出块时间（秒）
         "epoch": 30000,                // 每轮投票的区块数
         "blocktime": 15
       }
     },
     "nonce": "0x0000000000000042",
     "timestamp": "0x0",
     "extraData": "0x0000000000000000000000000000000000000000000000000000000000000000", // 初始矿工地址可以稍后指定
     "gasLimit": "0xffffffff",
     "difficulty": "0x4000",          // 初始难度，私有链可以设置较低
     "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
     "coinbase": "0x0000000000000000000000000000000000000000", // 初始矿工地址
     "alloc": {}                      // 预分配的账户，留空后续手动创建
   }

   • chainId：私有链的唯一标识符。
   • clique：指定使用Clique共识算法，这是以太坊针对私有链和小型联盟链设计的PoA算法，不需要挖矿,由授权节点轮流出块。
   • difficulty：初始难度,私有链可以设置较低值以便快速出块。
   • alloc：可以在这里预分配一些以太币给指定地址，但为了灵活性,我们选择后续手动创建和转账。

初始化创世区块并启动节点

1. 初始化创世区块： 使用geth的init命令，指定刚才创建的genesis.json文件。

   geth --datadir ~/private_chain_data init ~/private_chain/genesis.json

   执行后，会在~/private_chain_data目录下创建geth、keystore等文件夹,用于存储链数据和账户信息。

2. 启动第一个节点（创世节点）：

   geth --datadir ~/private_chain_data --networkid 12345 --nodiscover --rpc --rpcaddr "0.0.0.0" --rpcport 8545 --rpcapi "db,eth,net,web3,personal" --miner.threads 1 --mine --unlock 0 --password password.txt

   • --datadir：指定数据存储目录。
   • --networkid：与genesis.json中的chainId保持一致。
   • --nodiscover：禁止自动发现其他节点,因为是私有链。
   • --rpc：启用HTTP-RPC服务。
   • --rpcaddr "0.0.0.0"：允许任何IP访问RPC服务（生产环境请谨慎设置）。
   • --rpcport 8545：RPC服务端口,默认8545。
   • --rpcapi：暴露给RPC的API接口。
   • --mine：开启挖矿模式。
   • --miner.threads 1：挖矿线程数,根据CPU核心数调整。
   • --unlock 0：解锁账户，0表示keystore中的第一个账户。
   • --password password.txt：指定解锁账户的密码文件，请先创建一个password.txt为你的账户密码。

   启动后，节点会开始同步创世区块，并开始挖矿，你会看到类似“Mining started”的输出。

添加更多节点（可选，构建多节点私有链）

如果需要构建多节点的私有链（模拟联盟链）,可以在其他Linux机器或同一台机器的不同端口上进行操作。

1. 在其他节点上初始化相同的创世区块： 确保其他节点上的genesis.json文件与第一个节点完全一致。

   geth --datadir ~/private_chain_data_node2 init ~/private_chain/genesis.json

2. 启动其他节点并连接到创世节点：

   geth --datadir ~/private_chain_data_node2 --networkid 12345 --nodiscover --rpc --rpcaddr "0.0.0.0" --rpcport 8546 --rpcapi "db,eth,net,web3,personal" --bootnodes "enode://<创世节点的enode地址>@<创世节点IP>:30303"

   • --bootnodes：指定创世节点的enode地址，用于加入网络，如何获取创世节点的enode地址？ 在创世节点控制台（按Ctrl+C停止挖矿，然后输入console进入）中输入：

     admin.nodeInfo.enode

     输出类似：`enode://a