mbentley/virt-manager

镜像概述和主要用途

mbentley/virt-manager是一个基于alpine:latest的Docker镜像，旨在提供一种便捷方式在容器环境中运行virt-manager图形界面工具。virt-manager是一款常用的虚拟化管理工具，可通过图形界面管理KVM、Xen等虚拟化技术，该镜像无需在主机系统直接安装依赖，实现了隔离且轻量的虚拟化管理方案。

核心功能和特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 完整图形支持：包含virt-manager完整图形界面功能，可直接操作虚拟化管理
• SSH集成：支持挂载本地SSH密钥，方便连接远程虚拟化主机进行管理
• 配置持久化：可通过卷挂载持久化保存连接配置信息，避免重复设置
• 跨平台兼容：支持在macOS（配合XQuartz）和Linux X11环境下运行

使用场景和适用范围

• 需要在容器化环境中隔离运行virt-manager的场景
• 主机系统未安装或不便于安装virt-manager依赖时使用
• 跨平台管理远程虚拟化环境（如macOS管理Linux KVM主机）
• 临时或便携的虚拟化管理需求，无需修改主机系统配置

详细使用方法和配置说明

拉取镜像

bash
docker pull docker.xuanyuan.run/mbentley/virt-manager

在macOS上运行

前置准备

需先启动XQuartz，并通过socat将X11显示暴露到网络：

bash
socat TCP-LISTEN:6000,reuseaddr,fork UNIX-CLIENT:\"$DISPLAY\"

运行命令

bash
docker run --rm \
  -e DISPLAY=<你的主机IP>:0 \
  -v ~/.ssh/id_rsa:/root/.ssh/id_rsa:ro \
  docker.xuanyuan.run/mbentley/virt-manager

注意：不可使用-t参数分配tty，否则会通过tty而非GUI请求凭据
参数说明：
-e DISPLAY=<你的主机IP>:0：指定X11显示服务器地址（替换为macOS主机IP）
-v ~/.ssh/id_rsa:/root/.ssh/id_rsa:ro：只读挂载本地SSH私钥，用于连接远程主机

在Linux X11环境运行

允许本地用户连接X会话

bash
xhost +SI:localuser:$(whoami)

运行命令

bash
docker run --rm \
  -v /tmp/.X11-unix:/tmp/.X11-unix \
  -e DISPLAY=unix$DISPLAY \
  -v ~/.ssh/id_rsa:/root/.ssh/id_rsa:ro \
  docker.xuanyuan.run/mbentley/virt-manager

参数说明：
-v /tmp/.X11-unix:/tmp/.X11-unix：挂载X11 socket，使容器访问主机显示
-e DISPLAY=unix$DISPLAY：设置显示环境变量，使用主机X11显示
-v ~/.ssh/id_rsa:/root/.ssh/id_rsa:ro：只读挂载SSH私钥，用于远程连接

持久化保存连接配置

如需保存连接配置信息（避免重复设置），添加持久化卷挂载：

bash
-v /path/to/saved/config:/root/.config/dconf

将/path/to/saved/config替换为本地用于保存配置的目录，容器会将连接信息持久化至此目录