Intel RealSense SDK Ubuntu 22.04 安装:5 分钟 DKMS 部署 源码编译完整避坑实战【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsenseIntel RealSense SDK(librealsense)是 RealSense 深度相机在 Linux 上的官方驱动与采集 SDK,本文带你完成 Ubuntu 22.04 上的 DKMS 预编译包安装与源码编译两条部署路径。RealSense SDK Ubuntu 安装选型:DKMS 预编译包还是源码编译RealSense 相机依赖打过补丁的 uvcvideo 内核驱动,所以能不能装起来首先取决于内核版本。内核在官方维护的 5.15 / 5.19 / 6.5 序列内,直接用 DKMS(内核更新后自动重编驱动的机制)预编译包,apt 会在内核升级时替你重编驱动;内核不在这个列表里(比如 22.04.3 的 6.2),或者你需要改编译选项、跟最新代码,就走源码编译,它覆盖 Ubuntu 22.04 的所有内核。当前内核(uname -r输出)推荐路径耗时与适用5.15(22.04.1)/ 5.19(22.04.2)/ 6.5(22.04.4)DKMS 预编译包约 5 分钟,快速部署 / 生产环境6.2(22.04.3)或其他内核、需自定义编译选项源码编译约 30 分钟,开发调试 / 自定义功能先确认自己落在哪一行:uname -r # 输出示例:5.15.0-78-genericRealSense SDK Ubuntu 22.04 安装:DKMS 预编译包路径这条路径三步走完:准备系统、加官方源、装包。更新系统并安装 APT HTTPS 支持# 系统更新到最新状态 sudo apt-get update sudo apt-get upgrade -y # HTTPS 传输与证书支持,后面拉取官方 apt 源要用 sudo apt-get install apt-transport-https ca-certificates -y添加 Librealsense APT 源# 创建密钥存储目录 sudo mkdir -p /etc/apt/keyrings # 导入官方仓库公钥 curl -sSf https://librealsense.intel.com/Debian/librealsense.pgp | \ sudo tee /etc/apt/keyrings/librealsense.pgp /dev/null # 添加官方仓库(jammy 即 Ubuntu 22.04 代号,signed-by 指向刚导入的密钥) 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⚠️ 这步或后续步骤报Multiple realsense udev rules were found!,说明源码编译版与 DKMS 包混装冲突。彻底卸载旧版再重装:dpkg -l | grep realsense | cut -d -f3 | xargs sudo dpkg -P安装 librealsense2-dkms 内核驱动与工具# DKMS 内核驱动:内核升级后 apt 自动重编 uvcvideo 驱动 sudo apt-get install librealsense2-dkms -y # 工具包,含 realsense-viewer、rs-record 等命令 sudo apt-get install librealsense2-utils -y # (可选)需要 C / Python 开发调用 SDK 时再装 sudo apt-get install librealsense2-dev -y⚠️ 安装后出现modprobe: ERROR: could not insert uvcvideo,是装入的驱动与当前内核不匹配。先sudo apt-get install --reinstall librealsense2-dkms强制重编,仍失败则查/var/lib/dkms/librealsense2-dkms下的编译日志,确认内核版本是否在支持列表内。这步跑完,DKMS 路径的安装就结束了,驱动状态放到最后的验证部分统一检查。如果你的内核版本不在 DKMS 支持列表,或需要自定义编译选项,走下面的源码编译路径。源码编译路径:依赖安装、uvcvideo 内核补丁与 cmake 构建这条路只写与 DKMS 路径有差异的步骤,最后的系统安装同上。安装源码编译依赖# 基础构建工具 sudo apt-get install git cmake build-essential -y # 核心依赖库:libusb 是 USB 访问层,libudev 提供设备热插拔事件,glfw / mesa 供图形化示例使用 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⚠️ 编译日志出现openssl/opensslv.h: No such file or directory,是缺 OpenSSL 开发头文件。补装sudo apt-get install libssl-dev后重新配置即可。获取 librealsense 源码并设置相机 USB 权限# 克隆源码 git clone https://gitcode.com/GitHub_Trending/li/librealsense cd librealsense # 把相机 USB 访问权限规则写入系统(--uninstall 可移除) sudo ./scripts/setup_udev_rules.sh应用 uvcvideo 内核模块补丁# 自动匹配 5.15 / 5.19 / 6.5 HWE 内核,打 RealSense 补丁并加载新的 uvcvideo 模块 sudo ./scripts/patch-realsense-ubuntu-lts-hwe.sh脚本会下载与当前内核版本匹配的内核源码,对 uvcvideo 应用 RealSense 专属补丁,编译驱动后用新模块替换原模块,失败时自动还原原模块。运行前先把相机拔掉。执行日志在/var/log/librealsense-setup.log,失败时用dmesg | grep uvcvideo查看内核消息。cmake 编译参数与 Debug/Release 切换mkdir build cd build # 默认 Debug 模式(带调试信息,运行性能略低) # -DBUILD_EXAMPLES 构建示例程序,-DBUILD_GRAPHICAL_EXAMPLES 构建图形化示例 cmake .. -DBUILD_EXAMPLEStrue -DBUILD_GRAPHICAL_EXAMPLEStrue # 无图形界面的机器可加 -DBUILD_GRAPHICAL_EXAMPLESfalse 只构建文本示例 # 想要优化后的构建,换成 Release(替换上面一行): # cmake .. -DCMAKE_BUILD_TYPERelease -DBUILD_EXAMPLEStrue接着编译并安装:# -j 多线程编译,nproc 是当前 CPU 核心数 make -j$(nproc) # 安装到系统目录并更新动态链接库缓存(同上) sudo make install sudo ldconfig验证 RealSense 驱动加载与深度流数据按顺序做三个最小检查:modinfo uvcvideo | grep version:输出中包含 realsense 字符串,说明打过补丁的驱动已加载;启动realsense-viewer,设备列表里识别出相机并显示深度流:✅ Viewer 在设备列表识别出相机且深度流显示正常,即安装完成。⚠️ Viewer 识别出设备却无图像,先考虑 USB 端口供电不足:换 USB 3.0 端口(蓝色接口),避免经过 USB 集线器。深度流稳定后,跑rs-capture直接验证深度采集,pkg-config --modversion librealsense2会输出版本号(如2.54.1)。命令行侧还有几个常用工具:rs-enumerate-devices -S列出设备与支持模式,rs-record -o output.bag把数据流录制到文件,rs-benchmark做性能基准测试。DKMS 预编译包适合生产环境的快速部署,内核升级时驱动由 apt 自动重编;源码编译适合开发调试与支持列表之外的内核,代价是内核升级后要自己重编。RealSense SDK Ubuntu 安装到这一步即可交付日常使用。进阶调优:查相机当前 USB 带宽配置用lsusb -d 8086: -v | grep wMaxPacketSize,调高 USB 缓冲上限用echo 1000 /sys/module/usbcore/parameters/usbfs_memory_mb(需 root)。禁用相机 USB 自动挂起:向/etc/udev/rules.d/80-realsense-power.rules写入ACTIONadd, SUBSYSTEMusb, ATTR{idVendor}8086, ATTR{power/autosuspend}-1,然后sudo udevadm control --reload-rules sudo udevadm trigger。完整的安装与排错流程见官方 Linux 安装文档;align、pointcloud 等示例程序在 examples/,深度数据调优参数参考 后处理滤波器文档。【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Intel RealSense SDK Ubuntu 22.04 安装:5 分钟 DKMS 部署 + 源码编译完整避坑实战
Intel RealSense SDK Ubuntu 22.04 安装:5 分钟 DKMS 部署 源码编译完整避坑实战【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsenseIntel RealSense SDK(librealsense)是 RealSense 深度相机在 Linux 上的官方驱动与采集 SDK,本文带你完成 Ubuntu 22.04 上的 DKMS 预编译包安装与源码编译两条部署路径。RealSense SDK Ubuntu 安装选型:DKMS 预编译包还是源码编译RealSense 相机依赖打过补丁的 uvcvideo 内核驱动,所以能不能装起来首先取决于内核版本。内核在官方维护的 5.15 / 5.19 / 6.5 序列内,直接用 DKMS(内核更新后自动重编驱动的机制)预编译包,apt 会在内核升级时替你重编驱动;内核不在这个列表里(比如 22.04.3 的 6.2),或者你需要改编译选项、跟最新代码,就走源码编译,它覆盖 Ubuntu 22.04 的所有内核。当前内核(uname -r输出)推荐路径耗时与适用5.15(22.04.1)/ 5.19(22.04.2)/ 6.5(22.04.4)DKMS 预编译包约 5 分钟,快速部署 / 生产环境6.2(22.04.3)或其他内核、需自定义编译选项源码编译约 30 分钟,开发调试 / 自定义功能先确认自己落在哪一行:uname -r # 输出示例:5.15.0-78-genericRealSense SDK Ubuntu 22.04 安装:DKMS 预编译包路径这条路径三步走完:准备系统、加官方源、装包。更新系统并安装 APT HTTPS 支持# 系统更新到最新状态 sudo apt-get update sudo apt-get upgrade -y # HTTPS 传输与证书支持,后面拉取官方 apt 源要用 sudo apt-get install apt-transport-https ca-certificates -y添加 Librealsense APT 源# 创建密钥存储目录 sudo mkdir -p /etc/apt/keyrings # 导入官方仓库公钥 curl -sSf https://librealsense.intel.com/Debian/librealsense.pgp | \ sudo tee /etc/apt/keyrings/librealsense.pgp /dev/null # 添加官方仓库(jammy 即 Ubuntu 22.04 代号,signed-by 指向刚导入的密钥) 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⚠️ 这步或后续步骤报Multiple realsense udev rules were found!,说明源码编译版与 DKMS 包混装冲突。彻底卸载旧版再重装:dpkg -l | grep realsense | cut -d -f3 | xargs sudo dpkg -P安装 librealsense2-dkms 内核驱动与工具# DKMS 内核驱动:内核升级后 apt 自动重编 uvcvideo 驱动 sudo apt-get install librealsense2-dkms -y # 工具包,含 realsense-viewer、rs-record 等命令 sudo apt-get install librealsense2-utils -y # (可选)需要 C / Python 开发调用 SDK 时再装 sudo apt-get install librealsense2-dev -y⚠️ 安装后出现modprobe: ERROR: could not insert uvcvideo,是装入的驱动与当前内核不匹配。先sudo apt-get install --reinstall librealsense2-dkms强制重编,仍失败则查/var/lib/dkms/librealsense2-dkms下的编译日志,确认内核版本是否在支持列表内。这步跑完,DKMS 路径的安装就结束了,驱动状态放到最后的验证部分统一检查。如果你的内核版本不在 DKMS 支持列表,或需要自定义编译选项,走下面的源码编译路径。源码编译路径:依赖安装、uvcvideo 内核补丁与 cmake 构建这条路只写与 DKMS 路径有差异的步骤,最后的系统安装同上。安装源码编译依赖# 基础构建工具 sudo apt-get install git cmake build-essential -y # 核心依赖库:libusb 是 USB 访问层,libudev 提供设备热插拔事件,glfw / mesa 供图形化示例使用 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⚠️ 编译日志出现openssl/opensslv.h: No such file or directory,是缺 OpenSSL 开发头文件。补装sudo apt-get install libssl-dev后重新配置即可。获取 librealsense 源码并设置相机 USB 权限# 克隆源码 git clone https://gitcode.com/GitHub_Trending/li/librealsense cd librealsense # 把相机 USB 访问权限规则写入系统(--uninstall 可移除) sudo ./scripts/setup_udev_rules.sh应用 uvcvideo 内核模块补丁# 自动匹配 5.15 / 5.19 / 6.5 HWE 内核,打 RealSense 补丁并加载新的 uvcvideo 模块 sudo ./scripts/patch-realsense-ubuntu-lts-hwe.sh脚本会下载与当前内核版本匹配的内核源码,对 uvcvideo 应用 RealSense 专属补丁,编译驱动后用新模块替换原模块,失败时自动还原原模块。运行前先把相机拔掉。执行日志在/var/log/librealsense-setup.log,失败时用dmesg | grep uvcvideo查看内核消息。cmake 编译参数与 Debug/Release 切换mkdir build cd build # 默认 Debug 模式(带调试信息,运行性能略低) # -DBUILD_EXAMPLES 构建示例程序,-DBUILD_GRAPHICAL_EXAMPLES 构建图形化示例 cmake .. -DBUILD_EXAMPLEStrue -DBUILD_GRAPHICAL_EXAMPLEStrue # 无图形界面的机器可加 -DBUILD_GRAPHICAL_EXAMPLESfalse 只构建文本示例 # 想要优化后的构建,换成 Release(替换上面一行): # cmake .. -DCMAKE_BUILD_TYPERelease -DBUILD_EXAMPLEStrue接着编译并安装:# -j 多线程编译,nproc 是当前 CPU 核心数 make -j$(nproc) # 安装到系统目录并更新动态链接库缓存(同上) sudo make install sudo ldconfig验证 RealSense 驱动加载与深度流数据按顺序做三个最小检查:modinfo uvcvideo | grep version:输出中包含 realsense 字符串,说明打过补丁的驱动已加载;启动realsense-viewer,设备列表里识别出相机并显示深度流:✅ Viewer 在设备列表识别出相机且深度流显示正常,即安装完成。⚠️ Viewer 识别出设备却无图像,先考虑 USB 端口供电不足:换 USB 3.0 端口(蓝色接口),避免经过 USB 集线器。深度流稳定后,跑rs-capture直接验证深度采集,pkg-config --modversion librealsense2会输出版本号(如2.54.1)。命令行侧还有几个常用工具:rs-enumerate-devices -S列出设备与支持模式,rs-record -o output.bag把数据流录制到文件,rs-benchmark做性能基准测试。DKMS 预编译包适合生产环境的快速部署,内核升级时驱动由 apt 自动重编;源码编译适合开发调试与支持列表之外的内核,代价是内核升级后要自己重编。RealSense SDK Ubuntu 安装到这一步即可交付日常使用。进阶调优:查相机当前 USB 带宽配置用lsusb -d 8086: -v | grep wMaxPacketSize,调高 USB 缓冲上限用echo 1000 /sys/module/usbcore/parameters/usbfs_memory_mb(需 root)。禁用相机 USB 自动挂起:向/etc/udev/rules.d/80-realsense-power.rules写入ACTIONadd, SUBSYSTEMusb, ATTR{idVendor}8086, ATTR{power/autosuspend}-1,然后sudo udevadm control --reload-rules sudo udevadm trigger。完整的安装与排错流程见官方 Linux 安装文档;align、pointcloud 等示例程序在 examples/,深度数据调优参数参考 后处理滤波器文档。【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考