原文作者：PaperMoon团队

介绍

Polkadot SDK 提供了一个灵活且可扩展的区块链开发框架，使你能够根据具体的应用或业务需求创建定制化区块链。

本教程将引导你使用 Polkadot SDK Parachain Template 编译并运行一个平行链节点。

该平行链模板提供了一个预配置且可直接使用的运行时（runtime），可用于本地开发环境。模板中包含多个关键组件，例如用户账户和账户余额。

这些预置元素让你无需修改模板即可实验常见的区块链操作。在本教程中，你将完成以下内容：
    •    构建并启动一个本地平行链节点（基于 node template）
    •    学习如何通过前端界面：
    •    查看区块链活动信息
    •    提交一笔交易

前置条件

在开始之前，请确保你已经完成以下步骤：
    •    已完成《Install Polkadot SDK Dependencies》指南，并成功安装 Rust 及搭建开发环境所需的依赖包
    •    本系列教程必须使用 Rust 1.86。更新版本的编译器可能无法兼容该版本的平行链模板

macOS代码1， Ubuntu代码2

rustup install 1.86
rustup default 1.86
rustup target add wasm32-unknown-unknown --toolchain 1.86-aarch64-apple-darwin
rustup component add rust-src --toolchain 1.86-aarch64-apple-darwin

rustup toolchain install 1.86.0
rustup default 1.86.0
rustup target add wasm32-unknown-unknown --toolchain 1.86.0
rustup component add rust-src --toolchain 1.86.0

工具

本教程需要两个关键工具：

1. Chain spec builder

Chain spec builder 是 Polkadot SDK 提供的工具，用于生成链规范（chain specification）。详细用法请参考 Generate Chain Specs 文档。

通过以下命令安装：

cargo install --locked staging-chain-spec-builder@10.0.0

2. Polkadot Omni Node

Polkadot Omni Node 是 Polkadot SDK 提供的白标（white-labeled）二进制程序，可在生产环境中作为平行链的 collator 节点运行，具备完整的辅助功能，例如：
    •    RPC 服务器
    •    状态归档
    •    网络与共识相关组件

此外，它还可以在本地运行平行链的 wasm 文件，用于测试和开发。

安装命令如下：

该命令会安装 chain-spec-builder 可执行文件。

cargo install --locked polkadot-omni-node@0.5.0

该命令会安装 polkadot-omni-node 二进制文件。

编译 Runtime

Polkadot SDK Parachain Template 提供了一个开箱即用的开发环境。请按照以下步骤编译 runtime：
    1.    克隆模板仓库：

git clone -b v0.0.4 https://github.com/paritytech/polkadot-sdk-parachain-template.git parachain-template

    2.    进入项目目录：

cd parachain-template

    3.    编译 runtime：

cargo build --release --locked

提示（Tip）
    •    初次编译可能需要几分钟，具体取决于你的机器性能
    •    使用 release 相比默认的debug 构建可以获得更好的运行时性能
    •    如需排查问题，debug 构建提供更清晰的诊断信息
    •    在生产环境中，可考虑使用profile production，相比 release 可额外提升约 15–30% 的性能

成功后，你将看到类似如下输出：

Finished release profile [optimized] target(s) in 1.79s

启动本地链

成功编译后，你可以启动一个本地链并开始产块。该过程将启动你的本地平行链，并允许你与其交互。

首先需要生成一个链规范（chain spec），用于定义网络身份、初始连接以及创世状态。然后运行该链。

启动步骤如下：
    1.    生成平行链的链规范文件：

chain-spec-builder create -t development \
--relay-chain paseo \
--para-id 1000 \
--runtime ./target/release/wbuild/parachain-template-runtime/parachain_template_runtime.compact.compressed.wasm \
named-preset development

    2.    使用生成的 chain spec 启动 omni node（开发模式，不连接 relay chain）：

polkadot-omni-node --chain ./chain_spec.json --dev

dev 参数的作用包括：
    •    停止节点时删除所有数据（密钥、区块数据库、网络信息等）
    •    每次重启节点都确保一个干净的状态

验证节点是否正常运行

查看终端输出，你应该能看到类似如下内容：

（日志略，内容与原文一致）

只要你看到 finalized #X 的区块高度在不断增长，就说明你的区块链正在正常出块。

与节点交互

当模板节点运行时，默认可通过以下地址访问：

ws://localhost:9944

你可以使用 Polkadot.js Apps 前端界面与节点交互：
    1.    打开 Polkadot.js Apps

    2.    点击左上角网络图标（Polkadot logo）
    3.    连接到本地节点：
    •    滚动到最底部，选择 Development
    •    选择 Custom

    •    在输入框中输入：ws://localhost:9944
    •    点击 Switch

验证连接
    •    左上角显示 parachain-template-runtime
    •    界面中会展示本地区块链的相关信息

现在你已经成功连接到本地节点，可以通过 Polkadot.js Apps：
    •    浏览区块
    •    提交交易
    •    调用链上功能

如需深入了解该界面的使用方式，请参考 Polkadot Wiki 中的 Polkadot.js Guides。

停止节点

当你完成本地节点的探索后，可以停止节点并清除状态数据。

由于你是通过 --dev 模式启动节点的，停止节点后所有区块数据都会被清除，下次可从干净状态重新开始。

停止步骤：
    1.    回到显示节点日志的终端窗口
    2.    按下 Control-C
    3.    确认终端返回到 parachain-template 目录的命令行提示符

到此为止，你已经完成了部署一条区块链的第一个关键阶段：让链真正跑起来。
更具体地说，你已经做到：
    •    基于 Polkadot SDK Parachain Template 成功编译了一个完整的区块链 runtime
    •    生成了属于你这条链的 chain spec（创世配置），明确了链的身份、paraId 和初始状态
    •    启动了一个可以持续产块的本地平行链节点
    •    通过 Polkadot.js Apps 成功连接到链，并验证了链是可交互、可调用的

此时，你的链已经具备了最基本但也是最重要的能力：
    •    有运行中的共识与区块生产
    •    有状态、账户和余额
    •    有 RPC 接口和前端交互入口

下一篇文章我们会介绍更重要的事，真正决定「这条链是做什么的」。

原文链接：https://docs.polkadot.com/tutorials/polkadot-sdk/parachains/zero-to-hero/set-up-a-template/