1. 网络部署

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

1.1. 前置阅读

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

1.2. 准备环境

1. 创建网络部署环境

# 在xuperchain目录执行
make testnet

2. 查看网络部署环境

tree testnet

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

testnet
├── node1
│   ├── bin
│   │   ├── wasm2c
│   │   ├── xchain
│   │   └── xchain-cli
│   ├── conf
│   │   ├── contract.yaml
│   │   ├── engine.yaml
│   │   ├── env.yaml
│   │   ├── ledger.yaml
│   │   ├── log.yaml
│   │   ├── network.yaml
│   │   ├── server.yaml
│   │   └── xchain-cli.yaml
│   ├── control.sh
│   └── data
│       ├── genesis
│       │   ├── poa.json
│       │   ├── pow.json
│       │   ├── tdpos.json
│       │   ├── xpoa.json
│       │   ├── xpos.json
│       │   └── xuper.json
│       ├── keys
│       │   ├── address
│       │   ├── private.key
│       │   └── public.key
│       └── netkeys
│           ├── cacert.pem
│           ├── cert.pem
│           ├── net_private.key
│           └── private.key
├── node2
│   ├── bin
│   │   ├── wasm2c
│   │   ├── xchain
│   │   └── xchain-cli
│   ├── conf
│   │   ├── contract.yaml
│   │   ├── engine.yaml
│   │   ├── env.yaml
│   │   ├── ledger.yaml
│   │   ├── log.yaml
│   │   ├── network.yaml
│   │   ├── server.yaml
│   │   └── xchain-cli.yaml
│   ├── control.sh
│   └── data
│       ├── genesis
│       │   ├── poa.json
│       │   ├── pow.json
│       │   ├── tdpos.json
│       │   ├── xpoa.json
│       │   ├── xpos.json
│       │   └── xuper.json
│       ├── keys
│       │   ├── address
│       │   ├── private.key
│       │   └── public.key
│       └── netkeys
│           ├── cacert.pem
│           ├── cert.pem
│           ├── net_private.key
│           └── private.key
└── node3
├── bin
│   ├── wasm2c
│   ├── xchain
│   └── xchain-cli
├── conf
│   ├── contract.yaml
│   ├── engine.yaml
│   ├── env.yaml
│   ├── ledger.yaml
│   ├── log.yaml
│   ├── network.yaml
│   ├── server.yaml
│   └── xchain-cli.yaml
├── control.sh
└── data
    ├── genesis
    │   ├── poa.json
    │   ├── pow.json
    │   ├── tdpos.json
    │   ├── xpoa.json
    │   ├── xpos.json
    │   └── xuper.json
    ├── keys
    │   ├── address
    │   ├── private.key
    │   └── public.key
    └── netkeys
        ├── cacert.pem
        ├── cert.pem
        ├── net_private.key
        └── private.key

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网络配置

# 查看
cd node1
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 也可以选择都链接同一个节点,在启动网络时需要先启动该节点
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
# 如果sh命令运行不成功的话可以使用bash命令
#  bash ./control.sh start

   cd ../node2
   sh ./control.sh start
# 如果sh命令运行不成功的话可以使用bash命令
#  bash ./control.sh start

   cd ../node3
   sh ./control.sh start
# 如果sh命令运行不成功的话可以使用bash命令
#  bash ./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下的内容都应该不一样,这两个文件夹是节点在网络中的唯一标识,每个节点需要独自生成,否则网络启动异常;

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