Windows环境配置OpenSSL指南 – wiki大全


Windows 环境配置 OpenSSL 指南

引言

OpenSSL 是一个功能强大的开源工具包,用于实现安全套接层 (SSL) 和传输层安全 (TLS) 协议。它提供了丰富的命令行工具,可用于生成密钥对、创建 CSR(证书签名请求)、管理数字证书以及进行加密和解密操作。在 Windows 环境下正确配置 OpenSSL,对于开发、测试和生产环境中的安全通信至关重要。

本指南将详细介绍如何在 Windows 操作系统中下载、安装并配置 OpenSSL,确保您能够顺利使用其功能。

准备工作 (Prerequisites)

在安装 OpenSSL 之前,您需要确保系统已安装必要的运行库。

  • Microsoft Visual C++ Redistributables: OpenSSL 的许多预编译版本依赖于 Microsoft Visual C++ 运行时组件。如果在安装 OpenSSL 之前没有安装这些组件,您可能会遇到缺少 DLL 文件(如 vcruntime140.dll)的错误。

    • 如何获取: 您可以从微软官方网站下载并安装对应您系统架构(32 位或 64 位)的最新版 Visual C++ Redistributable。通常,安装最新的 x64 版本(对于 64 位系统)即可。

安装步骤

1. 下载 OpenSSL 安装程序

由于 OpenSSL 官方不提供 Windows 的预编译二进制文件,我们通常会使用第三方提供的可靠版本。Shining Light Productions 是一个广受推荐的来源。

  • 访问下载页面: 打开您的网络浏览器,访问 Shining Light Productions 网站 (通常是 https://slproweb.com/products/Win32OpenSSL.html)。
  • 选择合适的版本:
    • 根据您的 Windows 操作系统是 32 位还是 64 位,选择相应的安装包。大多数现代系统都是 64 位。
    • 建议选择 Light 版本(例如 Win64OpenSSL-Light-x.x.x.exe),因为它包含了大部分常用功能,且文件大小较小。
    • 选择最新的稳定版本(通常是 3.x 系列)。

2. 安装 Visual C++ Redistributables (如果尚未安装)

如果您在下载步骤之前没有安装,请务必在运行 OpenSSL 安装程序之前完成此步骤。

  • 找到您从微软官网下载的 Visual C++ Redistributable 安装文件(例如 vc_redist.x64.exe)。
  • 双击运行安装程序,按照提示完成安装。

3. 运行 OpenSSL 安装程序

  • 找到您下载的 OpenSSL .exe 安装文件(例如 Win64OpenSSL-Light-x.x.x.exe)。
  • 双击运行安装程序。如果出现用户账户控制 (UAC) 提示,请点击“是”。
  • 接受许可协议,然后点击“Next”。
  • 选择安装路径:
    • 推荐将 OpenSSL 安装在非系统盘或非 Program Files 默认路径下,以避免潜在的权限问题或路径过长问题。
    • 例如,您可以将其安装到 C:\OpenSSL-Win64 (对于 64 位系统) 或 C:\OpenSSL-Win32 (对于 32 位系统)。
    • 点击“Next”。
  • 选择组件: 通常保持默认选择即可。
  • 创建环境变量快捷方式: 在安装过程中,您可能会看到一个选项,询问是否将 OpenSSL 的可执行文件目录添加到系统 PATH 环境变量中。
    • 建议选择:“The OpenSSL binaries\DLLs to the Windows system directory.” 或者 “The OpenSSL binaries\DLLs to the \bin directory.” 这将自动配置一部分环境变量,简化后续步骤。如果没有此选项或您希望手动配置,则无需选择,我们将在下一步中手动完成。
  • 按照提示完成安装,点击“Finish”。

4. 配置环境变量

正确配置环境变量是确保您能在任何命令行位置执行 openssl 命令的关键。

  1. 打开系统属性:
    • 右键点击“此电脑”(或“我的电脑”),选择“属性”。
    • 点击“高级系统设置”。
  2. 打开环境变量窗口:
    • 在“系统属性”窗口中,点击“环境变量…”按钮。
  3. 配置 Path 变量:
    • 在“系统变量”部分,找到并选中 Path 变量,然后点击“编辑”。
    • 点击“新建”,然后输入您的 OpenSSL 安装目录下的 bin 文件夹路径。
      • 示例: 如果您将 OpenSSL 安装在 C:\OpenSSL-Win64,则路径为 C:\OpenSSL-Win64\bin
    • 点击“确定”保存更改。
  4. 配置 OPENSSL_CONF 变量:
    • 在“系统变量”部分,点击“新建”。
    • 变量名 (Variable name): 输入 OPENSSL_CONF
    • 变量值 (Variable value): 输入您的 OpenSSL 安装目录下的 openssl.cfg 文件路径。这个文件通常位于 bin 文件夹中。
      • 示例: 如果您将 OpenSSL 安装在 C:\OpenSSL-Win64,则路径为 C:\OpenSSL-Win64\bin\openssl.cfg
    • 点击“确定”保存更改。
  5. 关闭所有窗口: 连续点击“确定”关闭“环境变量”、“系统属性”等窗口,以确保更改生效。

5. 验证安装

完成以上步骤后,您需要验证 OpenSSL 是否已成功安装并配置。

  1. 打开新的命令行窗口:
    • 重要: 请务必打开一个新的命令提示符 (CMD) 或 PowerShell 窗口。在配置环境变量之前打开的窗口无法识别新的变量。
    • 您可以通过在搜索栏输入 cmdpowershell 来打开。
  2. 执行验证命令:
    • 在新打开的命令行窗口中,输入以下命令并按回车:
      bash
      openssl version
  3. 检查输出:
    • 如果安装成功,您应该会看到类似以下的输出,显示 OpenSSL 的版本号和构建信息:
      OpenSSL x.x.x Month Day Year [architecture]
    • 如果出现错误信息,例如 'openssl' 不是内部或外部命令,也不是可运行的程序或批处理文件。,这意味着环境变量配置不正确。请仔细检查步骤 4。

结论

恭喜!现在您已在 Windows 环境中成功配置了 OpenSSL。您可以使用 openssl 命令行工具来执行各种加密任务,例如:

  • 生成 RSA 或 ECC 密钥对
  • 创建 CSR (Certificate Signing Request)
  • 自签名证书
  • 将证书格式从 PEM 转换为 PFX (PKCS#12)
  • 加密和解密文件

通过本指南,您应该能够顺利地在 Windows 系统上利用 OpenSSL 提供的强大功能。


滚动至顶部