使用qBittorrentAPI出现连接错误，求助排查原因

你遇到的WinError 10061错误是目标机器主动拒绝连接，说明Python程序无法连接到qBittorrent的WebUI服务，以下是具体排查步骤：

1. 确保qBittorrent客户端正在运行 #

必须启动qBittorrent软件（可后台运行，但不能完全关闭），WebUI服务依赖qBittorrent主程序运行。

2. 检查qBittorrent WebUI是否正确启用 #

打开qBittorrent的设置（路径：工具 > 选项），切换到WebUI标签页，确认：

• 勾选启用WebUI选项
• 端口设置为8080（和代码中port=8080一致，若修改过端口，代码中也要同步更新）
• 认证信息匹配：默认用户名是admin，密码是adminadmin，如果修改过WebUI的登录凭据，代码中也要对应调整username和password参数
• 点击页面底部的测试WebUI按钮，验证服务是否正常

3. 验证WebUI可通过浏览器访问 #

打开浏览器输入http://localhost:8080，如果能正常打开qBittorrent的WebUI登录页面，说明服务运行正常；如果无法打开，返回步骤2重新配置WebUI。

4. 排除防火墙/杀毒软件拦截 #

Windows防火墙或第三方杀毒软件可能阻止Python程序访问8080端口，需要添加允许规则：

• 允许Python.exe或你的脚本进程访问8080端口
• 允许qBittorrent的WebUI服务对外提供8080端口的访问权限

5. 核对代码配置 #

确认代码中的Client参数完全匹配WebUI设置：

qbt_client = qbittorrentapi.Client(
    host='localhost',  # 若qBittorrent在远程机器，替换为对应IP
    port=8080,         # 必须和WebUI设置的端口一致
    username='admin',  # 对应WebUI设置的用户名
    password='adminadmin'  # 对应WebUI设置的密码
)

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