国密SM2证书Nginx安装指南

更新时间：2024-05-31 来源：TopSSL 作者：TopSSL

本指南详细介绍了在 Linux 环境下为 Nginx 服务器配置国密 SM2 证书的流程，涵盖依赖软件准备、SM2 模块下载及关联编译步骤。通过使用 wotrus_ssl 模块，实现了 Nginx 的国密合规改造。如需详细了解该国密SM2证书Nginx安装指南，请参考 TopSSL 的教程内容。

国密SM2证书Nginx安装指南（Linux环境配置教程）

随着国产密码算法与国密 HTTPS 的普及，越来越多政务、国企、金融及国产化项目开始部署国密 SM2 SSL 证书。

但很多用户在配置国密 HTTPS 时，经常会遇到：

Nginx 不支持 SM2
OpenSSL 编译失败
HTTPS 无法访问
国密证书不生效
浏览器兼容问题

实际上，国密 SSL 与普通 RSA SSL 最大的区别在于：

Nginx 默认并不直接支持 SM2，需要额外安装国密 OpenSSL 模块后重新编译。

本文将详细介绍 Linux 环境下 Nginx 安装配置国密 SM2 SSL 证书的方法。

一、安装前环境准备

部署国密 HTTPS 前，请先确认服务器环境满足以下条件。

1、Linux 操作系统

目前国密模块通常仅支持：

X86_64

架构。

推荐系统：

CentOS 7+
Rocky Linux
Alibaba Cloud Linux
Ubuntu 20+
麒麟 / 统信 UOS（需自行验证兼容）

2、Nginx版本要求

建议使用：

Nginx 1.14.2+

推荐使用较新的稳定版本。

Nginx官方下载地址：

http://nginx.org/en/download.html

3、准备国密 OpenSSL 模块

由于默认 OpenSSL 不支持国密 SM2，因此需要使用支持国密算法的 OpenSSL 模块。

常见国密模块：

沃通国密模块
Tongsuo（腾讯）
GmSSL
OpenSSL 国密分支

本文以沃通国密模块为例。

根据系统版本选择对应模块：

CentOS 6及以下

https://www.wotrus.com/download/wotrus_ssl_v1.tar.gz

CentOS 7及以上

https://www.wotrus.com/download/wotrus_ssl.tar.gz

4、准备国密SM2证书

通常需要：

SM2证书文件
SM2私钥文件
国密证书链

部分场景还会同时部署：

RSA证书
SM2证书

实现双证书兼容。

二、安装依赖环境

安装 Nginx 前，需要先安装编译依赖：

yum install gcc gcc-c++ pcre pcre-devel zlib zlib-devel openssl openssl-devel -y

如果是 Ubuntu 系统：

apt install build-essential libpcre3 libpcre3-dev zlib1g-dev openssl libssl-dev

三、上传并解压安装包

将以下文件上传至服务器：

nginx安装包
国密模块压缩包

例如上传至：

/usr/local/

然后解压：

tar -zxvf nginx-1.15.12.tar.gz
tar -zxvf wotrus_ssl.tar.gz

解压完成后：

/usr/local/nginx-1.15.12
/usr/local/wotrus_ssl

四、编译安装支持国密的Nginx

进入 Nginx 源码目录：

cd /usr/local/nginx-1.15.12

执行 configure：

./configure \
--prefix=/usr/local/nginx \
--with-http_stub_status_module \
--with-stream \
--with-http_ssl_module \
--with-stream_ssl_module \
--with-openssl=/usr/local/wotrus_ssl

说明：

参数	作用
--with-http_ssl_module	开启HTTPS模块
--with-stream_ssl_module	开启TCP SSL支持
--with-openssl	指定国密OpenSSL模块

这里仅配置了常用模块，其他模块可根据实际业务自行增加。

五、编译并安装Nginx

执行：

make && make install

如果过程中没有报错，则说明：

国密 OpenSSL 编译成功
Nginx 已支持 SM2

安装完成后：

/usr/local/nginx/

即为安装目录。

六、配置国密SM2证书

编辑 Nginx 配置文件：

/usr/local/nginx/conf/nginx.conf

或者虚拟主机配置：

/usr/local/nginx/conf/vhost/example.conf

添加 HTTPS 配置：

server {
    listen 443 ssl;
    server_name example.com;

    ssl_certificate      /usr/local/nginx/conf/ssl/sm2.pem;
    ssl_certificate_key  /usr/local/nginx/conf/ssl/sm2.key;

    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    location / {
        root html;
        index index.html index.htm;
    }
}

注意：