【保姆级打包】Ubuntu libssl1.1 缺失?用这个免费 .deb 包 3 步搞定(附完整排错表)
【保姆级打包】Ubuntu libssl1.1 缺失?用这个免费 .deb 包 3 步搞定(附完整排错表)
在 Ubuntu 上运行老程序,弹出 error while loading shared libraries: libssl.so.1.1: cannot open shared object file?多半不是程序坏了,而是系统里的 libssl1.1 库被移除了。下面用 3 步教你免费下载 libssl1.1 安装包完成修复,并附上常见报错的处理办法。
快速判断:如何确认是 libssl1.1 缺失导致的报错
先花 1 分钟确认问题出在 libssl1.1 上,再动手装包:
-
看报错信息:程序启动即退出,提示中包含
libssl.so.1.1、cannot open shared object file或cannot find shared library -
看运行环境:程序是几年前的旧构建(基于 OpenSSL 1.1),而系统已升级到 Ubuntu 22.04 及以后(官方源只提供 OpenSSL 3 的 libssl3)
-
一条诊断命令:
ldd ./你的程序 | grep "not found"输出里如果出现
libssl.so.1.1 => not found,就可以确定是缺这个库。顺便用
dpkg -s libssl1.1查一下,若返回package ... is not installed and no candidate for installation,说明官方源里也没有可用版本,正适合用下面这个现成的 .deb。
一键安装步骤:下载并安装 libssl1.1 .deb 包
资源来自本仓库打包好的 1.7z(约 1.3 MB),里面就是现成的 libssl1.1_1.1.1f-1ubuntu2_amd64.deb。
-
获取资源文件 在仓库页面下载
1.7z,或者 clone 仓库:git clone https://gitcode.com/open-source-toolkit/24b52 -
解出 .deb 安装包
7z x 1.7z没有 7z 的话,用系统自带的文件管理器右键解压即可。
-
用 dpkg 安装
sudo dpkg -i libssl1.1*.deb通配符写法能自动匹配包内实际文件名,不用纠结下划线还是连字符。
备选方案:apt 直装或其他架构怎么办
- Ubuntu 20.04 系统:官方源里仍有这个包,直接
sudo apt install libssl1.1即可,无需额外下载 - ARM 设备(如树莓派):本仓库的包仅支持 amd64 架构,
uname -m显示aarch64时请改用对应 arm64 版本的 libssl1.1 包(可从 Ubuntu 20.04 focal 仓库中获取同名包),安装命令同样是sudo dpkg -i xxx.deb - 安装时出现依赖报错:接着执行
sudo apt-get install -f让 dpkg 自动补齐依赖
原理速览:为什么装一个 .deb 就能修好
libssl1.1 是 OpenSSL 1.1 的运行时共享库,老程序启动时按名字加载 libssl.so.1.1。新版 Ubuntu 换用 OpenSSL 3 后不再提供它,老程序自然就加载不到了。这个 .deb 是 Ubuntu 官方针对 amd64 构建的 libssl1.1(1.1.1f-1ubuntu2),用 dpkg -i 装上后,系统库目录里重新有了 libssl.so.1.1,老程序便能正常找到并加载它——不用编译,也不用改程序。
验证修复与安装失败排查
验证是否修好(两步):
dpkg -s libssl1.1 | head -2 # 应显示 "Status: install ok installed"
ldd ./你的程序 | grep ssl # 不再出现 "not found"
或者直接重新运行你之前报错的程序,能正常启动即修复完成。
常见报错对照表:
| 报错信息 | 可能原因 | 处理办法 |
|---|---|---|
libssl.so.1.1 => not found |
库未安装 | 按上文 3 步安装 .deb |
dpkg: dependency problems / 包处于半安装状态 |
依赖没装全 | sudo apt-get install -f 修复依赖 |
trying to overwrite '/usr/lib/...' which is also in package ... |
与已装包的文件冲突 | sudo dpkg -i --force-overwrite libssl1.1*.deb |
no installation candidate(apt 提示) |
官方源已移除该包 | 这正是用本仓库 .deb 的原因 |
wrong architecture |
系统架构不是 amd64 | 用 dpkg --print-architecture 确认,换对应架构的包 |
注意事项
- 装前用
uname -m确认系统是 amd64(输出为x86_64),本包只覆盖该架构 - 安装会往系统库目录写入文件,重要数据建议先备份
- 该包仅用于"救活"旧程序;新项目仍建议迁移到 OpenSSL 3(libssl3)
- 更多说明可参考仓库文档:README.md
📌 到这里 libssl1.1 缺失的问题应该已经解决了。如果安装过程遇到本文没覆盖的报错,欢迎到仓库 Issues 页面反馈,也可以顺手看看 LICENSE 了解文件的授权范围。