基于某些需求我需要将一个以太坊网络运行在自己的服务器上,因此在查阅了相关资料后,我在自己的服务器上搭建了一个私链。搭建一个以太坊私链主要有两步:①安装geth;②私链环境配置和启动。

服务器系统版本:Ubuntu Server 18.04.1 LTS 64位;geth版本:1.10.16-stable-20356e7

一、安装geth

geth(go-ethereum)是以太坊官方社区开发的开源客户端,我们可以通过geth命令搭建以太坊私链或者通过geth客户端的控制台与以太坊网络进行交互。geth的安装方式有很多,但是ubuntu下安装geth还是比较方便的,不需要翻墙,在终端执行下面的命令即可(需要root权限,需要登陆root账户或在每个命令前面+sudo)。

apt-get install software-properties-commonadd-apt-repository -y ppa:ethereum/ethereumapt-get updateapt-get install ethereum

安装完后可以输入geth -h查看命令帮助,能正常显示则安装完成。

二、环境配置

首先第一步我们需要创建一个文件夹用来存放我们的私链项目。

mkdir /home/lls/FangChainmkdir /home/lls/Fangchain/data

项目目录的名称和位置根据需要自行变更,但是需要注意在对私链进行初始化的时候需要指定数据存储位置,能对应上即可,data目录用于存储私链数据,包括账本信息、用户私钥等。

接着我们需要创建一个私链配置json文件用于配置区块链的“创世”状态,这一步的目的是根据需求对私链的状态进行初始化。

cd /home/lls/FangChain/

跳转到项目目录下,创建配置文件genesis.json。

vi genesis.json

编辑文件内容,这里用以太坊官网给的例子,输入内容如下:

{"config": {"chainId": 15,//私链的ID,每条私链的ID应该是唯一的"homesteadBlock": 0,"eip150Block": 0,"eip155Block": 0,"eip158Block": 0,"byzantiumBlock": 0,"constantinopleBlock": 0,"petersburgBlock": 0,"ethash": {}},"difficulty": "1",//出块难度,数值越大,矿工挖矿出块的难度越大"gasLimit": "8000000",//每个区块最大的gas消耗"alloc": {//资产配置初始化,提前定义哪些地址所拥有的原生代币的数量,单位是wei"7df9a875a174b3bc565e6424a0050ebc1b2d1d82": { "balance": "300000" },"f41c74c9ae680c1aa78f42e5647a62f353b7bdde": { "balance": "400000" }}}

一般来说,在上述文件中需要我们进行配置的是链ID、出块难度和初始资产。这里记得将genesis.json文件内的注释删除,json不允许添加注释,否则在下面执行配置初始化命令会出错。文件保存后执行私链配置初始化命令。

geth init --datadir data genesis.json

其中–datadir字段用于配置私链数据的存储位置,这里存在data文件夹。输入命令后等待片刻,看到“Successfully wrote genesis state”的日志则表示配置完成。

当配置完私链的初始状态后就可以通过geth命令启动私链了,执行以下命令。

geth --datadir data --networkid 15 --http --http.addr 0.0.0.0 --http.port 8545 --http.corsdomain "*" --port 30305 --allow-insecure-unlock console 2>>geth.log

–datadir字段用于指示私链数据的存储位置,即工作目录;

–networkid字段用于配置私链id,需要与genesis.json文件内预定义的一致;

–http字段用于启用HTTP-RPC服务,主要应用于与前端页面的交互;

–http.addr字段表示节点接受的http连接的地址,0.0.0.0表示可以接受所有ip地址的http请求;

–http.port字段用于指定监听端口,默认是8545;

–http.corsdomain字段表示允许跨域请求的域名列表,“*”表示允许所有的跨域请求,不开启的话metamask钱包可能无法连接上搭建的私链;

–port字段用于指定节点之间通信的端口,默认是30303;

–allow-insecure-unlock表示允许不安全的账户解锁行为,开启这个选项后通过http连接到私链的钱包才能解锁账户进行转账操作;

console表示在运行私链节点的同时开启控制台,这样就可以在监控私链节点状态的同时对节点进行操作。因为geth命令运行完后会不断弹出监控日志影响到控制台的使用,因此在命令最后添加2>>geth.log就可以让监控日志输入到当前目录的geth.log文件中而不影响控制台的使用,然后在新开一个终端用tail -f geth.log的命令实时监控节点的日志即可。(如果不愿意这么麻烦可以把2>>geth.log删除)

三、用MetaMask钱包连接私链

若要用metamask钱包连接私链节点,则需要在metamask钱包中依次点击“设定-网络-添加网络”进行私链网络的添加。

其中网络名称原生代币的标签根据需要可以自行设置,RPC URL的格式为http://服务器地址:http端口号(如http://81.72.166.130:8545),链ID即为networkid中定义的id。当添加完私链网络后,我们就可以通过metamask钱包操作我们在私链上的账户,并可以通过remix将智能合约部署到私链上。

需要注意的是,如果你使用的是云服务器,则需要在云服务器的服务器管理界面开启上述配置中的对应的端口,尤其是http.port对应的端口,否则metamask钱包无法通过该端口连接上私链节点。

踩坑点

–http,–http.addr,–http.port和–http.corsdomain是较新版本的geth才启用的字段,老版本对应的字段分别为–rpc,–rpcaddr,–rpcport和rpccorsdomain,根据实际版本进行替换即可。而在新版本中如果你用的是websocket协议与节点交互,则对应的字段是–ws,–wsaddr,–ws.port和–ws.origins,具体命令详情可以在geth控制台中使用geth -h命令进行查看。

–port端口最好自行指定一个别的端口,因为8545端口为默认端口,在使用默认端口,且启动私链时允许所有ip地址的http请求和所有跨域请求的情况下,容易被机器人攻击,如下图所示。

可以看到在使用默认端口地情况下节点被高频率地访问,而修改端口可以有效避免这种情况。

参考资料

Private Networks | Go Ethereum

https://gist.github.com/0mkara/b953cc2585b18ee098cd

第一个为geth官网,第二个为genesis.json文件的解析。