跳转到主内容
新派编程网 - 新潮编程理念,全新技术课堂!

宝塔面板如何部署国密SM2标准SSL证书_手动修改Nginx配置加载国密证书

宝塔面板原生不支持国密SM2证书,需手动编译含nginx_gm模块的Nginx、使用加密SM2私钥与纯SM2证书链,并在配置中指定国密SSL参数及套件。 宝塔面板原生不支持国密SM2证书的自动识别与配置,必须手动修改Nginx配置文件并启用国密兼容模块(如
nginx_gm
),否则直接上传SM2证书会触发
SSL_CTX_use_PrivateKey_file() failed
或
unknown certificate type
错误。 确认Nginx是否已编译国密支持模块 国密SSL依赖底层Nginx对SM2/SM3/SM4算法的支持,官方Nginx不包含该能力。宝塔默认安装的Nginx(
nginx -V
输出中不含
--add-module=../nginx_gm
)无法加载SM2私钥。 执行
nginx -V 2>&1 | grep -o "nginx_gm"
,无输出即未启用国密模块 若未启用:需卸载当前Nginx,重新编译安装带
nginx_gm
的定制版本(推荐使用 tasshu/nginx_gm ) 编译时必须开启
--with-http_ssl_module --with-openssl=../gmssl
并指定国密版OpenSSL(如
gmssl 3.0+
)路径 验证:成功后
nginx -t
应通过,且
nginx -V
显示
nginx_gm
模块路径 准备SM2证书链与密钥格式 国密证书不是简单替换PEM文件——SM2私钥必须为
ENCRYPTED PRIVATE KEY
格式(含
-----BEGIN ENCRYPTED PRIVATE KEY-----
头尾),且不能是PKCS#8未加密裸密钥;证书链需合并为单个PEM文件,顺序为:站点证书 → SM2中级CA → SM2根CA。 SM2私钥若为
-----BEGIN EC PRIVATE KEY-----
格式,需用
gmssl ec -in key.pem -out key_enc.pem -aes256
转换加密 证书链中不能混入RSA证书;若CA仅提供RSA根证书,需向CA申请纯SM2信任链 宝塔Web界面上传时,会自动校验密钥格式,遇到
key is not valid
即说明私钥未加密或算法不匹配 建议将最终文件统一命名为
full_chain_sm2.pem
(证书链)和
privkey_sm2.pem
(加密私钥),避免路径混淆 手动修改Nginx站点配置启用SM2 宝塔不会为SM2生成专用server块,必须在站点配置的
server
块内手动添加国密相关指令,并关闭默认SSL参数冲突项。 Nginx 在宝塔面板中轻松管理Nginx高性能Web服务器。提供可视化配置反向代理、负载均衡、SSL证书及HTTP缓存功能,一键优化高并发性能,助您高效搭建稳定、快速的网站运行环境。 下载 在宝塔「网站」→「设置」→「配置文件」中,找到对应站点的
server
块,在
listen 443 ssl http2;
下方插入:
ssl_certificate /www/wwwroot/your-site/full_chain_sm2.pem; ssl_certificate_key /www/wwwroot/your-site/privkey_sm2.pem; ssl_protocols TLSv1.1 TLSv1.2 TLSv1.3; ssl_ciphers ECC-SM4-CBC-SM3:ECDHE-SM4-CBC-SM3:SM4-CBC-SM3; ssl_ecdh_curve sm2p256v1; ssl_prefer_server_ciphers off;
删除或注释掉原有
ssl_certificate
和
ssl_certificate_key
行(避免重复定义) 禁用
ssl_dhparam
(SM2不使用DH密钥交换)
ssl_ciphers
必须显式指定国密套件,不能依赖默认值;
ECC-SM4-CBC-SM3
是基础兼容套件 修改后务必执行
nginx -t
验证语法,再
systemctl reload nginx
生效 验证SM2握手是否生效 浏览器直接访问无法判断是否走SM2(Chrome/Firefox不支持国密套件显示),必须用命令行工具探测。 使用国密版
gmssl s_client -connect your-domain.com:443 -cipher ECC-SM4-CBC-SM3
成功响应中应出现
Server public key is 256 bit
、
New, TLSv1.3, Cipher is ECC-SM4-CBC-SM3
若返回
ssl handshake failure
,常见原因是:私钥未加密、证书链缺失SM2根证书、Nginx未加载
nginx_gm
模块 注意:部分WAF或CDN会终止SM2握手,验证前确保请求直连源站IP SM2部署真正的难点不在配置语法,而在于整条信任链的闭环——从OpenSSL编译、Nginx模块集成、到CA签发策略,任一环节用RSA替代都会导致握手失败。别跳过
gmssl s_client
这一步,肉眼看不到的协商细节,全靠它暴露。

相关文章