跳转至

安装 Looking Glass

请先阅读!

Looking-Glass 是一个极具实验性的项目,尚未可用于生产环境! 这意味着目前还没有 looking-glass-client 的官方软件包。
出于这个原因,我们不打包也不提供 looking-glass-client,仅提供可用的配置和 SELinux 规则,以便在汽核 OS 中使用它。 不过我们打包了 kvmfr 内核模块并包含在系统镜像中,因此任何关于 kvmfr 模块在汽核 OS 中的问题,请提交至我们的 Discord 或 Github issue 跟踪器,并确保 @HikariKnight。

只有当问题与 kvmfr 模块的打包和配置无关时,我们才会让你直接向 Looking-Glass 提交 issue。

启用 KVMFR 模块

你可以通过运行以下命令来启用 kvmfr 模块:

ujust setup-virtualization kvmfr

编译 Looking-Glass 客户端

创建一个 fedora:latest distrobox,用于编译二进制文件,使用以下命令创建容器;当询问使用哪个镜像时,选择默认镜像,因为已验证本指南在该镜像下可成功构建。 此 distrobox 必须手动创建,不带 --nvidia 标志(我们的 ujust 会自动应用该标志以启用硬件加速),但我们明确不希望如此,以便 cmake-data 能成功安装。

Note

如果你使用的不是最新的 Fedora 版本,请将 latest 改为你的版本号,以避免依赖版本问题。

distrobox create -i "fedora:latest" -n "tmp-lookingglass"
如果你想为此使用单独的主目录,则创建一个文件夹来存放此容器的家目录,并改用以下命令:
distrobox create -i "fedora:latest" -n "tmp-lookingglass" -H "/path/to/new/home"
使用 distrobox enter tmp-lookingglass 进入容器

按照 上游文档 操作,你可以在 这里 找到 fedora 的构建依赖,并且你还需要安装为 PipeWire 用户 提到的依赖。 由于我们将为 Wayland 而非 X11 进行构建,你还需要 libdecor-devel 软件包

当进行到运行 cmake 的部分时,使用以下命令:

cmake -DENABLE_WAYLAND=1 -DENABLE_X11=0 -DENABLE_PULSEAUDIO=0 -DENABLE_PIPEWIRE=1 ..
上述命令会禁用 X11 支持和 Pulseaudio 支持,但启用 Pipewire 和 Wayland 支持,这样可以避免任何问题,因为汽核 OS 不提供 looking-glass 所需的 X11 依赖。

将构建好的 looking-glass-client 二进制文件复制到 /run/host/home/$USER/.local/bin/ 如果你遵循了 looking-glass 文档,可以使用以下命令完成此操作。

mkdir /run/host/home/$USER/.local/bin
cp ./looking-glass-client /run/host/home/$USER/.local/bin/
在宿主上、你的虚拟机运行时测试 looking-glass-client 二进制文件是否可用。

退出容器并运行以下命令,删除我们用于构建 Looking-Glass 客户端的容器。

distrobox stop tmp-lookingglass ; distrobox rm tmp-lookingglass