Tut run node

说明

本教程仅帮助您启动 MathChain-Galois 全节点，不包含验证人功能，如您需要验证人功能，请查看 验证人节点教程

* 重要：如果您之前运行过0.6.1版本之前的节点，在启动节点前，需要删除之前链的数据文件夹，即之前启动命令中 -d 部分。

环境准备

测试网节点配置建议

最低配置：单核2G服务器，硬盘30G

推荐配置：双核4G服务器，硬盘50G

以下两种获取可执行文件方式任选其一

1、从源码编译

源码仓库：https://github.com/mathwallet/MathChain

• 编译环境配置
• 启动命令行
• 进入 mathchain 根目录
• 获取submodel：git submodule update --init --recursive
• cargo build --release
• 可以在 mathchain/target/release 下面找到编译好的可执行文件 mathchain(.exe)

2、根据系统下载可执行文件

当前版本 0.6.1

• macOS Catalina
• Linux

启动参数

从命令行读取配置启动

./mathchain \
    -d /tmp/example \
    --name Example \
  --chain galois

常用参数

参数	注释	子参数	子参数类型
validator	节点类型为验证人节点	无	无
rpc-external	监听所有 rpc，验证人节点需要使用 --unsafe-rpc-external 但不推荐验证人节点开启	无	无
ws-external	监听所有 ws，验证人节点需要使用 --unsafe-ws-external 但不推荐验证人节点开启	无	无
port	p2p 端口	端口号	数字
rpc-port	rpc 端口	端口号	数字
ws-port	ws 端口	端口号	数字
base-path	保存用于链的各种数据的地址	路径	字符串
name	节点的名称	节点名	字符串
rpc-cors	请求头白名单	过滤类型	枚举
bootnodes	用来获取启动数据的种子节点（/ip4/0.0.0.0/tcp/0/p2p/xxx）	节点 URL	字符串数组

查看所有参数

./mathchain --help

启动节点

启动命令

./mathchain \
    -d /tmp/example \
    --name Example \
  --chain galois

建议使用 systemctl，pm2，screen 等工具来维护进程。

种子节点

测试网已内置种子节点地址

Q&A

• Q：无法启动节点

• A：

  1. 确认系统支持该可执行文件
  2. 部分动态链接库依赖丢失，安装依赖

• Q：我的节点为什么不同步块

• A：

  1. 检查 bootnodes 是否填错
  2. 与目标节点网络通信差，尝试其他 bootnodes
  3. 目标节点连接数已满，尝试其他 bootnodes
  4. 确认版本号一致（多数情况下并不需要完全一致）

• 如仍有问题，欢迎提交 issue