frequencychain/standalone-node

Frequency本地独立密封模式Collator节点

镜像概述和主要用途

该镜像运行一个Frequency parachain的collator节点，以本地独立模式运行，不连接任何其他节点。默认采用即时密封模式，当交易进入验证交易池时会触发区块生成。"collator节点"是指主动生成区块（即形成区块提交至relay chain，尽管在此模式下无需relay chain）的Frequency parachain节点。

核心功能和特性

• 独立运行：单节点部署，不与其他节点建立连接，适用于本地隔离环境
• 灵活密封模式：支持即时密封（默认）、手动密封和间隔密封三种模式
• RPC接口暴露：默认开放JSON-RPC接口，支持区块操作、状态查询等功能
• 开发友好配置：内置开发链参数，自动配置CORS、日志级别等开发常用设置

使用场景和适用范围

主要用于本地开发和测试环境，无需连接relay chain或其他节点网络，可快速搭建Frequency parachain节点环境，验证交易处理、区块生成逻辑及智能合约部署等功能。

使用方法和配置说明

快速运行

通过以下命令快速启动本地独立节点，默认映射RPC端口9944：

sh
docker run --rm -p 9944:9944 frequencychain/standalone-node:<version.tag>

注意：--rm选项会在容器停止后自动删除关联卷，避免数据残留。

手动触发区块

在手动密封模式下或需在即时密封模式生成空区块时，可通过engine_createBlock RPC调用触发区块生成：

sh
curl http://localhost:9944 -H "Content-Type:application/json;charset=utf-8" -d   '{ \
    "jsonrpc":"2.0", \
    "id":1, \
    "method":"engine_createBlock", \
    "params": [true, true] \
    }'

默认参数说明

环境变量配置

通过环境变量可覆盖部分默认配置，适用于无法修改容器启动命令（如GitHub Actions）的场景：

参数覆盖示例

通过命令行参数可覆盖默认行为，例如启用手动密封模式：

sh
docker run --rm -p 9944:9944 frequencychain/standalone-node:<version.tag> -- --manual-seal

查看所有可用参数：

sh
docker run --rm frequencychain/standalone-node:<version.tag> -- --help

端口与资源管理器