Python sshtunnel绑定本地12345端口转发失败 随机端口正常如何解决

网络拓扑 #

my-pc                 ssh-server         another-app-server
-----------------------------------------------------------------------
 127.0.0.1:12345 ----> x.x.x.x:22  ---->  y.y.y.y:8080 [仅ssh-server可访问]  

本地主机运行Windows 10系统，需要通过SSH连接x.x.x.x的22端口，将本地127.0.0.1:12345的流量转发到仅SSH服务器可访问的y.y.y.y:8080服务。

故障现象 #

• 显式指定local_bind_address=('127.0.0.1', 12345)时，抛出错误：ERROR | Problem setting SSH Forwarder up: Couldn't open tunnel 127.0.0.1:12345 <> y.y.y.y:8080 might be in use or destination not reachable
• 移除local_bind_address参数时，隧道可正常运行，但会绑定随机本地端口，不符合固定端口的需求。
• 已通过常规端口检查确认12345未被主动监听占用。

故障由三个常见问题叠加导致，按以下步骤修复即可固定本地绑定端口：

1. 修正SSH服务端地址传参格式
   Python中单元素加括号不会被识别为元组，初始代码里(x.x.x.x)只是被括号包裹的字符串，不是sshtunnel要求的(host, port)二元元组，会导致地址解析异常。必须显式写入SSH端口22，传标准二元元组。

2. 规避Windows系统端口保留机制
   Windows下WSL、Hyper-V、WinNAT服务会默认保留大量高位端口段，这些端口不会出现在netstat的监听列表中，但手动绑定会直接失败，随机分配端口时系统会自动避开保留段所以能正常运行。
   先以管理员身份打开CMD执行以下命令，查看端口保留列表：

   netsh interface ipv4 show excludedportrange protocol=tcp
   

   如果12345在列出的保留端口区间内，要么换一个不在区间内的端口，要么临时关闭WSL/Hyper-V后重启释放保留端口。

3. 增加兼容性参数修正绑定逻辑
   Windows环境下强制关闭IPv6绑定，避免双栈冲突，同时注意Python缩进规则（with块内代码必须缩进），最终可用代码如下：

   from sshtunnel import SSHTunnelForwarder
   from time import sleep
   
   with SSHTunnelForwarder(
       ssh_address_or_host=('x.x.x.x', 22),
       ssh_username=MY_SSH_SERVER_USER,
       ssh_private_key=MY_KEY_PATH,
       remote_bind_address=('y.y.y.y', 8080),
       local_bind_address=('127.0.0.1', 12345),
       ipv6=False,
       set_keepalive=30
   ) as server:
       server.start()
       print(f"转发已生效，本地绑定端口：{server.local_bind_port}")
       while True:
           sleep(60)
   

补充：如果绑定仍然失败，右键以管理员身份运行IDE/终端再启动脚本即可，部分Windows组策略配置下，即使是高位端口也需要管理员权限才能完成绑定。

内容的提问来源于stack exchange，提问作者AKA4