区块链xuperchain ubuntu多机多节点 single共识 部署教程
一、环境
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/ [email protected]:~/xuper/xuperchain/
scp -r /home/shijianfeng/xuper/xuperchain/output/ [email protected]:~/xuper/xuperchain/
scp -r /home/shijianfeng/xuper/xuperchain/output/ [email protected]:~/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.yamlp2p:
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