在Windows上编译和安装OpenSSL – wiki基地

在Windows上编译和安装OpenSSL的详细指南

OpenSSL是一个强大的开源密码学库，提供了广泛的安全功能，包括SSL/TLS协议实现、各种加密算法、数字证书处理等等。在Windows平台上编译和安装OpenSSL虽然略显复杂，但掌握了正确的步骤，就可以轻松完成。本文将提供一个详细的指南，帮助您在Windows环境下成功编译和安装OpenSSL。

准备工作:

1. 安装Visual Studio: OpenSSL的编译需要C/C++编译器和构建工具。推荐安装Visual Studio Community版本，它提供了完整的开发环境。在安装过程中，确保选择了“使用C++的桌面开发”工作负载，并包含MSVC v142 – VS 2019 C++ x64/x86 build tools（v14.2x）以及Windows 10 SDK (10.0.1xxxx.0)。

2. 安装Perl: OpenSSL的配置脚本使用Perl编写。ActivePerl是一个常用的Windows Perl发行版。下载并安装ActivePerl，确保将其添加到系统环境变量中。

3. 安装NASM汇编器 (可选但推荐): 使用NASM可以优化OpenSSL的性能，尤其是在x86架构上。下载NASM的Windows版本，并将其添加到系统路径中。

4. 下载OpenSSL源码: 从OpenSSL官方网站或GitHub镜像下载OpenSSL的源代码包。解压到一个合适的目录，例如C:\openssl-source。

编译OpenSSL:

1. 打开Visual Studio开发者命令提示符: 在开始菜单中搜索”x64 Native Tools Command Prompt for VS 2019″ 或类似名称的命令提示符，并以管理员身份运行。这将设置必要的编译环境变量。

2. 进入OpenSSL源码目录: 使用cd命令进入解压后的OpenSSL源码目录，例如cd C:\openssl-source。

3. 配置编译选项: 使用以下命令配置OpenSSL的编译选项。根据您的需求修改目标平台（x64或x86）和安装目录。

4. 对于x64平台:

   bash
perl Configure VC-WIN64A no-shared --prefix=C:\openssl-install

5. 对于x86平台:

   bash
perl Configure VC-WIN32 no-shared --prefix=C:\openssl-install

6. 选项说明:

   • VC-WIN64A 或 VC-WIN32: 指定编译目标平台。
   • no-shared: 编译静态库，而不是动态链接库。
   • --prefix=C:\openssl-install: 指定OpenSSL的安装目录。您可以根据需要修改此路径。

7. 执行nmake命令: 配置完成后，使用nmake命令开始编译OpenSSL。

bash
nmake

此过程可能需要一些时间，取决于您的系统配置。

1. 运行测试 (可选): 编译完成后，可以使用nmake test命令运行OpenSSL的测试套件，验证编译是否成功。

bash
nmake test

1. 安装OpenSSL: 测试通过后，使用nmake install命令将OpenSSL安装到指定的目录。

bash
nmake install

配置环境变量:

编译和安装完成后，需要配置Windows的环境变量，以便系统能够找到OpenSSL的库文件和可执行文件。

1. 打开环境变量设置: 在Windows搜索栏中搜索“环境变量”，然后选择“编辑系统环境变量”。

2. 添加OpenSSL的bin目录到PATH: 在“系统变量”部分，找到名为“Path”的变量，点击“编辑”。 点击“新建”，并将OpenSSL的bin目录添加到路径中，例如C:\openssl-install\bin。

3. (可选) 添加OpenSSL的lib目录到LIB: 创建一个新的系统变量名为LIB，并将OpenSSL的lib目录添加到其值中，例如C:\openssl-install\lib。这在使用一些依赖OpenSSL的开发工具时可能会有用。

4. (可选) 添加OpenSSL的include目录到INCLUDE: 创建一个新的系统变量名为INCLUDE，并将OpenSSL的include目录添加到其值中，例如C:\openssl-install\include。这同样在开发过程中非常有用。

验证安装:

完成以上步骤后，可以验证OpenSSL是否已成功安装。

1. 打开命令提示符: 运行cmd打开命令提示符。

2. 运行openssl version命令: 输入以下命令并按下回车键：

bash
openssl version

如果OpenSSL安装成功，将会显示OpenSSL的版本信息。

常见问题及解决方法:

• 编译错误 “nmake is not recognized as an internal or external command…”: 确保已正确安装Visual Studio，并且已从Visual Studio开发者命令提示符运行编译命令。

• 编译错误 related to perl: 确保已正确安装Perl，并且已将其添加到系统环境变量中。

• 编译错误 related to missing header files: 确保Visual Studio安装过程中已选择正确的组件，包括Windows SDK。

• 运行时错误 “The procedure entry point could not be located…”: 这通常是由于DLL文件缺失或版本不匹配导致的。确保系统环境变量PATH已正确配置，并且没有其他版本的OpenSSL库文件与当前版本冲突。

总结:

在Windows上编译和安装OpenSSL需要一定的耐心和细心。 通过遵循本文提供的详细步骤，您可以成功地在Windows环境下构建和使用OpenSSL，为您的应用程序提供强大的安全保障。 记住，在遇到问题时，仔细检查错误信息，并参考OpenSSL官方文档或在线资源寻求帮助。 希望这篇指南能够帮助您顺利完成OpenSSL的编译和安装。