PiKVM VNC服务配置：跨平台远程访问方案
项目地址: https://gitcode.com/gh_mirrors/pi/pikvm 作为Web UI的替代方案，PiKVM支持通过标准VNC客户端实现远程访问。相比浏览器访问，VNC的主要优势在于全屏显示支持和完整快捷键拦截能力，尤其在低配置客户端设备上表现更流畅。本文将详细介绍VNC服务的启用配置及跨平台客户端设置方法。
服务端配置步骤
基础环境准备
- 推荐使用TigerVNC客户端以获得最佳兼容性
- 切换文件系统为可写模式：
rw
键盘布局配置（非TigerVNC客户端）
对于不支持直接键盘访问的客户端，需在配置文件中强制指定键盘布局：
# /etc/kvmd/override.yaml
vnc:
keymap: /usr/share/kvmd/keymaps/ru
所有可用键盘布局文件位于/usr/share/kvmd/keymaps目录： 
认证方式配置
推荐方案：用户密码认证
TigerVNC客户端默认支持标准用户密码认证，无需额外配置。
兼容方案：VNCAuth密码（不推荐）
对于TightVNC等不支持用户密码认证的客户端，需启用VNCAuth模式：
# /etc/kvmd/override.yaml
vnc:
auth:
vncauth:
enabled: true
通过以下命令设置VNCAuth密码：
nano /etc/kvmd/vncpasswd
服务启用与维护
- 启动VNC服务（默认监听5900端口）：
systemctl enable --now kvmd-vnc - 恢复文件系统只读模式：
ro - 配置参考文档：官方VNC配置指南
客户端配置方案
TigerVNC推荐设置
| 压缩配置 | 安全配置 |
|---|---|
 |  |
| H.264支持：若客户端版本≥1.13.0且为Windows系统，建议启用H.264编码以提升性能 常规设置：不支持H.264时选择"Tight"压缩模式 | 认证方式：选择"VNC password"并输入PiKVM的用户密码 2FA支持：密码后需追加6位验证码（如密码为 mypass，验证码为123456，则输入mypass123456） |
移动设备客户端
高级使用技巧
会话快捷键
在VNC会话中可使用以下PiKVM专用快捷键（依次快速按下释放）：
LeftAlt+LeftAlt+P：粘贴剪贴板文本（ASCII字符优先，不支持输入法切换）LeftAlt+LeftAlt+1~8：切换PiKVM Switch的1-8通道
多显示器支持
若配合KVM切换器使用，需在切换器配置中设置显示输出模式。
性能优化建议
常见问题排查
-
连接被拒绝：
- 检查防火墙规则：确保5900端口允许访问
- 服务状态：
systemctl status kvmd-vnc
-
密码认证失败：
- 2FA验证：确认密码后是否正确追加验证码
- 密码重置：参考密码管理文档
-
画面卡顿：
- 网络检测：使用
ping测试延迟，建议≤100ms - 客户端设置：降低色彩深度或关闭H.264编码
- 网络检测：使用
完整文档参见：PiKVM官方文档库
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
