PVE-VDIClient 快速上手指南基于 Proxmox VE 的轻量虚拟桌面客户端【免费下载链接】PVE-VDIClientProxmox based VDI client项目地址: https://gitcode.com/gh_mirrors/pv/PVE-VDIClient在 Proxmox VE 上给团队开虚拟桌面时普通用户想连上自己的那台往往还得登 Web 控制台、找到节点、翻到对应虚拟机很折腾。PVE-VDIClient 是一个用 Python 写的轻量 VDI 客户端直接对接 Proxmox API把当前用户有权限访问的桌面实例列出来点一下 Connect 就通过 SPICE 连进去登录、列表、连接三屏搞定。五分钟跑起来客户端本体只有一个 Python 文件vdiclient.py真正缺的是系统级的 virt-viewerSPICE 显示程序。在 Debian/Ubuntu 上可以一次性装好apt install python3-pip python3-tk virt-viewer git git clone https://gitcode.com/gh_mirrors/pv/PVE-VDIClient cd PVE-VDIClient chmod x requirements.sh ./requirements.sh cp vdiclient.py /usr/local/bin/ chmod x /usr/local/bin/vdiclient.pyFedora/RHEL 系统把 apt 换成 dnf、python3-tk 换成 python3-tkinter 即可。Windows 上需要先装好 virt-viewervirt-manager 项目提供下载和 Python运行 requirements.bat 装依赖然后使用项目 releases 里的预构建 MSI 安装包也可以用 build_vdiclient.bat 自行打包。装完还差一步把项目里的 vdiclient.ini.example 复制成 vdiclient.ini放到客户端默认查找的位置Linux 依次是 ~/.config/VDIClient/、/etc/vdiclient/、/usr/local/etc/vdiclient/填上你的集群地址再执行 python3 vdiclient.py登录窗口就会弹出来。核心功能一个客户端多个 Proxmox 集群配置里可以定义多个「服务器组」用户打开客户端时登录窗口顶部会出现下拉框选择连哪个集群。好处是多个机房、或开发和生产两套环境可以共用同一个入口用户不用关心背后是几台管理节点。用法上就是在配置文件里多写几节[Hosts.组名]组名就是用户看到的内容。桌面列表一键连 SPICE 桌面登录后客户端列出该用户能访问的全部虚拟机QEMU 和 LXC模板除外每行带状态标签后台每 5 秒自动刷新。目标虚拟机没开机的话点 Connect 会先自动开机再连接全程默认全屏打开 virt-viewer。再打开show_reset配置每行会多一个 Reset 按钮一键停止并重启该桌面适合把环境重置回初始状态。如何开启双因素认证TOTP在对应集群的配置段里把auth_totp设为 true登录窗口就会多出一个 OTP 输入框用户输入 Authenticator 应用里的动态码即可登录。对远程接入场景来说这一步基本零成本。无人值守与终端模式面向机房教室、接待终端这类场景有几个配置项很好用kiosk True让窗口不可关闭、不可移动auto_vmid指定登录成功后直接连哪台虚拟机再配上预填的用户名和 API Token仅单集群时可以做到启动即自动登录。另外timeout可以设置无操作多少分钟后自动登出避免终端一直被占着。配置要点配置文件是必选项——找不到 ini 文件客户端直接罢工。一份最小可运行示例[General] title 企业虚拟桌面 theme dark [Hosts.PVE] hostpool { 10.10.10.100 : 8006 } auth_backend pve tls_verify true几个关键参数hostpool是 JSON 字典地址: 端口格式同一集群的多个管理节点都可以列进去多行书写时务必保持缩进auth_totp true开启登录时的动态码输入框tls_verify true表示校验 Proxmox API 的 TLS 证书生产环境建议保持开启。另外常用的还有guest_type只列出 qemu 或 lxc 桌面和auto_vmid登录后自动连接。完整的选项说明在项目自带的 vdiclient.ini.example 里每一行都有注释。安全与权限认证全部走 Proxmox API支持三种方式用户名密码、密码TOTP 动态码、以及 API Token配合预填用户名。API 本身走 8006 端口的 HTTPS保持 tls_verify 开启即可命令行提供的 --ignore_ssl 只建议自签证书救急时用不要常态化。用户能看到和连接哪些桌面完全由 Proxmox 侧的权限分配决定每台被访问的虚拟机都需要 VM.PowerMgmt、VM.Console、VM.Audit 三项权限没配权限的机器客户端里根本不会出现。除可选预填用户名或配置 Token 外客户端不在本地保存密码。常见坑问一启动就弹「找不到配置文件」 答客户端只在默认位置找 iniLinux 上依次是 ~/.config/VDIClient/、/etc/vdiclient/、/usr/local/etc/vdiclient/。把 vdiclient.ini 放进去或用 --config_location 显式指定路径。问点连接后提示「Is SPICE display configured for your VM?」 答说明这台虚拟机的显示设备不是 SPICE。去 Proxmox Web 界面把显示改成 SPICE重启虚拟机后再试。问Windows 上提示 virt-viewer 缺失 答virt-viewer 是负责渲染远程桌面的程序Windows 上必须单独安装 virt-manager 的下载包客户端不会替你检测以外的任何事。问改了 hostpool 报 JSON 解析错误 答hostpool 的值必须是合法 JSON拆成多行时每一行都要缩进图省事就把整个字典写成一行。问内网外访问时 SPICE 代理地址不通 答API 返回的 proxy 地址如 pve1:3128常常是内网 IP。可先把 inidebug 设为 True 看到实际传给 virt-viewer 的 SPICE 配置再在 [SpiceProxyRedirect] 段里加一条「原地址 可达地址」的重写规则。PVE-VDIClient 适合这样一批人你已经有 Proxmox VE虚拟机显示设备是 SPICE或愿意改过去现在需要一个让普通用户「双击就能开桌面」的入口比如机房教室、分支机构或远程办公。选型时注意两点它是纯前端账号、权限、会话策略都依赖 Proxmox 侧管理RBAC 没理清楚的话它救不了你它支持的也是 SPICE 通道的桌面别指望用它连 RDP 之类的协议。对于不想引入重型 VDI 中间件的小团队来说这基本是部署成本最低的虚拟桌面入口了。【免费下载链接】PVE-VDIClientProxmox based VDI client项目地址: https://gitcode.com/gh_mirrors/pv/PVE-VDIClient创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考