区块链原理 / 系统课时
version 握手如何完成
version 握手如何完成
两台 Bitcoin 节点连上网络端口后,还不能立即互传交易和区块。它们必须先交换 version,核对协议版本及服务能力,再用 verack 确认收到对方的声明。本篇用双节点时序和 regtest 实验判断握手何时完成,以及入站、出站连接有什么区别。
学习目标
- 按时序说明
version、verack与可选能力协商消息的作用。 - 解释关键字段及入站、出站方向,不把协议版本与软件版本混淆。
- 用 Bitcoin Core RPC 验证双方确实收发过握手消息。
从连接到正常消息交换
假设节点 A 主动连接 B:对 A 是出站连接,对 B 是入站连接。建立 TCP 连接后,若使用 BIP324 v2 传输,还会先完成传输层加密握手;无论使用 v1 还是 v2 传输,随后都要完成 Bitcoin P2P 的 version/verack 协商。
- A 发送自己的
version;B 接收后检查可接受的协议版本、服务声明等,并发送自己的version。 - 双方收到对方的
version后,在发送verack前可以发送sendaddrv2(BIP155)和wtxidrelay(BIP339)等适用的能力协商消息。 - A、B 分别发送空载荷的
verack,确认已处理对方的version。双方各自完成版本交换并收到对端verack,连接才进入常规消息处理阶段。 - 此后才进行通常的
getheaders、headers、inv、getdata等同步或转发。实际报文可交错到达,并不保证严格按示例的四个主报文先后排序。

version 中的字段各自有什么用
version 是开场的能力声明,不是交易,也不代表已经验证对方的区块数据。以 Bitcoin Core 31.0 为例,P2P 协议版本为 70016,软件版本则会显示在 user_agent 中,例如 /Satoshi:31.0.0/;这两者不能直接比较大小。
| 字段 | 读取方式与判断 |
|---|---|
version |
4 字节协议版本号;判断能否按兼容的规则继续通信。 |
services |
8 字节位掩码;如 NODE_NETWORK=1 表示提供完整区块数据,NODE_WITNESS=8 表示支持见证数据。 |
timestamp |
节点提供的 Unix 秒级时间,可估计时钟偏差,不是共识时间证明。 |
nonce |
用于识别意外连接到自身,不能当作节点永久身份。 |
user_agent |
软件标识字符串,可以由对方自行填写,不能作为可信身份凭证。 |
start_height |
对方声称的链高度,仅供同步判断,不能据此认定链已验证。 |
relay |
可选的交易公告偏好位,false 不表示断开区块同步。 |
报文还包含 addr_recv、addr_from 等地址字段。services 告诉对方“我声称能提供什么”,但是否实际发送交易,还受连接类型、转发策略和后续协商影响。见 Bitcoin P2P 协议参考。
入站和出站如何区分
同一条连接,在 A 的 getpeerinfo 中 inbound=false,在 B 中则为 inbound=true。连接方向只表示谁发起连接,不表示只能单向传消息;A 和 B 都必须发送 version 和 verack。
观察 connection_type 时还要区分用途:自动建立的 outbound-full-relay 用于正常传播,block-relay-only 则刻意不进行交易与地址转发;用 addnode 手动发起的连接可能显示为 manual。transport_protocol_type 的 v1 或 v2 指传输格式,与 version=70016 不是一个层级。
在 regtest 上验证双向握手
准备 Bitcoin Core 31.0 的 bitcoind、bitcoin-cli 和 Python 3,在 Linux 或 macOS 终端执行下列完整示例。它使用两个独立的临时数据目录,节点 A 主动拨号 B,并读取 getpeerinfo 中按消息类型统计的收发字节数,而不只看连接总数。
set -euo pipefail
BASE="$(mktemp -d)"
mkdir -p "$BASE/a" "$BASE/b"
# 先启动被连接的 B,再启动主动连接的 A;两者隔离数据和 RPC 端口。
bitcoind -regtest -daemon -datadir="$BASE/b" -port=19445 -rpcport=19446 >/dev/null
bitcoin-cli -regtest -datadir="$BASE/b" -rpcwait getblockcount >/dev/null
bitcoind -regtest -daemon -datadir="$BASE/a" -port=19444 -rpcport=19443 >/dev/null
bitcoin-cli -regtest -datadir="$BASE/a" -rpcwait getblockcount >/dev/null
bitcoin-cli -regtest -datadir="$BASE/a" addnode "127.0.0.1:19445" "onetry" >/dev/null
python3 - "$BASE" <<'PY'
import json
import subprocess
import sys
import time
base = sys.argv[1]
def peers(name):
raw = subprocess.check_output(
["bitcoin-cli", "-regtest", f"-datadir={base}/{name}", "getpeerinfo"],
text=True,
)
return json.loads(raw)
def complete(peer, inbound):
sent = peer.get("bytessent_per_msg", {})
recv = peer.get("bytesrecv_per_msg", {})
# 同时检查版本、方向,以及两个握手消息在收发两侧都有记录。
return (
peer.get("inbound") is inbound
and peer.get("version", 0) >= 70016
and all(sent.get(k, 0) > 0 and recv.get(k, 0) > 0
for k in ("version", "verack"))
)
for _ in range(30):
if (any(complete(p, False) for p in peers("a"))
and any(complete(p, True) for p in peers("b"))):
print("A:出站,version/verack 双向完成")
print("B:入站,version/verack 双向完成")
break
time.sleep(0.2)
else:
raise SystemExit("握手尚未完成,请检查节点日志")
PY预期输出:
A:出站,version/verack 双向完成
B:入站,version/verack 双向完成19444、19445 是本实验的 P2P 端口,19443、19446 是 RPC 端口;冲突时请换为空闲的 <PORT>。临时数据目录实际位于 <PATH>,由 mktemp 生成。验证后可对两个节点分别执行 bitcoin-cli -regtest -datadir="$BASE/a" stop 和对应 B 的 stop,待进程退出再删除目录。字段定义见 Bitcoin Core 31.0 getpeerinfo 文档。
握手卡住时检查哪里
先看 B 是否监听实验指定的 P2P 端口,再看 A 的 getpeerinfo 是否出现连接。完全没有连接,通常是端口冲突、节点未启动或地址错误;出现连接但 version/verack 收发不全,才转向版本不兼容、对端主动断开或报文校验问题。
如果 getpeerinfo 已记录双方 version 与 verack,却没有交易公告,先检查 connection_type、relaytxes 和节点的转发策略,而不是重试握手。block-relay-only 本来就不转发交易;刚建立的 regtest 网络没有新交易可公告,也完全正常。