用 PVE-VDIClient 把 Proxmox VE 变成人人可用的虚拟桌面【免费下载链接】PVE-VDIClientProxmox based VDI client项目地址: https://gitcode.com/gh_mirrors/pv/PVE-VDIClient想让员工像登网页邮箱一样连上公司 Proxmox VE一款开源虚拟化平台里的虚拟机传统做法是每人记 SPICE一种高效远程桌面传输协议连接参数还要手动装工具很麻烦。PVE-VDIClient 就是一个基于 Proxmox 的 VDIVirtual Desktop Infrastructure虚拟桌面基础设施轻量客户端一个图形登录窗口输入账号密码列表里点Connect就能进桌面适合批量部署到培训机房、开发测试环境。它解决了什么问题批量发桌面不用发一堆连接串所有用户装同一个客户端连哪个集群、哪台虚拟机全由配置文件统一管理用户只需登录。多集群一套客户端搞定可以定义多个服务器组Hosts.xxx用户登录后先选组再选虚拟机天然支持北京机房/上海机房这类多环境场景。权限跟着 Proxmox 走客户端不自己维护用户列表你在 Proxmox 里给谁分配了 VM 权限谁就能在列表里看到并连接那台 VM。支持无值守场景配合 kioskiosk 模式禁止关闭窗口和 API Token 自动登录可以把它做成开机即进桌面的工位终端。先看效果登录界面开启 TOTP 双因素时下方会多出一个验证码输入框登录成功后看到的虚拟桌面实例列表可直接连接或重置如何快速开始LinuxDebian/UbuntuFedora 系把 apt 换成 dnf 即可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.pyvirt-viewer是真正负责画面传输的远程查看器Python 包则提供界面和 Proxmox API 调用。Windows:: 1. 先安装 virt-viewerVirtual Machine Manager 组件 :: 2. 安装 Python 3.14 后执行安装依赖 requirements.bat :: 3. 自定义签名/定制后打包 MSI build_vdiclient.bat也可以直接从 Releases 下载现成的 MSI 安装包装完放入配置文件即可使用。配置文件放在这些地方不传命令行参数时按此顺序查找Linux~/.config/VDIClient/vdiclient.ini或/etc/vdiclient/vdiclient.iniWindows%APPDATA%\VDIClient\vdiclient.ini全部选项见 vdiclient.ini.example。核心配置详解最小可运行配置长这样10 行以内即可跑通[General] theme dark [Hosts.PVE] hostpool { 10.10.10.100 : 8006 } auth_backend pve auth_totp false tls_verify true最关键就这几项配置项位置说明hostpool[Hosts.组名]集群节点列表格式{IP/域名: 端口}注意必须带缩进组名就是登录框里Server Group的下拉项auth_totp[Hosts.组名]true时登录界面追加 TOTP 验证码框tls_verify[Hosts.组名]false表示不校验 TLS 证书自签证书环境用公网建议保持开启guest_type[General]列表显示范围qemu、lxc或bothtimeout[General]无操作自动登出分钟0 为不超时登录与权限怎么选登录方式怎么配适用场景密码默认即可内网、信任环境双因素 TOTPauth_totp trueProxmox 用户需开启 TOTP远程办公、外网接入API Tokenusertoken_nametoken_value固定工位免登录只定义一个集群时会自动登录配合auto_vmid登录即直连指定 VM服务端权限方面每个用户访问的每台 VM都需要分配这三个权限缺一不可VM.PowerMgmt列表里能开关机/重置VM.Console连接控制台VM.Audit查看审计信息 建议用 Proxmox 角色打包成VDI 用户角色再批量分配方便日后审计。实用技巧与常见问题性能与体验调优参数列表太长时改page_size默认 10控制每页数量USB 设备透传在[AdditionalParameters]里加enable-usbredir true这些参数会原样传给virt-viewer/remote-viewerSPICE 连接地址被防火墙改写时用[SpiceProxyRedirect]重写格式原地址:端口 实际地址:端口配合inidebug true可查看当前生成的 proxy 值;集中下发配置vdiclient --config_type http --config_location http://.../vdiclient.ini还能走 HTTP Basic 认证适合统一管理几百台终端。连接失败按这个顺序排查多数问题前三步就能定位网络客户端能否telnet 集群节点 8006证书报错含 certificate 字样时先确认自签证书是否被信任临时可用--ignore_ssl验证API用户名在 Proxmox 中是否存在、密码是否正确用 Proxmox API 直接登录测试权限列表里看不到 VM 或点了没反应检查那台 VM 上是否齐了VM.PowerMgmt、VM.Console、VM.Audit。⚠️ 生产环境别长期开着--ignore_ssl或tls_verify false只用于定位问题。一句话总结PVE-VDIClient 用一个 INI 一个登录窗口把 Proxmox 虚拟机变成了普通员工能自助使用的桌面池配置门槛几乎为零。后续值得关注两个方向API Token 免登录在固定工位终端上的落地实践以及通过 HTTP 集中下发配置实现多机房统一运维。【免费下载链接】PVE-VDIClientProxmox based VDI client项目地址: https://gitcode.com/gh_mirrors/pv/PVE-VDIClient创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/8/21 21:29:19 · 阅读 1.2k 用 PVE-VDIClient 把 Proxmox VE 变成人人可用的虚拟桌面
用 PVE-VDIClient 把 Proxmox VE 变成人人可用的虚拟桌面【免费下载链接】PVE-VDIClientProxmox based VDI client项目地址: https://gitcode.com/gh_mirrors/pv/PVE-VDIClient想让员工像登网页邮箱一样连上公司 Proxmox VE一款开源虚拟化平台里的虚拟机传统做法是每人记 SPICE一种高效远程桌面传输协议连接参数还要手动装工具很麻烦。PVE-VDIClient 就是一个基于 Proxmox 的 VDIVirtual Desktop Infrastructure虚拟桌面基础设施轻量客户端一个图形登录窗口输入账号密码列表里点Connect就能进桌面适合批量部署到培训机房、开发测试环境。它解决了什么问题批量发桌面不用发一堆连接串所有用户装同一个客户端连哪个集群、哪台虚拟机全由配置文件统一管理用户只需登录。多集群一套客户端搞定可以定义多个服务器组Hosts.xxx用户登录后先选组再选虚拟机天然支持北京机房/上海机房这类多环境场景。权限跟着 Proxmox 走客户端不自己维护用户列表你在 Proxmox 里给谁分配了 VM 权限谁就能在列表里看到并连接那台 VM。支持无值守场景配合 kioskiosk 模式禁止关闭窗口和 API Token 自动登录可以把它做成开机即进桌面的工位终端。先看效果登录界面开启 TOTP 双因素时下方会多出一个验证码输入框登录成功后看到的虚拟桌面实例列表可直接连接或重置如何快速开始LinuxDebian/UbuntuFedora 系把 apt 换成 dnf 即可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.pyvirt-viewer是真正负责画面传输的远程查看器Python 包则提供界面和 Proxmox API 调用。Windows:: 1. 先安装 virt-viewerVirtual Machine Manager 组件 :: 2. 安装 Python 3.14 后执行安装依赖 requirements.bat :: 3. 自定义签名/定制后打包 MSI build_vdiclient.bat也可以直接从 Releases 下载现成的 MSI 安装包装完放入配置文件即可使用。配置文件放在这些地方不传命令行参数时按此顺序查找Linux~/.config/VDIClient/vdiclient.ini或/etc/vdiclient/vdiclient.iniWindows%APPDATA%\VDIClient\vdiclient.ini全部选项见 vdiclient.ini.example。核心配置详解最小可运行配置长这样10 行以内即可跑通[General] theme dark [Hosts.PVE] hostpool { 10.10.10.100 : 8006 } auth_backend pve auth_totp false tls_verify true最关键就这几项配置项位置说明hostpool[Hosts.组名]集群节点列表格式{IP/域名: 端口}注意必须带缩进组名就是登录框里Server Group的下拉项auth_totp[Hosts.组名]true时登录界面追加 TOTP 验证码框tls_verify[Hosts.组名]false表示不校验 TLS 证书自签证书环境用公网建议保持开启guest_type[General]列表显示范围qemu、lxc或bothtimeout[General]无操作自动登出分钟0 为不超时登录与权限怎么选登录方式怎么配适用场景密码默认即可内网、信任环境双因素 TOTPauth_totp trueProxmox 用户需开启 TOTP远程办公、外网接入API Tokenusertoken_nametoken_value固定工位免登录只定义一个集群时会自动登录配合auto_vmid登录即直连指定 VM服务端权限方面每个用户访问的每台 VM都需要分配这三个权限缺一不可VM.PowerMgmt列表里能开关机/重置VM.Console连接控制台VM.Audit查看审计信息 建议用 Proxmox 角色打包成VDI 用户角色再批量分配方便日后审计。实用技巧与常见问题性能与体验调优参数列表太长时改page_size默认 10控制每页数量USB 设备透传在[AdditionalParameters]里加enable-usbredir true这些参数会原样传给virt-viewer/remote-viewerSPICE 连接地址被防火墙改写时用[SpiceProxyRedirect]重写格式原地址:端口 实际地址:端口配合inidebug true可查看当前生成的 proxy 值;集中下发配置vdiclient --config_type http --config_location http://.../vdiclient.ini还能走 HTTP Basic 认证适合统一管理几百台终端。连接失败按这个顺序排查多数问题前三步就能定位网络客户端能否telnet 集群节点 8006证书报错含 certificate 字样时先确认自签证书是否被信任临时可用--ignore_ssl验证API用户名在 Proxmox 中是否存在、密码是否正确用 Proxmox API 直接登录测试权限列表里看不到 VM 或点了没反应检查那台 VM 上是否齐了VM.PowerMgmt、VM.Console、VM.Audit。⚠️ 生产环境别长期开着--ignore_ssl或tls_verify false只用于定位问题。一句话总结PVE-VDIClient 用一个 INI 一个登录窗口把 Proxmox 虚拟机变成了普通员工能自助使用的桌面池配置门槛几乎为零。后续值得关注两个方向API Token 免登录在固定工位终端上的落地实践以及通过 HTTP 集中下发配置实现多机房统一运维。【免费下载链接】PVE-VDIClientProxmox based VDI client项目地址: https://gitcode.com/gh_mirrors/pv/PVE-VDIClient创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考