Docker部署Parachain节点Cumulus容器化部署与镜像构建完整指南【免费下载链接】cumulusWrite Parachains on Substrate项目地址: https://gitcode.com/gh_mirrors/cum/cumulusCumulus 是 Parity 开源的 Substrate Parachain 开发框架而 Docker 容器化部署 Parachain 节点 是快速搭建测试链、验证 Collator出块节点行为的最快方式。本指南带你用容器完成 Cumulus 镜像构建与节点部署全程无需在本地安装 Rust 工具链几分钟即可跑通一个完整的 Parachain 测试网络。为什么选择容器化部署 CumulusParachain 节点的构建依赖庞大的 Rust 工具链本地编译往往耗时数十分钟甚至数小时。使用 Docker或 Podman部署 Cumulus 节点有三大好处环境隔离构建和运行互不污染本机零依赖可复现镜像化交付团队协作与 CI 流水线开箱即用最小足迹不占本机磁盘和内存资源docker-compose一条命令拉起整条测试链官方文档对容器用法的说明位于docs/container.md其中明确指出Podman 与 Docker 命令可互换可通过alias dockerpodman直接兼容。四种容器镜像构建方式按需选择Cumulus 提供了从开箱即用到完全自编译的 4 种镜像方案难度递增方式适用场景难度关键文件官方镜像直接拉取现成镜像运行节点⭐parity/polkadot-parachain镜像Parity CI 镜像用容器代替本地编译出 Linux 二进制⭐⭐docker/scripts/build_polkadot.sh二进制注入镜像已有编译好的二进制快速打包⭐⭐docker/injected.Dockerfile容器内全量构建零本地环境一行命令出镜像⭐⭐⭐docker/polkadot-parachain_builder.Containerfile方式一拉取 Parity 官方镜像官方维护的容器镜像可直接用于运行节点是最快验证 Cumulus 的方式。方式二用 CI 镜像编译 Linux 二进制借助 Parity 内部通用的 CI 基础镜像不需要安装 Rust 即可编译出 Linux 二进制编译产物位于target/目录为后续注入镜像做准备。方式三二进制注入Injected Image这是最快得到一个可用镜像的办法把编译好的polkadot-parachain二进制注入到 Parity 基础镜像parity/base-bin中。注入逻辑由docker/injected.Dockerfile完成它会自动拷贝parachains/chain-specs/下的所有链规格到镜像的/specs目录并暴露 30333、9933、9944、9615 四个端口。方式四Containerfile 容器内全量构建完全不想碰编译环境直接执行容器内构建由docker/polkadot-parachain_builder.Containerfile负责在 CI 基础镜像里完成整个 Cargo Release 编译。耗时较长但对新手最友好——无需本地 Rust 工具链构建完成后即可用--collator --tmp参数快速启动测试节点。一键部署Docker Compose 拉起完整测试网络Cumulus 内置了一套开箱即用的测试编排文件docker/docker-compose.yml一次docker-compose up就能同时启动6 个容器服务作用镜像/构建来源node_alice/node_bob两个 Relay Chain 全节点固定 IP 172.28.1.1 / 172.28.1.2polkadot:${BRANCH}镜像genesis_state导出 Parachain 创世状态到共享卷docker/test-parachain-collator.dockerfilecollator测试 Parachain 的出块节点Collator同上collator构建阶段runtime输出编译好的 Parachain Runtime WASM 到共享卷同上runtime构建阶段registrar等待就绪后自动调用registrar.registerPara注册 Parachain 100docker/parachain-registrar.dockerfile整套流程自动完成编译 Runtime → 导出创世状态 → 等待 Relay Chain 节点就绪 → 发送注册交易 → 启动 Collator。其中注册脚本docker/scripts/register_para.sh会等待 Runtime WASM 与创世状态文件写入共享卷再通过polkadot-js-api以//Alice账户发起注册交易Collator 启动脚本docker/scripts/inject_bootnodes.sh则会自动从 Alice/Bob 节点的 RPC 接口获取 Peer ID 并注入 bootnodes彻底省去手工配置。最快启动方式在仓库根目录执行以下两个脚本即可完成构建 后台启动启动测试链与 Collatordocker/scripts/run_collator.sh内部执行docker builddocker-compose up -d停止 Collatordocker/scripts/stop_collator.sh如果你只想手动构建某个镜像可执行docker/scripts/build_docker.sh并指定目标 dockerfile脚本会自动以文件名作为镜像名打标签。端口速查表宿主机映射的常用端口如下便于用 Polkadot.js Apps 等工具接入节点P2PRPC (9933 系)WS (9944 系)Alice3033399339944Bob3034499359945健康检查如何确认 Parachain 节点部署成功docker/test-parachain-collator.dockerfile中为 Collator 配置了 HEALTHCHECK执行docker/scripts/healthcheck.sh该脚本两次查询 Parachain 100 的parachains.heads间隔 60 秒只要 Head 发生变化即说明Collator 已在持续为 Parachain 生产区块部署成功。检查间隔设为 300 秒避免频繁 RPC 请求。常见问题与排错清单⏳首次构建很慢Containerfile 全量构建需编译整个 Cargo 工作区请耐心等待构建阶段结果会被缓存二次启动可复用。Podman 用户全部命令中把docker换成podman或建立 alias 即可。WS 连不上确认 Collator 已注入正确的 bootnodes查看容器日志中--bootnodes参数并确认 Relay Chain 节点 RPC 已就绪。本地二进制开发若你已用 CI 镜像编译出polkadot-parachain可用注入镜像方式三省去容器内编译环节。延伸阅读容器使用完整说明docs/container.md测试网络编排与卷定义docker/docker-compose.yml多阶段构建builder / collator / runtime 三个目标docker/test-parachain-collator.dockerfile集成测试网络拓扑zombienet/examples/small_network.toml掌握了以上 4 种镜像构建方式和 Compose 一键部署流程你就已经具备用 Docker 容器化运行 Cumulus Parachain 节点的全部能力——从本地开发测试到 CI 流水线交付一条命令即可完成。【免费下载链接】cumulusWrite Parachains on Substrate项目地址: https://gitcode.com/gh_mirrors/cum/cumulus创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考