RK3588在Armbian上运行PIKVM

## [](#项目运行环境)项目运行环境

## [](#简单安装方法)简单安装方法

1.  本项目依赖 `Python 3.10`，可以选择预装了 `Python 3.10` 的发行版，例如 `Ubuntu jammy`
    
2.  根据项目手册安装

<table><tbody><tr><td class="gutter"><pre>1 2 3 4 </pre></td><td class="code"><pre>sudo apt install -y git git clone http://github.com/jacobbar/fruity-pikvm cd fruity-pikvm sudo ./install.sh </pre></td></tr></tbody></table>

1.  由于本项目的ustreamer不支持rk3588的NV24等，用支持NV24的替换掉它们

<table><tbody><tr><td class="gutter"><pre>1 2 3 4 5 6 </pre></td><td class="code"><pre>sudo apt install build-essential libevent-dev libjpeg-dev libbsd-dev git clone -b rk3588-b https://github.com/Vincent056/ustreamer.git cd ustreamer &amp;&amp; make cp src/ustreamer.bin /usr/bin/ustreamer cp src/ustreamer-dump.bin /usr/bin/ustreamer-dump </pre></td></tr></tbody></table>

1.  修改 `/etc/kvmd/main.yaml` 配置中的 `kvmd-video` 为 `video0`

<table><tbody><tr><td class="gutter"><pre>1 2 3 4 5 6 7 8 9 10 </pre></td><td class="code"><pre> - "--device=/dev/kvmd-video" sudo systemctl restart kvmd sudo systemctl stop kvmd sudo systemctl disable --now kvmd-webterm kvmd-otg start kvmd --run </pre></td></tr></tbody></table>

## [](#高级安装方法)高级安装方法

<table><tbody><tr><td class="gutter"><pre>1 2 3 4 </pre></td><td class="code"><pre>sudo apt update sudo apt install -y nginx tesseract-ocr tesseract-ocr-eng janus libevent-dev libgpiod-dev wget https://github.com/jacobbar/fruity-pikvm/releases/download/debfile/fruity-pikvm_0.2_arm64.deb sudo dpkg -i fruity-pikvm_0.2_arm64.deb </pre></td></tr></tbody></table>

1.  由于本项目依赖 `Python 3.10`，如果你用的是预装 `Python 3.10` 的发行版如 `Ubuntu jammy`，那么可以直接跳过下面编译Python这步
    
2.  如果你系统发行版预装的Python为其它版本（例如：bookworm预装版本为3.11），那么请自行编译所需Python版本

<table><tbody><tr><td class="gutter"><pre>1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 </pre></td><td class="code"><pre>sudo apt update sudo apt install build-essential uuid-dev xz-utils zlib1g-dev tk-dev \ libssl-dev libffi-dev libbz2-dev liblzma-dev libreadline-dev \ libsqlite3-dev libgdbm-dev libgdbm-compat-dev libncurses-dev wget https://www.python.org/ftp/python/3.10.9/Python-3.10.9.tgz tar xzf Python-3.10.9.tgz cd Python-3.10.9 ./configure --enable-optimizations --prefix=/usr/local make -j$(nproc) sudo make altinstall sudo rm /usr/sbin/python sudo ln -s /usr/local/bin/python3.10 /usr/sbin/python sudo bash -c "echo '/usr/local/lib/python3.10/kvmd-packages' &gt; /usr/local/lib/python3.10/site-packages/kvmd.pth" </pre></td></tr></tbody></table>

1.  编译支持RK3588中HDMIRX所需的NV24格式支持的ustreamer程序

<table><tbody><tr><td class="gutter"><pre>1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 </pre></td><td class="code"><pre> git clone -b rk3588-b https://github.com/Vincent056/ustreamer.git cd ustreamer &amp;&amp; make cp src/ustreamer.bin /usr/bin/ustreamer cp src/ustreamer-dump.bin /usr/bin/ustreamer-dump 1. 在Armbian上静态编译需要安装如下： sudo apt install build-essential libevent-dev libjpeg-dev libbsd-dev libmd-dev 2. 在Alpine下静态编译需要安装如下： apk add gcc make libc-dev libevent-dev libevent-static libjpeg-turbo-dev libjpeg-turbo-static libbsd-dev libbsd-static libmd-dev 3. 修改src/Makefile第16行 _LDFLAGS = $(LDFLAGS) -static _COMMON_LIBS = -l:libm.a -l:libjpeg.a -l:libpthread.a -l:librt.a _USTR_LIBS = $(_COMMON_LIBS) -l:libevent.a -l:libevent_pthreads.a -l:libbsd.a -l:libmd.a 4. 去除调试信息来减肥 strip src/ustreamer.bin src/ustreamer-dump.bin 5. 查看动态连接程序依赖的库 readelf -a src/ustreamer.bin | grep "NEEDED" 6. 用编译的支持NV24格式的替换掉本项目中不支持的版本 cp src/ustreamer.bin /usr/bin/ustreamer cp src/ustreamer-dump.bin /usr/bin/ustreamer-dump 7. 测试程序是否正常（通过设备 IP:8080 访问，默认端口8080） ustreamer --device=/dev/video0 --host=0.0.0.0 --port=80 </pre></td></tr></tbody></table>

## [](#端口账户密码)端口账户密码

<table><tbody><tr><td class="gutter"><pre>1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 </pre></td><td class="code"><pre> listen 80; listen [::]:80; listen 443 ssl http2; listen [::]:443 ssl http2; sudo kvmd-htpasswd set UserName sudo kvmd-htpasswd del admin sudo kvmd-htpasswd list sudo systemctl restart kvmd kvmd-nginx </pre></td></tr></tbody></table>

## [](#通过VNC连接)通过VNC连接

<table><tbody><tr><td class="gutter"><pre>1 2 3 4 5 6 7 8 9 </pre></td><td class="code"><pre> systemctl enable kvmd-vnc systemctl start kvmd-vnc admin -&gt; admin:admin passwd -&gt; UserName:PassWord </pre></td></tr></tbody></table>

## [](#模拟插入U盘)模拟插入U盘

<table><tbody><tr><td class="gutter"><pre>1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 </pre></td><td class="code"><pre> dd if=/dev/zero of=/root/disk.img bs=1M count=1024 mkfs.ext4 /root/disk.img /root/disk.img /var/lib/kvmd/msd ext4 nodev,nosuid,noexec,rw,errors=remount-ro,data=journal,X-kvmd.otgmsd-root=/var/lib/kvmd/msd,X-kvmd.otgmsd-user=kvmd 0 0 kvmd: msd: type: otg mount /root/disk.img cd /usr/local/lib/python3.10/kvmd-packages/ wget -O /tmp/3.198msd.patch https://github.com/jacobbar/fruity-pikvm/raw/main/patches/3.198msd.patch patch -s -p0 &lt; /tmp/3.198msd.patch sudo systemctl restart kvmd-otg kvmd </pre></td></tr></tbody></table>

## [](#网络唤醒支持)网络唤醒支持

<table><tbody><tr><td class="gutter"><pre>1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 </pre></td><td class="code"><pre> kvmd: msd: type: disabled gpio: drivers: wol_server1: type: wol mac: 12:34:56:78:90:ab scheme: wol_server1: driver: wol_server1 pin: 0 mode: output switch: false view: table: - ["#Win32 PC", "wol_server1|Send Wake-on-LAN"] </pre></td></tr></tbody></table>

## [](#启用文本识别)启用文本识别

<table><tbody><tr><td class="gutter"><pre>1 2 3 </pre></td><td class="code"><pre> sudo apt install tesseract-ocr-chi-sim sudo systemctl restart kvmd </pre></td></tr></tbody></table>

## [](#将其打DEB包)将其打DEB包

<table><tbody><tr><td class="gutter"><pre>1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 </pre></td><td class="code"><pre> dpkg-deb -X fruity-pikvm_0.2_arm64.deb pikvm/ dpkg-deb -e fruity-pikvm_0.2_arm64.deb pikvm/DEBIAN/ dpkg-deb -b pikvm/ fruity-pikvm_rk3588_arm64.deb tar -xzvf Python-3.10.9.tgz &amp;&amp; cd Python-3.10.9/ ./configure --enable-optimizations --prefix=/home/leux/Python/usr/local make -j$(nproc) make altinstall mkdir /home/leux/Python/DEBIAN/ cat &lt;&lt; EOF &gt; /home/leux/Python/DEBIAN/control Package: python3.10 Version: 3.10.9-1 Architecture: arm64 Maintainer: leux &lt;leux@xxx.org&gt; Description: The Python Language (Version 3.10.9) EOF cat &lt;&lt; EOF &gt; /home/leux/Python/DEBIAN/postinst ln -sf /usr/local/bin/python3.10 /usr/sbin/python echo "/usr/local/lib/python3.10/kvmd-packages" &gt; /usr/local/lib/python3.10/site-packages/site-packages.pth EOF cat &lt;&lt; EOF &gt; /home/leux/Python/DEBIAN/prerm rm /usr/sbin/python rm /usr/local/lib/python3.10/site-packages/site-packages.pth EOF cd /home/leux/ chmod 755 /home/leux/Python/DEBIAN/prerm chmod 755 /home/leux/Python/DEBIAN/postinst dpkg -b Python/ python3.10_arm64.deb sudo apt install -y nginx tesseract-ocr tesseract-ocr-eng janus libevent-dev libgpiod-dev dpkg -i fruity-pikvm_rk3588_arm64.deb dpkg -i python3.10_arm64.deb </pre></td></tr></tbody></table>