Sunshine项目在Ubuntu 24.10上的libminiupnpc兼容性问题解决方案
问题背景
Sunshine是一款优秀的开源游戏串流软件,近期有用户在Ubuntu 24.10系统上安装时遇到了共享库依赖问题。具体表现为运行时提示"libminiupnpc.so.17: cannot open shared object file"错误。这个问题源于Ubuntu 24.10系统更新了libminiupnpc库的版本,导致与Sunshine预编译包不兼容。
技术分析
libminiupnpc是一个轻量级的UPnP客户端库,用于实现端口映射等功能。在Ubuntu 24.04中,该库的版本为2.2.6-1build2,提供了libminiupnpc.so.17文件。而Ubuntu 24.10将其升级到了2.2.8-2版本,对应的库文件变更为libminiupnpc.so.18。
Sunshine的预编译包是针对Ubuntu 24.04构建的,因此硬编码依赖了libminiupnpc.so.17。当用户在24.10系统上安装时,虽然系统安装了更新的libminiupnpc库,但由于版本号不匹配,导致运行时找不到所需的共享库。
解决方案
方法一:创建符号链接(临时解决方案)
对于不需要使用UPnP功能的用户,可以创建一个符号链接来临时解决此问题:
- 打开终端,执行以下命令:
cd /usr/lib/x86_64-linux-gnu
sudo ln -s libminiupnpc.so.18 libminiupnpc.so.17
- 验证链接是否创建成功:
ls -lh /usr/lib/x86_64-linux-gnu | grep libminiupnpc
这个方法的优点是简单快捷,不需要额外安装或编译任何组件。但需要注意的是,这只是一个临时解决方案,可能会在未来的系统更新中被覆盖。
方法二:从源代码编译(推荐方案)
对于需要长期稳定使用或需要使用UPnP功能的用户,建议从源代码编译Sunshine:
- 安装必要的编译工具和依赖:
sudo apt install build-essential cmake git
- 克隆Sunshine源代码:
git clone https://github.com/LizardByte/Sunshine.git
cd Sunshine
- 配置编译选项(如需禁用CUDA支持):
mkdir build && cd build
cmake .. -DSUNSHINE_ENABLE_CUDA=OFF
- 编译并安装:
make -j$(nproc)
sudo make install
从源代码编译的优点是能够完全适配当前系统的库版本,避免兼容性问题。同时,用户可以根据自己的硬件配置和需求定制编译选项。
注意事项
-
对于NVIDIA显卡用户,如果遇到CUDA相关编译错误,可以尝试禁用CUDA支持或确保正确安装了CUDA工具包。
-
符号链接方法虽然简单,但不建议在生产环境中长期使用,因为它可能会影响其他依赖libminiupnpc的应用程序。
-
系统更新后,可能需要重新创建符号链接或重新编译Sunshine。
-
如果遇到其他依赖问题,可以使用
ldd
命令检查Sunshine的依赖关系:
ldd $(which sunshine)
总结
Ubuntu 24.10用户在使用Sunshine时遇到的libminiupnpc.so.17缺失问题,本质上是系统库版本更新导致的兼容性问题。用户可以根据自身需求选择临时符号链接方案或更稳定的源代码编译方案。随着Sunshine项目的持续更新,未来可能会提供针对Ubuntu 24.10的官方预编译包,彻底解决这一兼容性问题。
- DDeepSeek-R1-0528DeepSeek-R1-0528 是 DeepSeek R1 系列的小版本升级,通过增加计算资源和后训练算法优化,显著提升推理深度与推理能力,整体性能接近行业领先模型(如 O3、Gemini 2.5 Pro)Python00
cherry-studio
🍒 Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端TSX030deepflow
DeepFlow 是云杉网络 (opens new window)开发的一款可观测性产品,旨在为复杂的云基础设施及云原生应用提供深度可观测性。DeepFlow 基于 eBPF 实现了应用性能指标、分布式追踪、持续性能剖析等观测信号的零侵扰(Zero Code)采集,并结合智能标签(SmartEncoding)技术实现了所有观测信号的全栈(Full Stack)关联和高效存取。使用 DeepFlow,可以让云原生应用自动具有深度可观测性,从而消除开发者不断插桩的沉重负担,并为 DevOps/SRE 团队提供从代码到基础设施的监控及诊断能力。Go00
热门内容推荐
最新内容推荐
项目优选









