Nginx安装SSL证书时http_ssl_module相关报错及解决方法

常见报错

解决方法

确认服务器中已安装了openssl，若当前Nginx未编译http_ssl_module，还需重新编译Nginx使其包含http_ssl_module。

示例方案

1. 检查当前版本Nginx是否包含http_ssl_module模块。

   1. 执行以下命令，查看当前Nginx的编译参数。

      nginx -V | grep http_ssl_module

   2. 如下所示，如果输出中包含--with-http_ssl_module字样，即说明已经包含http_ssl_module模块，否则表示当前Nginx安装版本中不包含该模块，您需要手动添加。

      [root@xxx ~]# nginx -V
      nginx version: nginx/1.14.1
      built with gcc 8.2.1 20180905 (Red Hat 8.2.1-3) (GCC)
      built with OpenSSL 1.1.1 FIPS  11 Sep 2018 (running with OpenSSL 1.1.1k  FIPS 25 Mar 2021)
      TLS SNI support enabled
      configure arguments: --prefix=/usr/share/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib64/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --http-client-body-temp-path=/var/lib/nginx/tmp/client_body --http-proxy-temp-path=/var/lib/nginx/tmp/proxy --http-fastcgi-temp-path=/var/lib/nginx/tmp/fastcgi --http-uwsgi-temp-path=/var/lib/nginx/tmp/uwsgi --http-scgi-temp-path=/var/lib/nginx/tmp/scgi --pid-path=/run/nginx.pid --lock-path=/run/lock/subsys/nginx --user=nginx --group=nginx --with-file-aio --with-ipv6 --with-http_ssl_module --with-http_v2_module --with-http_realip_module --with-http_addition_module --with-http_xslt_module=dynamic --with-http_image_filter_module=dynamic --with-http_sub_module --with-http_dav_module --with-http_flv_module --with-http_mp4_module --with-http_gunzip_module --with-http_gzip_static_module --with-http_random_index_module --with-http_secure_link_module --with-http_degradation_module --with-http_slice_module --with-http_stub_status_module --with-http_perl_module=dynamic --with-http_auth_request_module --with-mail=dynamic --with-mail_ssl_module --with-pcre --with-pcre-jit --with-stream=dynamic --with-stream_ssl_module --with-debug --with-cc-opt='-O2 -g -pipe -Wall -Werror=format-security -Wp,-D_FORTIFY_SOURCE=2 -Wp,-D_GLIBCXX_ASSERTIONS -fexceptions -fstack-protector-strong -grecord-gcc-switches -specs=/usr/lib/rpm/redhat/redhat-hardened-cc1 -specs=/usr/lib/rpm/redhat/redhat-annobin-cc1 -m64 -mtune=generic -fasynchronous-unwind-tables -fstack-clash-protection -fcf-protection' --with-ld-opt='-Wl,-z,relro -Wl,-z,now -specs=/usr/lib/rpm/redhat/redhat-hardened-ld -Wl,-E'

2. 安装http_ssl_module。

   # CentOS为例，openssl 1.1.1k版本，请根据Nginx选择兼容的openssl版本。
   sudo yum install openssl-devel-1.1.1k

3. 配置http_ssl_module并编译。

   # 前往Nginx安装目录(示例目录，请替换为实际的Nginx安装目录)
   cd /usr/local/nginx/
   # 配置http_ssl_module，其他参数可自定义
   ./configure --with-http_ssl_module
   # 编译
   sudo make 

   重要

   注意不能make install，否则会覆盖原有Nginx的配置。

4. 再次检查http_ssl_module模块是否成功安装。如果未成功安装，请重复步骤2-3。

   nginx -V | grep http_ssl_module

5. 重启Nginx服务。

   # 进入Nginx服务的可执行目录（示例目录，请以实际路径为准）。
   cd /usr/local/nginx/sbin
   # 重新载入配置文件。
   ./nginx -s reload