Looking Glass 客户端 Linux 安装指南:从 `make install` 到用户级部署

发布时间:2026/10/12 2:19:26
Looking Glass 客户端 Linux 安装指南:从 `make install` 到用户级部署 音视频图形学【免费下载链接】LookingGlassAn extremely low latency KVMFR (KVM FrameRelay) implementation for guests with VGA PCI Passthrough.项目地址https://gitcode.com/gh_mirrors/lo/LookingGlass点击查看免费下载导读本文是 Looking GlassKVMFR即 KVM FrameRelay 实现Linux 客户端的完整安装指南。Looking Glass 客户端负责在 Linux 主机上接收 Windows 虚拟机中由 Looking Glass 服务端采集的画面并显示同时承载输入、音频、叠加层overlay与可选的 SPICE 服务。读完本文你将掌握从源码构建产物出发的两种安装方式——系统级安装与用户级安装理解make install背后的 CMake 安装规则、.desktop启动器与调试文件.debug的部署位置并能独立完成安装后的验证、启动与卸载。说明本文对应仓库 doc/install_client.rst 的安装章节并补充了 doc/build.rst 的构建流程与 client/CMakeLists.txt 的安装实现细节供读者对照查阅。安装前的定位客户端与服务端的分工在进入安装步骤前先明确客户端在整个架构中的角色参见 doc/install_client.rst 与 doc/build_host.rstLooking Glass Client客户端运行在 Linux 主机上接收来自 Windows 虚拟机中 Looking Glass 服务端实现传输的帧并负责显示、输入、音频、叠加层及可选的 SPICE 服务。Looking Glass Host服务端旧称 Host Application运行在 Windows 虚拟机内是采集与发送端的服务程序。注意Host在这里指的是被客户端连接的服务端应用不是指宿主机操作系统。常见的部署形态是宿主机 OS 上运行虚拟机客户端应用跑在宿主机 OS服务端应用跑在虚拟机内Looking Glass 也支持虚拟机对虚拟机的形态。典型工作流为先启动 Windows 虚拟机及其显示驱动IDD再启动客户端客户端默认通过 LGMP 协议在/dev/kvmfr0设备上自动通信详见 doc/usage.rst。先决条件客户端需要先构建截至当前仓库版本客户端没有现成的 Linux 发行版软件包安装必须以源码构建的产物为前提doc/install_client.rst 明确说明 There are currently no Linux distribution packages for the client。因此完整的安装路径是按 doc/build.rst 的指引从源码构建客户端在构建目录中执行安装命令配置运行环境并启动验证。构建要点完整步骤见 doc/build.rst# 在仓库根目录下创建构建目录并配置 mkdir client/build cd client/build cmake ../ make构建产物包括looking-glass-client客户端主二进制用于显示来自虚拟机的帧looking-glass-client.debug调试符号文件。必须与对应二进制配套保留才能在崩溃栈回溯中获得源码位置安装目标会自动将其放到标准的bin/.debug位置。构建期有两个常见注意点也与安装结果直接相关GNOME on Wayland 用户可开启 libdecor 支持cmake -DENABLE_LIBDECORON ../以获得更完整的窗口装饰支持详见 doc/build.rst 及 FAQ编译报错常见于 backtrace 支持可尝试cmake -DENABLE_BACKTRACE0 ../关闭后重新构建。构建完成的二进制可以直接从构建目录运行./looking-glass-client方式一系统级安装make install在构建目录中以 root 权限执行make install这是文档给出的标准安装方式。默认前缀由 CMake 的GNUInstallDirs模块决定通常为/usr/local具体行为可查看 client/CMakeLists.txt 中的安装规则。make install实际做了什么从源码看安装目标install target共注册了四类内容client/CMakeLists.txt安装项目标位置说明looking-glass-client可执行文件${CMAKE_INSTALL_BINDIR}即bin/如/usr/local/bin组件binarylooking-glass-client.debug${CMAKE_INSTALL_BINDIR}/.debug即bin/.debug调试符号随二进制一并安装looking-glass-client.desktop${CMAKE_INSTALL_DATAROOTDIR}/applications如/usr/local/share/applications桌面启动器由 resources/looking-glass-client.desktop.in 模板生成lg-logo.svg重命名为looking-glass.svg${CMAKE_INSTALL_DATAROOTDIR}/icons/hicolor/scalable/apps图标资源供桌面环境索引其中.desktop模板resources/looking-glass-client.desktop.in的关键字段如下[Desktop Entry] TypeApplication NameLooking Glass Client CommentClent for Looking Glass KVMFR Iconlooking-glass ExecCMAKE_INSTALL_PREFIX/bin/looking-glass-client Terminalfalse KeywordsKVM CategoriesSystem; StartupWMClasslooking-glass-client SingleMainWindowtrue注意Exec行中的CMAKE_INSTALL_PREFIX会在 CMake 配置阶段被替换为实际安装前缀因此系统级安装与用户级安装生成的.desktop内容会指向各自对应的可执行文件路径。调试符号由构建阶段的POST_BUILD自定义命令生成client/CMakeLists.txtobjcopy --only-keep-debug提取调试信息到.debug文件strip --strip-debug精简主二进制最后objcopy --add-gnu-debuglink在二进制中写入指向.debug的链接。这也是安装规则把.debug放到bin/.debug的原因——GDB 等调试器会沿.gnu_debuglink在该标准位置寻找符号。验证安装结果系统级安装完成后可执行which looking-glass-client looking-glass-client --help--help会列出当前安装构建支持的全部选项命令行选项优先级高于配置文件详见 doc/usage.rst。方式二用户级安装仅当前用户如果当前用户没有 root 权限或者希望把客户端限制在个人账户内可以在配置阶段指定用户级前缀cmake -DCMAKE_INSTALL_PREFIX$HOME/.local .. make install关键点 1前缀在配置阶段决定CMAKE_INSTALL_PREFIX是 CMake 配置configure阶段的变量必须在cmake时传入而不是在执行make install时传入。若构建目录已经用其他前缀配置过需要先重新配置或换一个全新的构建目录否则安装目标仍会使用旧前缀。关键点 2.desktop启动器随前缀联动由于 resources/looking-glass-client.desktop.in 中的Exec使用了CMAKE_INSTALL_PREFIX用户级构建生成的.desktop会指向$HOME/.local/bin/looking-glass-client不会与其他用户的安装冲突。关键点 3PATH 必须包含用户级 bin 目录用户级安装后可执行文件位于$HOME/.local/bin。文档明确提示使用用户级安装时必须确保$HOME/.local/bin在PATH中否则 shell 无法找到looking-glass-client命令。可以在当前 shell 会话中临时加入export PATH$HOME/.local/bin:$PATH持久化则写入 shell 配置文件如~/.bashrc、~/.zshrcecho export PATH$HOME/.local/bin:$PATH ~/.bashrc修改后需重新加载配置source ~/.bashrc或重新登录使生效。安装后的启动与验证安装完成后即可按 doc/usage.rst 的指引启动# 在 Windows 虚拟机与 IDD 运行起来之后 looking-glass-client客户端会自动选择传输设备/dev/kvmfr0可用时默认走 LGMP over/dev/kvmfr0否则回退到/dev/shm/looking-glass。需要指定其他设备时looking-glass-client -f /dev/kvmfr1常见验证手段looking-glass-client --help查看当前构建支持的全部选项按ScrLk默认逃逸键进入或退出捕获模式长按ScrLk可查看可用命令如ScrLkQ退出、ScrLkF切换全屏若键盘没有ScrLk可通过input:escapeKey或-m修改逃逸键。卸载客户端客户端工程通过 cmake/UninstallTarget.cmake 注册了uninstall自定义目标client/CMakeLists.txt第 26 行通过include(UninstallTarget)引入。在构建目录中执行make uninstall其实现cmake/uninstall.cmake.in读取构建目录下的install_manifest.txt逐条删除安装时落地的文件包括二进制、.debug调试文件、.desktop启动器与图标并支持DESTDIR环境变量。若提示找不到install_manifest.txt说明当前构建目录从未执行过安装无需卸载。常见问题与排错looking-glass-client: command not found多发生在用户级安装后忘记配置PATH。检查$HOME/.local/bin是否在PATH中或直接以绝对路径运行$HOME/.local/bin/looking-glass-client。安装位置与预期不符确认cmake配置时-DCMAKE_INSTALL_PREFIX是否按需指定系统级默认前缀通常为/usr/local变更前缀需要重新配置构建目录。崩溃时无法定位源码检查bin/.debug/looking-glass-client.debug是否与二进制同版本配套存在若构建时关闭了 backtrace-DENABLE_BACKTRACE0需用gdb手动获取回溯。GNOME on Wayland 窗口装饰异常构建时用cmake -DENABLE_LIBDECORON ../启用 libdecor 支持后重新安装。延伸阅读客户端构建完整流程doc/build.rst客户端日常使用、默认按键与配置文件doc/usage.rst旧版服务端构建legacy Host Applicationdoc/build_host.rst客户端安装规则源码client/CMakeLists.txt桌面启动器模板resources/looking-glass-client.desktop.in卸载目标实现cmake/UninstallTarget.cmake 与 cmake/uninstall.cmake.in赞分享音视频图形学【免费下载链接】LookingGlassAn extremely low latency KVMFR (KVM FrameRelay) implementation for guests with VGA PCI Passthrough.项目地址https://gitcode.com/gh_mirrors/lo/LookingGlass点击查看免费下载相关推荐Looking Glass 完整安装指南VM 共享内存、Windows IDD 与 Linux 客户端部署Looking Glass 完整安装指南VM 共享内存、Windows IDD 与 Linux 客户端部署 本文是 Looking Glass 项目的官方安装音视频图形学Looking Glass Linux 客户端编译指南依赖安装、CMake 配置与源码构建全流程Looking Glass Linux 客户端编译指南依赖安装、CMake 配置与源码构建全流程 Looking Glass 是一个通过共享内存IVSHME音视频图形学DroidCam Linux客户端完全指南从安装到高级配置DroidCam Linux客户端完全指南从安装到高级配置 DroidCam是一款将Android设备转变为高质量网络摄像头的开源工具特别适用于Linux系音视频视频处理智能硬件上一篇Grafana Tempo 中的 Viper 配置体系Go 应用配置管理的完整实战指南下一篇PTO-ISA TEXPANDS 指令详解将标量广播填充至 Tile 的标量扩展算子创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

关于本文作者

来自尧图内容编辑团队

尧图内容编辑团队 内容团队

尧图内容编辑团队

本文由尧图网络内容编辑团队执笔。团队由资深项目经理、前端工程师与设计师组成,所有内容均来自亲手交付的真实项目,先讲清问题、再给出可落地的解法。尧图深耕北京网站建设十年,服务过京华建材集团、智造科技等各行业客户,把一线经验沉淀为可复用的行业观察。

  • 十年建站经验,覆盖建材、制造、服务、文创等
  • 项目经理把关选题与事实准确性
  • 工程师与设计师联合撰写专业细节
  • 统一编辑规范,保证文风与排版一致
  • 每月复盘转化数据,迭代选题方向

延伸阅读

相关资讯与近期热门内容

深度阅读推荐

建站决策前值得细读的三篇

网站改版的5个关键决策
2024-08-12

网站改版的5个关键决策

什么时候该改版、改到什么程度、如何避免流量掉光,京华建材集团改版复盘给出答案。

获取专属建站方案

看完文章,把您的行业与预算告诉我们,免费获取一份量身定制的官网建设方案与报价。

立即免费咨询