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），僅供參考 Docker部署Parachain節點：Cumulus容器化部署與鏡像構建完整指南
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），僅供參考