1. 网络部署¶
本节内容将教你手把手使用XuperChain搭建一个3节点的区块链网络。帮助开发者掌握XuperChain网络的部署流程。
1.1. 前置阅读¶
在阅读本节前,请先阅读 XuperChain环境部署 和 XuperChain基本操作 ,了解XuperChain单节点网络部署和基本操作等。
1.2. 准备环境¶
1. 创建网络部署环境
make testnet
2. 查看网络部署环境
tree testnet
可以看到如下部署环境,其中有3个节点,分别为node1、node2、node3。
testnet
├── node1
│ ├── bin
│ ├── conf
│ └── data
│ ├── genesis
│ ├── keys
│ └── netkeys
├── node2
│ ├── bin
│ ├── conf
│ └── data
│ ├── genesis
│ ├── keys
│ └── netkeys
└── node3
├── bin
├── conf
└── data
├── genesis
├── keys
└── netkeys
1.3. 网络配置说明¶
注解
上述创建好的部署环境,网络已经默认配置好,此段仅仅是为了说明,开发者也可以跳过此小节,直接调到 启动网络 章节
节点加入网络需要通过网络中一个或者多个种子节点,区块链网络中任何一个节点都可以作为种子节点,通过配置种子节点的网络连接地址netURL可以加入网络。
1. 查看种子节点netURL
假设我们设定node1、node2、node3都是种子节点,分别查看3个节点的netURL
# 查看node1节点连接地址netURL
cd node1
./bin/xchain-cli netURL preview
# 得到如下结果,实际使用时,需要将ip配置节点的真实ip,port配置成
/ip4/{{ip}}/tcp/{{port}}/p2p/Qmf2HeHe4sspGkfRCTq6257Vm3UHzvh2TeQJHHvHzzuFw6
# 查看node2节点连接地址netURL
cd ../node2
./bin/xchain-cli netURL preview
/ip4/{{ip}}/tcp/{{port}}/p2p/QmQKp8pLWSgV4JiGjuULKV1JsdpxUtnDEUMP8sGaaUbwVL
# 查看node3节点连接地址netURL
cd ../node3
./bin/xchain-cli netURL preview
/ip4/{{ip}}/tcp/{{port}}/p2p/QmZXjZibcL5hy2Ttv5CnAQnssvnCbPEGBzqk7sAnL69R1E
如果想给节点分配一个新的网络连接地址,可以使用如下命令:
cd node1
./bin/xchain-cli netURL gen
2. p2p网络配置
# 查看
cat conf/network.yaml
# p2p network config
# Module is the name of p2p module plugin.(p2pv1 | p2pv2)
module: p2pv2
# Port the p2p network listened
port: 47101
# Address multiaddr string
address: /ip4/127.0.0.1/tcp/47101
# IsTls config the node use tls secure transparent
isTls: true
# KeyPath is the netdisk private key path
keyPath: netkeys
# BootNodes config the bootNodes the node to connect
bootNodes:
- "/ip4/127.0.0.1/tcp/47101/p2p/Qmf2HeHe4sspGkfRCTq6257Vm3UHzvh2TeQJHHvHzzuFw6"
- "/ip4/127.0.0.1/tcp/47102/p2p/QmQKp8pLWSgV4JiGjuULKV1JsdpxUtnDEUMP8sGaaUbwVL"
- "/ip4/127.0.0.1/tcp/47103/p2p/QmZXjZibcL5hy2Ttv5CnAQnssvnCbPEGBzqk7sAnL69R1E"
# service name
serviceName: localhost
注解
注意: 如果您是部署在同一个节点上,p2p模块端口应该配置不同,同时不要和其他已经被占用的端口冲突
1.4. 启动网络¶
进入每个节点部署路径,分别启动每个节点:
cd ./testnet/node1
sh ./control.sh start
cd ../node2
sh ./control.sh start
cd ../node3
sh ./control.sh start
1.5. 确认服务状态¶
分别查看每个节点运行状态:
./bin/xchain-cli status -H :37101
./bin/xchain-cli status -H :37102
./bin/xchain-cli status -H :37103
1.6. 常见问题¶
端口冲突:注意如果在一台机器上部署多个节点,各个节点的RPC监听端口以及p2p监听端口都需要设置地不相同,避免冲突;
不同节点公私钥和netURL冲突:注意网络中不同节点./data/keys下的文件和./data/netkeys下的内容都应该不一样,这两个文件夹是节点在网络中的唯一标识,每个节点需要独自生成,否则网络启动异常;
启动时连接种子节点失败:注意要先将种子节点启动,再起动其他节点,否则会因为加入网络失败而启动失败;