P2P 与分布式存储 / 系统课时

用 3 个客户端复现 Swarm 传输

用 3 个客户端复现 Swarm 传输

使用一台 Seeder 和两个初始下载节点,可以在本地复现 BitTorrent 的完整分发过程。本课通过三个独立客户端、一个自建测试 Tracker 和一份可校验的测试文件,观察 Peer 发现、Piece 扩散、下载节点之间的互传,以及最终文件的完整性验证。

学习目标

  • 搭建包含 Seeder S、Leecher A 和 Leecher B 的三节点测试 Swarm。
  • 观察 Peer 连接、分块交换和下载节点之间的上传行为。
  • 使用客户端统计信息与 SHA-256 校验确认传输结果。

准备三个隔离的客户端

建议使用 qBittorrent 4.6.x 或 5.x 的三个独立实例。为避免客户端配置目录冲突,最容易复现的方式是准备三台虚拟机,或者三台处于同一测试局域网的设备。以下以 Linux 环境为例,使用 qBittorrent-nox 作为客户端,Python 3 作为测试文件生成工具。

三个节点使用不同 IP 地址,例如:

节点 测试 IP 监听端口 初始角色
Seeder S 192.168.56.10 51001 持有完整文件
Leecher A 192.168.56.11 51002 无文件
Leecher B 192.168.56.12 51003 无文件

上述地址是示例测试网段,实际部署时必须替换成虚拟机或设备的真实地址。三个节点应能相互访问,且各自的保存目录必须独立。

在 Ubuntu 或 Debian 测试机上安装客户端:

bash
sudo apt-get update
sudo apt-get install -y qbittorrent-nox python3
qbittorrent-nox --version

预期结果:显示已安装的 qBittorrent 版本,例如:

text
qBittorrent v5.0.0

版本号以实际安装结果为准。首次启动 qbittorrent-nox 时,需要按终端提示接受法律声明,并为 Web UI 设置管理员凭据。随后通过 Web UI 设置每个实例的监听端口与下载目录。不同版本的首次登录凭据机制可能不同,不要假定默认密码固定不变。

建议在隔离测试网络中运行,不把 Web UI 暴露到公网。关闭 UPnP、NAT-PMP、DHT、PeX 和本地 Peer 发现,后续仅使用指定 Tracker 发现节点。这样可以排除其他发现路径的干扰。

创建测试文件与私有种子

在 Seeder S 上生成一份 8 MiB 的测试文件。使用确定性的字节序列可以让三个节点的校验结果完全一致,并避免依赖外部下载资源。

bash
mkdir -p ~/bt-lab/source
python3 - <<'PY'
from pathlib import Path
import hashlib

path = Path.home() / 'bt-lab/source/sample.bin'
block = bytes(range(256)) * 4096
with path.open('wb') as file:
    for _ in range(8):
        file.write(block)
print('size:', path.stat().st_size)
print('sha256:', hashlib.sha256(path.read_bytes()).hexdigest())
PY

预期结果:

text
size: 8388608
sha256: <SHA256>

<SHA256> 表示实际计算得到的 64 位十六进制摘要;同一生成算法在三个节点上的摘要必须一致。

在 Seeder S 的 qBittorrent Web UI 中选择创建 Torrent 的功能(部分版本位于工具菜单,具体位置以版本界面为准),按以下参数建立种子:

参数 测试取值
源文件 sample.bin
Piece 大小 256 KiB
Tracker URL http://192.168.56.10:6969/announce
私有 Torrent 启用
创建后开始做种 启用

8 MiB 文件采用 256 KiB 的 Piece 大小,理论上划分为 32 个 Piece。创建种子之前,需要准备能够响应 HTTP Announce 的测试 Tracker。可以使用支持 HTTP Tracker 协议的独立服务,例如 opentracker,并根据其安装版本配置监听端口 6969;仅启动普通 HTTP 文件服务器不能代替 Tracker。

将生成的 .torrent 文件复制到 A、B,但不要复制源数据文件。A、B 添加种子时分别指定空目录,确保它们的初始完成度为 0%。

观察三节点的连接与分块传播

启动 Tracker 后,先让 S 加入 Swarm,再让 A 和 B 加入。观察客户端的 Tracker 状态、Peers 列表和下载进度。

三个客户端的Swarm拓扑与Piece扩散过程

按以下顺序执行测试:

  1. 在 S 上确认种子完成度为 100%,状态为做种,Tracker 状态正常。
  2. 在 A 上启动下载,等待其发现 S,并确认已接收部分 Piece。
  3. 在 A 尚未完成时启动 B,使两个下载节点同时参与 Swarm。
  4. 在 A 和 B 的 Peers 列表中检查对方的 IP、连接状态和上传下载速率。
  5. 等待两个节点完成下载,记录各自累计下载量和上传量。

典型现象是 S 首先向 A、B 分发不同 Piece。A 和 B 一旦拥有对方缺少且已通过校验的 Piece,就可能互相上传。实际 Piece 选择取决于稀缺度、Peer 可用性、Choke 状态和请求调度,不保证严格按照图中的编号顺序。

需要注意,三个节点同属一个 Swarm,并不保证 A、B 一定建立连接或产生可观测的互传。如果文件过小、S 上传过快,A、B 可能在相互交换前就已经完成下载。

为了增加观察窗口,可以在 S 的客户端设置中将全局上传速率限制为 256 KiB/s,同时让 A、B 保持较高的上传上限。该限制只用于实验,不是 BitTorrent 协议参数。

验证下载节点确实参与上传

不要只凭下载进度判断 Swarm 是否实现了多节点分发。需要同时检查连接对象、上传方向和累计上传量。

在 qBittorrent 中选中测试任务,查看 Peers 和常规统计信息,重点记录以下数据:

观察指标 预期现象 判断用途
A 的下载进度 从 0% 增长到 100% A 收到完整资源
B 的下载进度 从 0% 增长到 100% B 收到完整资源
A 的 Peers 列表 可能出现 B 的 IP A 与 B 建立直接连接
B 的 Peers 列表 可能出现 A 的 IP B 与 A 建立直接连接
A 或 B 的累计上传量 在下载期间增加 下载节点参与数据上传
S 的累计上传量 随分发增加 初始 Seeder 提供数据

其中,累计上传量增加只能说明节点发生了上传;若要证明 A 向 B 传输了 Piece,需要在 A 的 Peers 列表中观察 B 对应连接的上传速率或上传字节统计,并在 B 侧对应连接观察下载行为。不同版本的界面统计字段可能不同。

如果要验证特定连接上的流量,可在隔离测试网络使用 tcpdump 抓取 A 与 B 之间的 TCP 通信。以下命令在 A 上执行,示例使用 B 的监听端口:

bash
sudo tcpdump -ni any 'host 192.168.56.12 and tcp port 51003' -c 10

预期结果:当 A、B 使用 TCP 传输且存在通信时,终端会显示包含双方 IP、端口及 TCP 标志位的报文记录;抓满 10 个报文后退出。实际时间戳、源端口和报文长度不同。若客户端使用 uTP,则需要改为捕获对应 UDP 流量。

抓包只能证明两个节点之间存在网络流量。要确认 Piece 数据交换,还需结合协议报文解析或客户端的 Peer 级传输统计。

校验文件完整性并定位异常

当 A、B 均达到 100% 后,在两个下载节点分别计算文件的 SHA-256,并与 S 的原始文件摘要比较。

bash
sha256sum ~/bt-lab/source/sample.bin

这条命令在 S 上执行;A、B 应将路径替换为各自实际保存的 sample.bin 路径。

预期结果:

text
<SHA256>  /home/<USER>/bt-lab/source/sample.bin

实际用户名、路径和摘要以运行环境为准。三个文件的 SHA-256 应完全相同。Torrent 自身的 Piece 校验负责传输完整性,额外计算 SHA-256 可以独立确认最终文件字节一致。

若实验未达到预期,按现象逐项定位:

现象 优先检查 修复方式
Tracker 显示未工作 URL、服务端口、Tracker 日志 修正地址并确认 Announce 可达
A、B 始终找不到 S IP 连通性、监听端口、防火墙 放行测试网络中的 TCP/UDP 监听端口
只连接 S,不连接彼此 Peer 发现结果、A/B 防火墙、连接限制 检查 Tracker 返回的节点与入站连接
A、B 没有明显互传 文件过小、S 上传过快、任务已完成 限制 S 上传速度并延长并发下载窗口
下载停在 99% 缺失 Piece、可用 Peer、请求超时 查看 Piece 可用性并保持 S 在线
文件摘要不一致 保存路径、文件版本、下载完成状态 强制重新校验并确认比较的是同一文件

如果客户端显示 100%,但外部 SHA-256 不一致,应先检查是否比较了不同版本或不同目录中的文件,不要直接认定 BitTorrent 的 Piece 校验失效。

验收标准是:S 最初持有完整文件,A、B 从 0% 下载至 100%,三份文件的 SHA-256 一致;若实验目标还包括证明下载节点互传,则必须额外取得 A 与 B 之间的 Piece 数据传输证据。这样才能区分普通的一对多下载和真正发生了 Peer 间分块扩散的 Swarm。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 3 个客户端复现 Swarm 传输

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

登录哪都通