Google Colab安装CARLA模拟器报错及cloudflared使用问题咨询

核心目标 #

• 掌握cloudflared工具的使用方法
• 修复CARLA Colab部署过程中的三类报错，实现参考笔记可直接正常运行
• 明确VNC基本概念、当前部署场景下VNC的必要性与使用方法

部署问题清单 #

• 依赖安装范围存疑：不清楚笔记requirements栏列出的程序是否需要在本地个人电脑安装
  
• CARLA启动失败：运行完全部单元格后弹出报错，模拟器无法正常启动
  
• 模块导入异常：Colab文件目录可见全部已安装文件，但运行时提示no module found模块不存在错误
  

分问题解决方案 #

1. requirements依赖安装范围说明 #

笔记requirements栏列出的所有依赖仅需在Colab云端运行环境安装，不需要在本地个人电脑安装。
Colab的代码执行、资源调度全部在谷歌云端服务器完成，本地设备仅承担浏览器交互入口的作用，不需要承载CARLA运行负载，基础运行场景下本地无需提前安装任何相关依赖。仅当后续需要本地编写自定义脚本直连Colab中运行的CARLA服务时，才需要在本地安装与Colab端版本完全一致的CARLA Python客户端包。

2. no module found模块不存在报错修复 #

该报错基本由Colab环境路径未正确配置导致，按以下步骤操作即可修复：

1. 新建Colab单元格运行如下命令，查询CARLA的实际安装路径：

   !find / -name "carla" -type d 2>/dev/null
   

2. 在所有导入carla模块的代码之前，先运行如下代码将CARLA包路径加入系统环境变量（注意将路径替换为上一步查询到的实际路径，通常为/opt/carla/PythonAPI/carla/dist/carla-对应版本-py3-linux-x86_64.egg格式）：

   import sys
   sys.path.append("/查询到的/carla包/实际路径")
   

3. 重启Colab内核后重新运行代码即可正常导入模块。注意Colab实例断开重连后会重置所有环境配置，上述路径配置代码需要放在notebook最开头位置，每次重连后优先运行。

3. CARLA启动失败报错修复 #

结合该公开笔记的已知问题，按如下顺序排查修复：

1. 确认Colab实例硬件加速配置正确：点击菜单栏「修改」-「笔记本设置」，硬件加速器选择GPU，确认分配到的GPU显存不小于12G（Tesla T4可满足运行要求，K80显存不足会直接启动失败）。
2. 清理残留占用进程后重新启动服务：

   !pkill -9 CarlaUE4
   !fuser -k 2000/tcp 2001/tcp 2002/tcp
   

3. 确认虚拟显示配置正确，启动CARLA前先运行如下代码配置虚拟显示环境：

   !apt-get install -y xvfb
   import os
   os.environ['DISPLAY'] = ':1'
   !Xvfb :1 -screen 0 1024x768x24 &
   

VNC相关说明 #

基本概念 #

VNC（Virtual Network Console，虚拟网络控制台）是一种图形界面转发协议，可将远端服务器的图形化桌面实时传输到本地设备，支持通过本地键鼠直接操作远端的图形化程序。

场景必要性 #

Colab部署CARLA场景下必须使用VNC：CARLA是带图形渲染界面的模拟器，Colab本身未提供直接的图形界面访问入口，必须通过VNC将云端运行的CARLA渲染画面转发到本地，才能查看模拟效果、进行交互操作。

场景使用流程 #

1. 在Colab端安装VNC服务端，配置虚拟显示参数，设置VNC访问密码
2. 通过内网穿透工具将Colab端VNC默认服务端口5900暴露为公网可访问的地址
3. 本地使用VNC客户端（VNC Viewer、浏览器VNC插件均可）输入公网地址与访问密码，即可连接查看CARLA运行界面

cloudflared使用方法（适配Colab场景） #

cloudflared是Cloudflare推出的内网穿透工具，无需自备服务器、无需注册账号即可直接将内网端口映射为公网可访问地址，在当前场景下的使用步骤如下：

1. 在Colab端下载Linux版本cloudflared二进制文件并赋予执行权限：

   !wget https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 -O cloudflared
   !chmod +x cloudflared
   

2. 启动隧道映射VNC服务的5900端口：

   !./cloudflared tunnel --url tcp://localhost:5900
   

3. 命令运行后从输出日志中获取生成的公网访问地址（格式为tcp://xxx.trycloudflare.com:xxxx），将该地址填入本地VNC客户端即可完成连接，无需额外配置防火墙或端口映射。

笔记可直接运行的配置顺序 #

将对应代码按如下顺序排列到notebook中，每次启动实例后从上到下顺序运行即可，不要跳步：

1. 配置GPU硬件加速
2. 安装系统依赖、CARLA安装包、xvfb、VNC服务端、cloudflared
3. 配置系统路径、DISPLAY环境变量，启动虚拟显示
4. 启动VNC服务、启动cloudflared隧道
5. 启动CARLA服务，本地通过VNC连接访问

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