以太坊私网搭建全指南,从零开始构建你的私有测试链

搭建以太坊私网前的准备

在开始搭建之前,你需要准备以下工具和环境：

1. 操作系统：Linux（如Ubuntu）、macOS或Windows（推荐WSL2），本文以Linux（Ubuntu为例）为主要演示环境。
2. 以太坊客户端：最常用的客户端是Geth（Go语言实现）或Parity（现OpenEthereum）,本文以Geth为例进行讲解。
3. 基本工具：Git（用于克隆代码）、Go（如果需要从源码编译Geth，通常推荐直接下载预编译二进制文件）。
4. 文本编辑器：用于修改配置文件，如Vim、Nano等。

你可以从Geth官方GitHub仓库下载适合你操作系统的预编译二进制文件,并将其添加到系统PATH中。

以太坊私网搭建步骤

初始化创世区块

私网需要一个独特的创世区块（Genesis Block），这是区块链的起点，我们需要创建一个创世配置文件（例如genesis.json）。

1. 创建一个目录用于存放私网相关文件，例如ethereum-private-net。

   mkdir ethereum-private-net
   cd ethereum-private-net

2. 创建genesis.json如下（这是一个基础的创世配置示例）：

   {
     "config": {
       "chainId": 12345,       // 私网唯一标识符，避免与主网及其他测试网冲突
       "homesteadBlock": 0,
       "eip150Block": 0,
       "eip155Block": 0,
       "eip158Block": 0,
       "byzantiumBlock": 0,
       "constantinopleBlock": 0,
       "petersburgBlock": 0,
       "istanbulBlock": 0,
       "berlinBlock": 0,
       "londonBlock": 0,
       "mergeNetsplitBlock": 0,
       "shanghaiTime": 0,
       "terminalTotalDifficulty": 0,
       "terminalTotalDifficultyPassed": true,
       "ethash": {}           // 如果使用PoW共识，需要配置ethash；PoS则不需要
     },
     "nonce": "0x0000000000000042",
     "timestamp": "0x0",
     "extraData": "0x0000000000000000000000000000000000000000000000000000000000000000",
     "gasLimit": "0x47b760", // 初始gas限制，可根据需要调整
     "difficulty": "0x40000", // 初始挖矿难度
     "mixHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
     "coinbase": "0x0000000000000000000000000000000000000000",
     "alloc": {}             // 预分配地址及其余额，可选
   }

   • chainId：非常重要,确保你的私网有唯一的ID。
   • ethash：这是以太坊主网和早期测试网使用的PoW工作量证明算法，对于私网，你也可以选择其他共识机制，如PoA（权威证明），但Geth默认支持ethash，如果使用PoA,可能需要额外的配置或使用其他客户端。
   • alloc：可以在这里预先分配一些地址和以太币,方便测试。

初始化数据目录

使用Geth的init命令来根据创世文件初始化数据目录：

geth --datadir "./data" init genesis.json

• --datadir：指定数据存储目录，这里我们创建了一个名为data的子目录，执行后，data目录下会生成geth和keystore等文件夹。

启动私网节点

现在可以启动私网节点了，根据你的需求,可以选择不同的启动方式：

简单启动（不挖矿）

geth --datadir "./data" --networkid 12345 --nodiscover --http --http.addr "0.0.0.0" --http.port "8545" --http.api "personal,eth,net,web3,miner"

• --datadir "./data"：指定数据目录。
• --networkid 12345：指定网络ID，与genesis.json中的chainId保持一致。
• --nodiscover：禁止节点自动发现其他节点，因为是私网,不需要发现公网节点。
• --http：启用HTTP-RPC服务,方便与DApp交互。
• --http.addr "0.0.0.0"：允许HTTP-RPC服务监听所有网络接口（注意安全风险，生产环境应限制访问）。
• --http.port "8545"：指定HTTP-RPC端口,默认是8545。
• --http.api：暴露的API接口，personal用于账户管理，eth用于以太坊相关操作，net用于网络信息，web3，miner等。

启动并开启挖矿（用于生成区块）

如果你需要让私网产生新的区块（例如测试交易）,需要开启挖矿。

geth --datadir "./data" --networkid 12345 --nodiscover --http --http.addr "0.0.0.0" --http.port "8545" --http.api "personal,eth,net,web3,miner" --miner.threads 1 --mine --etherbase "0xYourAllocatedAddress"

• --miner.threads 1：指定挖矿使用的线程数,私网单线程即可。
• --mine：开启挖矿模式。
• --etherbase "0xYourAllocatedAddress"：指定挖矿收益地址，这个地址应该在genesis.json的alloc中预分配过,或者在后续创建。

启动后，节点会开始尝试打包区块，由于是私网，难度较低,区块生成速度会较快。

连接到私网节点并进行交互

你可以使用多种方式连接到启动的私网节点：

1. Geth控制台（JavaScript Console）： 在另一个终端窗口，进入数据目录的父目录（或指定datadir）,运行：

   geth attach http://localhost:8545

   进入控制台后，可以使用Web3.js API与节点交互，

   // 查看当前区块号
   eth.blockNumber
   // 查看账户列表
   eth.accounts
   // 创建新账户
   personal.newPassword("account1", "yourpassword")
   // 解锁账户
   personal.unlockAccount(eth.accounts[0], "yourpassword")
   // 发送交易（需要解锁发送方账户，并指定足够的gas和gas price）
   // eth.sendTransaction({from: eth.accounts[0], to: "0xRecipientAddress", value: web3.toWei(1, "ether"), gas: 21000})

2. Remix IDE： 在浏览器中打开Remix IDE，在“ENVIRONMENT”选项中选择“Web3 Provider”，然后输入http://localhost:8545,连接成功后即可在Remix中部署和测试智能合约。

3. 其他Web3.js/Ethers.js应用： 编写前端应用，将Web3 Provider指向你的私网节点HTTP地址即可。

步骤五（可选）：添加更多节点形成网络

如果你的私网需要多个节点相互通信（模拟多节点网络