elestio/docker-desktop-vnc

Docker Desktop VNC 镜像文档

概述

Docker Desktop VNC镜像提供了通过Web VNC界面访问Ubuntu桌面环境的功能，支持浏览器直接访问或通过VNC查看器连接，适用于需要远程桌面环境的场景。

核心功能与特性

• 支持Web VNC访问，通过浏览器即可连接Ubuntu桌面
• 提供VNC查看器连接方式，支持密码保护
• 支持HTTP基本认证和SSL加密
• 可自定义屏幕分辨率
• 允许配置默认用户及密码
• 支持工作区目录持久化存储

使用场景

• 远程访问Ubuntu桌面环境
• 开发或测试需要图形界面的应用
• 演示或教学环境搭建
• 轻量级远程办公桌面

详细使用方法

快速开始

运行容器并通过6080端口访问：

shell
docker run -p 6080:80 -v /dev/shm:/dev/shm -v ${PWD}/knime-workspace:/root/knime-workspace elestio/docker-desktop-vnc

在浏览器中访问：[***]

VNC查看器连接

转发VNC服务端口5900到主机：

shell
docker run -p 6080:80 -p 5900:5900 -v /dev/shm:/dev/shm -v ${PWD}/knime-workspace:/root/knime-workspace elestio/docker-desktop-vnc

使用VNC查看器连接到5900端口。如需设置VNC密码，通过VNC_PASSWORD环境变量：

shell
docker run -p 6080:80 -p 5900:5900 -e VNC_PASSWORD=mypassword -v ${PWD}/knime-workspace:/root/knime-workspace elestio/docker-desktop-vnc

连接时浏览器或VNC查看器会提示输入密码。

HTTP基本认证

通过HTTP_PASSWORD环境变量设置HTTP基本认证：

shell
docker run -p 6080:80 -e HTTP_PASSWORD=mypassword -v ${PWD}/knime-workspace:/root/knime-workspace elestio/docker-desktop-vnc

SSL加密连接

首先生成自签名SSL证书（如无证书）：

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

指定SSL端口、证书路径并转发到6081端口：

shell
docker run -p 6081:443 -e SSL_PORT=443 -v ${PWD}/ssl:/etc/nginx/ssl -v ${PWD}/knime-workspace:/root/knime-workspace elestio/docker-desktop-vnc

屏幕分辨率设置

默认分辨率会根据首次连接的浏览器窗口大小自适应。可通过RESOLUTION环境变量设置固定分辨率：

shell
docker run -p 6080:80 -e RESOLUTION=1920x1080 -v ${PWD}/knime-workspace:/root/knime-workspace elestio/docker-desktop-vnc

默认桌面用户

默认用户为root。可通过USER和PASSWORD环境变量修改用户及密码：

shell
docker run -p 6080:80 -e USER=doro -e PASSWORD=password -v ${PWD}/knime-workspace:/root/knime-workspace elestio/docker-desktop-vnc

credits

本镜像基于以下项目构建：https://github.com/fcwu/docker-ubuntu-vnc-desktop