shokinn/docker-alpine-desktop

docker-alpine-desktop 镜像说明

镜像概述

本镜像基于Alpine Linux构建，集成Xfce4桌面环境，通过Web VNC提供图形界面访问。镜像体积轻量，功能完整，支持持久化配置、定制化参数调整及安全访问控制，适用于快速部署可视化桌面环境。

核心功能

1. 轻量级设计：基于Alpine Linux，镜像体积小，资源占用低；
2. 双访问方式：支持Web浏览器（5800端口）和VNC客户端（5900端口）访问；
3. 持久化存储：配置数据和媒体文件可通过卷映射持久化；
4. 定制化参数：通过环境变量调整用户ID、时区、显示分辨率、安全设置等；
5. 多语言支持：可启用CJK字体（中文/日文/韩文）；
6. 安全选项：支持加密连接和VNC密码保护。

使用场景

• 个人开发测试环境：快速搭建临时可视化桌面；
• 远程访问需求：通过Web/VNC远程操作桌面应用；
• 轻量化办公场景：运行基础办公软件或工具；
• 教学演示：快速部署统一的桌面环境供学员使用。

配置说明

部署示例

Docker Run命令

bash
docker run -d --name=alpine-desktop \
-v /host/path/config:/config \
-v /host/path/media:/media \
-e USER_ID=1000 \
-e GROUP_ID=1000 \
-e TZ=Asia/Shanghai \
--cap-add SYS_ADMIN \
--device /dev/fuse \
--shm-size docker.xuanyuan.run/2g \
-p 5800:5800 \
-p 5900:5900 \
shokinn/alpine-desktop:latest

访问地址：http://你的主机IP:5800

环境变量

数据卷

端口映射

安全设置

• 加密连接：设置SECURE_CONNECTION=1启用HTTPS/VNC SSL加密；
• VNC密码：通过VNC_PASSWORD或/config/.vncpass_clear文件设置访问密码；
• 证书管理：可在/config/certs目录放置自定义证书替换默认自签名证书。

反向代理配置（NGINX）

基于域名路由

nginx
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

upstream alpine-desktop {
    server 127.0.0.1:5800;
}

server {
    server_name alpine-desktop.yourdomain.com;
    
    location / {
        proxy_pass http://alpine-desktop;
    }
    
    location /websockify {
        proxy_pass http://alpine-desktop;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection $connection_upgrade;
        proxy_read_timeout 86400;
    }
}

Shell访问

bash
docker exec -ti alpine-desktop sh