如何使用Python离线通过libtorrent校验种子文件的所有文件？

要实现离线状态下的「强制重新校验」，不能直接调用torrent对象的recheck()方法——libtorrent的校验逻辑由session管理，通过session完成校验会自动处理v1/v2种子、混合种子和merkle树等细节，无需自行实现哈希计算。

实现步骤 #

• 创建session并配置为离线模式，确保不会尝试连接外部网络
• 将种子添加到session，指定本地文件的保存路径，开启强制校验标记
• 等待校验完成，通过torrent状态判断本地文件是否与种子完全匹配

示例代码 #

import libtorrent as lt
import time

# 创建session并配置离线模式
session = lt.session()
# 关闭所有网络相关功能，确保离线操作
session.stop_dht()
session.stop_lsd()
session.stop_upnp()
session.stop_natpmp()
session.set_settings({
    "allow_incoming_connections": False,
    "enable_outgoing_connections": False
})

# 加载种子文件
torrent_info = lt.load_torrent_file("torrents/legal_linux_iso.torrent")
# 配置添加参数：指定保存路径+开启强制校验
add_params = {
    "save_path": "data/",
    "ti": torrent_info,
    "flags": lt.add_torrent_params.flags_t.force_recheck
}

# 将种子加入session开始校验
torrent_handle = session.add_torrent(add_params)

# 等待校验完成
while not torrent_handle.status().is_seeding:
    # 可在此处添加进度打印，比如：print(f"校验进度: {torrent_handle.status().progress * 100:.2f}%")
    time.sleep(0.1)
    # 处理alert避免内存泄漏
    session.pop_alerts()

# 判断校验结果
if torrent_handle.status().is_seeding:
    print("本地文件与种子完全匹配！")
else:
    print("本地文件与种子不匹配，存在缺失或损坏部分。")

关键细节说明 #

• force_recheck标志：强制libtorrent忽略已有进度记录，重新校验所有piece
• is_seeding状态：离线状态下，当所有piece校验通过时，torrent会进入seeding状态，代表本地拥有完整且匹配的文件
• 离线配置：通过关闭DHT、LSD等网络组件，确保校验过程完全离线，不依赖外部服务

内容的提问来源于stack exchange，提问作者pipe