以太坊私链搭建完全指南：从零开始创建本地测试网络

关键词：以太坊私网、geth 安装、genesis 配置、private chain、本地测试链、节点互联、网络参数

为什么要搭建私链？

在真实主网部署智能合约或测试大额转账前，最直接、最低成本的方法就是先跑一条以太坊私网。它既能提供与主网一致的环境，又可以无限制、无风险地调试代码。本文将一步步展示如何借助 Geth（Go‐Ethereum） 完成私链初始化、节点互联及挖矿全过程。

步骤一：安装并验证 Geth 客户端

Geth 是用 Go 编写的官方以太坊客户端，脚本少、速度快，是当前最常用的工具。

下载与系统对应的发行版
Mac 用户可执行：
```
brew tap ethereum/ethereum
brew install ethereum
```
Windows / Linux 用户可在 GitHub release 页面直接下载二进制文件。
安装成功后，终端输入
```
geth version
```
出现版本号即代表安装完成。

步骤二：理解私链核心——genesis block & network id

任何两条以太坊链，只要 genesis block 或 network id 不同，就会被认为是完全不同的链。

genesis block
创世区块定义了链的初始状态，包括初始余额、难度、gas limit。
network id
网络标识符决定节点之间能否握手。主网 network id 为 1，本示例我们设为 123。

👉 想立刻动手？查看如何快速生成 genesis 文件并开始实战

步骤三：编写你的第一张 genesis 文件

在工作目录新建 custom_genesis.json：

{
  "config": {
    "chainId": 123,
    "homesteadBlock": 0,
    "eip150Block": 0,
    "eip155Block": 0,
    "eip158Block": 0
  },
  "nonce": "0x0000000000000042",
  "timestamp": "0x0",
  "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "extraData": "0x123456789abcdef",
  "gasLimit": "0x0123123",
  "difficulty": "0x400",
  "mixhash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "coinbase": "0x3333333333333333333333333333333333333333",
  "alloc": {
    "3282791d6fd713f1e94f4bfd565eaa78b3a0599d": {
      "balance": "1337000000000000000000"
    }
  }
}

difficulty: 0x400 设置足够低，才能在本地 CPU 上快速挖矿。
alloc 字段直接内置 1,337 ETH 到指定地址，测试时无需 faucet。

步骤四：初始化数据目录

为避免与主网数据冲突，创建独立目录并初始化：

mkdir privatechain      # 任意名称
geth --datadir ./privatechain init custom_genesis.json

终端提示 successfully wrote genesis block 即成功。

步骤五：启动节点并进入 console

命令模板：

geth --datadir ./privatechain \
     --networkid 123 \
     --verbosity 2 \
     --maxpeers 5 \
     --nodiscover \
     --mine

参数	说明
`--datadir`	指定数据目录
`--networkid`	与 genesis 中的 chainId 保持一致
`--verbosity`	打印信息量，范围 0–6
`--maxpeers`	最大对等节点数
`--nodiscover`	关闭自动发现
`--mine`	立即开始挖矿

进入交互式 console：

geth attach ./privatechain/geth.ipc

步骤六：打造多节点私网

方法一：手动互联

节点 A 启动后，在 console 执行：
```
admin.nodeInfo
```
记录 enode://...，示例如下：
```
enode://[email protected]:30303
```

节点 B 启动时追加：

--bootnodes "enode://[email protected]:30303"

方法二：静态节点文件（推荐）

在节点根目录 ./privatechain/static-nodes.json 内写死一条或多条 enode 记录：

[
  "enode://[email protected]:30303",
  "enode://[email protected]:30303"
]

重启即自动互联。

方法三：动态 addPeer

进入 console 实时添加：

admin.addPeer("enode://...")

确认连接状态：

admin.peers

步骤七：轻松挖矿与查询余额

终端 console 内：

开始挖矿：miner.start()
停止挖矿：miner.stop()
查看新区块：eth.blockNumber
查看地址余额：eth.getBalance("0x328...99d")

👉 掌握更多挖矿技巧与 Gas 费用优化做法

FAQ：常见疑惑一次性解答

Q1：我的私网需要真实的 ETH 吗？
A：不需要。所有资金与交易都是本地模拟，无真实价值。

Q2：设置完全一样，两个节点的链长仍冲突怎样排查？
A：确认两项：1. network id；2. genesis hash（执行 eth.getBlock(0).hash 对比输出即可）。

Q3：--nodiscover 关闭后怎么重新开启？
A：去掉 --nodiscover 参数并重启节点即可。

Q4：如何限制节点只在局域网内通信？
A：加装 --netrestrict 192.168.0.0/16，仅接受局域网段的握手请求。

Q5：Ethereum 主网 chainId ≠ network id，私网也要区分吗？
A：在 Geth 中并不区分这两个参数，统一指定即可。

Q6：可导出私链数据并迁移到别的电脑吗？
A：复制整个 ./privatechain 目录到目标机器上的同等位置，重新附加即可。

通过以上 7 步，你已拥有完整的 以太坊私链 环境：可自由铸造 ETH、部署合约、测试 DApp，甚至搭建公司内部的区块链教学平台。愿你在这条本地网络上写出惊艳世界的下一轮爆款应用！