加入网络 - Injective Docs

在 Mainnet、Testnet 或本地开发网络上设置并同步 Injective 节点。

Mainnet
Testnet
本地网络

Injective Mainnet 的 chain-id 为 injective-1。

同步选项

快照恢复、state sync 和区块同步

节点软件

安装 injectived、配置并运行

硬件

最低和推荐规格

同步选项

选择如何为你的节点引导链数据。对大多数运营者来说，快照恢复是让节点最快运行起来的方式。选项 1. 快照恢复（推荐）下载预构建的快照并将其解压到你的数据目录。这是同步新节点最快、最可靠的方式。Injective 提供官方剪枝快照（goleveldb，约 2-3 GB），社区也维护其他选项。有关下载链接、使用说明和社区提供商，请参阅 Chain Portal 上的快照页面。

验证者： 在快照恢复期间，你必须备份并还原 priv_validator_state.json。完整流程请参阅验证者故障排查指南。

# Example: download and extract
sudo systemctl stop injectived
rm -rf ~/.injectived/data
wget -O snapshot.lz4 <SNAPSHOT_URL>
lz4 -d snapshot.lz4 | tar xf - -C ~/.injectived/
sudo systemctl start injectived

选项 2. State Sync（CometBFT P2P）State sync 通过 CometBFT P2P 层从对等节点下载状态机快照来引导节点，而不是重放所有历史区块。它需要两个可信的 RPC 服务器。有关可用端点，请参阅 Chain Portal 上的 RPC 提供商页面。请在 config.toml 的 [statesync] 下进行配置：

[statesync]
enable = true
rpc_servers = "<rpc_server_1>,<rpc_server_2>"
trust_height = <recent_height>
trust_hash = "<block_hash_at_trust_height>"
trust_period = "168h0m0s"

获取信任高度和哈希：

# Get a recent height and its hash from a trusted RPC
LATEST=$(curl -s https://sentry.tm.injective.network/block | jq -r '.result.block.header.height')
TRUST_HEIGHT=$((LATEST - 2000))
TRUST_HASH=$(curl -s "https://sentry.tm.injective.network/block?height=$TRUST_HEIGHT" | jq -r '.result.block_id.hash')
echo "trust_height = $TRUST_HEIGHT"
echo "trust_hash = \"$TRUST_HASH\""

State sync 不会恢复 wasm/ 目录。 CometBFT state sync 会恢复 IAVL 状态树，但不会恢复存储在 ~/.injectived/data/wasm/ 中的 CosmWasm 已编译合约字节码。缺少这些文件时，节点会在同步完成后立即出现 AppHash 不匹配。如果你遇到此问题，可以：

改用快照恢复（选项 1）。Injective 的官方快照包含 wasm/ 目录
从可信来源获取 wasm/ 目录，并在启动节点之前将其放置在 ~/.injectived/data/wasm/

PebbleDB 用户： Injective 的官方快照仅使用 goleveldb。官方不维护 PebbleDB 快照。如果你运行 PebbleDB 且无法使用快照恢复，则在使用 state sync 时必须单独获取 wasm/ 目录。

选项 3. 区块同步（完整重放）这是默认行为。节点从对等节点下载并重放每一个区块。这是最慢的方法，但不需要外部快照。除非从最近的快照高度开始同步，否则对主网并不实用。同步方法对比：

方法	速度	是否包含 wasm？	说明
快照恢复	快（数分钟）	是（官方快照）	推荐给大多数运营者
State Sync	快（数分钟）	否 —— 若不手动恢复 wasm 会导致 AppHash 不匹配	在 `config.toml` 的 `[statesync]` 中配置
区块同步	慢（数天）	不适用（通过执行构建）	默认方式，从创世开始同步主网不实用

对等节点发现

你的节点需要对等节点才能与网络同步。请将种子节点或持久对等节点添加到 ~/.injectived/config/config.toml 的 [p2p] 部分。社区提供商维护着最新的种子和对等节点列表：

Polkachu Injective 种子节点
Decentrio Injective 基础设施（种子节点、对等节点、地址簿）

你也可以下载预构建的地址簿以加快对等节点发现：

# Decentrio address book
wget -O ~/.injectived/config/addrbook.json \
  https://backend.decentrio.ventures/snapshots/injective/addrbook.json

节点软件

安装 `injectived`

每个 Injective core 发布版本都在单个 zip 中包含 injectived、peggo（Peggy 跨链桥编排器）和 libwasmvm。验证者必须在其节点旁运行 peggo。非验证者节点运营者只需要 injectived。

# Download the latest release
wget https://github.com/InjectiveFoundation/injective-core/releases/latest/download/linux-amd64.zip
unzip linux-amd64.zip
sudo mv injectived /usr/bin
sudo mv libwasmvm.x86_64.so /usr/lib

# Validators also need peggo
sudo mv peggo /usr/bin

初始化新的 Injective 节点

在运行 Injective 节点之前，请初始化链和 genesis 文件：

# <moniker> 参数是你节点的自定义用户名。它应该是人类可读的。
export MONIKER=<moniker>
injectived init $MONIKER --chain-id injective-1

运行 init 命令将在 ~/.injectived 创建 injectived 默认配置文件。

准备配置以加入 Mainnet

下载主网 genesis 文件。Injective 将其与官方快照一起提供：

# Download the mainnet genesis file
wget -O ~/.injectived/config/genesis.json \
  http://injective-mainnet-snapshots.s3-website.gra.io.cloud.ovh.net/genesis.json

验证校验和：

sha256sum ~/.injectived/config/genesis.json
# Expected: 573b89727e42b41d43156cd6605c0c8ad4a1ce16d9aad1e1604b02864015d528

为对等节点发现配置种子节点（参见同步选项部分中的对等节点发现），并在 ~/.injectived/config/config.toml 中将 timeout_commit 设置为 300ms。

使用 `app.toml` 和 `config.toml` 配置节点

两个配置文件会自动生成在 ~/.injectived/config 中：

config.toml：配置共识层（CometBFT）。在共识层文档中了解更多。
app.toml：配置节点的应用和执行层，包括状态剪枝策略、遥测、gRPC 和 REST 服务器配置、状态同步等。

为 `injectived` 配置 `systemd` 服务（可选）

编辑 /etc/systemd/system/injectived.service 的配置：

[Unit]
  Description=injectived

[Service]
  WorkingDirectory=/usr/bin
  ExecStart=/bin/bash -c '/usr/bin/injectived --log-level=error start'
  Type=simple
  Restart=always
  RestartSec=5
  User=root

[Install]
  WantedBy=multi-user.target

启动和重启 systemd 服务：

sudo systemctl daemon-reload
sudo systemctl restart injectived
sudo systemctl status injectived

# 启用系统启动时自动启动
sudo systemctl enable injectived

# 查看日志
journalctl -u injectived -f

在将快照数据加载到正确目录之前应停止服务，之后再启动。

# 停止节点
sudo systemctl stop injectived

# 启动节点
sudo systemctl start injectived

硬件

节点运营者应部署裸机服务器以实现最佳性能。验证者节点必须满足推荐的硬件规格，特别是 CPU 要求，以确保高正常运行时间。

最低要求	推荐配置
RAM 内存 128GB	RAM 内存 128GB
CPU 12 核	CPU 16 核
CPU 基础频率 3.7GHz	CPU 基础频率 4.2GHz
存储 2TB NVMe	存储 2TB NVMe
网络 1Gbps+	网络 1Gbps+

支持如有任何其他问题，你可以随时通过 Discord、Telegram 或电子邮件与 Injective 团队联系

硬件规格

节点运营者应部署裸机服务器以实现最佳性能。此外，validator 节点必须满足推荐的硬件规格，特别是 CPU 要求，以确保高正常运行时间。

最低要求	推荐配置
RAM 内存 128GB	RAM 内存 128GB
CPU 12 核	CPU 16 核
CPU 基础频率 3.7GHz	CPU 基础频率 4.2GHz
存储 2TB NVMe	存储 2TB NVMe
网络 1Gbps+	网络 1Gbps+

安装 `injectived` 和 `peggo`

请参阅 Injective releases repo 获取最新版本。非 validator 节点运营者不需要安装 peggo。

wget https://github.com/InjectiveLabs/testnet/releases/latest/download/linux-amd64.zip
unzip linux-amd64.zip
sudo mv peggo /usr/bin
sudo mv injectived /usr/bin
sudo mv libwasmvm.x86_64.so /usr/lib 

初始化新的 Injective 链节点

在运行 Injective 节点之前，我们需要初始化链以及节点的 genesis 文件：

# <moniker> 参数是你节点的自定义用户名，它应该是人类可读的。
export MONIKER=<moniker>
# Injective Testnet 的 chain-id 为 "injective-888"
injectived init $MONIKER --chain-id injective-888

运行 init 命令将在 ~/.injectived 创建 injectived 默认配置文件。

准备配置以加入 Testnet

你现在应该使用 Testnet 的 genesis 文件和应用程序配置文件更新默认配置，并使用种子节点配置你的持久对等节点。

git clone https://github.com/InjectiveLabs/testnet.git

# 将 genesis 文件复制到配置目录
aws s3 cp --no-sign-request s3://injective-snapshots/testnet/genesis.json .
mv genesis.json ~/.injectived/config/

# 将配置文件复制到配置目录
cp testnet/corfu/70001/app.toml  ~/.injectived/config/app.toml
cp testnet/corfu/70001/config.toml ~/.injectived/config/config.toml

你还可以验证 genesis 校验和 - a4abe4e1f5511d4c2f821c1c05ecb44b493eec185c0eec13b1dcd03d36e1a779

sha256sum ~/.injectived/config/genesis.json

为 `injectived` 配置 `systemd` 服务

编辑 /etc/systemd/system/injectived.service 的配置：

[Unit]
  Description=injectived

[Service]
  WorkingDirectory=/usr/bin
  ExecStart=/bin/bash -c '/usr/bin/injectived --log-level=error start'
  Type=simple
  Restart=always
  RestartSec=5
  User=root

[Install]
  WantedBy=multi-user.target

启动和重启 systemd 服务

sudo systemctl daemon-reload
sudo systemctl restart injectived
sudo systemctl status injectived

# 启用系统启动时自动启动
sudo systemctl enable injectived

# 查看日志
journalctl -u injectived -f

与网络同步

请参阅 Polkachu Injective Testnet Node Snapshot 下载快照并与网络同步。支持如有任何其他问题，你可以随时通过 Discord、Telegram 或电子邮件与 Injective 团队联系。

要轻松设置本地节点，请从 injective-core 仓库下载并运行 setup.sh 脚本。请使用与已安装的 injectived 版本匹配的脚本版本。

# 将版本标签替换为与你的 injectived 二进制文件匹配的版本
# 例如，使用 v1.18.3 的脚本：
wget https://raw.githubusercontent.com/InjectiveFoundation/injective-core/v1.18.3/setup.sh
chmod +x ./setup.sh # 使脚本可执行
./setup.sh

旧版 injective-chain-releases 仓库中的 setup.sh 脚本已过时，仅兼容 injectived v1.14.1 及更早版本。请始终使用 InjectiveFoundation/injective-core 仓库中与你的链版本对应的脚本。

通过运行以下命令启动节点：

injectived start # 运行此命令后应该开始产生区块

有关脚本执行内容的进一步说明以及对设置过程的更精细控制，请继续阅读下文。

初始化链

在运行 Injective 节点之前，我们需要初始化链以及节点的 genesis 文件：

# <moniker> 参数是你节点的自定义用户名。它应该是人类可读的。
injectived init <moniker> --chain-id=injective-1

上述命令创建节点运行所需的所有配置文件以及定义网络初始状态的默认 genesis 文件。所有这些配置文件默认位于 ~/.injectived 中，但你可以通过传递 --home 标志来覆盖此文件夹的位置。请注意，如果你选择使用 ~/.injectived 以外的目录，则每次运行 injectived 命令时都必须使用 --home 标志指定位置。如果你已有 genesis 文件，可以使用 --overwrite 或 -o 标志覆盖它。~/.injectived 文件夹具有以下结构：

.                                   # ~/.injectived
  |- data                           # 包含节点使用的数据库。
  |- config/
      |- app.toml                   # 应用程序相关配置文件。
      |- config.toml                # Tendermint 相关配置文件。
      |- genesis.json               # genesis 文件。
      |- node_key.json              # 用于 p2p 协议中节点身份验证的私钥。
      |- priv_validator_key.json    # 用于共识协议中作为 validator 的私钥。

修改 `genesis.json` 文件

此时，需要修改 genesis.json 文件：

将 staking bond_denom、crisis denom、gov denom 和 mint denom 的值更改为 "inj"，因为这是 Injective 的原生 token。

可以通过运行以下命令轻松完成：

cat $HOME/.injectived/config/genesis.json | jq '.app_state["staking"]["params"]["bond_denom"]="inj"' > $HOME/.injectived/config/tmp_genesis.json && mv $HOME/.injectived/config/tmp_genesis.json $HOME/.injectived/config/genesis.json
cat $HOME/.injectived/config/genesis.json | jq '.app_state["crisis"]["constant_fee"]["denom"]="inj"' > $HOME/.injectived/config/tmp_genesis.json && mv $HOME/.injectived/config/tmp_genesis.json $HOME/.injectived/config/genesis.json
cat $HOME/.injectived/config/genesis.json | jq '.app_state["gov"]["deposit_params"]["min_deposit"][0]["denom"]="inj"' > $HOME/.injectived/config/tmp_genesis.json && mv $HOME/.injectived/config/tmp_genesis.json $HOME/.injectived/config/genesis.json
cat $HOME/.injectived/config/genesis.json | jq '.app_state["mint"]["params"]["mint_denom"]="inj"' > $HOME/.injectived/config/tmp_genesis.json && mv $HOME/.injectived/config/tmp_genesis.json $HOME/.injectived/config/genesis.json

上述命令仅在使用默认 .injectived 目录时有效。对于特定目录，请修改上述命令或手动编辑 genesis.json 文件以反映更改。

为 Validator 账户创建密钥

在启动链之前，你需要用至少一个账户填充状态。为此，首先在 test keyring backend 下创建一个名为 my_validator 的新账户（可以选择其他名称和其他 backend）：

injectived keys add my_validator --keyring-backend=test

# 将生成的地址放入变量中以供后续使用。
MY_VALIDATOR_ADDRESS=$(injectived keys show my_validator -a --keyring-backend=test)

现在你已创建本地账户，继续在链的 genesis 文件中授予它一些 inj token。这样做还将确保你的链从创世开始就知道此账户的存在：

injectived add-genesis-account $MY_VALIDATOR_ADDRESS 100000000000000000000000000inj --chain-id=injective-1

$MY_VALIDATOR_ADDRESS 是保存 keyring 中 my_validator 密钥地址的变量。Injective 中的 token 具有 {amount}{denom} 格式：amount 是 18 位精度的十进制数，denom 是带有其面额键的唯一 token 标识符（例如 inj）。这里我们授予 inj token，因为 inj 是 injectived 中用于 staking 的 token 标识符。

将 Validator 添加到链

现在你的账户有了一些 token，你需要向链添加一个 validator。Validator 是参与共识过程以向链添加新区块的特殊全节点。任何账户都可以声明其成为 validator 运营者的意图，但只有获得足够委托的账户才能进入活跃集。在本指南中，你将把本地节点（通过上面的 init 命令创建）添加为链的 validator。可以在链首次启动之前通过包含在 genesis 文件中的特殊交易（称为 gentx）声明 validator：

# 创建 gentx。
injectived genesis gentx my_validator 1000000000000000000000inj --chain-id=injective-1 --keyring-backend=test

# 将 gentx 添加到 genesis 文件。
injectived genesis collect-gentxs

gentx 做三件事：

将你创建的 validator 账户注册为 validator 运营者账户（即控制 validator 的账户）。
自委托提供的 staking token amount。
将运营者账户与用于签署区块的 Tendermint 节点公钥链接。如果未提供 --pubkey 标志，则默认为通过上面的 injectived init 命令创建的本地节点公钥。

有关 gentx 的更多信息，请使用以下命令：

injectived genesis gentx --help

使用 `app.toml` 和 `config.toml` 配置节点

两个配置文件会自动生成在 ~/.injectived/config 中：

config.toml：用于配置 Tendermint（在 Tendermint 文档中了解更多），以及
app.toml：由 Cosmos SDK（Injective 基于此构建）生成，用于状态修剪策略、遥测、gRPC 和 REST 服务器配置、状态同步等配置。

两个文件都有详细注释——请直接参考它们来调整你的节点。一个需要调整的示例配置是 app.toml 中的 minimum-gas-prices 字段，它定义了 validator 节点愿意接受的处理交易的最低 gas 价格。如果为空，请确保编辑该字段并设置某个值，例如 10inj，否则节点将在启动时停止。在本教程中，让我们将最低 gas 价格设置为 0：

 # validator 愿意接受的处理交易的最低 gas 价格。
 # 交易的费用必须满足此配置中指定的任何面额的最低要求
 # （例如 0.25token1;0.0001token2）。
 minimum-gas-prices = "0inj"

运行本地网络

现在一切都已设置好，你终于可以启动节点了：

injectived start # 运行此命令后应该开始产生区块

此命令允许你运行单个节点，这足以通过节点与链交互，但你可能希望同时运行多个节点以查看它们之间如何达成共识。

同步选项

节点软件

硬件

​同步选项

​对等节点发现

​节点软件

​安装 injectived

​初始化新的 Injective 节点

​准备配置以加入 Mainnet

​使用 app.toml 和 config.toml 配置节点

​为 injectived 配置 systemd 服务（可选）

​硬件

​硬件规格

​安装 injectived 和 peggo

​初始化新的 Injective 链节点

​准备配置以加入 Testnet

​为 injectived 配置 systemd 服务

​与网络同步

​初始化链

​修改 genesis.json 文件

​为 Validator 账户创建密钥

​将 Validator 添加到链

​使用 app.toml 和 config.toml 配置节点

​运行本地网络

同步选项

对等节点发现

节点软件

安装 `injectived`

初始化新的 Injective 节点

准备配置以加入 Mainnet

使用 `app.toml` 和 `config.toml` 配置节点

为 `injectived` 配置 `systemd` 服务（可选）

硬件

硬件规格

安装 `injectived` 和 `peggo`

初始化新的 Injective 链节点

准备配置以加入 Testnet

为 `injectived` 配置 `systemd` 服务

与网络同步

初始化链

修改 `genesis.json` 文件

为 Validator 账户创建密钥

将 Validator 添加到链

使用 `app.toml` 和 `config.toml` 配置节点

运行本地网络