进阶 docs.nethermind.io 2026-11-13 08:27:03 · 13 阅读
第13章 开发者指南
版本:2.2.0 从源码构建 可以从 GitHub 上的仓库获取 Nethermind 的源代码:
git clone --recursive https://github.com/nethermindeth/nethermind.git
从源码构建 Nethermind 有两种方式: 独立二进制文件 Docker 镜像 提示 要实现可复现构建,需满足以下条件: 环境变量 CI 必须设置为 true。 环境变量 SOURCE_DATE_EPOCH 在每次构建时必须设置为相同的 Unix 时间戳。 MSBuild 属性 SourceRevisionId 在每次构建时必须设置为相同的 Git commit hash。如果项目根目录下存在 .git 目录,这一步会自动处理。 构建独立二进制文件 前置条件 要从源码构建 Nethermind,需要安装 .NET SDK 10 或更高版本。 构建 要同时构建客户端和测试,请在项目根目录下运行以下命令: dotnet build src/Nethermind/Nethermind.slnx -c release
如果只想以指定配置运行客户端而不构建测试,请参见下文。 注意 运行客户端或测试之前,请确保满足平台相关的前置条件。 运行 Nethermind 可以直接启动,无需显式编译(因此可以跳过上一步)。以下命令会在需要时自动构建并运行 Nethermind: cd src/Nethermind/Nethermind.Runner
dotnet run -c release -- -c mainnet
所有 Nethermind 专有参数都可以在 -- 之后指定。例如,上面的命令就指定了 Mainnet 配置。 构建产物位于 src/Nethermind/artifacts/bin/Nethermind.Runner/release 目录,日志和数据库目录默认也在这里。 更多信息请参阅运行节点。 测试 测试套件有两套:Nethermind 和 Ethereum Foundation。可以用以下命令运行测试(无需先执行构建步骤): cd src/Nethermind
# 运行 Nethermind 测试
dotnet test --solution Nethermind.slnx -c release
# 运行 Ethereum Foundation 测试
dotnet test --solution EthereumTests.slnx -c release
构建 Docker 镜像 提示:构建 Nethermind Docker 镜像无需克隆 Nethermind 源码,因为 Docker 可以直接从仓库构建。更多信息请参阅 Docker Docs。 目前项目根目录下有三个 Docker 镜像: Dockerfile:默认的 Nethermind Docker 镜像。 Dockerfile.chiseled:无 root、chiseled 版本的 Nethermind Docker 镜像。 Dockerfile.diag:预装了 .NET 诊断和跟踪工具的镜像。此镜像仅供内部使用,不会通过公开渠道分发。 所有 Docker 镜像都支持以下可选参数: BUILD_CONFIG:构建配置,可选 release 或 debug,默认为 release。 CI:主要用于 CI 构建,指定构建是否为确定性构建。必须为 true 或 false,默认为 true。 COMMIT_HASH:用作版本字符串一部分的 Git commit hash。 SOURCE_DATE_EPOCH:以 Unix 时间戳表示的构建时间,默认为当前时间。 基于以上说明,以下命令可从项目根目录构建 Nethermind chiseled Docker 镜像: docker build . \
-f Dockerfile.chiseled \
-t nethermind-chiseled \
--build-arg COMMIT_HASH=$(git rev-parse HEAD) \
--build-arg SOURCE_DATE_EPOCH=$(git log -1 --format=%ct)
如果只是快速测试镜像,上述参数在不需要时可以省略: docker build . -t nethermind
更快的做法是直接从仓库构建镜像。以下命令构建 1.27.0 版本: docker build "https://github.com/nethermindeth/nethermind.git#1.27.0" -t nethermind
如有需要,上述可选参数同样可以指定。 关于运行 Docker 容器的更多信息, 请参阅 Installing Nethermind。
从源码构建 Nethermind 有两种方式: 独立二进制文件 Docker 镜像 提示 要实现可复现构建,需满足以下条件: 环境变量 CI 必须设置为 true。 环境变量 SOURCE_DATE_EPOCH 在每次构建时必须设置为相同的 Unix 时间戳。 MSBuild 属性 SourceRevisionId 在每次构建时必须设置为相同的 Git commit hash。如果项目根目录下存在 .git 目录,这一步会自动处理。 构建独立二进制文件 前置条件 要从源码构建 Nethermind,需要安装 .NET SDK 10 或更高版本。 构建 要同时构建客户端和测试,请在项目根目录下运行以下命令: dotnet build src/Nethermind/Nethermind.slnx -c release
如果只想以指定配置运行客户端而不构建测试,请参见下文。 注意 运行客户端或测试之前,请确保满足平台相关的前置条件。 运行 Nethermind 可以直接启动,无需显式编译(因此可以跳过上一步)。以下命令会在需要时自动构建并运行 Nethermind: cd src/Nethermind/Nethermind.Runner
dotnet run -c release -- -c mainnet
所有 Nethermind 专有参数都可以在 -- 之后指定。例如,上面的命令就指定了 Mainnet 配置。 构建产物位于 src/Nethermind/artifacts/bin/Nethermind.Runner/release 目录,日志和数据库目录默认也在这里。 更多信息请参阅运行节点。 测试 测试套件有两套:Nethermind 和 Ethereum Foundation。可以用以下命令运行测试(无需先执行构建步骤): cd src/Nethermind
# 运行 Nethermind 测试
dotnet test --solution Nethermind.slnx -c release
# 运行 Ethereum Foundation 测试
dotnet test --solution EthereumTests.slnx -c release
构建 Docker 镜像 提示:构建 Nethermind Docker 镜像无需克隆 Nethermind 源码,因为 Docker 可以直接从仓库构建。更多信息请参阅 Docker Docs。 目前项目根目录下有三个 Docker 镜像: Dockerfile:默认的 Nethermind Docker 镜像。 Dockerfile.chiseled:无 root、chiseled 版本的 Nethermind Docker 镜像。 Dockerfile.diag:预装了 .NET 诊断和跟踪工具的镜像。此镜像仅供内部使用,不会通过公开渠道分发。 所有 Docker 镜像都支持以下可选参数: BUILD_CONFIG:构建配置,可选 release 或 debug,默认为 release。 CI:主要用于 CI 构建,指定构建是否为确定性构建。必须为 true 或 false,默认为 true。 COMMIT_HASH:用作版本字符串一部分的 Git commit hash。 SOURCE_DATE_EPOCH:以 Unix 时间戳表示的构建时间,默认为当前时间。 基于以上说明,以下命令可从项目根目录构建 Nethermind chiseled Docker 镜像: docker build . \
-f Dockerfile.chiseled \
-t nethermind-chiseled \
--build-arg COMMIT_HASH=$(git rev-parse HEAD) \
--build-arg SOURCE_DATE_EPOCH=$(git log -1 --format=%ct)
如果只是快速测试镜像,上述参数在不需要时可以省略: docker build . -t nethermind
更快的做法是直接从仓库构建镜像。以下命令构建 1.27.0 版本: docker build "https://github.com/nethermindeth/nethermind.git#1.27.0" -t nethermind
如有需要,上述可选参数同样可以指定。 关于运行 Docker 容器的更多信息, 请参阅 Installing Nethermind。