You need to enable JavaScript to run this app. 求助:Google Colab中flask-ngrok运行失效,提示ngrok隧道未找到
优惠活动
大模型
产品
解决方案
定价
更多

求助:Google Colab中flask-ngrok运行失效,提示ngrok隧道未找到

Colab环境下flask-ngrok报 Tunnel xxxxxxx.ngrok.io not found 解决方案

核心报错根因

  • flask-ngrok第三方包已停止维护4年以上,适配的是ngrok 2020年之前的无认证匿名隧道接口;目前ngrok官方已全量下线该接口,旧包调用后返回的隧道地址属于已回收的无效地址,直接触发“隧道不存在”报错。
  • 报错和原示例代码的编写逻辑无关,是底层依赖的服务接口变更导致的兼容性问题。

可直接运行的替代实现

  1. 先卸载失效的旧包,清除残留依赖冲突
    !pip uninstall flask-ngrok -y -q
    
  2. 安装兼容当前ngrok服务的封装库
    !pip install pyngrok flask -q
    
  3. 运行适配后的服务代码
    from pyngrok import ngrok
    from flask import Flask
    
    # 填入个人ngrok账号的专属认证token
    ngrok.set_auth_token("你的专属认证token")
    # 清空所有残留的无效隧道连接,避免端口/地址占用
    ngrok.kill()
    
    app = Flask(__name__)
    # 将本地5000端口映射为公网可访问地址
    public_url = ngrok.connect(addr="5000")
    print(f"公网访问地址:{public_url}")
    
    @app.route("/")
    def home():
        return "hello api"
    
    # 关闭热重载避免Colab环境下的端口占用冲突
    app.run(port=5000, use_reloader=False)
    

认证token获取路径:登录ngrok官方个人账号后台,在Authtokens功能页复制生成的专属字符串即可,这是当前免费隧道的必填校验项,无token会被直接拦截请求。

排查避坑清单

  • 禁止复用旧flask-ngrok生成的历史隧道地址,这类地址已被ngrok官方回收,无论怎么发起请求都会返回隧道不存在。
  • 如果执行代码后地址无响应,重新执行ngrok.kill()清空连接状态后再启动服务,不要在原有残留连接上重复发起隧道请求。
  • 免费账号生成的隧道地址为每次启动时随机分配,不可长期固定复用。

内容的提问来源于stack exchange,提问作者pp7sec

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 04:15:04