如何在Docker容器化的JupyterLab中添加noVNC并解决连接报错

问题根源 #

你当前的配置核心遗漏了Xvfb虚拟显示服务和x11vnc VNC服务的启动步骤：你在Dockerfile中安装了这两个组件，但入口脚本只启动了Jupyter和noVNC代理，没有任何服务监听5901端口提供VNC服务，因此websockify转发请求时会被拒绝，返回连接失败错误。

修复步骤 #

1. 修改entrypoint.sh启动脚本 #

补充Xvfb、窗口管理器、x11vnc的启动逻辑，修改后内容如下：

#!/bin/bash
# 启动Xvfb虚拟显示，对应配置的DISPLAY=:1
Xvfb :1 -screen 0 1920x1080x16 &
# 等待X服务初始化完成
sleep 2
# 启动openbox窗口管理器
DISPLAY=:1 openbox &
# 启动x11vnc服务，监听本地5901端口，无密码访问（需密码可补充-passwd参数）
x11vnc -display :1 -nopw -listen localhost -xkb -ncache 10 -forever &
# 启动Jupyter服务
jupyter lab --allow-root --ip=* --port=8888 &
# 启动noVNC代理，显式指定静态资源路径避免加载异常
/notebooks/novnc/utils/novnc_proxy --vnc localhost:5901 --listen 6080 --web /notebooks/novnc
fg %1

2. 可选配置调整 #

如果需要设置VNC访问密码，可将x11vnc启动参数修改为：

x11vnc -display :1 -passwd 自定义VNC密码 -listen localhost -xkb -ncache 10 -forever &

3. 运行验证 #

重新构建镜像启动容器后，可进入容器执行以下命令确认服务状态：

apt update && apt install -y net-tools
netstat -tulpn

正常返回结果中，5901端口应被x11vnc进程占用，6080端口应被websockify进程占用。

注意事项 #

• Xvfb和x11vnc首次启动需要1-3秒初始化，建议容器启动后等待3秒再尝试连接noVNC，避免服务未就绪导致的临时连接失败
• 如需使用原生VNC客户端直接连接容器，可将x11vnc的监听地址从localhost改为0.0.0.0

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