qBittorrent中查看Peer列表需右键任务选择“对等节点”,可查IP、端口、速率及状态;启用“对等节点信息面板”可显示连接时长、uTP/加密等高级字段;WebUI和API也支持远程或脚本化获取JSON格式Peer数据。

如果您正在使用 qBittorrent 下载资源,但无法判断当前是否已成功连接到其他下载者(Peers),或想确认对等节点的活跃状态与网络分布,则需要直接查看实时 Peer 列表。以下是获取该信息的具体操作路径与验证方式:
一、通过下载任务界面查看活跃 Peer
qBittorrent 主界面中每个下载任务下方默认显示当前连接的 Peer 数量及状态,点击展开可查看详细列表。该方式无需额外配置,适用于快速核验连接有效性。
1、在主窗口中找到目标下载任务,右键单击该任务。
2、在弹出菜单中选择“打开文件夹” → “打开下载文件夹”以外的选项,直接点击“对等节点”(Peer)。
3、新弹出的窗口即为当前任务所连接的所有 Peer 列表,包含 IP 地址、端口、客户端标识(如 -QB4.5.0-)、上传/下载速率、连接状态(Choked/Interested 等)。
4、列表顶部显示统计信息:已连接 Peer 数 / 总请求 Peer 数,若前者为 0 则说明尚未建立有效连接。
二、启用高级 Peer 信息面板
默认界面仅显示基础 Peer 数据,启用“高级对等节点信息”后可查看握手时间、加密状态、支持协议(uTP/TCP)、远程地理定位(IP 归属地)等深层字段,便于排查连接异常。
1、点击顶部菜单栏“视图” → “对等节点信息面板”,勾选启用。
2、在主窗口底部状态栏区域将自动出现“Peers”标签页,点击切换至该面板。
3、右键表格标题栏,勾选所需列:如“国家代码”、“连接时长”、“uTP”、“加密”等。
4、按“连接时长”列降序排列,可快速识别长期稳定连接的 Peer。
三、导出 Peer 列表为文本文件进行离线分析
当需比对多个时间点的 Peer 分布、筛查可疑 IP 或提交给 Tracker 运维人员协助诊断时,可将当前 Peer 数据导出为结构化文本,避免手动截图遗漏关键字段。
1、在“对等节点”窗口(右键任务 → “对等节点”)中,按Ctrl + A全选所有 Peer 行。
2、按Ctrl + C复制选中内容。
3、新建记事本文件,粘贴内容并保存为 UTF-8 编码的 .txt 文件(如 peers_20260507.txt)。
4、导出数据中每行含 7~9 列,关键列为:IP:端口、客户端、上传速率、下载速率、状态标志;其中“?”表示未完成握手,“L”表示本地连接,“D”表示被阻塞(Choked)。
四、通过 WebUI 查看远程连接的 Peer 列表
当 qBittorrent 运行于 NAS 或服务器且通过 WebUI 远程管理时,Peer 列表仍可完整访问,但需确保 WebUI 权限已授予“查看对等节点”能力,否则该选项将不可见。
1、在浏览器中访问 qBittorrent WebUI 地址(如 http://192.168.1.100:8080)并登录。
2、在左侧导航栏点击“Torrents”,找到目标任务后,鼠标悬停其右侧操作图标(三个点)。
3、点击弹出菜单中的“Peers”项。
4、页面跳转至 Peer 表格页,列字段与桌面版一致;右上角有“刷新”按钮和“每页显示条数”下拉框,支持分页浏览百级 Peer。
五、使用命令行工具获取 JSON 格式 Peer 数据
对于自动化监控或脚本集成场景,可通过 qBittorrent 的 REST API 直接调用获取结构化 Peer 列表,返回标准 JSON,适配 Python、Shell 等解析环境,避免 GUI 层面的交互延迟。
1、确保 qBittorrent 已启用 WebUI 并开启“启用远程控制”(设置 → WebUI → 勾选)。
2、获取当前会话 Cookie:向 /api/v2/auth/login 发送 POST 请求,参数为 username 和 password,响应头中提取 Set-Cookie 值。
3、构造 GET 请求:/api/v2/sync/torrentPeers?hash=【torrent_hash】,在 Header 中携带 Cookie 与 User-Agent。
4、响应体为 JSON 对象,key 为 peer_id,value 包含 ip、port、client、downspeed、upspeed、progress、flags 等字段;flags 字段中 'I' 表示 Interested,'C' 表示 Choked。

















