跳到主要内容

配置节点

Conflux节点提供了丰富的配置选项，允许通过修改这些设置来调整节点行为。 本文档提供了节点配置选项及其含义的概述。

How to configure nodes​

配置文件​

The configuration file for Conflux nodes is hydra.toml(testnet.toml for testnet), and by default, it is located in the run directory where the node program is downloaded. 通过修改此文件中的配置选项，您可以调整节点的行为。

命令行参数​

节点也可以使用命令行参数进行配置，命令行参数的优先级高于配置文件。 例如，可以使用--jsonrpc-http-port参数指定节点的JSON-RPC端口。

./conflux --jsonrpc-http-port 12537

可以通过运行./conflux -h查看参数的详细列表。

配置文件选项简介​

节点类型​

节点类型，有三个可能的值：full（完整）、archive（归档）、light（轻）。 默认值为full。

node_type="full"

链ID​

链ID，用于识别Conflux网络。 核心空间（Core Space）主网的链ID为1029，eSpace主网的链ID为1030。 测试网的链ID分别为1和71。

chain_id=1029
evm_chain_id=1030

通常，除非您想要设置本地测试网络，否则无需修改此配置选项。

bootnodes​

Bootnodes are the initial nodes that the node connects to when it starts. The node will discover other nodes in the network through these bootnodes.

bootnodes="cfxnode://25265e1aa470d9d8667947820c4830a64e9f9678d6cb23ecde91e0447527f4926257b9637923a305ce91e15c929ed28164e6c32b76213764eb4a9624120ae1d7@39.97.180.246:32323,cfxnode://2b72adc3f52a80945db10fa35c3f6d02c73f65ff98b4a9eae4f7b244e8a51f01690e7dcef7a30bfb67fb07fcb2949e67c27487169623d40f6a9e55a8d04ca34f@39.107.143.220:32323"

Note: The mainnet and testnet bootnodes are different, you can get mainnet bootnodes from the official-bootnodes page.

Core Space RPC​

Core Space RPC相关选项。

jsonrpc_http_port=12537 # JSON-RPC HTTP port
jsonrpc_ws_port=12535 # JSON-RPC WebSocket port
# Specify the APIs available through the public JSON-RPC interfaces (HTTP, TCP, WebSocket)
# using a comma-delimited list of API names.
# Possible Core space names are: all, safe, cfx, pos, debug, pubsub, test, trace, txpool.
# `safe` only includes `cfx` and `pubsub`, `txpool`.
public_rpc_apis='safe' 
poll_lifetime_in_seconds=60 # To open filter related methods

Note: if some method is not available(eg. method not found), you can check the public_rpc_apis and poll_lifetime_in_seconds configuration.

eSpace RPC​

eSpace RPC相关选项。

jsonrpc_http_eth_port=8545
jsonrpc_ws_eth_port=8546
# Possible eSpace names are: eth, ethpubsub, ethdebug.
# `evm` only includes `eth` and `ethpubsub`
# to use eth_debugTraceTransaction and other trace methods, you need to enable `ethdebug`
public_evm_rpc_apis = "evm"

eth_call/cfx_call max gas limit​

# By default, the maximum gas limit supported by gas estimation is 27 million for 
# core space and 15 million for espace. These limits are also supported by the majority 
# of transaction pools. You can override this parameter, but be aware that the estimated 
# gas may be rejected by transaction pools, including the transaction pool on yourself,
#
max_estimation_gas_limit = 30_000_000

数据索引​

与交易（tx）和区块相关的RPC接口默认不支持查询历史数据。 如果需要查询历史数据，必须启用数据索引。

persist_block_number_index=true
persist_tx_index=true

交易跟踪​

Parity 风格的交易跟踪相关选项

executive_trace=true

如果想要启用此配置，需要重新同步数据。

全状态（fullstate）​

全状态模式支持查询区块链的历史状态。

要为单个空间启用全状态模式，可以使用single_mpt_space配置选项指定空间名称。

single_mpt_space = "evm" # 核心空间使用"native"

启用双空间的全状态模式。

enable_single_mpt_storage=true

目前，Conflux 基金会不提供包含完整历史状态的快照数据，用户需要自行同步数据。 要运行一个支持在任意区块高度查询区块链状态的 fullstate node 节点，您需要使用一个特殊编译的 Conflux 客户端程序。 目前，官方的二进制发布版本未启用此功能，您需要自行编译。 The compilation command is:

cargo build --release --features u64-mpt-db-key

PivotHint​

如果您想要完全同步数据，您需要启用与 pivot_hint 相关的配置选项。

  • pivot_hint_path: pivot hint文件的路径
  • pivot_hint_checksum:Page Digests 部分的预期校验和（十六进制字符串，不带“0x”前缀）

注意：这两个配置项必须同时指定或同时省略。 如果只指定其中一个，将会导致错误。

PivotHint文件可以在这里下载。

cfx_getLogs/eth_getLogs相关选项​

getLogs RPC方法对节点造成了显著的性能负担。 过度查询此方法的数据可能导致节点负载高。 为了缓解这一点，调整以下配置选项以限制每个getLogs请求请求的数据量。

get_logs_filter_max_limit=1000
get_logs_epoch_batch_size=1000
get_logs_filter_max_epoch_range=1000
get_logs_filter_max_block_number_range=2000

日志​

与节点日志相关的配置选项。

log_conf="log.yaml" # 日志配置文件
log_file="conflux.log"
log_level="info" # 值应为 "error"、"warn"、"info"、"debug"、"trace"、"off" 其中之一

PoW挖矿​

与工作量证明（PoW）挖矿相关的配置选项。

mining_author="cfx:aarc9abycue0hhzgyrr53m6cxedgccrmmyybjgh4xg"
stratum_listen_address="127.0.0.1"
stratum_port=32525
stratum_secret="aaaa"
pow_problem_window_size=1

交易池​

与交易池相关的配置选项。

tx_pool_size=50000 # tx pool size
tx_pool_min_native_tx_gas_price=1_000_000_000 # core space tx minimum gas price
tx_pool_min_eth_tx_gas_price=20_000_000_000 # eSpace tx minimum gas price
# Controls whether transactions exceeding half of the gas limit are allowed to be packed.
# If set to false, transactions exceeding half of the gas limit will not be packed.
# For eSpace the block gas limit is 30 million, so the threshold is 15 million.
tx_pool_allow_gas_over_half_block = false

存储目录​

区块链数据存储目录配置：

conflux_data_dir="./blockchain_data"
block_db_dir="./blockchain_data/blockchain_db"
netconf_dir="./blockchain_data/net_config"

pos 相关选项​

pos_key 密码​

用于加密PoS私钥的密码，用来保护PoS私钥。 默认情况下，这个密码是在节点首次启动时通过命令行交互设置的。 您可以通过配置文件设置此密码以避免命令行交互。

dev_pos_private_key_encryption_password="aaaa"

或者您可以通过环境变量传递它: CFX_POS_KEY_ENCRYPTION_PASSWORD。

pos 配置文件​

以下是 PoS 配置文件、初始节点文件和私钥文件的默认路径。 您可以修改这些路径来自定义 PoS 配置。

# PoS 配置文件路径
pos_config_path=./pos_config/pos_config.yaml
# PoS 初始节点文件路径
pos_initial_nodes_path=./pos_config/initial_nodes.json
# PoS 账户私钥文件路径
pos_private_key_path=./pos_config/pos_key

发布包含一个默认的 PoS 配置文件，可以在 pos_config 目录中找到。 pos_key 文件将在第一次节点启动后自动生成。

存储优化​

相关的存储优化选项。

# 为 MPT 表使用独立数据库
# 将其设置为 true 将减少磁盘使用量
# 在 v2.3.4 中引入 https://github.com/Conflux-Chain/conflux-rust/releases/tag/v2.3.4
use_isolated_db_for_mpt_table=true

配置文件示例​

要获得更全面的配置文件示例，您可以参考hydra.toml。 There are more configuration options (with annotated explanations) available in the configuration file, and you can adjust them according to your needs.

常见问题解答​

我想运行一个Core Space RPC节点，我需要配置哪些参数？​

node_type="archive"
jsonrpc_http_port=12537
jsonrpc_ws_port=12535
public_rpc_apis='safe'
persist_block_number_index=true
persist_tx_index=true
max_estimation_gas_limit=30000000

我想运行一个eSpace RPC节点，我需要配置哪些参数？​

node_type="archive"
jsonrpc_http_eth_port=8545
jsonrpc_ws_eth_port=8546
public_evm_rpc_apis = "evm"
persist_block_number_index=true
persist_tx_index=true
max_estimation_gas_limit=30000000

我的节点运行了一段时间后，我想启用executive_trace配置。 我需要重新同步数据吗？​

是的，您需要重新同步数据。

官方提供的归档节点快照数据是否包含trace数据？​

是的，包含。

修改配置后，我需要清除数据然后重启节点吗？​

根据情况而定，有时需要，有时不需要。 如果配置涉及数据存储或数据索引，配置更改时需要重启节点，例如：

  • persist_tx_index
  • executive_trace
  • persist_block_number_index

其他一般不需要重启。

我要访问 Core Space 的调试/测试 RPC 方法，需要配置哪些参数？​

jsonrpc_local_http_port=12539 # this is the port for debug/test RPC methods