forumi0721/alpine-desktop

alpine-desktop镜像文档

镜像概述

alpine-desktop是一个基于Alpine Linux的轻量级桌面环境镜像，旨在提供资源占用低、部署便捷的远程桌面解决方案。该镜像支持x64和aarch64两种架构，内置xfce4桌面环境，通过VNC、RDP、SSH和noVNC多种协议实现远程访问，适用于开发测试、临时图形界面需求等场景。

基础信息

• 发行版：Alpine Linux
• 支持架构：x64、aarch64
• 桌面环境：xfce4

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，系统体积小，资源占用低
• 多架构支持：同时提供x64（64位Intel/AMD）和aarch64（64位ARM）架构版本
• 完整桌面环境：集成xfce4桌面环境，包含基础图形界面组件
• 多协议访问：支持VNC、RDP、SSH和noVNC四种远程访问方式
• 灵活配置：支持自定义用户信息（用户名、UID、GID）、VNC密码及显示参数（分辨率、色彩深度等）

使用场景

• 资源受限环境下的轻量级图形界面需求
• 跨架构（x64/aarch64）的远程桌面部署
• 临时开发测试环境的图形界面访问
• 无需本地安装桌面环境的轻量化办公场景

使用方法

基本运行命令

sh
docker run -d -t \
              -e RUN_USER_NAME=<用户名> \
              -e RUN_USER_UID=<用户UID> \
              -e RUN_USER_GID=<用户GID> \
              -e VNC_PASSWD=<vnc密码> \
              -e VNC_DESKTOP_NAME=<桌面名称> \
              -e VNC_DESKTOP_GEOMETRY=<分辨率> \
              -e VNC_DESKTOP_DEPTH=<色彩深度> \
              -p 5900:5900 -p 3389:3389 -p 2222:2222 -p 6080:6080 \
              forumi0721/alpine-desktop:[架构标签]

说明：[架构标签] 需替换为实际架构版本，可选值为 x64 或 aarch64；建议添加端口映射参数（如 -p 5900:5900）以允许外部访问。

访问方式

• VNC客户端访问：vnc://localhost:5900
• 浏览器访问（noVNC）：http://localhost:6080
• RDP客户端访问：localhost:3389
• SSH客户端访问：ssh -p 2222 <用户名>@localhost

默认登录信息：用户名 forumi0721，密码 passwd

配置说明

Docker运行选项

端口映射说明

环境变量配置

卷挂载

该镜像无默认数据卷配置，可根据需求自行挂载外部存储卷。

使用示例

启动x64架构镜像并自定义配置

sh
docker run -d -t \
              -e RUN_USER_NAME=devuser \
              -e RUN_USER_UID=1001 \
              -e RUN_USER_GID=101 \
              -e VNC_PASSWD=Dev@VNC2024 \
              -e VNC_DESKTOP_GEOMETRY=1280x720 \
              -p 5900:5900 -p 6080:6080 \
              forumi0721/alpine-desktop:x64

访问说明

• 通过VNC客户端连接：vnc://localhost:5900，密码 Dev@VNC2024
• 通过浏览器访问：http://localhost:6080，输入密码 Dev@VNC2024
• 登录用户：devuser，桌面分辨率：1280x720