Ubuntu 22.04 RealSense SDK 完整安装指南DKMS 五分钟快速部署与源码编译双路径【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense这份指南面向 Intel RealSense SDKlibrealsense——Intel RealSense 深度相机的官方开发套件提供驱动、库文件和示例程序让你拿到深度与彩色图像数据。在 Ubuntu 22.04 上有两条部署路线只想让相机跑起来用 DKMS 预编译包几分钟就能点亮要基于 SDK 写程序、跑示例则建议源码编译环境完全可控。读完并照做后你会得到一台能稳定出图的深度相机外加一套验证、录制和排障的命令行工具。先查内核30 秒决定走哪条路Ubuntu 22.04 默认内核是 5.15但系统升级后经常切到 HWE 内核。动手之前先确认当前正在运行的内核uname -r # 输出示例5.15.0-78-genericDKMS 预编译包只针对 5.15、5.19、6.5 三个内核系列构建都是 22.04 的 LTS/HWE 内核。落在其中就选 DKMS 路线不在其中或者想用最新未发版的特性就走源码编译——它对内核版本没有硬性要求。两条路线怎么选路线内核要求大概耗时主要动作适合你如果……DKMS 预编译包5.15 / 5.19 / 6.5约 5 分钟三两条 APT 命令生产环境快速部署只消费数据源码编译无限制全部 22.04 内核约 30 分钟装依赖 → 打补丁 → cmake → 编译开发调试需要示例程序和自定义配置⚠️ 两种方式不要混装。残留的 udev 规则会让设备归属冲突报multiple realsense udev rules found处理方式见后文排障手册。完整的决策路径如下DKMS 路线安装 RealSense 内核驱动与工具包1. 更新系统并补齐 HTTPS 支持官方仓库走 HTTPS 协议先升级包索引再装上负责证书校验和 HTTPS 传输的两个包sudo apt-get update sudo apt-get upgrade -y sudo apt-get install apt-transport-https ca-certificates -y成功标志两条命令跑完无报错。2. 导入仓库密钥并写入 APT 源建一个专门存放公钥的目录把仓库公钥写进去再把 APT 源指到官方 librealsense 仓库jammy 就是 22.04 的代号# 密钥存放目录 sudo mkdir -p /etc/apt/keyrings # 下载并保存仓库公钥 curl -sSf https://librealsense.intel.com/Debian/librealsense.pgp | \ sudo tee /etc/apt/keyrings/librealsense.pgp /dev/null # 写入官方 APT 源 echo deb [signed-by/etc/apt/keyrings/librealsense.pgp] https://librealsense.intel.com/Debian/apt-repo jammy main | \ sudo tee /etc/apt/sources.list.d/librealsense.list # 刷新包索引跳过这一步新装的包会找不到 sudo apt-get update成功标志update 输出中出现从 librealsense.intel.com 拉取索引的行。3. 装驱动与工具DKMS 包负责内核驱动内核更新后会自动重新编译utils 包带 realsense-viewer 和各类命令行工具dev 包装头文件和库只有要写程序集成 SDK 才需要# 内核驱动DKMS 机制 sudo apt-get install librealsense2-dkms -y # 实用工具含 RealSense Viewer sudo apt-get install librealsense2-utils -y # 开发库可选 sudo apt-get install librealsense2-dev -y4. 确认驱动模块已生效DKMS 机制会替换系统的 uvcvideo 模块用它来判断驱动是否真的接管了modinfo uvcvideo | grep version:✅ 成功标志输出的 version 行中包含 realsense 字样。查不到就跳去排障手册第 1 条。源码路线RealSense 依赖配置与编译安装1. 装编译工具与依赖库C 项目编译离不开基础工具链另外还有一批 USB、udev、OpenSSL、图形相关的库要提前就位# 基础编译工具 sudo apt-get install git cmake build-essential -y # 核心依赖USB 通信、系统事件、OpenSSL、图形界面 sudo apt-get install libssl-dev libusb-1.0-0-dev libudev-dev \ pkg-config libgtk-3-dev libglfw3-dev libgl1-mesa-dev libglu1-mesa-dev -y⚠️ libssl-dev 容易漏装缺了它 cmake 阶段会直接报openssl/opensslv.h找不到。2. 获取源码与设备权限# 获取源码 git clone https://gitcode.com/GitHub_Trending/li/librealsense cd librealsense # 写入 udev 规则普通用户免 sudo 访问相机设备 sudo ./scripts/setup_udev_rules.sh成功标志脚本输出 Setting-up permissions for RealSense devices。3. 应用内核补丁发行版自带 UVC 驱动缺少 RealSense 需要的元数据通道补丁脚本会自动匹配当前内核、编译并加载新的 uvcvideo 模块# 适用于 22.04 的 5.15 / 5.19 / 6.5 HWE 内核 sudo ./scripts/patch-realsense-ubuntu-lts-hwe.sh成功标志脚本末尾提示模块加载成功。完整日志在/var/log/librealsense-setup.log失败时用dmesg | grep uvcvideo看内核日志定位。4. cmake 配置mkdir build cd build # 默认 Debug 模式同时构建示例程序 cmake .. -DBUILD_EXAMPLEStrue -DBUILD_GRAPHICAL_EXAMPLEStrue # 要发布级库时改用 Release 编译 cmake .. -DCMAKE_BUILD_TYPERelease -DBUILD_EXAMPLEStrue5. 编译、安装与刷新链接缓存# 用满所有 CPU 核心并行编译 make -j$(nproc) # 安装到系统目录 sudo make install # 刷新动态库缓存不做这步运行程序会找不到库 sudo ldconfig6. 跑示例并确认版本# 深度采集示例 cd examples/capture ./rs-capture # 查询已安装库的版本号 pkg-config --modversion librealsense2✅ 成功标志rs-capture 弹出窗口显示深度图pkg-config 输出带版本号示例为 2.54.1。点亮验证Viewer 与四个测试工具装完先开图形查看器这是最直观的验收方式realsense-viewer左侧设备列表出现相机型号、底部输出区显示版本号点开播放键后深度流与彩色流就出来了。不想开图形界面时下面四个命令行工具足以逐项验证功能rs-enumerate-devices -S——列出设备及其支持的全部流模式不开 GUI 确认设备已被枚举rs-record -o output.bag——把数据流录制成 bag 文件之后可在查看器中加载回放rs-benchmark——性能基准测试核对数据吞吐是否达标realsense-viewer——同时支持实机与回放两种数据源。排障手册四个高频报错与对应处理1. 内核模块加载失败现象modprobe: ERROR: could not insert uvcvideo。原因是 DKMS 编译产物与当前内核对不上重装 DKMS 包让它重新构建再翻构建日志找具体报错sudo apt-get install --reinstall librealsense2-dkms ls /var/lib/dkms/librealsense2-dkms # 查看对应内核版本目录下的日志2. Viewer 识别到设备但没有图像多数是供电问题深度相机启动瞬间功耗很大。把相机换到主板后置的 USB 3.0 口蓝色口别经过 USB 集线器或机箱前置面板。3. 编译时报openssl/opensslv.h缺失缺 OpenSSL 开发头文件补装后重跑 cmake 继续即可sudo apt-get install libssl-dev4. 报multiple realsense udev rules foundDKMS 包和手动源码装并存两套 udev 规则在抢设备。最干净的做法是彻底清掉再按单一路线重装dpkg -l | grep realsense | cut -d -f3 | xargs sudo dpkg -P然后回到「DKMS 路线」或「源码路线」任选其一从头走一遍。进阶调优USB 带宽与电源管理1. 检查并上调 USB 缓冲先看当前 USB 设备的配置与带宽参数lsusb -d 8086: -v | grep wMaxPacketSize若需要更大的 USB 缓冲单位 MBroot 权限echo 1000 /sys/module/usbcore/parameters/usbfs_memory_mb2. 关闭 USB 自动挂起系统电源管理会在空闲时把相机休眠表现为数据流无故中断。加一条 udev 规则禁止 RealSense 设备Intel 厂商标识 8086自动挂起sudo tee /etc/udev/rules.d/80-realsense-power.rules EOF ACTIONadd, SUBSYSTEMusb, ATTR{idVendor}8086, ATTR{power/autosuspend}-1 EOF sudo udevadm control --reload-rules sudo udevadm trigger✅ 成功标志重新插拔相机后设备正常枚举长时间拉流不再出现中断。装完之后下一步去哪示例程序合集examples/建议先跑通 align、pointcloud、multicam 三个深度数据的后处理滤波说明doc/post-processing-filters.md录制回放、安装细节等其他主题doc/。⚠️ 最后提醒DKMS 装法在内核更新如 apt upgrade 换了内核后会自动重建驱动源码装法在内核变化后需要重跑一次patch-realsense-ubuntu-lts-hwe.sh补丁脚本。【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考