obs-backgroundremoval项目CUDA依赖问题的分析与解决方案

obs-backgroundremoval是OBS Studio的一个插件，主要用于在肖像图像和视频中替换背景以及增强低光场景。在将该项目打包为Fedora RPM时，发现了一个关于CUDA依赖的重要技术问题。

问题根源分析

项目默认构建会捆绑onnxruntime库，这些库在默认构建配置下强制包含了CUDA运行时路径(rpath)。具体表现为：

1. libonnxruntime.so.1.17.1文件中包含无效的CUDA路径/usr/local/cuda-11.8/lib64
2. libonnxruntime_providers_cuda.so文件同样包含CUDA相关路径

这种硬编码的运行时路径会导致在没有安装CUDA的系统上出现兼容性问题，同时也违反了Linux发行版的打包规范。

解决方案详解

经过深入分析，我们找到了完整的解决方案：

1. 使用系统onnxruntime

首先需要修改CMake配置，使其能够正确检测并使用系统安装的onnxruntime，而不是捆绑的版本。这需要：

• 在CMakeLists.txt中添加系统onnxruntime的检测逻辑
• 设置USE_SYSTEM_ONNXRUNTIME=ON选项

2. 禁用GPU加速功能

由于系统onnxruntime默认会尝试使用TensorRT执行提供程序(OrtSessionOptionsAppendExecutionProvider_Tensorrt)，这仍然依赖CUDA，因此需要：

• 设置DISABLE_ONNXRUNTIME_GPU=ON选项
• 这样会强制使用CPU模式运行，避免任何GPU加速依赖

3. 完整的构建配置

最终的构建配置应包含以下关键选项：

-DCMAKE_BUILD_TYPE=Release
-DENABLE_FRONTEND_API=ON
-DENABLE_QT=OFF
-DUSE_SYSTEM_ONNXRUNTIME=ON
-DDISABLE_ONNXRUNTIME_GPU=ON
-DUSE_SYSTEM_OPENCV=ON

依赖管理建议

在打包为RPM时，需要正确处理依赖关系：

构建依赖(BuildRequires):

• onnxruntime-devel
• opencv-devel
• cmake(libobs)

运行时依赖(Requires):

• onnxruntime
• opencv-core

技术影响评估

这种解决方案虽然避免了CUDA依赖，但需要注意：

1. 性能影响：禁用GPU加速后，所有计算将在CPU上执行，处理速度可能会降低
2. 功能完整性：核心背景移除功能仍然完整，只是失去了硬件加速优势
3. 兼容性提升：方案可以在没有NVIDIA GPU的系统上正常运行

最佳实践建议

对于希望保持GPU加速的用户，建议：

1. 提供两个构建版本：带CUDA支持和不带CUDA支持的
2. 在安装时检测系统环境，自动选择最合适的版本
3. 明确文档说明不同版本的功能和性能差异

这个解决方案为在Linux发行版中打包obs-backgroundremoval插件提供了可靠的技术路径，特别是对于那些希望避免专有驱动依赖的用户群体。