GCP AI Platform Jupyter Notebook 内核无法连接问题咨询

根因定位 #

你遇到的是企业网络环境下的高频共性问题，报错已经明确指向WebSocket长连接建立失败，核心原因是企业防火墙/代理默认拦截了Jupyter Lab用于内核通讯的wss协议请求，而手机移动网络无相关拦截策略，因此访问正常。

可行解决方案 #

• 调整企业防火墙/代理规则：将*.notebooks.googleusercontent.com加入出站白名单，同时放行该域名下的wss协议连接，取消针对该域名的流量扫描、连接超时强制断开策略，Jupyter内核运行需要长时间保持长连接。
• 用IAP隧道替代直连：如果暂时无法修改企业网络规则，可以通过GCP IAP隧道的方式访问，不需要建立WebSocket直连。操作步骤如下：
  1. 确保你本地已经安装并配置好gcloud CLI，完成账号认证
  2. 执行命令启动实例（如果实例未运行）：gcloud notebooks instances start <你的实例名称> --location=<实例所在区域，如us-east1>
  3. 执行端口转发命令：gcloud notebooks instances start-iap-tunnel <你的实例名称> --location=<实例所在区域> --local-port=8888
  4. 本地浏览器直接访问http://localhost:8888即可正常使用Jupyter Lab
• 本地配置排查：检查Windows系统代理、浏览器代理的规则，确认*.notebooks.googleusercontent.com没有走不支持WebSocket透传的代理节点，关闭浏览器的广告拦截、代理类插件，部分插件会主动拦截非白名单的WebSocket请求。

同类问题说明 #

该问题在企业网络环境下的出现频率很高，超过90%的同类案例通过上述方案都可以完全解决。

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