区块链xuperchain ubuntu多机多节点 single共识 部署教程

Posted 2021-05-29 软件工程小施同学

一、环境

1. Ubuntu虚拟机4台

name	ip	role
node1	192.168.92.129	bootNode
node2	192.168.92.130
node3	192.168.92.131
node4	192.168.92.132

2. 安装golang

版本为1.11或更高

因为sudo apt install golang目前安装的版本是1.10，所以需要通过手动安装，若之前已经通过apt安装了golang，则可以参考https://shijianfeng.blog.csdn.net/article/details/117306277卸载。

#下载
wget https://dl.google.com/go/go1.15.3.linux-amd64.tar.gz
#解压
sudo tar -C /usr/local -xzf go1.15.3.linux-amd64.tar.gz
#建立软连接
sudo ln -s /usr/local/go/bin/* /usr/bin/
#设置环境变量
sudo vim ~/.bashrc

 在文件末尾插入下面2行，保存退出

export GOPATH="$HOME/go"
export PATH="$PATH:/usr/local/go/bin:$GOPATH/bin"

#使配置文件生效
source ~/.bashrc

测试是否安装成功

go version

查看环境变量

go env

 

3.安装git

sudo apt-get install git
# 查看是否安装成功
git --version 

4. 安装gcc

GCC版本需要升级到4或5以上，可以先gcc  --version查看是否已经安装及其版本。

sudo apt-get update
sudo apt-get install build-essential
gcc --version

 

二、安装XuperChain

1. 编译XuperChain

只需要在一台机器上进行编译，然后拷贝到其它机器

1.1 在node1编译

#创建一个xuper文件夹作为工作目录
mkdir ~/xuper
cd ~/xuper

#使用git下载源码到本地
git clone https://github.com/xuperchain/xuperchain.git

#编译
cd src/github.com/xuperchain/xuperchain
make

若报错：

"https://proxy.golang.org/github.com/%21burnt%21sushi/toml/@v/v0.3.1.mod": dial tcp 216.58.200.49:443: connect: connection refused
Makefile:22: recipe for target 'build-release' failed

则可以换一个国内能访问的代理地址，执行命令：

go env -w GOPROXY=https://goproxy.cn

重新执行编译。

 

在output目录下，主要目录有data, logs, conf, plugins等, 二进制文件有xchain，xchain-cli

各目录的功能如下表：

目录名	功能
output/	节点根目录
├─ conf	xchain.yaml: xchain服务的配置信息（注意端口冲突） plugins.conf: 插件的配置信息
├─ data	数据的存放目录，创世块信息，以及共识和合约的样例
│ ··· ├─ blockchain	账本目录
│ ··· ├─ keys	此节点的地址，具有全局唯一性
│ ··· ├─ netkeys	此节点的网络标识ID，具有全局唯一性
│ ··· └─ config	包括创始的共识，初始的资源数，矿工奖励机制等
├─ logs	程序日志目录
├─ plugins	so扩展的存放目录
├─ xchain	xchain服务的二进制文件
├─ xchain-cli	xchain客户端工具
└─ wasm2c	wasm工具（智能合约会用到）

 

1.2 将output文件夹拷贝到其它机器

在其它机器（node2,3,4）新建目录

mkdir -p ~/xuper/xuperchain/

将node1中的output文件夹发送到其它机器

scp -r /home/shijianfeng/xuper/xuperchain/output/ shijianfeng@192.168.92.130:~/xuper/xuperchain/

scp -r /home/shijianfeng/xuper/xuperchain/output/ shijianfeng@192.168.92.131:~/xuper/xuperchain/

scp -r /home/shijianfeng/xuper/xuperchain/output/ shijianfeng@192.168.92.132:~/xuper/xuperchain/

 

 

2.部署xchain服务

2.1 创建区块链

在node1节点创建区块链

在启动xchain服务之前，我们首先需要创建一条链（创世区块），xchain客户端工具提供了此功能

cd ~/xuper/xuperchain/output/
# 创建xuper链
./xchain-cli createChain

使用 config/xuper.json 中的配置创建了一条链（此时 data/blockchain 中会生成 xuper 目录，里面即是我们创建的链的账本等文件）

启动该节点

# 启动服务节点
nohup ./xchain &

2.2 指定bootNode节点

首先需要有一个节点作为“bootNode”，其他节点启动前都配置这个“bootNode”的地址即可实现

对于bootNode节点，我们需要先获取它的netURL，具体命令如下：

./xchain-cli netURL get -H 192.168.92.129:37101

如此我们会获得一个类似于 /ip4/127.0.0.1/tcp/47101/p2p/QmVxeNubpg1ZQjQT8W5yZC9fD7ZB1ViArwvyGUB53sqf8e样式的返回。

使用时将上述命令中的127.0.0.1改为机器的实际ip192.168.92.129

 

2.3 生成其它节点的私钥与netURL

在每个节点目录中分别进行操作

cd ~/xuper/xuperchain/output/
./xchain-cli account newkeys -f
./xchain-cli netURL gen

 

2.4 修改其它节点的配置

对其他的节点，我们需要修改其服务配置 conf/xchain.yaml 中p2p一节

vim conf/xchain.yaml

p2p:
    module: p2pv2
    // port是节点p2p网络监听的默认端口
    port: 47101
    // 节点加入网络所连接的种子节点的链接信息，
    bootNodes:
    - "/ip4/192.168.92.129/tcp/47101/p2p/QmVxeNubpg1ZQjQT8W5yZC9fD7ZB1ViArwvyGUB53sqf8e"

 

2.5 启动其它节点

修改完配置后，即可在每一个节点使用相同配置创建链，然后分别启动bootNode和其他节点，即完成了多节点环境的部署

# 启动服务节点
nohup ./xchain &

 

3. 确认服务状态

可以在各个节点，另其一个命令行窗口，使用系统状态的命令检查环境是否正常

./xchain-cli status -H 192.168.92.129:37101

通过变更 -H 参数，查看每个节点的状态，若所有节点高度都是一致变化的，则证明环境部署成功

 

 

三、基本功能使用

https://xuper.baidu.com/n/xuperdoc/quickstart.html#basic-usage

 

 

 

 

参考

https://xuper.baidu.com/n/xuperdoc/quickstart.html

https://xuper.baidu.com/n/xuperdoc/advanced_usage/multi-nodes.html