1 OpenSSL是什么及怎么用
参考: openssl中文手册
2 下载源文件
Github: https://github.com/openssl/openssl
官网: https://www.openssl.org/source/
3 安装
先查看README.md文档,根据描述找到自己对应平台的NOTES-*.md文档和INSTALL.md文档
3.1 环境配置
从INSTALL.md和NOTES-WINDOWS.md中得知需要做如下准备
- make工具
官方用的是nmake,其他的或许也可以
VS2022中自带
在开发平台中打开命令行输入nmake /?
执行,如果有输出,说明已经安装
- perl
需要另外安装
- ANSI C编译器
VS2022中已安装
- 支持开发库和C头文件的开发环境
VS2022支持
- 支持的操作系统
Windows10支持
- NASM
需要另外安装
perl安装(参考文档NOTES-PERL.md)
- 下载
官方针对VC-*环境推荐Strawberry Perl
地址:http://strawberryperl.com
要求版本在5.10.0以上,直接下最新版
- 安装
安装完成后,打开命令行输入perl --version,有版本信息输出代表安装成功
- 模块安装
按照文档描述,需要安装Text::Template和Test::More两个模块
注:需要以管理员身份执行命令
cpan -i Text::Template
cpan -i Test::More
NASM安装
- 下载
地址:https://www.nasm.us,下载最新稳定版- 安装
可以直接下载可执行文件压缩包,解压后需要自己添加环境变量
或者下载installer安装包快捷安装,自动添加环境变量- 测试
- 安装完成后,在命令行输入
nasm --version
执行,有版本信息输出则说明安装成功
3.2 生成makefile
用管理员模式打开VS2022,打开下载的OpenSSL根目录,打开开发者命令提示窗口
执行命令perl Configure
,程序会自动判断当前系统和处理器架构
也可自己指定
perl Configure VC-WIN32
perl Configure VC-WIN64A
perl Configure VC-WIN64-ARM
3.3 生成OpenSSL
配置环境变量
在执行命令之前,需要配置临时环境变量
- 根据自己的系统环境情况,找到VS安装目录下的vcvars32.bat或vcvars64.bat文件(可能在Tools下面,也可能在别的地方,最好下个Everything搜一下)
- 复制这个文件的完整路径(包括文件名),在VS2022打开的命令窗口中输入执行(需要用双引号括起来)
E:\Downloads\openssl-3.0.11\openssl-3.0.11>"D:\Program Files\Microsoft Visual Studio\2022\Community\VC\Auxiliary\Build\vcvars64.bat"
**********************************************************************
** Visual Studio 2022 Developer Command Prompt v17.7.4
** Copyright (c) 2022 Microsoft Corporation
**********************************************************************
[vcvarsall.bat] Environment initialized for: 'x64'
生成
执行命令nmake
生成结果测试
执行命令:nmake test
如果没问题,最后一行会显示result: pass,好像是这样,过程中会有许多ok和少量skipped
安装
执行命令:nmake install
这一步需要以管理员权限执行,如果一开始就是以管理员权限打开VS2022的,可以直接执行,否则需要关闭后再重新以管理员权限打开VS2022
判断是否安装成功
- 在目录C:\Program Files\OpenSSL下有四个文件夹
- 命令行执行
openssl
,出现类似执行python的效果
PS C:\WINDOWS\system32> openssl
OpenSSL>
以上两点应该能大致判断安装成功了,具体是不是缺少哪些文件需要用了才知道,可以看看OpenSSL的中文手册
4 遇到的问题
- fatal error C1041: 无法打开程序数据库“xxxxxx.pdb”;如果要将多个 CL.EXE 写入同一个 .PDB 文件,请使用/FS
出现这个错误可能是因为并行编译的问题,即同时有很多个文件在编译,它们都需要往这个pdb文件中写入东西,从而发生冲突- 解决:
- 方法1:不让它并行编译
在VS中打开工具-选项,设置最大并行项目生成数为1
- 方法2:强制写入文件
通过nmake的输出知道编译用的是cl命令,打开makefile,查找发生冲突的pdb文件名,发现修改这个pdb文件的宏指令,其中/Fd参数是cl命令用于给文件命名的,具体各种参数参考cl命令的帮助文档
按照出错时的提示,在命令中间添加/FS参数,保存
估计其他pdb文件也可能出现这种问题,所以通过查找/Fd参数,找到每一个生成pdb文件的指令,在里面添加/FS参数,保存
- 方法1:不让它并行编译
- 两种方法可以分别尝试一下,我是两个一起搞的,所以不知道是哪个方法在起作用
- 解决了这个问题后,后面列出的问题也都迎刃而解了
- 解决:
- fatal error C1090: PDB API 调用失败,错误代码“3”
可能的原因:- 权限的问题
解决:以管理员模式运行 - 文件被占用
解决:按照C1041错误的方法执行一遍,不行再另外想办法
- 权限的问题
- 下面的问题错误都是由于前面的问题导致命令执行失败引起的,所以前面的问题解决之后,后面的U1077错误就跟着解决了
- fatal error U1077: “cmd”: 返回代码“0x2”
- fatal error U1077: “cl”: 返回代码“0x2”
后续
- 2023.10.8
遇到新的问题:用安装的openssl生成证书,执行命令
openssl genrsa -out privkey.pem 2048
openssl req -new -key privkey.pem -out cert.csr
openssl req -new -x509 -key privkey.pem -out cacert.pem -days 3650
第一条命令执行没有问题,会在本地用户目录下生成一个privkey.pem文件,但是后面两条命令执行失败,
C:\Users\Jiang>openssl req -new -x509 -key privkey.pem -out cacert.pem -days 3650
Can't open Z:/extlib/_openssl111__/ssl/openssl.cnf for reading, No such file or directory
24696:error:02001003:system library:fopen:No such process:crypto/bio/bss_file.c:69:fopen('Z:/extlib/_openssl111__/ssl/openssl.cnf','r')
24696:error:2006D080:BIO routines:BIO_new_file:no such file:crypto/bio/bss_file.c:76:
提示无法打开文件,而且文件路径是我电脑上绝对没有的,说明之前的强制写入可能存在问题,具体是什么原因实在不明白
解决办法:(PS:这个问题其实昨晚刚发完这篇文章就遇到了,但是太晚了也太累了,不想整了)
今天偶然间发现其实不用自己去单独安装openssl,为什么呢?
因为Git里面已经集成了包括perl、ssh、openssl等等在内的很多工具
至于我怎么发现的,我在Git Bash里面使用ssh生成密钥时,遇到一些不懂的,想通过/?和–help参数看能不能查看ssh的帮助文档,发现行不通,然后我就尝试用平常查看版本信息的参数-V测试有没有版本信息输出
Jiang@Crazy MINGW64 ~/.ssh
$ ssh -help
ssh: unknown option -- h
usage: ssh [-46AaCfGgKkMNnqsTtVvXxYy] [-B bind_interface] [-b bind_address][-c cipher_spec] [-D [bind_address:]port] [-E log_file][-e escape_char] [-F configfile] [-I pkcs11] [-i identity_file][-J destination] [-L address] [-l login_name] [-m mac_spec][-O ctl_cmd] [-o option] [-P tag] [-p port] [-Q query_option][-R address] [-S ctl_path] [-W host:port] [-w local_tun[:remote_tun]]destination [command [argument ...]]Jiang@Crazy MINGW64 ~/.ssh
$ ssh /?
ssh: Could not resolve hostname /?: Name or service not knownJiang@Crazy MINGW64 ~/.ssh
$ ssh -V
OpenSSH_9.4p1, OpenSSL 3.1.2 1 Aug 2023
问题来了,居然同时输出了OpenSSH和OpenSSL的版本信息,但是openssl的版本号和前面安装的不一样,于是就在git bash 里面执行了前面生成SSL证书的三条命令,都执行成功了,简直了
为什么直接在cmd里面执行会失败呢? 因为我在安装Git for Windows时,怕把系统环境变量搞得太乱,设置了Git命令只能在git bash上执行,Git中集成的工具当然也只能在git bash上执行了,这就导致无法在除了git bash之外的其他命令行窗口中运行这些命令