下载 Go 安装包(以 1.19.5 为例,请根据需要替换版本)

admin 发布于 2026-02-16 19:09 频道：默认分类阅读：9

手把手教你搭建以太坊私链：从零开始掌握环境配置与节点运行**

以太坊作为目前最知名的智能合约平台,其公链网络虽然功能强大，但对于开发者而言，在进行应用测试、学习智能合约开发或进行某些需要独立环境的实验时，搭建一个本地或私有的以太坊网络（即“以太坊私链”）则更为便捷和高效，本文将详细介绍如何从零开始，一步步安装并运行一条属于自己的以太坊私链。

为什么需要搭建以太坊私链

在正式开始搭建之前,我们先了解一下搭建私链的必要性：

开发与测试环境：智能合约的开发和部署需要反复测试，私链提供了一个与主网隔离的安全环境，避免了测试成本（如Gas费用）和对主网的影响。

>实验与学习：对于初学者，私链是理解以太坊节点同步、区块生成、交易处理等底层机制的理想平台。

私有网络需求：某些企业或组织可能需要一个内部可控的区块链网络，用于特定的业务场景，私链可以满足这种定制化需求。

快速迭代：在私链中，可以自由调整出块时间、Gas限制等参数，加速应用的迭代和测试过程。

搭建以太坊私链的前期准备

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

操作系统：本文以主流的 Ubuntu 20.04 LTS 为例，其他 Linux 发行版或 macOS、Windows（通过 WSL2 或虚拟机）也基本适用，命令和路径可能略有差异。
Go 语言环境：以太坊客户端（如 Geth）是用 Go 语言开发的，因此需要安装 Go，建议安装较新版本（如 1.18+）。
Git：用于从代码仓库下载 Geth 等工具。
基本命令行工具：如 curl, wget, make 等。

安装与配置以太坊私链（以 Geth 为例）

Geth 是以太坊官方推荐的 Go 语言客户端，功能强大，是搭建私链的常用选择。

步骤1：安装 Go 语言环境

打开终端,执行以下命令安装 Go：

# 解压到 /usr/local 目录
sudo tar -C /usr/local -xzf go1.19.5.linux-amd64.tar.gz
# 配置环境变量
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
echo 'export GOPATH=$HOME/go' >> ~/.bashrc
echo 'export GOBIN=$GOPATH/bin' >> ~/.bashrc
source ~/.bashrc
# 验证安装
go version

步骤2：安装 Geth 客户端

Geth 可以通过源码编译安装，也可以直接下载预编译的二进制文件，这里推荐使用源码编译，以获取最新版本：

# 安装必要的编译依赖
sudo apt update
sudo apt install -y git build-essential
# 克隆 Geth 仓库
git clone https://github.com/ethereum/go-ethereum.git
cd go-ethereum
# 编译 Geth
make geth
# 验证安装
./build/bin/geth version

编译完成后,./build/bin/geth 就是可执行文件，你可以将其复制到系统 PATH 中方便使用，

sudo cp ./build/bin/geth /usr/local/bin/

步骤3：初始化创世区块

以太坊的每个网络都有一个创世区块（Genesis Block），它是区块链的起点，私链需要自定义创世区块配置。

创建创世配置文件：创建一个名为 genesis.json 的文件，内容如下：

{
  "config": {
    "chainId": 15,       // 私链的 Chain ID，必须唯一，避免与公网冲突
    "homesteadBlock": 0,
    "eip150Block": 0,
    "eip155Block": 0,
    "eip158Block": 0,
    "byzantiumBlock": 0,
    "constantinopleBlock": 0,
    "petersburgBlock": 0,
    "istanbulBlock": 0,
    "berlinBlock": 0,
    "londonBlock": 0,
    "mergeNetsplitBlock": 0,
    "terminalTotalDifficulty": 0,
    "terminalTotalDifficultyPassed": true,
    "ethash": {}
  },
  "alloc": {},       // 预分配地址，可选，用于给某些地址初始化 Ether
  "coinbase": "0x0000000000000000000000000000000000000000",
  "difficulty": "0x4000", // 初始难度，私链可以设置低一些方便挖矿
  "extraData": "",
  "gasLimit": "0xffffffff",
  "nonce": "0x0000000000000042",
  "mixhash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "parentHash": "0x0000000000000000000000000000000000000000000000000000000000000000",
  "timestamp": "0x00"
}

注意：chainId 是私链的唯一标识，不要与主网（1）、Ropsten（3）等冲突。

初始化节点：使用 Geth 的 init 命令和创世配置文件来初始化数据目录：
```
mkdir -p ~/ethereum/private_chain_data
geth --datadir ~/ethereum/private_chain_data init ~/ethereum/genesis.json
```
执行成功后,数据目录 ~/ethereum/private_chain_data 下会生成 geth 和 keystore 等文件夹。

步骤4：启动私链节点

现在可以启动私链节点了：

geth --datadir ~/ethereum/private_chain_data --networkid 15 --nodiscover --http --http.addr "0.0.0.0" --http.port "8545" --http.api "personal,eth,net,web3,miner"

参数说明：

--datadir: 指定数据目录。
--networkid: 设置网络 ID，与创世文件中的 chainId 保持一致。
--nodiscover: 禁止节点自动发现，避免连接到其他网络。
--http: 启用 HTTP-RPC 服务。
--http.addr "0.0.0.0": 允许任何 IP 访问 HTTP-RPC 接口。
--http.port "8545": 设置 HTTP-RPC 端口。
--http.api: 暴露的 API 接口列表，包括 personal（账户管理）、eth（以太坊核心）、net（网络）、web3（Web3.js 兼容）、miner（挖矿）等。

启动后,你会看到 Geth 的日志输出，包括正在同步的信息（私链同步很快，几乎瞬间完成）。

步骤5：创建账户与挖矿

创建账户：打开一个新的终端，连接到 Geth 的控制台：
```
geth attach http://localhost:8545
```
进入控制台后,执行以下命令创建新账户：
```
personal.newAccount("your_password_here") // 替换为你的密码
```
记下返回的账户地址,0x1234567890123456789012345678901234567890。

解锁账户：在挖矿前需要解锁账户：

personal.unlockAccount(eth.accounts[0], "your_password_here") // 使用第一个账户或你创建的账户地址

开始挖矿：由于我们创世文件中设置了较低的难度，挖矿会比较容易：
```
miner.start(1) // 参数为线程数，1 即可
```
你会看到节点开始出块,可以通过 eth.blockNumber 查看当前区块高度。
停止挖矿：
```
miner.stop()
```

与私链交互

你可以通过以下方式与你的私链交互：

Geth 控制台：如上所述，使用 geth attach 进入 JavaScript 控制台，调用各种 API 进行交易、查询等操作。
Web3.js/Ethers.js：在网页应用中，通过 HTTP-RPC 接口连接