区块链原理 / 系统课时

安装节点并启动 regtest 网络

安装节点并启动 regtest 网络

在 x86_64 Linux 上固定安装 Bitcoin Core 31.0,先验证发行包的签名与哈希,再把节点数据放入独立目录,启动不连接主网的 regtest 进程,并通过 RPC 确认当前链与区块高度。

学习目标

  • 校验 Bitcoin Core 31.0 安装包与可信签署者的签名。
  • 使用独立数据目录启动仅供本机实验的 regtest 节点。
  • 通过 bitcoin-cli 验证 RPC 连通性并排查常见启动错误。

确认运行环境与隔离目录

以下操作适用于 x86_64 Linux 的 Bash 终端(例如 Ubuntu 22.04/24.04),需要 curl、git、gpg、sha256sum、tar 和 grep。执行 uname -m 应得到 x86_64;ARM64、macOS 或 Windows 应在31.0 官方发行目录选择对应安装包,不能直接照搬 Linux 文件名与命令。

实验根目录设为 $HOME/bitcoin-core-31-lab,程序解压在根目录,链数据存放在 data/regtest。-datadir 指向独立的 data,避免读写默认的 ~/.bitcoin 主网目录。regtest 使用独立的创世块与共识参数,节点初始高度为 0,默认 RPC 端口为 18443。

验证下载包的来源与完整性

SHA256SUMS 列出文件哈希;SHA256SUMS.asc 是对该清单的签名。仅凭“本地哈希与下载的清单一致”无法排除两者同时被替换,因此先用已核对指纹的签署者公钥验证清单,再校验压缩包。

开发者公钥、签名清单与安装包的验证关系

在 Bash 中执行以下命令;guix.sigs 存放可导入的构建签署者公钥。导入后还须通过独立可信渠道核对准备信任的密钥指纹,不能把“成功导入”当作信任证明。

bash
set -e
LAB="$HOME/bitcoin-core-31-lab"
mkdir -p "$LAB/downloads"
cd "$LAB/downloads"
BASE="https://bitcoincore.org/bin/bitcoin-core-31.0"
for name in SHA256SUMS SHA256SUMS.asc bitcoin-31.0-x86_64-linux-gnu.tar.gz; do
  curl -fLO "$BASE/$name"
done
git clone --depth 1 https://github.com/bitcoin-core/guix.sigs.git
# 导入公钥不等于信任公钥,必须独立核对签署者指纹
gpg --import guix.sigs/builder-keys/*
# 先验证校验清单的签名,再核对下载文件的摘要
gpg --verify SHA256SUMS.asc SHA256SUMS
sha256sum --ignore-missing --check SHA256SUMS

预期结果:GPG 对已核对指纹的签署者报告 Good signature,哈希检查包含以下一行;具体签署者信息与下载进度会不同。

text
bitcoin-31.0-x86_64-linux-gnu.tar.gz: OK

解压并启动本地节点

签名与哈希都通过后解压官方 Linux 发行包。保持数据目录独立并只允许当前用户访问;-listen=0 关闭入站 P2P 监听,RPC 默认只监听本机,不要将 RPC 端口暴露到公网。

bash
LAB="$HOME/bitcoin-core-31-lab"
mkdir -p "$LAB/data"
chmod 700 "$LAB/data"
tar -xzf "$LAB/downloads/bitcoin-31.0-x86_64-linux-gnu.tar.gz" -C "$LAB"
# 后台启动 regtest,使用独立数据目录和 RPC 服务
"$LAB/bitcoin-31.0/bin/bitcoind" -regtest -datadir="$LAB/data" -daemon -server=1 -listen=0

预期输出:

text
Bitcoin Core starting

-daemon 仅表示后台进程已被请求启动;真正就绪还要执行 RPC 检查。首次启动会在 data/regtest 产生 debug.log、链状态文件和用于本机 RPC 认证的 .cookie,无须设置明文 rpcpassword。

验证 RPC 与处理启动失败

使用同一 -datadir 和 -regtest 调用 bitcoin-cli。-rpcwait 会等待 RPC 服务就绪,getblockchaininfo 返回当前链状态。用 grep 只显示本次验收需要的两个字段。

bash
LAB="$HOME/bitcoin-core-31-lab"
# 网络和数据目录必须与已启动的节点保持一致
"$LAB/bitcoin-31.0/bin/bitcoin-cli" -regtest -datadir="$LAB/data" -rpcwait getblockchaininfo | grep -E '"(chain|blocks)"'

新建且未挖矿的数据目录,预期输出:

text
  "chain": "regtest",
  "blocks": 0,

如果 chain 不是 regtest,立即检查两条命令是否都带有 -regtest 和相同的 -datadir;如果高度不是 0,说明该目录已经产生或导入过区块。

遇到 Could not connect to the server,先检查进程及 data/regtest/debug.log,确认节点未启动失败;若提示端口被占用,检查默认 RPC 端口 18443 是否已被其他 regtest 实例使用。需要改端口时,启动命令和 CLI 都要指定相同的 -rpcport=18453。如果报告数据目录被锁定,不要直接删除锁文件,应找到占用该目录的旧节点并正常关闭。

实验结束后可执行 bitcoin-cli 的 stop RPC 正常关停,保留隔离数据目录即可在下次启动时继续使用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装节点并启动 regtest 网络

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通