跳到主要内容

配置节点

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

如何配置节点​

配置文件​

Conflux节点的配置文件为hydra.toml，默认位于节点程序下载的run目录中。 通过修改此文件中的配置选项，您可以调整节点的行为。

命令行参数​

节点也可以使用命令行参数进行配置，命令行参数的优先级高于配置文件。 例如，可以使用--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

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

Core Space RPC​

Core Space RPC相关选项。

jsonrpc_http_port=12537 # JSON-RPC HTTP port
jsonrpc_ws_port=12535 # JSON-RPC WebSocket port
public_rpc_apis='safe' # JSON-RPC API namespace list，Multiple namespaces are separated by commas, and using "all" represents enabling all APIs.
poll_lifetime_in_seconds=60 # To open filter related methods

eSpace RPC​

eSpace RPC相关选项。

jsonrpc_http_eth_port=8545
jsonrpc_ws_eth_port=8546
public_evm_rpc_apis = "evm"

数据索引​

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

persist_block_number_index=true
persist_tx_index=true

交易跟踪​

Parity style transaction trace related options.

executive_trace=true

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

全状态（fullstate）​

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

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

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

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

enable_single_mpt_storage=true

The Conflux Foundation currently does not provide snapshot data containing the full historical state; users need to synchronize the data themselves.

PivotHint​

If you want to fully synchronize the data, you need to enable the pivot_hint related configuration option.

  • pivot_hint_path: Path to the pivot hint file
  • pivot_hint_checksum: Expected checksum of Page Digests section (hex string without "0x" prefix)

Note: These two configurations must either both be specified or both be omitted. Specifying only one will result in an error.

PivotHint file can be downloaded here

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_min_native_tx_gas_price=1_000_000_000 # 核心空间交易最低燃气价格
tx_pool_min_eth_tx_gas_price=20_000_000_000 # eSpace交易最低燃气价格

存储目录​

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

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"

Or you can pass it through environment variable: 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。

常见问题解答​

我想运行一个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

其他一般不需要重启。

I want to access Core Space debug/test RPC methods, what parameters do I need to configure?​

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