宝塔面板原生不支持国密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参数冲突项。
- 在宝塔「网站」→「设置」→「配置文件」中，找到对应站点的
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 这一步，肉眼看不到的协商细节，全靠它暴露。
