Config
节点配置详解
全面掌握 aeternity.yaml 与环境变量
配置文件结构
Aeternity 节点默认读取 aeternity.yaml。如果是 Docker 部署，通常映射到容器内的 /home/aeternity/aeternity.yaml。
chain:
# 数据持久化开关
persist: true
# 数据库路径 (Mnesia/RocksDB)
db_path: ./data/mnesia
http:
external:
port: 3013 # 对外 API 端口
internal:
port: 3113 # 内部管理端口 (勿暴露到公网)
websocket:
channel:
port: 3014 # 状态通道 WebSocket 端口mining:
# 是否自动开始挖矿
autostart: true
# 挖矿收益接收地址
beneficiary: "ak_2dATVcZ9KF..."
# 算法配置 (Cuckoo Cycle)
cuckoo:
edge_bits: 29
miners:
- executable: mean29-avx2
extra_args: ""
主网挖矿通常需要连接矿池（Stratum），单独配置见 Stratum 部分。
peers:
# 种子节点列表 (用于初始发现)
- "aenode://[email protected]:3015"
sync:
# 同步端口
port: 3015
# 单个请求获取的区块数
max_headers: 100
环境变量覆盖
所有配置项都可以通过环境变量覆盖，格式为：AE__{SECTION}__{KEY} (双下划线分隔)。
| YAML 配置 | 环境变量 | 示例值 |
|---|---|---|
chain.persist |
AE__CHAIN__PERSIST |
true |
mining.beneficiary |
AE__MINING__BENEFICIARY |
ak_... |
fork_management.network_id |
AE__FORK_MANAGEMENT__NETWORK_ID |
ae_mainnet |
技巧： 在 Docker Compose 中使用环境变量通常比挂载配置文件更灵活。
高级配置
Stratum 矿池协议
如果你运行的是矿池节点，需要开启 Stratum 服务：
stratum:
enabled: true
port: 9999
reward:
reward_type: key_block垃圾回收 (GC)
控制内存占用和数据库大小：
chain:
db_direct_access: true
garbage_collection:
enabled: true
interval: 1000 # 区块间隔