esraghu/docker-ubuntu-vnc-desktop

docker-ubuntu-vnc-desktop

https://img.shields.io/docker/pulls/esraghu/docker-ubuntu-vnc-desktop.svg](https://hub.docker.com/r/esraghu/docker-ubuntu-vnc-desktop/) https://img.shields.io/docker/stars/esraghu/docker-ubuntu-vnc-desktop.svg](https://hub.docker.com/r/esraghu/docker-ubuntu-vnc-desktop/)

镜像概述

该镜像基于Ubuntu 16.04构建LXDE桌面环境，支持通过HTML5 VNC在浏览器中访问，或通过VNC查看器连接。核心优势是无需本地安装虚拟机即可快速搭建具备图形界面的开发环境，且允许在容器内部运行Docker容器。

核心功能

• 多端访问: 浏览器（HTML5 VNC）或VNC查看器双方式连接桌面。
• 安全认证: 支持VNC密码保护和HTTP基础认证。
• SSL加密: 可配置HTTPS访问，保障数据传输安全。
• 分辨率灵活: 自适应浏览器窗口或指定固定分辨率。
• 用户自定义: 可设置非root用户及密码。
• Docker-in-Docker: 需特权模式支持容器内运行其他Docker容器。
• 声音支持: Linux环境下可启用音频输出（预览版）。

使用场景

• 快速搭建Ubuntu桌面开发环境，替代本地虚拟机。
• 云服务器（如GCP）上部署图形化开发环境。
• 测试需图形界面的应用程序。
• 隔离运行Docker容器的桌面环境。

配置说明

快速启动

运行容器并通过6080端口访问浏览器界面：

bash
docker run -p 6080:80 docker.xuanyuan.run/dorowu/ubuntu-desktop-lxde-vnc

访问地址：[***]

VNC查看器连接

转发VNC端口5900并设置密码：

bash
docker run -p 6080:80 -p 5900:5900 -e VNC_PASSWORD=mypassword docker.xuanyuan.run/dorowu/ubuntu-desktop-lxde-vnc

使用VNC查看器连接127.0.0.1:5900并输入密码。

HTTP基础认证

设置HTTP访问密码：

bash
docker run -p 6080:80 -e HTTP_PASSWORD=mypassword docker.xuanyuan.run/dorowu/ubuntu-desktop-lxde-vnc

SSL加密访问

生成自签名证书：

bash
mkdir -p ssl
openssl req -x509 -nodes -days 365 -newkey rsa:2048 -keyout ssl/nginx.key -out ssl/nginx.crt

运行容器启用SSL：

bash
docker run -p 6081:443 -e SSL_PORT=443 -v ${PWD}/ssl:/etc/nginx/ssl docker.xuanyuan.run/dorowu/ubuntu-desktop-lxde-vnc

访问地址：[***]

屏幕分辨率设置

指定固定分辨率（如1920x1080）：

bash
docker run -p 6080:80 -e RESOLUTION=1920x1080 docker.xuanyuan.run/dorowu/ubuntu-desktop-lxde-vnc

自定义用户

设置非root用户及密码：

bash
docker run -p 6080:80 -e USER=doro -e PASSWORD=password docker.xuanyuan.run/dorowu/ubuntu-desktop-lxde-vnc

声音支持（仅Linux）

加载内核模块：

bash
sudo modprobe snd-aloop index=2

运行容器启用声音：

bash
docker run -it --rm -p 6080:80 --device /dev/snd -e ALSADEV=hw:2,0 docker.xuanyuan.run/dorowu/ubuntu-desktop-lxde-vnc

访问地址：[***] -> Chromium Web Browser Sound）测试音频。

GCP部署

在GCP创建实例时：

1. 勾选"Deploy a container image to this instance"，输入镜像名esraghu/docker-ubuntu-vnc-desktop。
2. 推荐配置：至少1vCPU + 3.75GB RAM。
3. 高级容器选项：选择"Run as Privileged"以支持Docker-in-Docker。
4. 添加环境变量（如VNC_PASSWORD、SSL_PORT等）。
5. 挂载数据卷保持持久化。
6. 防火墙允许HTTP/HTTPS访问。

故障排除与常见问题

1. boot2docker连接问题：参考https://github.com/fcwu/docker-ubuntu-vnc-desktop/issues/2%E3%80%82

许可证

详见LICENSE文件。 ===END===