PiKVM官方的功能说明文档在哪？

  如果您需要对功能进行高级配置，非常建议查阅官方文档，官方项目文档的的FAQ和功能配置讲解非常详细，包含示例易于上手。官方文档（英文）：PiKVM Handbook。

能进去网页但网页黑屏如何解决？

  网页视频黑屏提示无No Singal，请检查采集卡硬件是否受支持、是否正确连接、是否松动；

  网页端黑屏无任何画面或是彩色竖条，请检查是否有被控机HDMI信号输入；

  进系统画面显示正常，BIOS界面黑屏或渲染异常，请在BIOS界面开启CMS兼容模式；

  网页画面显示片刻黑屏，刷新网页重复此现象，请使用火狐浏览器或修改kvmd主配置文件使用yuyv格式。

  如果以上情况都不符合请尝试重启玩客云自动复位。

为什么网页视频感觉非常卡顿？

  视频流输出配置中采用了yuyv格式。mjpeg格式可以实现1080p30帧或720p60帧，但占用带宽非常大（峰值50mbps左右），yuyv格式更加稳定但帧率较低（1080p5fps或720p10fps、峰值10mbps左右）。在浏览器中使用mjpeg视频流非常容易黑屏，在OBS Studio和火狐浏览器（你没有看错，事实如此）使用mjpeg格式的视频流不会出现黑屏现象。

  提示使用体验的方法：使用mjpeg格式，选择火狐浏览器，使用720p60帧或1080p30帧，右上角sysytem调整至最大帧率。针对1080p屏幕1080p画质远控请全屏使用，720p请点击网页视频右上角的“•”自动缩放画面与原画面分辨率相同。

如何在公网中访问局域网的One-KVM？

  如果您的路由器有公网IP地址，您可以直接使用端口映射转发443端口。在其他情况下，您可以使用内网穿透服务（如Tailscale），只需几个简单的命令即可在One-KVM上配置。

如何修改软件端口和账户密码？

  修改端口请编辑 /etc/kvmd/nginx/目录下的conf后缀文件将相关端口修改所需端口（443是网页运行的端口），然后运行systemctl restart kvmd kvmd-nginx 生效。下面是修改密码的示例

#添加用户 请将silentwind替换为你的用户名

kvmd-htpasswd set silentwind

#输入密码

#删除用户 kvmd-htpasswd del admin

#列出所有用户 kvmd-htpasswd list

#重启服务，使修改立刻生效

systemctl restart kvmd kvmd-nginx

我可以将静态IP分配给One-KVM吗？

  使用终端图形化工具armbain-config或者编辑文件 /etc/systemd/network/eth0.network。

我可以使用One-KVM进行游戏或是刷剧吗？

  不能，因HDMI-USB采集卡的视频帧率（最高1080p30fps）无法满足游戏要求，且没有音频。

One-KVM可以传输4K视频吗？

对于USB采集设备将原视频画面采样到更小的分辨率以满足USB 2.0带宽限制，因此源可能是4k，但网友视频流不会。4K的实时视频无论如何都不适合通过网络。

光标/视频延迟来自哪里？

这是将图像传输到浏览器或VNC客户端的过程：采集设备->压缩->网络->解压->渲染，延迟大概100-200ms。

我可以在移动设备上使用One-KVM上吗？

  是的，但WEB界面可能无法正常操控，所以在移动设备上推荐使用VNC应用程序，请注意不要使用不兼容的RealVNC。

如何添加自己的SSL证书？

  如果您有证书（制作证书超出了PiKVM的范围-请参考OpenSSL留档或使用Let's Encrypt），请替换 /etc/kvmd/nginx/ssl中的密钥，必要时编辑 /etc/kvmd/nginx/ssl.conf并重新启动kvmd-nginx服务。

当我尝试访问 One-KVM 主页时，提示 500 错误?

  可能原因：错误的 YAML 语法或者硬件外设不满足。可执行systemctl status kvmd kvmd-otg或是kvmd --run查看详细报错信息。

如何为多个 One-KVM 使用不同的主机名？

  使用 SSH 会话或 Web 终端，如果您不是 root，请使用命切换为 root 再执行命名hostnamectl set-hostname onecloud，然后重新启动 pikvm服务。

为什么我的机器不能再通过按下重置键的方式刷机了？

  脚本通过覆盖分区的方式跳过了UBoot线刷检测，如需使用其他系统则需重新短接主板刷机或使用烧录好系统的U盘通过U盘启动。

网页视频窗口提示”Janus WebSocket“连接失败如何解决？

此事件发生概率为2%，为偶发性事件，难以复现，无法解决，建议重装软件。

为什么网页视频会有无法消除的黑边且模糊无比？

非硬件和软件原因，请检查你的被控机系统设置。

最新文档地址和项目地址？

Github地址：https://github.com/mofeng-git/One-KVM （欢迎点个Star）

文档地址：https://p1b237lu9xm.feishu.cn/drive/folder/IsOifWmMKlzYpRdWfcocI7jdnQA?from=from_copylink