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 测试机上安装客户端:
sudo apt-get update
sudo apt-get install -y qbittorrent-nox python3
qbittorrent-nox --version预期结果:显示已安装的 qBittorrent 版本,例如:
qBittorrent v5.0.0版本号以实际安装结果为准。首次启动 qbittorrent-nox 时,需要按终端提示接受法律声明,并为 Web UI 设置管理员凭据。随后通过 Web UI 设置每个实例的监听端口与下载目录。不同版本的首次登录凭据机制可能不同,不要假定默认密码固定不变。
建议在隔离测试网络中运行,不把 Web UI 暴露到公网。关闭 UPnP、NAT-PMP、DHT、PeX 和本地 Peer 发现,后续仅使用指定 Tracker 发现节点。这样可以排除其他发现路径的干扰。
创建测试文件与私有种子
在 Seeder S 上生成一份 8 MiB 的测试文件。使用确定性的字节序列可以让三个节点的校验结果完全一致,并避免依赖外部下载资源。
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预期结果:
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 列表和下载进度。

按以下顺序执行测试:
- 在 S 上确认种子完成度为 100%,状态为做种,Tracker 状态正常。
- 在 A 上启动下载,等待其发现 S,并确认已接收部分 Piece。
- 在 A 尚未完成时启动 B,使两个下载节点同时参与 Swarm。
- 在 A 和 B 的 Peers 列表中检查对方的 IP、连接状态和上传下载速率。
- 等待两个节点完成下载,记录各自累计下载量和上传量。
典型现象是 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 的监听端口:
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 的原始文件摘要比较。
sha256sum ~/bt-lab/source/sample.bin这条命令在 S 上执行;A、B 应将路径替换为各自实际保存的 sample.bin 路径。
预期结果:
<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。