应启用qbittorrent内置upnp/nat-pmp并手动设固定监听端口（如52187），若失败则需手动配置路由器tcp/udp双协议端口转发，windows用户还需启用ssdp discovery与upnp device host系统服务。
如果您在使用qBittorrent时发现做种上传缓慢、连接Peer数量极少或状态栏长期显示黄色感叹号，很可能是由于外部节点无法主动连接您的客户端——这通常源于UPnP或NAT-PMP未正确启用或失效。以下是实现自动端口映射的多种配置路径：
一、启用qBittorrent内置UPnP/NAT-PMP功能
该方法依赖客户端主动向路由器发起端口映射请求，无需手动填写规则，适用于支持UPnP/NAT-PMP协议的主流家用路由器。
1、启动qBittorrent，点击顶部菜单栏“工具 → 选项”，切换至“连接”标签页。
2、在“网络接口”区域下方，勾选使用我的路由器的UPnP / NAT-PMP端口转发。
3、取消勾选随机选择监听端口，在“监听端口”输入框中手动设定一个固定端口（推荐50000–65535区间内非热门值，如52187）。
4、点击“确定”保存设置，观察右下角状态栏：若显示✅ 全功能模式，则映射成功；若仍为⚠️ 或❌，需进入下一步排查。
二、验证并强制刷新UPnP/NAT-PMP映射状态
部分路由器虽开启UPnP但存在缓存延迟或映射过期问题，需触发客户端重试机制以更新网关表项。
1、保持qBittorrent运行，在“工具 → 选项 → 连接”中，先取消勾选UPnP/NAT-PMP选项，点击“确定”关闭设置窗口。
2、等待10秒后重新打开“选项 → 连接”，再次勾选UPnP/NAT-PMP选项并确认端口未被随机化。
3、立即前往路由器管理界面（通常为192.168.1.1或192.168.0.1），在“UPnP状态”或“端口映射列表”中查找对应端口（如52187）是否已动态添加。
4、若列表为空或条目显示“失效”，说明路由器UPnP服务未响应，应切换至第三种方案。
三、手动配置路由器端口转发（双协议覆盖）
当UPnP/NAT-PMP完全失效时，必须通过路由器后台建立静态TCP+UDP双协议映射，确保BitTorrent协议全链路可达。
1、登录路由器管理页面，定位至“端口转发”“虚拟服务器”或“NAT设置”子菜单（不同品牌名称略有差异）。
2、新增第一条规则：协议类型选TCP，外部端口与内部端口均填入qBittorrent所设端口（如52187），内部IP地址填入运行qBittorrent设备的局域网IP（如192.168.1.102）。
3、新增第二条规则：协议类型选UDP，其余参数与上一条完全一致。
4、保存并重启路由器，返回qBittorrent检查状态栏是否变为✅ 全功能模式；若仍未生效，请确认设备IP未被DHCP变更，建议为其分配静态IP。
四、检查并启用系统级UPnP服务（Windows平台专用）
Windows系统若禁用底层UPnP支撑服务，即使qBittorrent和路由器均启用，映射请求也无法送达网关。
1、按下Win+R键，输入services.msc回车，打开“服务”管理控制台。
2、在服务列表中依次找到SSDP Discovery与UPnP Device Host两项。
3、分别双击打开属性，将“启动类型”设为自动，若状态栏显示“已停止”，则点击“启动”按钮。
4、全部启用后，重启qBittorrent并观察状态栏变化；若此前为❌，此时可能转为⚠️，表明系统层障碍已清除，仅剩路由器侧待处理。
五、Docker部署场景下的端口透传配置
在NAS或Linux服务器以Docker容器方式运行qBittorrent时，宿主机防火墙及Docker网络模式会拦截UPnP广播包，必须显式暴露端口并禁用网络隔离。
1、停止当前qBittorrent容器，在Portainer或命令行中编辑容器配置，将网络模式由默认的bridge改为host（推荐）或确保已添加-p 52187:52187/tcp -p 52187:52187/udp端口映射参数。
2、进入容器终端，执行cat /proc/sys/net/ipv4/ip_forward，确认返回值为1；若为0，需在宿主机执行sudo sysctl -w net.ipv4.ip_forward=1并写入/etc/sysctl.conf持久化。
3、在qBittorrent WebUI中，“工具 → 选项 → 连接”内，除启用UPnP/NAT-PMP外，还需勾选使用套接字选项SO_BINDTODEVICE（仅Linux）（若选项可见）。
4、保存后重启容器，检查宿主机netstat -tuln | grep :52187是否同时显示tcp和udp监听状态。
