在Nginx服务器上安装国密标准SSL证书
本文以CentOS 7操作系统中的Nginx 1.24.0服务器为例介绍国密标准(SM2)SSL证书的安装步骤,您在安装国密标准证书时可以进行参考。证书安装好后,您的Web服务器才能支持SSL通信,实现通信安全。

由于服务器系统版本或服务器环境配置不同,在安装SSL证书过程中使用的命令或修改的配置文件信息可能会略有不同,云证书管理服务提供的安装证书示例,仅供参考,请以您的实际情况为准。
如参考文档安装证书后,HTTPS仍然不生效或遇到其他问题,请单击一对一咨询购买SSL证书配置优化服务,联系专业工程师为您排查具体问题。
前提条件
- 证书已签发且“证书状态”为“已签发”。
- 已下载SSL证书,具体操作请参见下载SSL证书。
约束条件
- 证书安装前,务必在安装SSL证书的服务器上开启“443”端口,同时在安全组增加“443”端口,避免安装后仍然无法启用HTTPS。
- 如果一个域名有多个服务器,则每一个服务器上都要部署。
- 待安装证书的服务器上需要运行的域名,必须与证书的域名一一对应,即购买的是哪个域名的证书,则用于哪个域名。否则安装部署后,浏览器将提示不安全。
- 待安装证书为国密标准证书。
操作步骤
在CentOS 7操作系统中的Nginx 1.24.0服务器上安装SSL证书的流程如下所示:
步骤一:环境配置
- 准备gmssl_openssl。
访问GMSSL页面,在左侧导航树中选择“国密Web服务器”,单击“国密Web服务器下载”页签,下载openssl国密版,拷贝到/root/目录并解压。
tar xzfm gmssl_openssl_b2025.xxxx_x64.tar.gz -C /usr/local
以上命令中gmssl_openssl_b2025.xxxx_x64.tar.gz请替换为实际下载的包名。
则/usr/local/gmssl为国密版openssl目录。
- 准备Nginx。
- 执行如下命令配置参数。
如果报错“C compiler cc is not found”,则需要安装pcre-devel包,安装命令:yum -y install gcc pcre-devel openssl openssl-devel。
./configure \ --without-http_gzip_module \ --with-http_ssl_module \ --with-http_stub_status_module \ --with-http_v2_module \ --with-file-aio \ --with-openssl="/usr/local/gmssl" \ --with-cc-opt="-I/usr/local/gmssl/include" \ --with-ld-opt="-lm"
- 编译安装。
make install
则/usr/local/nginx为生成的国密版Nginx目录。
步骤二:获取文件
安装证书前,需要获取证书文件和密码文件,请根据申请证书时选择的“证书请求文件”生成方式来选择操作步骤:
具体操作如下:
- 系统生成CSR
- 在本地解压已下载的证书文件。
下载的文件包含了“Apache”、“Nginx” 2个文件夹和1个“domain.csr”文件,如图本地解压SSL证书所示。
- 从“证书ID_证书绑定的域名_Nginx”文件夹内获得证书文件“证书ID_证书绑定的域名_server.crt”、私钥文件“证书ID_证书绑定的域名_server.key”、“证书ID_证书绑定的域名_encrypt.crt”和私钥文件“证书ID_证书绑定的域名_ encrypt.key”。
- “证书ID_证书绑定的域名_server.crt”文件包括两段证书代码“-----BEGIN CERTIFICATE-----”和“-----END CERTIFICATE-----”,分别为服务器证书和中级CA。
- “证书ID_证书绑定的域名_server.key”文件包括一段私钥代码“-----BEGIN EC PRIVATE KEY-----”和“-----END EC PRIVATE KEY-----”。
- “证书ID_证书绑定的域名_ encrypt.crt”文件包括一段加密证书代码“-----BEGIN CERTIFICATE-----”和“-----END CERTIFICATE-----”。
- “证书ID_证书绑定的域名_ encrypt.key”文件包括一段私钥代码“-----BEGIN EC PRIVATE KEY-----”和“-----END EC PRIVATE KEY-----”。
- 在本地解压已下载的证书文件。
- 自己生成CSR
- 解压已下载的证书压缩包,获得“证书ID_证书绑定的域名_server.pem”文件。
“证书ID_证书绑定的域名_server.pem”文件包括两段证书代码“-----BEGIN CERTIFICATE-----”和“-----END CERTIFICATE-----”,分别为服务器证书和中级CA证书。
- 将“证书ID_证书绑定的域名_server.pem”的后缀名修改为“crt”,即“server.crt”。
- 将“证书ID_证书绑定的域名_encrypt.pem”的后缀名修改为“crt”,即“encrypt.crt”。
- 将“server.crt”,“encrypt.crt”,“encrypt.key”和生成CSR时的私钥“server.key”放在任意文件夹内。
- 解压已下载的证书压缩包,获得“证书ID_证书绑定的域名_server.pem”文件。
在/usr/local/nginx/conf目录下创建“cert”目录,并且将“server.key”、“server.crt”、“encrypt.key”和“encrypt.crt”复制到“cert”目录下。
步骤三:修改配置文件

修改配置文件前,请将配置文件进行备份,并建议先在测试环境中进行部署,配置无误后,再在现网环境进行配置,避免出现配置错误导致服务不能正常启动等问题,影响您的业务。
配置/usr/local/nginx/conf目录下的“nginx.conf”文件。
- 找到如下配置内容,并取消注释。
1 2 3 4 5 6 7 8 9 10 11 12 13 14
#server { # listen 443 ssl; # server_name localhost; # ssl_certificate cert.pem; # ssl_certificate_key cert.key; # ssl_session_cache shared:SSL:1m; # ssl_session_timeout 5m; # ssl_ciphers HIGH:!aNULL:!MD5; # ssl_prefer_server_ciphers on; # location / { # root html; # index index.html index.htm; # } #}
- 修改如下参数,具体参数修改说明如表参数说明所示。
1 2 3 4
ssl_certificate cert/server.crt; ssl_certificate_key cert/server.key; ssl_certificate cert/enc_server.crt; ssl_certificate_key cert/enc_server.key;
完整的配置如下,其余参数根据实际情况修改:
不要直接复制所有配置,参数中“ssl”开头的属性与证书配置有直接关系,其它参数请根据自己的实际情况修改。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
server { .com; #修改为您证书绑定的域名。 cert/server.crt; #替换成您的签名证书文件的路径。 cert/server.key; #替换成您的签名证书私钥文件的路径。 cert/encrypt.crt; #替换成您的加密证书文件的路径。 cert/encrypt.key; #替换成您的加密证书私钥文件的路径。 listen 443 ssl; #配置HTTPS的默认访问端口为443。如果在此处未配置HTTPS的默认访问端口,可能会导致Nginx无法启动。 server_name test ssl_certificate cert/server.crt; ssl_certificate_key cert/server.key; ssl_certificate cert/enc_server.crt; ssl_certificate_key cert/enc_server.key; ssl_session_cache shared:SSL:1m; ssl_session_timeout 5m; ssl_protocols TLSv1 TLSv1.1 TLSv1.2; ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:AES128-SHA:DES-CBC3-SHA:ECC-SM4-CBC-SM3:ECC-SM4-GCM-SM3; ssl_prefer_server_ciphers on; location / { root html; #站点目录。 index index.html index.htm; #添加属性。 } }
表1 参数说明 参数
参数说明
listen
SSL访问端口号,设置为“443”。
配置HTTPS的默认访问端口为443。如果未配置HTTPS的默认访问端口,可能会导致Nginx无法启动。
server_name
证书绑定的域名。示例:www.domain.com
ssl_certificate
- 签名证书的证书文件“server.crt”:设置为“server.crt”文件的路径,且路径中不能包含中文字符,例如“/usr/local/nginx/conf/cert/server.crt”。
- 加密证书的证书文件“enc_server.crt”:设置为“enc_server.crt”文件的路径,且路径中不能包含中文字符,例如“/usr/local/nginx/conf/cert/enc_server.crt”。
ssl_certificate_key
- 签名证书的私钥文件“server.key”:设置为“server.key”文件的路径,且路径中不能包含中文字符,例如“/usr/local/nginx/conf/cert/server.key”。
- 加密证书的私钥文件“enc_server.key”:设置为“enc_server.key”文件的路径,且路径中不能包含中文字符,例如“/usr/local/nginx/conf/cert/enc_server.key”。
- 修改完成后保存配置文件。
步骤四:验证配置是否正确
进入Nginx执行目录下,执行以下命令:
sbin/nginx -t
当回显信息如下所示时,则表示配置正确:
nginx.conf syntax is ok nginx.conf test is successful
效果验证
部署成功后,可在浏览器的地址栏中输入“https://域名”,按“Enter”。
如果浏览器地址栏显示安全锁标识,则说明证书安装成功。
- 如果网站仍然出现不安全提示,请参见为什么部署了SSL证书后,网站仍然出现不安全提示?进行处理。
- 如果通过域名访问网站时,无法打开网站,请参见为什么部署了SSL证书后,通过域名访问网站时,无法打开网站?进行处理。
- 如果仍未解决或出现其他问题,华为云市场提供SSL证书配置优化服务,专业工程师一对一服务,请直接单击一对一咨询进行购买,购买服务后,联系工程师进行处理。