AyuCLouD-Services返回首页

Transmission UPnP/NAT-PMP 怎么开启?端口关闭与 9091 误用排查

更新于 2026-11-20 · ayu-ssr.buzz

简答: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_portBT peer 连接监听端口是
rpc_portWeb、远程管理或 RPC 接口端口不是
随机端口启动时或按设置更换 peer port会影响固定映射

如果启用了随机端口,路由器中固定填写的端口可能会与 Transmission 实际使用的端口不一致。需要固定转发时,先关闭随机端口,再记录当前 peer port。

Transmission 桌面客户端开启 UPnP/NAT-PMP

  1. 打开 Transmission 的设置或偏好设置。
  2. 进入 Network 或“网络”相关页面。
  3. 找到端口设置区域,确认 peer port,并启用 Forward port from router,中文界面可能显示为“从路由器转发端口”或相近描述。
  4. 保存设置,必要时完全退出并重新打开 Transmission。
  5. 回到端口状态位置,观察是否显示端口已开放。

官方端口转发指南给出的路径是“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。

自动映射失败时:手动转发怎么填

  1. 在 Transmission 中关闭随机端口,记录固定的 peer port。
  2. 确认运行 Transmission 的设备局域网地址,例如路由器分配给电脑、NAS 或容器宿主机的地址。
  3. 进入路由器的“端口转发”“端口映射”或相近页面。
  4. 将外部端口和内部端口都填写为同一个 peer port,目标地址填写运行 Transmission 的设备地址。
  5. 协议优先选择 TCP 与 UDP 均启用;如果路由器只能分开创建规则,则分别建立两条。
  6. 保存后重新检查 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;若仍需入站连接,再建立固定的手动端口转发。

相关阅读

参考资料

  1. Transmission 官方端口转发指南
  2. Transmission 官方端口关闭排障说明
  3. Transmission 官方配置文件编辑说明