Python用pyngrok实现ngrok自动化连接并获取HTTPS URL
无法获取HTTPS公网地址的核心调整方案
常见误区澄清
很多人搞混了ngrok隧道的两层协议:connect方法传入的协议参数指的是本地映射服务的协议,不是公网入口的协议。ngrok默认给每个创建的隧道同时开放HTTP和HTTPS两个公网入口,不需要本地服务支持HTTPS,网关层会自动完成SSL卸载。
之前直接拿connect的返回值拿不到HTTPS地址,本质是pyngrok的connect方法默认返回的就是公网侧的HTTP入口条目,不会主动返回HTTPS地址。
补充说明:同一条隧道对应的HTTP、HTTPS公网入口是完全同域名的,不需要为使用HTTPS单独创建一条新隧道,重复创建反而会消耗ngrok的免费连接配额。
具体代码调整步骤
- 清理残留进程避免端口冲突
每次启动新隧道前先执行ngrok.kill()杀掉所有后台残留的ngrok进程,防止旧隧道占用资源导致API返回异常。 - 正常创建本地HTTP映射隧道
本地跑在8080端口的明文HTTP服务,正常调用connect创建隧道即可,不需要额外传HTTPS相关参数:from pyngrok import ngrok # 清理旧的ngrok后台进程 ngrok.kill() # 映射本地8080端口的HTTP服务 ngrok.connect(8080, "http") - 从全量隧道列表中筛选HTTPS条目
不要直接用connect的返回值,调用ngrok.get_tunnels()拉取所有活跃隧道的完整信息,遍历匹配HTTPS协议的公网地址:https_public_url = None for tunnel in ngrok.get_tunnels(): # 筛选公网侧协议为HTTPS的条目,排除本地隧道的反向映射地址 if tunnel.public_url.startswith("https://"): https_public_url = tunnel.public_url break print("可直接使用的HTTPS公网地址:", https_public_url)
仍拿不到HTTPS地址的排查方向
- 版本兼容问题:pyngrok版本过低会导致和新版ngrok API的字段不匹配,执行
pip install --upgrade pyngrok升级到最新稳定版即可 - 鉴权异常:没有配置有效的ngrok authtoken时,服务会限制隧道的HTTPS入口开放,配置完合法token再重启隧道即可
- 配置错误:不要在
connect时传入"https"作为本地服务协议,如果本地实际跑的是明文HTTP服务,传这个参数会导致隧道握手失败,根本无法建立连接 - 自定义配置锁死:手动修改过ngrok默认配置、关闭了公网HTTPS入口的,恢复默认配置再重启隧道即可
内容的提问来源于stack exchange,提问作者Kongu B K Riot
相关产品推荐
相关产品推荐

