qbPortWeaver：VPN 端口同步托盘工具

项目简介

qbPortWeaver 是一个运行在 Windows 系统托盘的应用，用来把 qBittorrent、Transmission、Deluge 或 Nicotine+ 的监听端口，与 VPN 服务商分配的端口保持同步。支持的端口来源包括 ProtonVPN、PIA、任何支持 NAT-PMP 的 VPN 网关或路由器，以及会分配固定转发端口的服务商。客户端始终使用 VPN 提供的端口，有助于改善隐私与连通性。

程序常驻托盘，负责配置与日志管理，检测到端口变化时自动更新客户端的监听端口。它还内置 Media Manager，可按 TMDB 标题匹配，把文件导入 Plex 兼容的媒体库目录。

主要功能

• 自动端口同步：自动获取当前 VPN 端口并写入客户端，支持 qBittorrent（Web API）、Transmission（RPC）、Deluge（Web JSON-RPC）和 Nicotine+（由程序自动安装桥接插件，端口即时生效，无需重启）。
• 网络变化即同步：除定时周期外，检测到网络或 VPN 连接变化时立即执行一次同步，快速变化会合并成一次；默认开启。
• 多 VPN 支持：ProtonVPN（日志解析或 NAT-PMP）、PIA（通过 piactl 命令行）、任意 NAT-PMP 网关或路由器（RFC 6886，同时申请 TCP 与 UDP），以及账户中固定转发端口的服务商（Static port 选项，手动填一次端口）。
• 默认端口回退：VPN 未连接时可选用配置好的默认端口。
• 启动时等待 VPN：启动后一段时间内，仍在连接中的 VPN 不算失败，不写警告、不触发回退与自动恢复。
• 端口变更后重启客户端、强制启动客户端、断线重启（仅 qBittorrent，连续三次无效后停止，重连后自动恢复）。
• 端口连通性验证：同步后检查端口是否真的能从外网访问，端口变化后执行并按周期复查；关闭结果会经二次确认后再告警。
• VPN 出口地址检查：在 NAT-PMP、ProtonVPN、PIA 模式下，当端口被判定为关闭或无法测试时，检查 VPN 的出口地址是否与转发端口所在地址一致，不一致会记录日志、提示，并在开启恢复时最多重连 3 次。
• 暂停与恢复同步：托盘菜单可临时暂停同步周期（含 Media Manager 导入），暂停期间仍可手动执行一次「Sync Port Now」。
• 网卡不匹配警告（qBittorrent、Nicotine+）：客户端绑定的网卡与配置的 VPN 不符、绑定全部网卡或绑定到已断开的网卡时提示。
• 网卡绑定失效检测（qBittorrent）：检查绑定的内部标识是否失效，并可在 VPN 协议或服务商切换后自动重新绑定到当前网卡并重启 qBittorrent。
• 通知与日志：端口更新成功提示、警告或错误时的一次性托盘气泡、托盘提示中的警告/错误计数。
• 自动恢复：连续失败达到阈值后，通过轻量助手服务（qbPortWeaverHelper，以 LocalSystem 运行，不需要 UAC）重启 VPN 服务与客户端，或用 netsh 重启网卡；设置项旁有 Test 按钮可手动验证整条链路。

安装与使用

系统要求：Windows 10/11 (x64)，具备 ProtonVPN、PIA、支持 NAT-PMP 且开启端口转发的 VPN/路由器，或提供固定转发端口的服务商；并已安装并配置好以下客户端之一：启用 Web UI 的 qBittorrent、启用 RPC 的 Transmission、启用 Web UI 插件的 Deluge，或配合桥接插件的 Nicotine+。

winget：

winget install --id martsg666.qbPortWeaver -e

Chocolatey（需在管理员命令行中执行）：

choco install qbportweaver

也可以从 最新 release 下载 qbPortWeaver_<version>_Setup.msi 手动安装。安装完成后，从托盘图标打开 Settings 进行配置即可。

注意事项

• MSI 安装包未做代码签名，首次安装时 Windows SmartScreen 可能提示「未知发布者」，点击更多信息 → 仍要运行即可。
• 各安装方式安装的是同一个程序；新版本先出现在 GitHub release 页面，包管理器需等审核通过后跟进。
• Nicotine+ 无需重启即可应用端口，因此没有「端口变更后重启」选项。
• Transmission 和 Deluge 上报的是绑定地址而非网卡名，因此网卡不匹配检查不适用于它们。
• Static port 模式不提供转发地址，因此不进行 VPN 出口地址检查。
• 端口验证依赖各客户端自身或对应项目提供的在线检测服务：Deluge 的检测服务会过滤自动化请求，结果通常为不确定；qBittorrent 依据传入连接推断，空闲时可能报告为关闭。

本作品整理自 GitHub 开源项目 martsg666/qbPortWeaver，原作者 @martsg666。中文介绍由 AI 根据项目 README 整理，以原仓库为准。