节点安装教程

系统要求

配置	最低要求	推荐配置
CPU	2核	4核+
内存	4GB	8GB+
磁盘	50GB SSD	100GB SSD
操作系统	Ubuntu 20.04+	Ubuntu 22.04

安装步骤

1 下载并解压

# 下载节点程序
wget https://koanchain.com/downloads/koan-node-linux-x86_64.tar.gz

# 解压
tar -xzf koan-node-linux-x86_64.tar.gz

# 移动到系统目录
sudo mv koand /usr/local/bin/
sudo chmod +x /usr/local/bin/koand

# 验证安装
koand version

2 初始化节点

# 初始化节点配置
koand init YOUR_NODE_NAME --chain-id koan_313-1

# 创建钱包账户
koand keys add validator --keyring-backend file

⚠️ 请保存好生成的助记词，这是恢复钱包的唯一方式！

3 获取 Genesis 文件

# 从官网获取 genesis.json
wget https://koanchain.com/downloads/genesis.json -O ~/.koand/config/genesis.json

# 验证 Genesis
koand validate-genesis

4 配置 P2P 种子节点

# 编辑 config.toml，添加种子节点
sed -i 's/^seeds = ""/seeds = "d0dfb70e14fe74b5b11689e798913e5a043bb184@43.134.8.45:26656"/' ~/.koand/config/config.toml

# 开放端口（腾讯云/阿里云需在安全组开放）
# 26656 - P2P
# 26657 - RPC
# 1317 - API

5 启动节点

# 创建 systemd 服务
sudo tee /etc/systemd/system/koand.service > /dev/null << 'EOF'
[Unit]
Description=Koan Chain Node
After=network.target

[Service]
Type=simple
User=YOUR_USER
ExecStart=/usr/local/bin/koand start
Restart=on-failure
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

# 启动服务
sudo systemctl daemon-reload
sudo systemctl enable koand
sudo systemctl start koand

# 查看日志
journalctl -u koand -f

6 成为验证者

# 确保节点同步完成后，创建验证者
koand tx staking create-validator \
  --amount 1000000akoan \
  --pubkey $(koand tendermint show-validator) \
  --moniker YOUR_MONIKER \
  --chain-id koan_313-1 \
  --from validator \
  --commission-rate 0.10 \
  --commission-max-rate 0.20 \
  --commission-max-change-rate 0.01 \
  --min-self-delegation 1000000 \
  --fees 500akoan

# 查看验证者状态
koand query staking validator $(koand keys show validator --bech val -a)

网络信息

参数	值
Chain ID	`koan_313-1`
基础代币	`akoan`
种子节点	`d0dfb70e14fe74b5b11689e798913e5a043bb184@43.134.8.45:26656`
RPC 地址	`http://43.134.8.45:26657`
Bech32 前缀	`koan` / `koanvaloper`

常见问题

Q: 节点同步很慢怎么办？

A: 检查网络连接，确保 26656 端口已开放。可以尝试添加更多种子节点或 peers。

Q: 如何查看节点是否同步？

A: 使用 curl localhost:26657/status 查看 catching_up 字段，false 表示已同步。