文档教程【免费下载链接】pikvmOpen and inexpensive DIY IP-KVM based on Raspberry Pi项目地址https://gitcode.com/gh_mirrors/pi/pikvm点击查看免费下载KVMD 4.4 是 PiKVM 的一次重要功能迭代其核心成果是得益于 Raspberry Pi 内核团队修复了与直通模式相关的 H.264 颜色显示错误V4 Plus 的 HDMI 直通HDMI Video Passthrough功能从此稳定并在新镜像中默认启用。本文基于仓库内 2024-08-19 发布公告 与 HDMI 直通官方指南完整梳理该功能的原理、启用方式、分辨率限制与关闭方法并结合仓库中的 EDID、USB 直通与 V4 硬件资料做纵深补充帮助你在本地显示与远程 Web/VNC 访问之间获得零冲突、零延迟的双通道视频体验。什么是 HDMI 直通为什么这次更新重要HDMI 直通允许将来自被控主机Host的视频信号直接转发到PiKVM V4 Plus 的 HDMI 输出口所连接的物理显示器上。PiKVM 此时充当视频信号的中继它一边把信号原样复制给本地显示器一边将同一路视频流转发到 Web UI 或 VNC供远程访问使用。这一特性在 KVMD 3.333 时首次引入见 2024-04-16 发布公告当时的定位是在远程访问时不打扰本地显示器的正常工作。而 KVMD 4.4 解决了此前直通模式下H.264 流中颜色显示错误的关键缺陷——该问题由 Raspberry 内核团队修复因此公告中特别强调启用后无论是 Web 流还是外部物理显示器都能获得juicy colors饱满正确的色彩。此前的实验性状态随 4.4 宣告结束功能转为默认开启。图片说明PiKVM V4 Plus 位于被控主机与本地显示器之间视频信号经 PiKVM 同时送达本地显示与远程 Web UI。功能定位与适用硬件从 官方直通指南 可以确认以下关键事实仅限 PiKVM V4 Plus它是唯一拥有 HDMI 输出端口OUT2的 PiKVM 型号。参考 V4 后视图rear 面同时提供 HDMI 视频输入口与两个 HDMI 输出口OUT2为直通专用另有OUT1而 V4 Mini 没有这些端口。配合 USB 直通效果最佳直通只解决看的问题若还要在本地直接用键鼠操作主机应同时启用 USB 直通详见下文。分辨率上限直通支持最高1920x1200像素。启用 HDMI 直通两步完成直通功能在新版镜像中默认启用因此大多数用户拿到手即可使用。如果设备上未启用按官方步骤操作即可更新 PiKVM OS 并重启。以root身份执行[rootpikvm ~]# pikvm-update若提示bash: pikvm-update: command not found说明系统镜像过旧需先用rw切换根文件系统为可写再通过 pacman 安装更新器详见 更新说明[rootpikvm ~]# rw [rootpikvm ~]# pacman -Syy [rootpikvm ~]# pacman -S pikvm-os-updater [rootpikvm ~]# pikvm-update官方建议仅在拥有设备物理访问权限或极端必要时执行系统更新因为虽然更新过程非常可靠但仍存在小概率需要重新刷写 SD 卡的风险。将物理显示器连接到 V4 Plus 背面的OUT2端口。重启完成后本地显示器上即可看到来自主机的画面。图片说明PiKVM OS 通过pikvm-update在线更新的实际界面。搭配 USB 直通本地键鼠 本地显示的一体化体验HDMI 直通只负责视频若希望本地显示器与键鼠形成接近直接连接主机的体验需要同时启用 USB 直通docs/usb_pass.md。典型接线拓扑为PiKVM V4 Plus 接入 PiKVM Switch键盘与鼠标连接到 PiKVM 的 USB A 口外部显示器通过 HDMI Out 直连 PiKVM。启用 USB 直通要求 KVMD 4.74同样通过pikvm-update更新只需一条命令[rootpikvm ~]# rw; systemctl enable --now kvmd-localhid; ro启用后即可获得完整能力在多个被控主机间切换配合 PiKVM Switch、用本地键鼠直接操作当前主机、在本地显示器上看到所选主机的画面同时远程 Web/VNC 访问不受任何影响。直通模式的即时切换快捷键USB 直通启用后可使用如下快捷键在控制 PiKVM 本体与控制主机之间切换按键需连续快速按下LeftAlt, LeftAlt, KK KVM关闭键鼠抓取让本地键鼠控制 PiKVM 自身例如操作系统控制台LeftAlt, LeftAlt, HH Host切回直通模式键鼠事件转交被控主机。显示器不支持 1920x1200 时怎么办V4 支持 1920x1200 的先进采集模式。若本地物理显示器最高仅支持 1920x1080则画面的底部会被裁切。两种应对方式优先在主机操作系统里降低分辨率使其不超过显示器上限若主机 OS 不允许调整则直接在 PiKVM 侧禁用 1920x1200 模式[rootpikvm ~]# rw [rootpikvm ~]# kvmd-edidconf --import-presetv4plus.no-1920x1200 [rootpikvm ~]# reboot这里涉及 EDID扩展显示标识数据机制PiKVM 通过 HDMI CSI 桥接芯片向上游主机播报自己支持的视频模式EDID 指南。kvmd-edidconf负责导入/导出与调整这份 EDID--import-presetv4plus.no-1920x1200会把默认 EDID 替换为不含 1920x1200 的预设使主机只向 PiKVM 发送 1080p 信号从而保证本地显示器完整显示。除直通场景外EDID 指南 还提供了kvmd-edidconf --import-presetv4plus --apply恢复默认 EDID以及针对 V4 系列v4mini、v4plus等不同型号的预设选项。EDID 文件实体位于/etc/kvmd/tc358743-edid.hex由kvmd-tc358743.service在开机时加载进采集芯片。当前限制先了解再部署直通功能较新、仍在持续改进官方文档明确列出以下限制显示器分辨率必须大于等于 PiKVM 采集分辨率PiKVM 不做任何降采样downscaling。例如显示器上限是 720p而主机输出 1080p则本地看不到画面。尽力而为的兜底策略若输入信号为 1920x1200、显示器仅支持 1920x1080画面仍会显示但底部被裁切——目的是让你至少有机会去调整主机的图像参数。暂不支持音频直通链路当前只传输视频。从 V4 快速上手指南 还可确认相关的通用注意点V4 Plus 的 Mini-PCIe 插槽仅设计给 LTE 调制解调器使用不要尝试安装 NVMe 扩展卡部分 HP/DELL 主板存在兼容性问题可通过微调 HDMI/EDID 设置解决。关闭 HDMI 直通如果不需要该功能例如希望 PiKVM 完全隐身于链路之外可通过 KVMD 的 override 配置将其关闭编辑/etc/kvmd/override.yaml追加以下内容kvmd: streamer: forever: false cmd_remove: - --v4p执行reboot重启生效。从配置结构可以推断--v4p是 KVMD 流服务streamer启动参数中负责启用 V4 直通能力的开关cmd_remove会让 KVMD 在组装流进程命令行时剔除该参数forever: false则关闭流服务的常驻运行行为二者结合即实现直通功能的整体禁用。这与 KVMD 一贯的 override 配置哲学一致配置系统总览见 config.md。小结KVMD 4.4 标志着 PiKVM V4 Plus 的 HDMI 直通从实验功能走向开箱即用H.264 颜色缺陷被内核层修复、功能默认开启、新镜像即插即用。对运维与 DIY 用户而言这意味着一个 PiKVM 即可同时承担远程 IP-KVM 与本地零延迟显示器中继的双重角色。部署时只需牢记三点只适用于 V4 Plus 并接在OUT2口、显示器分辨率不低于采集分辨率、需要本地键鼠时配合 USB 直通使用。如需进一步深入可继续阅读仓库内以下文档HDMI 直通完整指南本文所有限制与配置的权威来源USB 直通指南本地键鼠直通的完整设置与快捷键EDID 指南1920x1200 模式与自定义 EDID 的底层原理V4 快速上手V4 Mini/Plus 硬件接口与直通相关端口说明更新 PiKVM OSpikvm-update的标准更新流程与旧镜像升级路径KVMD 3.333 发布公告直通功能的首次亮相与设计初衷。赞分享文档教程【免费下载链接】pikvmOpen and inexpensive DIY IP-KVM based on Raspberry Pi项目地址https://gitcode.com/gh_mirrors/pi/pikvm点击查看免费下载相关推荐PiKVM V4 Plus HDMI Video Passthrough 完全指南零延迟本地显示与远程管理并行架构PiKVM V4 Plus HDMI Video Passthrough 完全指南零延迟本地显示与远程管理并行架构 导读 本文围绕 PiKVM 在 V4 Pl文档教程PiKVM 系统配置覆盖指南正确使用 override.yaml 定制 kvmd 默认设置PiKVM 系统配置覆盖指南正确使用 override.yaml 定制 kvmd 默认设置 PiKVM OS 内置了大量底层系统参数 kvmd 守护进程的超文档教程PiKVM V4 Plus HDMI Video Passthrough 完全指南零延迟本地显示与远程流同步PiKVM V4 Plus HDMI Video Passthrough 完全指南零延迟本地显示与远程流同步 PiKVM V4 Plus 的 HDMI 视频透文档教程上一篇MAA明日方舟助手终极免费自动化工具完整指南下一篇Apache APISIX api-breaker 插件详解API 熔断机制的配置、原理与源码剖析创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考