CentOS 7 以太坊开发环境安装完整教程（Geth + Solidity + Truffle）

以太坊（Ethereum）是目前最流行的智能合约开发平台，本文将详细介绍如何在 CentOS 7 系统上从零搭建一套完整的以太坊开发环境，包括 Geth 客户端、Solidity 编译器和 Truffle 开发框架，整个过程亲测可用,适合区块链开发入门者参考。

环境说明：

• 系统：CentOS 7.9（64位）
• 所需组件：Geth、Go、Node.js、Solc、Truffle

---

系统准备

处理 yum 源问题（重要）

CentOS 7 已于 2024 年 6 月 30 日停止维护，官方源已下线，需要先切换到 vault 归档源，否则 yum 命令会报错：

sudo sed -i 's/mirrorlist/#mirrorlist/g' /etc/yum.repos.d/CentOS-Base.repo
sudo sed -i 's|#baseurl=http://mirror.centos.org|baseurl=http://vault.centos.org|g' /etc/yum.repos.d/CentOS-Base.repo

安装基础依赖

sudo yum update -y
sudo yum install -y epel-release
sudo yum install -y git wget curl vim gcc gcc-c++ make bzip2

---

安装 Go 语言环境

Geth 是用 Go 语言编写的，编译安装 Geth 前需要先安装 Go，CentOS 7 自带的 Go 版本过旧,建议手动安装官方版本。

下载并解压

cd /opt
sudo wget https://golang.google.cn/dl/go1.19.13.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.19.13.linux-amd64.tar.gz

配置环境变量

echo 'export GOROOT=/usr/local/go' >> ~/.bashrc
echo 'export GOPATH=$HOME/go' >> ~/.bashrc
echo 'export PATH=$PATH:$GOROOT/bin:$GOPATH/bin' >> ~/.bashrc
source ~/.bashrc

验证安装

go version

看到类似 go version go1.19.13 linux/amd64 的输出即表示安装成功。

---

安装 Geth 以太坊客户端

直接下载官方编译好的二进制包（推荐）

cd /opt
sudo wget https://gethstore.blob.core.windows.net/builds/geth-linux-amd64-1.13.15-3f1f5422.tar.gz
sudo tar -xzf geth-linux-amd64-1.13.15-3f1f5422.tar.gz
sudo mv geth-linux-amd64-1.13.15-3f1f5422 /usr/local/geth
echo 'export PATH=$PATH:/usr/local/geth' >> ~/.bashrc
source ~/.bashrc

源码编译

git clone https://github.com/ethereum/go-ethereum.git
cd go-ethereum
make geth
sudo cp build/bin/geth /usr/local/bin/

验证安装

geth version

输出 Geth 版本信息即安装成功。

---

安装 Node.js 和 npm

Truffle 等开发工具依赖 Node.js，同样 yum 自带版本太旧，推荐通过 NodeSource 安装：

curl -fsSL https://rpm.nodesource.com/setup_16.x | sudo bash -
sudo yum install -y nodejs

验证安装：

node -v    # v16.x.x
npm -v     # 8.x.x

提示： 如果下载速度慢,可以切换国内镜像源：

npm config set registry https://registry.npmmirror.com

---

安装 Solidity 编译器和 Truffle 框架

安装 solc-js

sudo npm install -g solc
solcjs --version

安装 Truffle

sudo npm install -g truffle
truffle version

（可选）安装 Ganache 命令行版

Ganache 可在本地快速搭建测试链：

sudo npm install -g ganache

---

环境验证：创建第一个项目

依次执行以下命令,测试环境是否完整可用：

mkdir my-dapp && cd my-dapp
truffle init
truffle develop

进入 Truffle 控制台后,可以尝试编译自带的示例合约：

compile
migrate

如果能看到合约编译和部署成功的输出，恭喜你,以太坊开发环境已搭建完成！

---

常见问题排查

**1. make geth 报错 gcc 版本