[stacks 区块链开发文档] 使用 Docker 配置并运行 stacks 区块链本地 testnet 测试网络节点

https://docs.stacks.co/understand-stacks/runnin-testnet-node

英语原文链接

介绍

此过程演示了如何使用 Docker 镜像来运行 stacks 区块链本地测试网节点。

此过程侧重于类 Unix 操作系统（ Linux 和 MacOS ）。此过程尚未在 Windows 上进行测试。

前期准备：

运行节点没有专门的硬件要求。用户已经成功地在 Raspberry Pi 和其他系统架构上运行节点。为了完成此过程，您必须在节点主机上安装以下软件：

• Docker

• curl

• jq

防火墙配置：

为了使 API 节点服务正常工作，您必须配置任何网络防火墙规则以允许本节中讨论的端口上的流量。网络和防火墙配置的详细信息与您的机器和网络相关，因此不提供详细示例。以下端口必须在主机上打开：

入口:

• stacks-blockchain (open to 0.0.0.0/0):

• 20443 TCP

• 20444 TCP

出口:

• 18332

• 18333

• 20443-20444

这些出口端口用于同步 stacks 区块链和比特币头部信息。如果它们未打开，则同步将失败。

第一步：初始化配置

为了运行 testnet 节点，您必须下载 Docker 镜像并创建一个目录结构来保存来自网络的持久数据。你可以使用以下命令下载并配置 Docker 镜像：

docker pull blockstack/stacks-blockchain 

使用以下命令为服务数据创建目录结构：

mkdir -p ./stacks-node/persistent-data/stacks-blockchain/testnet && cd stacks-node 

第二步：运行 stacks 区块链

使用以下命令启动 stacks-区块链 容器：

docker run -d --rm \ --name stacks-blockchain \ -v $(pwd)/persistent-data/stacks-blockchain/testnet:/root/stacks-node/data \ -p 20443:20443 \ -p 20444:20444 \ blockstack/stacks-blockchain \ /bin/stacks-node xenon 

您可以使用以下命令验证正在运行的 stacks 区块链容器：

docker ps --filter name=stacks-blockchain 

第三步；验证服务

最初的 burnchain 头同步可能需要几分钟，直到同步完成，以下命令才会起作用。

验证 stacks 区块链 burnchain 头同步进度：

docker logs stacks-blockchain 

终端输出应该类似于以下内容：

INFO [1626290705.886954] [src/burnchains/bitcoin/spv.rs:926] [main] Syncing Bitcoin headers: 1.2% (8000 out of 2034380) INFO [1626290748.103291] [src/burnchains/bitcoin/spv.rs:926] [main] Syncing Bitcoin headers: 1.4% (10000 out of 2034380) INFO [1626290776.956535] [src/burnchains/bitcoin/spv.rs:926] [main] Syncing Bitcoin headers: 1.7% (12000 out of 2034380) 

要验证 stacks-blockchain 尖端高度是否在进行中，请使用以下命令：

curl -sL localhost:20443/v2/info | jq 

如果实例正在运行，您的终端会输出类似于以下内容的信息：

{ "peer_version": 4207599105, "pox_consensus": "12f7fa85e5099755a00b7eaecded1aa27af61748", "burn_block_height": 2034380, "stable_pox_consensus": "5cc4e0403ff6a1a4bd17dae9600c7c13d0b10bdf", "stable_burn_block_height": 2034373, "server_version": "stacks-node 2.0.11.2.0-rc1 (develop:7b6d3ee+, release build, linux [x86_64])", "network_id": 2147483648, "parent_network_id": 118034699, "stacks_tip_height": 509, "stacks_tip": "e0ee952e9891709d196080ca638ad07e6146d4c362e6afe4bb46f42d5fe584e8", "stacks_tip_consensus_hash": "12f7fa85e5099755a00b7eaecded1aa27af61748", "genesis_chainstate_hash": "74237aa39aa50a83de11a4f53e9d3bb7d43461d1de9873f402e5453ae60bc59b", "unanchored_tip": "32bc86590f11504f17904ee7f5cb05bcf71a68a35f0bb3bc2d31aca726090842", "unanchored_seq": 0, "exit_at_block_height": null } 

如何停止测试网节点

使用以下命令停止本地 testnet 节点：

docker stop stacks-blockchain