openssl与ubuntu兼容性问题

发布时间:2025-06-25 20:18:21

阅读量:83

OpenSSL与Ubuntu的兼容性问题通常涉及不同版本的OpenSSL在Ubuntu系统上的安装和使用。以下是一些常见的兼容性问题及其解决方法：

Node.js与OpenSSL 3.0的兼容性问题

在使用Vue CLI构建项目时，如果本地安装的Node.js版本过高（尤其是17及以上版本），可能会导致启动或打包阶段出现报错。这是因为Node.js自17起默认启用了OpenSSL 3.0，而OpenSSL 3.0已经移除了对某些旧加密算法（如md4）的支持，从而触发了错误提示ERR_OSSL_EVP_UNSUPPORTED。

解决方法：

临时设置环境变量启用兼容模式：

在启动项目之前，临时配置NODE_OPTIONS环境变量，使Node.js继续使用旧的OpenSSL加密接口。具体命令如下：
```
export NODE_OPTIONS=--openssl-legacy-provider
```
适用于macOS或Linux，然后再执行项目的启动命令，即可正常运行Vue项目。

在package.json中统一配置兼容参数：

将上述参数统一写入package.json的scripts中，项目成员只需执行脚本命令即可自动应用兼容设置。例如：

"scripts": {
  "dev": "NODE_OPTIONS=--openssl-legacy-provider vue-cli-service serve --open",
  "build:prod": "NODE_OPTIONS=--openssl-legacy-provider vue-cli-service build --report",
  "build:stage": "NODE_OPTIONS=--openssl-legacy-provider vue-cli-service build --mode staging",
  "preview": "NODE_OPTIONS=--openssl-legacy-provider node build/index.js --preview"
}

在macOS或Linux中，则可将set替换为export。

降级Node.js至16或更低版本：

如果不希望使用兼容参数，或遇到依赖不兼容等复杂情况，也可以选择将Node.js版本降至16或以下。Node.js 16默认使用的是OpenSSL 1.1.1，仍支持md4算法，兼容旧版本Vue CLI项目。可以使用nvm（Node Version Manager）来灵活切换Node.js版本。例如：
```
nvm install 16
nvm use 16
```
切换版本后，重新安装依赖并启动项目，通常可以顺利运行。

Ubuntu系统上安装多个OpenSSL版本的兼容性问题

在Ubuntu 22.04上安装多个OpenSSL版本并正确使用特定版本进行程序编译，可以通过以下步骤实现：

安装多个OpenSSL版本：

安装系统默认的OpenSSL：

sudo apt update
sudo apt install openssl

下载并编译其他OpenSSL版本。例如，安装OpenSSL 1.1.1：

sudo apt install build-essential checkinstall zlib1g-dev -y
wget https://www.openssl.org/source/openssl-1.1.1u.tar.gz
tar -xvf openssl-1.1.1u.tar.gz
cd openssl-1.1.1u
./config --prefix=/opt/openssl/1.1.1 --openssldir=/opt/openssl/1.1.1 shared zlib
make
sudo make install

使用特定版本的OpenSSL进行编译：

通过环境变量指定OpenSSL版本：

export OPENSSL_ROOT_DIR=/opt/openssl/1.1.1
export OPENSSL_INCLUDE_DIR=$OPENSSL_ROOT_DIR/include
export OPENSSL_LIB_DIR=$OPENSSL_ROOT_DIR/lib
export LD_LIBRARY_PATH=$OPENSSL_LIB_DIR:$LD_LIBRARY_PATH
export PATH=$OPENSSL_ROOT_DIR/bin:$PATH

验证环境变量：
```
openssl version
```

编译程序：

gcc -o my_program my_program.c -lssl -lcrypto

切换默认的OpenSSL版本：

创建符号链接：

sudo ln -sf /opt/openssl/1.1.1/bin/openssl /usr/local/bin/openssl

更新动态库缓存：
```
sudo ldconfig /opt/openssl/1.1.1/lib
```
验证版本：
```
openssl version
```

在Ubuntu系统上安装和更新OpenSSL

通过APT包管理器安装OpenSSL：

sudo apt update
sudo apt install openssl libssl-dev

验证安装：
```
openssl version
```

更新OpenSSL：

使用APT包管理器更新OpenSSL：

sudo apt update
sudo apt upgrade openssl

从源码编译安装特定版本的OpenSSL（高级用户）：

wget https://www.openssl.org/source/openssl-3.0.7.tar.gz
tar -xzvf openssl-3.0.7.tar.gz
cd openssl-3.0.7
./config --prefix=/usr/local/openssl --openssldir=/usr/local/openssl shared zlib
make
sudo make install
sudo ldconfig