Transmission UPnP/NAT-PMP 怎么开启?端口关闭与 9091 误用排查
简答:Transmission 的自动端口映射需要客户端启用“从路由器转发端口”,并由路由器支持且开启 UPnP 或 NAT-PMP;先核对 peer port,再查看端口状态。9091 是 Web/RPC 管理端口,不是 BT peer port。
定义:UPnP/NAT-PMP 是让 Transmission 请求路由器自动创建端口映射的机制,用于接收 BT peer 连接。
先试这一步:确认开启的是 peer port
Transmission 中要映射的是 peer port,不是 Web/RPC 管理端口。官方配置说明显示,peer_port 默认值为 51413,rpc_port 默认值为 9091;因此,路由器映射和外部端口检测应使用 Transmission 当前显示的 peer port,而不是 9091。可先打开 Transmission 端口转发指南核对端口用途。
| 项目 | 作用 | 是否用于 BT 入站连接 |
|---|---|---|
peer_port | BT peer 连接监听端口 | 是 |
rpc_port | Web、远程管理或 RPC 接口端口 | 不是 |
| 随机端口 | 启动时或按设置更换 peer port | 会影响固定映射 |
如果启用了随机端口,路由器中固定填写的端口可能会与 Transmission 实际使用的端口不一致。需要固定转发时,先关闭随机端口,再记录当前 peer port。
Transmission 桌面客户端开启 UPnP/NAT-PMP
- 打开 Transmission 的设置或偏好设置。
- 进入 Network 或“网络”相关页面。
- 找到端口设置区域,确认 peer port,并启用 Forward port from router,中文界面可能显示为“从路由器转发端口”或相近描述。
- 保存设置,必要时完全退出并重新打开 Transmission。
- 回到端口状态位置,观察是否显示端口已开放。
官方端口转发指南给出的路径是“Preferences > Network > Ports”,并说明该选项会尝试使用 UPnP 或 NAT-PMP 转发端口。实际菜单文字可能随系统和版本变化,以你查看当天的界面为准。
UPnP 与 NAT-PMP 不要求在 Transmission 中同时勾选两个开关。应由路由器提供其支持的自动映射协议;Transmission 的自动转发选项负责发起请求。
路由器端也要开启自动端口映射
只在 Transmission 中打开自动转发还不够,路由器必须启用对应功能。登录路由器管理页面,查找名称接近以下内容的菜单:
- UPnP
- NAT-PMP
- 端口映射自动配置
- 应用层网关或自动端口转发
不同品牌、固件和运营商定制界面的菜单名称无法统一核实。找到后,开启路由器支持的 UPnP 或 NAT-PMP 功能,再回到 Transmission 检查端口状态。官方排障文档也要求确认路由器支持并启用了 UPnP/NAT-PMP;如果路由器不支持,就需要改用手动端口转发。
如果路由器里已经为同一个 peer port 建立了手动规则,先检查是否存在重复或冲突。官方排障说明还建议确认 DMZ 未启用、端口未被其他应用占用,并确保 Transmission 正常释放了该端口。
端口仍显示关闭:按四层顺序判断
| 检查层 | 判断方法 | 处理方式 |
|---|---|---|
| Transmission | 当前 peer port 是否与路由器规则一致 | 关闭随机端口,重新记录并保存 peer port |
| 路由器 | UPnP/NAT-PMP 是否开启,是否存在重复映射 | 删除冲突规则,或改用一条手动映射 |
| 本机防火墙 | 端口是否允许 Transmission 的入站连接 | 为当前 peer port 放行 TCP 与 UDP,按系统权限操作 |
| 上游网络 | 是否存在第二台路由器、运营商级 NAT 或 VPN 接管 | 检查桥接、双重 NAT、公网入站能力和 VPN 端口转发支持 |
Windows 可通过“Windows Defender 防火墙 > 高级设置 > 入站规则”创建端口规则;需要管理员权限。官方指南指出,Windows 防火墙放行只影响本机,不会替代路由器端口转发。macOS 首次运行时若出现允许 Transmission 接收入站连接的提示,应选择允许;Linux 或其他 Unix 系统则需按所用防火墙工具放行对应端口。
端口检测依赖外部检测服务。如果 Transmission 显示关闭,但检测服务本身异常,结果不能单独作为结论。可在 Transmission 正在运行且 peer port 已确认后,用端口检测工具输入同一个端口复核;不要输入 9091。
自动映射失败时:手动转发怎么填
- 在 Transmission 中关闭随机端口,记录固定的 peer port。
- 确认运行 Transmission 的设备局域网地址,例如路由器分配给电脑、NAS 或容器宿主机的地址。
- 进入路由器的“端口转发”“端口映射”或相近页面。
- 将外部端口和内部端口都填写为同一个 peer port,目标地址填写运行 Transmission 的设备地址。
- 协议优先选择 TCP 与 UDP 均启用;如果路由器只能分开创建规则,则分别建立两条。
- 保存后重新检查 Transmission 的端口状态。
手动转发的目标必须是实际运行 Transmission 的主机。Docker 场景还要同时检查“路由器 → Docker 宿主机”和“宿主机 → 容器”的端口发布是否一致;容器只发布 Web/RPC 端口而未发布 peer port 时,9091 能打开并不代表 BT 入站端口可用。
NAS、虚拟机或多路由器环境要额外确认端口经过的每一层设备。官方说明指出,Transmission 通常只能自动映射它直接连接的路由器;如果前面还有调制解调器路由器或第二台路由器,就可能需要桥接或逐层转发。
配置文件与安全边界:只改对的键
daemon、CLI 或无图形界面的部署可以编辑 JSON 配置文件。官方配置文档要求修改前先关闭客户端,否则设置可能被旧进程覆盖;daemon 修改后可发送 SIGHUP 重新加载。
当前配置字段包括:
peer_port:BT peer 端口。peer_port_random_on_start:是否启动时随机选择 peer 端口。port_forwarding_enabled:是否启用 UPnP 或 NAT-PMP。rpc_port:RPC 管理端口,默认值在官方配置说明中为 9091。
Transmission 4.1.0 起正在从 kebab-case 过渡到 snake_case;旧格式在 Transmission 4 中仍可能存在,但配置文件应以你安装版本实际生成的字段为准,不要把两个命名格式混写。可参考官方的 配置文件编辑说明。
不要为了测试 BT 端口而把 9091 直接暴露到公网。9091 属于 RPC 管理接口,若确实需要远程管理,应单独配置认证、白名单和访问范围,并参考 Transmission RPC 规范。
什么时候应关闭 UPnP/NAT-PMP
如果你不需要自动创建端口映射,或者希望所有入站规则都由自己管理,可以在 Transmission 中关闭自动端口转发,同时在路由器中关闭对应的 UPnP/NAT-PMP 功能。关闭后,若仍需要接收入站 peer 连接,就改用固定 peer port 和手动转发。
- 需要固定端口、固定设备和可审计规则:优先手动转发。
- 家庭网络设备经常变化、路由器支持自动映射:可先使用 UPnP/NAT-PMP。
- 存在双重 NAT、运营商级 NAT 或 VPN:自动映射可能无法穿透上游网络。
- 只想远程打开 Web 管理页面:不要把 Web/RPC 端口当成 BT 端口处理。
如果自动映射和手动转发都失败,问题通常不在 Transmission 的勾选项本身,而在端口冲突、防火墙、双重 NAT、上游网络或 VPN 是否提供可用的入站端口。
常见问题
Transmission 的 UPnP 和 NAT-PMP 要同时开启吗?
不需要在 Transmission 中强行同时启用。确认路由器支持并开启相应的自动映射功能,再在 Transmission 中启用“从路由器转发端口”即可。
Transmission 显示端口关闭,是否一定是设置错了?
不一定。还要检查端口检测服务、Windows 或 Linux 防火墙、路由器规则、端口占用、双重 NAT、运营商级 NAT 和 VPN。先确认检测的是当前 peer port。
51413 和 9091 分别是什么?
51413 是 Transmission 配置说明中的默认 peer port,主要用于 BT peer 连接;9091 是默认 RPC 管理端口,不应拿来替代 peer port 做 BT 端口映射。
关闭随机端口后为什么还显示关闭?
固定端口只解决端口变化问题,仍需确认路由器转发到正确的局域网设备、本机防火墙允许入站连接,并排除第二台路由器或上游网络限制。
Docker 中 Transmission 开启 UPnP 后仍无法入站怎么办?
检查路由器是否把 peer port 转发到 Docker 宿主机,再检查宿主机是否把同一端口发布到容器;同时确认容器内 Transmission 的 peer port 与外部映射一致。
UPnP 自动映射不需要时怎么关闭?
在 Transmission 的 Network/Ports 页面关闭“Forward port from router”,并按需在路由器中关闭 UPnP 或 NAT-PMP;若仍需入站连接,再建立固定的手动端口转发。
相关阅读
- Transmission Docker 端口与权限排查
- Transmission Docker 网络、DNS、MTU 和端口配置
- Transmission 下载与端口关闭的完整排查
- Transmission 中文界面设置与排障