R1 Box

硬件介绍

PiKVM CN_R1盒子满血版采用四核 2.0GHZ ARM A55 CPU、2GB LPDDR4X内存、Mali-G57 GPU 手机级机皇芯片，它配备了一个千兆网络接口千兆网卡，一个 Typec 口和一个 USB 3.0 接口，PiKVM为此硬件适配了 H264 硬件编解码，能获得更好的 H264 视频体验。

使用说明

硬件连接

硬件准备 拿到盒子第一时间，硬件连接可参考S805盒子接口类似，连接路由器网口，连接被控机的HDMI和USB接口。接入电源后等待1分钟左右，盒子等变为绿色，即为启动成功。

获取盒子IP 如能登录路由器后台，查找别名为armbian的新连入设备，可查看获取其IP。若无法登录路由器或者局域网后台，可用连入同局域网的手机上扫描App（如:Fing或者电脑上使用局域网扫描工具如：https://pikvm.cn/download/tools/pingtools.zip, 笔记本电脑上解压直接运行pingtools.exe。也可自行选用其他同网段IP地址扫描工具，扫描可用局域网ip（开放80和443端口）。通过浏览器依次验证访问链接【https://局域网内扫出的每个ip/api/info 】, 有json数据返回即为PiKVM盒子。

局域网登录盒子 盒子地址webui https://盒子ip/ 即可访问界面webui默认 admin/admin vnc登陆用户 admin/admin

终端安装界面 1.网页终端Terminal 切换root用户命令 su root 然后输入密码 1234 后方可在盒子内安装软件

2.终端连接盒子ip 默认用户root
密码 1234 首次会提示创建默认新用户请牢记新pass

互联网访问和一控多教程 [国内nat点对点组网教程] (https://pikvm.cn/custom/openp2pnat.pdf) （在盒子端安装linux openp2pclient，在远程主控端也安装client 在internet环境中建立直连的虚拟局域网）

tailscale组网若国际tailscale较慢XEdge国内兼容版代替

frp映射教程自有云vps推荐自建开源nps 内网映射服务

无路由器直连版本教程

一控多教程

HDMI环出模块 R1Box套装里赠送了一套高清HDMI环出同步模块支持1920x1080P 120fps或者4K 60fps的输入，此模块原为不带独立显卡也想支持被控机同时接显示器，或者同时接录制盒子来录制操作确保部分场景操作合规。但是此模块最大单路输入为1920x1080P 120fps时扩展为2路HDMI输出时，EDID每一路仅支持 1920x1080 60fps，导致PiKVM盒子的 1920x1080P MJPG模式最高120fps的采集优势发挥不出来，webUI内 MJPG模式只能到1920x1080P 60fps。

想要发挥高帧率的解决方法有如下3种： 1.若被控机有独立显卡支持DVI+HDMI输出，可把显示器用DVI连接，HDMI输出连接PiKVM盒子的采集卡。被控机的显卡输出模式显示设定双显示器复制，且HDMI显示器输出确保设置为显卡最高帧率输出。 2.若被控机不支持双路显卡，用同时连一路HDMI线的方法。赠送的的高清HDMI环出同步模块，采用物理插拔方法或者关闭显示器电源的情况下，拔下显示器HDMI输出后重启盒子即可实现120FPS高刷（若被控机也支持高刷输出），反之不需要远控时拔下PiKVM 盒子的采集卡HDMI输入，保障本地显示器的最高刷显示。 3.若被控机不支持双路显卡，又需要双路最高刷同时显示，可购买价格更贵但更高端输出的HDMI一分二同步器【自行购买前请和客服确认能否同时实现4K 60fps双HDMI同时输出，请务必选择usb独立供电版本（非独立供电版本在PiKVM盒子下黑屏不可用）】。

视频质量 R1Box采用了接近树莓派4的国产芯片，用VPU可加速编码.

树莓派国际版MJPG仅最大支持 1920px1080p 60fps，R1BOX 最高可支持到1920px1080p 120fps。

受国产VPU芯片制程硬件限制，PiKVM R1版本硬编码下的WebRTC和H264视频质量同国际版几乎一致，即1920px1080p 30fps 或者720p 60fps。

In H.264 mode (WebUI and VNC), you will get stable 30fps on 1080p and 60fps on 720p In MJPEG mode it just works a little faster.

参考PiKVM国际版刷新率 ,此规格基本上满足了大部分办公、运维或者普通PC游戏场景的使用的情况。

MJPG模式120FPS：参考上述HDMI单独接采集卡的方式，且设置被控机刷新频率为高刷新率（可用Macbook或者Mac Mini来测试）。选择MJPG模式局域网内可达最高刷新率 1920x1080 120fps或者 4K 30FPS。 MJPG模式延迟感几乎忽略不计,劣势是需要的上行带宽较高且不支持声音传输，对于互联网访问需要确保用户外网出口比较大，需求被控端和主控端至少60Mbps以上有线连接的公网带宽。

若公网出口不大还需要高清异地显示传输及音频同步，需要WebRTC或者H264模式下，画面经过H264编码压缩来显著降低了互联网传输带宽（10-20Mbps). 但由于实时编码消耗资源较高，目前R1盒子的VPU在保障普通发热占用的情况下，支持到 1920x1080p 30fps或者1280px720p 60fps内的长期实时编码和互联网传输，确保了远程运维、远程办公和一般游戏的流畅使用。

WebRTC下音频同步

WebRTC下音频同步时，需要远程被控机端设定被控机的声音输出设备为PIKVM虚拟的HDMI USB Audio 输出，方可远程同步被控机声音。

其他提示

待优化内容尚未实现

针对云游戏用户的需求，需要WebRTC高清版的高刷新率模式,比如1920x1080p 60fps以上帧率（大部分商业级云游戏稳定运行的帧率）

在不改R1硬件的，有如下两种路径待优化（目前版本尚未内置、持续测试进行中，等待验证后提供更新脚本）。

1.在不改R1硬件的情况下，被控机上安装Sunshine编码串流利用被控机高性能显卡编码能力，PiKVM盒子安装moonlight等串流软件中转，实现1920x1080p 60fps及以上高刷新率。

2.在不改R1硬件的情况下，R1Box硬件还具备一部分超频优化空间，我们还在联系国内芯片原厂提供更新驱动，在R1各种持续多线程优化VPU的加速H264编码情况（或将显著增加发热情况，在发热时自动降帧率）。

**新一代硬件-R1 Pro BOX-RK3588芯片驱动的KVM盒子 **

R1 Box Pro版【价格或高于R1盒子一倍】或将新一代芯片如RK3588系列，显著增加了VPU的编解码能力，默认支持1920x1080p 60fps H264硬编码，但也显著增加盒子的成本和售价。

硬件安全警告

为避免潜在风险（如被控设备无法正常启动或识别设备，甚至极少数情况下造成硬件损坏），R1满血套装已经自带了处理过的USB OTG线，

若需要更换更长的Type-C线，需要前采取以下任一方法自制USB TypeC 线：

方案一：剪断或移除 USB 线中的红色 5V 电源线（VCC），仅保留数据线（D+/D−）和地线（GND），以切断供电路径；

方案二：在 USB 链路中串接一个带独立电源开关的 USB HUB，并确保在连接时关闭其电源开关。

部分低功耗设备可能在未通主电源的情况下，通过 USB OTG 接口从 KVM 设备反向取电，导致进入异常状态——即使后续接通主电源也可能无法正常启动。

**除非您明确了解操作后果，否则请务必采用上述防护措施以保障设备安全。**

数据安全提示

不建议直接断电！eMMC 在写入过程中突然断电可能导致数据丢失。

如因特殊原因需直接断电，建议在写入操作后执行 sync 命令确保数据写入；关机或重启时，建议使用 poweroff 或 reboot 指令，让系统安全完成数据同步和关机流程。

SSH 远程登录

Armbian 系统默认开启 SSH，SSH 初始用户密码为 root/1234。

警告

不建议使用 apt upgrade 升级内核和设备树，可能会出现系统异常，OTG 功能无法使用。

硬件连接

Typec 口是 USB OTG 口接被控机设备，USB 3.0 C口是普通 USB 口接 USB 采集卡。

USB 端点数量

此硬件 CPU 的 USB OTG 端点数量为9个，共可以虚拟端点总数为9个的 USB 设备。

若ATX开机套装，其中侧向的USB为 3.0接采集卡，USB ATX开机模块接USB扩展器的竖方向任意两个其中之一即可。

WIFI 连接用户使用场景 搭配 Client（客户端模式）：作为无线网卡连接现有网络的无线迷你路由器，如 TL-WR800N， WR802N等迷你路由器若选购带迷你路由器的版本可参考WIFI连接教程 ,WIFI版的usb供电也可插入USB扩展器剩余的接口。

公网访问流量消耗 各种常用画质所需的网络带宽-上行： MJPG模式：

H264压缩： 720p 60Hz: 10Mb/s 1080p 60Hz: 20Mb/s 1080p 120Hz: 30Mb/s 2k 60Hz: 40Mb/s 2k 120Hz: 60Mb/s 4k 60Hz: 80Mb/s 4k 120Hz: 115Mb/s 要实现高清化传输还需要机制的线路速度和比较好的通讯环境。

长期监控流量消耗

在使用PiKVM进行远程桌面管理时，用户发现即使面对几乎完全静态的KDE桌面环境（仅有一个每分钟更新一次的时钟小部件），视频流比特率仍会在数百kbps到数Mbps之间波动。这种异常现象会导致不必要的网络带宽消耗，特别是在长期监控场景下尤为明显

问题核心在于H.264编码的关键帧（I帧）间隔设置。默认配置下，PiKVM每秒都会强制插入一个关键帧，这是导致静态画面下仍产生高比特率的主要原因。关键帧包含完整的画面信息，即使画面内容没有变化，编码器仍会定期生成这些大尺寸帧。通过调整以下参数可有效降低静态画面时的比特率： 1.关键帧间隔调整：访问PiKVM的System菜单将H.264 gop参数设为0 该设置允许编码器根据实际画面变化决定关键帧生成时机 2.效果验证：优化后比特率降至170-255kbps区间画面质量保持稳定动态内容响应性不受影响