novaspirit/alpine_xfce4_novnc

Alpine xfce4 noVNC Docker镜像文档

1. 镜像概述和主要用途

1.1 概述

基于Alpine Linux的轻量级Docker镜像，集成XFCE4桌面环境与noVNC服务，支持通过HTML5浏览器实现远程图形界面访问，无需安装专用VNC客户端。

1.2 主要用途

提供轻量化、免客户端的远程桌面环境，适用于临时图形界面需求、演示场景或轻量化开发/测试环境。

2. 核心功能和特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• XFCE4桌面：集成简洁高效的XFCE4图形用户界面
• noVNC支持：通过HTML5协议实现浏览器直接访问，跨平台兼容性强
• 即开即用：预配置VNC服务与访问参数，简化部署流程
• 低门槛访问：无需专业客户端，现代浏览器即可连接

3. 使用场景和适用范围

• 临时远程桌面需求（无本地图形界面环境时）
• 开发/测试过程中的图形工具访问
• 教学演示或培训场景中的图形环境共享
• 轻量化服务器的图形界面扩展
• 资源受限环境下的图形应用运行

4. 使用方法和配置说明

4.1 本地构建镜像

bash
# 克隆源码仓库
git clone https://github.com/novaspirit/Alpine_xfce4_noVNC.git

# 构建镜像
docker build -t alpine-xfce4 Alpine_xfce4_noVNC/

4.2 运行镜像

4.2.1 本地构建镜像运行

bash
docker run -it -p 6080:6080 --name alpine-novnc docker.xuanyuan.run/alpine-xfce4

4.2.2 从Docker Hub运行

bash
docker run -it -p 6080:6080 --name alpine-novnc docker.xuanyuan.run/novaspirit/alpine_xfce4_novnc

4.2.3 Docker Compose部署示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  alpine-novnc:
    image: docker.xuanyuan.run/novaspirit/alpine_xfce4_novnc
    container_name: alpine-novnc
    ports:
      - "6080:6080"  # noVNC服务端口映射
    tty: true        # 启用终端交互
    stdin_open: true # 保持标准输入打开

启动命令：

bash
docker-compose up -d

4.3 连接noVNC服务

1. 在浏览器中访问以下URL：
   http://<Docker主机IP>:6080/vnc.html
   （将<Docker主机IP>替换为运行容器的主机IP地址）

2. 输入预定义访问密码：alpine

3. 成功连接后即可使用XFCE4桌面环境

4.4 配置参数说明

5. 许可证

本镜像遵循MIT许可证。