qbittorrent做种上传慢需依次排查端口映射、tracker有效性、连接限制及权限问题：确保bt端口tcp/udp双映射并可达，更新活跃tracker列表，调高连接数与禁用速率限制，正确配置puid/pgid避免权限异常。
如果您在使用qBittorrent进行做种时发现上传速度缓慢，可能由端口未正确映射、Tracker响应不足、连接数限制或网络策略干预导致。以下是针对性的优化与端口映射设置步骤：
一、验证并修正WebUI与BT端口映射
端口映射错误将直接导致外部Peer无法连接您的客户端，严重抑制上传能力。必须确保WebUI管理端口与BT通信端口均被正确暴露且无冲突。
1、确认容器启动时已映射两类端口：WebUI端口（如8080）和BT端口（TCP/UDP双协议，如6881）。
2、检查Docker命令中是否同时指定：-p 8080:8080 -p 6881:6881 -p 6881:6881/udp。
3、若使用docker-compose.yml，确保ports字段包含三行，其中UDP端口需显式标注/udp后缀。
4、在宿主机执行netstat -tuln | grep :6881，确认6881端口处于LISTEN状态且绑定地址为0.0.0.0（非127.0.0.1）。
二、强制启用并验证BT端口可达性
即使端口已映射，若路由器未开启UPnP或未配置手动端口转发，外部Peer仍无法建立入站连接，导致上传通道关闭。
1、登录qBittorrent WebUI，进入“工具 → 选项 → 连接”，勾选启用UPnP/NAT-PMP端口映射。
2、在相同页面底部，找到“监听端口”区域，取消勾选随机选择监听端口，手动设为6881（或您自定义的BT端口）。
3、点击“确定”保存后，观察界面右下角状态栏是否显示✅ 全功能模式（绿色对勾）；若显示❌或黄色感叹号，说明端口不可达。
4、若UPnP失败，须登录路由器后台，在“端口转发”或“虚拟服务器”中添加两条规则：一条TCP协议映射外网6881→内网NAS IP:6881，另一条UDP协议同端口映射。
三、更新活跃Tracker列表提升Peer发现效率
冷门种子依赖Tracker主动推送Peer信息，过期或失效的Tracker会导致长期零上传。批量注入高可用公共Tracker可显著激活死种。
1、访问GitHub仓库ngosang/trackerslist，复制trackers_all.txt原始内容（纯文本URL列表，每行一个）。
2、在qBittorrent中右键目标任务 → “属性” → “追踪器”，清空原有地址，粘贴全部新Tracker。
3、点击“应用”，等待约30秒，观察“Peers”标签页中“已知”数量是否从0跃升至数十或上百。
4、如使用Docker镜像支持自动更新（如johngong/qbittorrent），可在环境变量中设置：QB_TRACKERS_UPDATE_AUTO=true及对应URL。
四、解除连接与速率硬性限制
默认限制造成上传带宽未充分利用，尤其在多任务做种场景下，连接数不足会大幅降低并发上传能力。
1、进入“工具 → 选项 → 连接”，将全局最大连接数调至1000，每个Torrent最大连接数设为500。
2、切换至“速度”选项卡，确认全局上传速率限制设为0（即无限制），且未勾选“当下载完成时暂停上传”。
3、在“BitTorrent”选项卡中，确保启用DHT网络、启用PeX、启用本地用户发现三项全部启用。
4、若网络环境允许，将协议加密模式设为“强制”，避免ISP流量识别与节流。
五、校验并修复宿主机权限与用户ID映射
权限异常可能导致qBittorrent无法写入.torrent临时文件或peer信息缓存，间接影响Peer握手成功率与上传稳定性。
1、在宿主机终端运行id your_username，记录输出中的uid与gid值（如uid=1000,gid=1000）。
2、启动容器时必须传入环境变量：-e PUID=1000 -e PGID=1000（数值需与上步一致）。
3、检查挂载的/downloads目录权限：ls -ld /path/to/downloads，应显示属主为对应uid，而非root。
4、若权限异常，执行sudo chown -R 1000:1000 /path/to/downloads（数字替换为实际PUID/PGID）。
