1. 网络部署

本节内容将教你手把手使用XuperChain搭建一个3节点的区块链网络。帮助开发者掌握XuperChain网络的部署流程。

1.1. 前置阅读

在阅读本节前，请先阅读 XuperChain环境部署 和 XuperChain基本操作 ，了解XuperChain单节点网络部署和基本操作等。

1.2. 准备环境

1. 创建网络部署环境

  1. make testnet

2. 查看网络部署环境

  1. tree testnet

可以看到如下部署环境，其中有3个节点，分别为node1、node2、node3。

  1. testnet
  2. ├── node1
  3. │   ├── bin
  4. │   ├── conf
  5. │   └── data
  6. │       ├── genesis
  7. │       ├── keys
  8. │       └── netkeys
  9. ├── node2
  10. │   ├── bin
  11. │   ├── conf
  12. │   └── data
  13. │       ├── genesis
  14. │       ├── keys
  15. │       └── netkeys
  16. └── node3
  17.     ├── bin
  18.     ├── conf
  19.     └── data
  20.         ├── genesis
  21.         ├── keys
  22.         └── netkeys

1.3. 网络配置说明

注解

上述创建好的部署环境，网络已经默认配置好，此段仅仅是为了说明，开发者也可以跳过此小节，直接调到 启动网络 章节

节点加入网络需要通过网络中一个或者多个种子节点，区块链网络中任何一个节点都可以作为种子节点，通过配置种子节点的网络连接地址netURL可以加入网络。

1. 查看种子节点netURL

假设我们设定node1、node2、node3都是种子节点，分别查看3个节点的netURL

  1. # 查看node1节点连接地址netURL
  2. cd node1
  3. ./bin/xchain-cli netURL preview
  4. # 得到如下结果，实际使用时，需要将ip配置节点的真实ip，port配置成
  5. /ip4/{{ip}}/tcp/{{port}}/p2p/Qmf2HeHe4sspGkfRCTq6257Vm3UHzvh2TeQJHHvHzzuFw6
  7. # 查看node2节点连接地址netURL
  8. cd ../node2
  9. ./bin/xchain-cli netURL preview
  10. /ip4/{{ip}}/tcp/{{port}}/p2p/QmQKp8pLWSgV4JiGjuULKV1JsdpxUtnDEUMP8sGaaUbwVL
  12. # 查看node3节点连接地址netURL
  13. cd ../node3
  14. ./bin/xchain-cli netURL preview
  15. /ip4/{{ip}}/tcp/{{port}}/p2p/QmZXjZibcL5hy2Ttv5CnAQnssvnCbPEGBzqk7sAnL69R1E

如果想给节点分配一个新的网络连接地址，可以使用如下命令:

  1. cd node1
  2. ./bin/xchain-cli netURL gen

2. p2p网络配置

  1. # 查看
  2. cat conf/network.yaml
  1. # p2p network config
  3. # Module is the name of p2p module plugin.(p2pv1 | p2pv2)
  4. module: p2pv2
  5. # Port the p2p network listened
  6. port: 47101
  7. # Address multiaddr string
  8. address: /ip4/127.0.0.1/tcp/47101
  9. # IsTls config the node use tls secure transparent
  10. isTls: true
  11. # KeyPath is the netdisk private key path
  12. keyPath: netkeys
  13. # BootNodes config the bootNodes the node to connect
  14. bootNodes:
  15.   - "/ip4/127.0.0.1/tcp/47101/p2p/Qmf2HeHe4sspGkfRCTq6257Vm3UHzvh2TeQJHHvHzzuFw6"
  16.   - "/ip4/127.0.0.1/tcp/47102/p2p/QmQKp8pLWSgV4JiGjuULKV1JsdpxUtnDEUMP8sGaaUbwVL"
  17.   - "/ip4/127.0.0.1/tcp/47103/p2p/QmZXjZibcL5hy2Ttv5CnAQnssvnCbPEGBzqk7sAnL69R1E"
  18. # service name
  19. serviceName: localhost

注解

注意: 如果您是部署在同一个节点上，p2p模块端口应该配置不同，同时不要和其他已经被占用的端口冲突

1.4. 启动网络

进入每个节点部署路径，分别启动每个节点:

  1. cd ./testnet/node1
  2. sh ./control.sh start
  4. cd ../node2
  5. sh ./control.sh start
  7. cd ../node3
  8. sh ./control.sh start

1.5. 确认服务状态

分别查看每个节点运行状态：

  1. ./bin/xchain-cli status -H :37101
  2. ./bin/xchain-cli status -H :37102
  3. ./bin/xchain-cli status -H :37103

1.6. 常见问题

  • 端口冲突：注意如果在一台机器上部署多个节点，各个节点的RPC监听端口以及p2p监听端口都需要设置地不相同，避免冲突；

  • 不同节点公私钥和netURL冲突：注意网络中不同节点./data/keys下的文件和./data/netkeys下的内容都应该不一样，这两个文件夹是节点在网络中的唯一标识，每个节点需要独自生成，否则网络启动异常；

  • 启动时连接种子节点失败：注意要先将种子节点启动，再起动其他节点，否则会因为加入网络失败而启动失败；