跳到主要内容
ssl证书按装

SSL证书购买、安装与HTTPS配置实战:CSR、Nginx/Apache、小程序排错

SSL证书购买、安装与HTTPS配置实战:CSR、Nginx/Apache、小程序排错 — SSL证书购买、安装与HTTPS配置实战:CSR、Nginx/Apache、小程序排错

问题背景与根因:为什么小程序和现代浏览器必须HTTPS

HTTP明文传输会被中间人劫持,插入广告、篡改下载包,微信小程序、苹果ATS和主流浏览器都要求HTTPS。小程序服务器域名必须使用https,不能使用IP或localhost,TLS版本需1.2及以上,证书必须受信任且证书链完整;否则开发者工具和真机出现request:fail ssl hand shake error。另一个根因是证书有效期已缩短:公共CA签发的SSL/TLS证书最长有效期398天,Let’s Encrypt为90天,旧文章里“默认一年证书”的说法已过时,必须建立续期机制。常见故障还包括只部署叶证书缺少中间证书、SNI未命中、ECS安全组未放行443、域名与CSR的CN/SAN不一致、服务器仍启用TLS1.0/1.1。排查先执行:curl -I http://example.com;openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates;ss -lntp | grep ‘:443’。若curl返回301/302到https且openssl显示Verify return code: 0 (ok),说明证书配置基本正确;若出现unable to get local issuer certificate,优先检查fullchain.pem是否按“站点证书+中间证书”顺序拼接。证书购买、证书安装、证书配置应作为一个闭环处理,不能只买不续、只装不验。

证书购买前先选型:DV、OV、EV与单域名、多域名、通配符

证书购买先确定覆盖范围和验证等级。DV只验证域名控制权,几分钟签发,适合个人站点、API、微信小程序后端;OV验证企业身份,通常3-5个工作日,适合企业门户;EV也是组织验证,但主流浏览器已不再在地址栏展示公司名称,不应把“地址栏显示公司名”作为采购理由。按域名分:单域名证书只保护example.com或www.example.com一个名称;多域名证书通过SAN保护多个不同域名;通配符证书保护*.example.com,只匹配一级子域,不匹配a.b.example.com,也不自动包含example.com,CSR的SAN要写清。公共CA证书最长有效期398天,Let’s Encrypt 90天且可自动续期;商业证书也需按398天规划续期。采购前在服务器执行openssl version、nginx -v或httpd -v,向CA提供操作系统和Web服务端版本;准备域名管理权限,配合添加TXT解析记录完成DNS验证。商业SSL证书常为特殊商品,售出不退换,下单前核对域名、SAN、有效期和服务器类型。预算有限且能接受90天自动续期,选Let’s Encrypt DV;需要组织信息和商业支持,选OV;小程序和普通官网用DV即可,不必为EV溢价。证书配置时务必保留私钥和CSR,后续换机、负载均衡导入都要用。

完整实操步骤:CSR、DNS TXT验证、签发与部署

第一步生成私钥和CSR,命令可直接执行:openssl genrsa -out example.com.key 2048;openssl req -new -sha256 -key example.com.key -out example.com.csr -subj ‘/CN=example.com/O=Example/OU=IT/C=CN’。商业CA下单时粘贴CSR,并按提示添加TXT记录,例如dig TXT _dnsauth.example.com +short确认生效;TXT未生效不要反复重签。使用Let’s Encrypt可用certbot certonly –webroot -w /var/www/html -d example.com -d www.example.com,需放行80端口;也可用certbot certonly –manual –preferred-challenges dns -d example.com做DNS-01。云服务器先在安全组放行80和443,再执行ss -lntp | grep ‘:443’确认监听。签发后得到站点证书、中间证书和私钥;Nginx应使用fullchain.pem(站点证书在前、中间证书在后)和privkey.pem。上传后设置权限:chmod 600 /etc/nginx/ssl/example.com.key;chown root:root /etc/nginx/ssl/example.com.key。部署前用openssl x509 -noout -modulus -in fullchain.pem | openssl md5与openssl rsa -noout -modulus -in example.com.key | openssl md5比对,两个md5必须一致。最后nginx -t;systemctl reload nginx。若使用IIS/Tomcat,导入PFX/JKS时同样要包含中间证书,Tomcat的server.xml配置keystoreFile、keystorePass并启用TLS1.2。证书安装完成不等于上线完成,还要做301跳转和链验证。

Nginx与Apache配置示例:443、301跳转与TLS加固

Nginx最小可用配置如下:server { listen 80; server_name example.com www.example.com; return 301 https://$host$request_uri; } server { listen 443 ssl http2; server_name example.com www.example.com; ssl_certificate /etc/nginx/ssl/fullchain.pem; ssl_certificate_key /etc/nginx/ssl/example.com.key; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers ‘ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384’; ssl_prefer_server_ciphers off; ssl_session_cache shared:SSL:10m; ssl_session_timeout 1d; add_header Strict-Transport-Security ‘max-age=31536000; includeSubDomains’ always; location / { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Forwarded-Proto $scheme; } }。执行nginx -t;systemctl reload nginx。Apache示例:<VirtualHost *:80> ServerName example.com Redirect permanent / https://example.com/ </VirtualHost>;<VirtualHost *:443> SSLEngine on SSLCertificateFile /etc/httpd/ssl/fullchain.pem SSLCertificateKeyFile /etc/httpd/ssl/example.com.key SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 </VirtualHost>,执行apachectl configtest;systemctl reload httpd。注意301跳转不要在后端应用和Nginx同时反复重写,代理场景用X-Forwarded-Proto判断,避免重定向循环。HSTS先短max-age灰度,确认全站HTTPS后再加includeSubDomains。证书配置中不要使用ssl on旧语法,TLS1.0/1.1必须关闭,否则小程序和部分浏览器握手失败。

证书与部署方案对比表格:选型、有效期与验证方式

下表用于证书购买和证书安装前的快速决策。公共CA证书最长有效期按398天规划,Let’s Encrypt为90天;表中“自动续期”指通过ACME客户端实现,不是证书永久有效。通配符只覆盖一级子域,多域名按SAN数量计价。部署方式要结合服务器和云产品,负载均衡终止TLS时,后端可用HTTP但需限制内网访问。

类型 验证方式 签发时长 有效期 适用场景
DV SSL HTTP-01/DNS-01域名控制权 几分钟 90天或最长398天 个人站、API、小程序后端
OV SSL 域名+企业资料审核 3-5工作日 最长398天 企业门户、官网
EV SSL 严格组织审核 5-7工作日 最长398天 金融、电商合规场景
覆盖方式 示例 注意点
单域名 example.com www需另加SAN
多域名 a.com、b.com 按SAN数量计价
通配符 *.example.com 只匹配一级子域,不含example.com
Let’s Encrypt 90天DV certbot renew自动续期
部署位置 证书文件 关键动作
Nginx fullchain.pem+key nginx -t后reload
Apache fullchain.crt+key configtest后reload
IIS PFX 导入个人存储并绑定443
Tomcat JKS/PKCS12 server.xml启用TLS1.2
云负载均衡 PEM/PFX 上传服务器证书和中间链

选型结论:小程序、普通官网优先DV;需要企业资质展示选OV;EV仅在有合规要求时考虑。证书购买后先核对SAN和有效期,再进入证书安装。

常见错误排查:真实报错与逐条修复

1)Nginx报SSL_CTX_use_PrivateKey(…) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch),说明证书和私钥不匹配。执行openssl x509 -noout -modulus -in fullchain.pem | openssl md5和openssl rsa -noout -modulus -in example.com.key | openssl md5,两个md5不一致就重新签发或找回正确私钥。2)curl报curl: (60) SSL certificate problem: unable to get local issuer certificate,多为缺中间证书。fullchain.pem必须是站点证书+中间证书,不能只放站点证书;用openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null查看链。3)浏览器报NET::ERR_CERT_COMMON_NAME_INVALID,检查CSR的CN和SAN是否包含实际访问域名,通配符*.example.com不匹配a.b.example.com。4)浏览器报ERR_SSL_PROTOCOL_ERROR,检查443监听和TLS版本:ss -lntp | grep ‘:443’;nginx -t;确认ssl_protocols包含TLSv1.2/TLSv1.3且未只开TLS1.3导致旧客户端失败。5)微信小程序报request:fail ssl hand shake error,按TLS1.2+、证书受信任、完整链、域名已配置为request合法域名、443可访问逐项排查。6)curl: (7) Failed to connect to example.com port 443: Connection refused,检查安全组和防火墙:firewall-cmd –list-ports;云安全组放行443。7)DNS验证失败,执行dig TXT _dnsauth.example.com +short,等待TTL生效后再点验证。8)301循环,检查代理的X-Forwarded-Proto,避免后端再次跳https。

效果验证与续期监控:openssl、curl、SSL Labs

部署后先做本地验证:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates,确认subject包含域名、issuer为受信任CA、notAfter未过期;echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | grep ‘Verify return code’应返回0 (ok)。再执行curl -I https://example.com看HTTP/2 200和Strict-Transport-Security头;curl -I http://example.com应返回301 Location: https://example.com/。证书链可用openssl s_client -showcerts观察是否包含中间证书。外部验证用SSL Labs,目标A/A+,重点看证书链、TLS1.0/1.1是否关闭、HSTS。续期方面,Let’s Encrypt 90天证书用certbot renew –dry-run演练,生产用systemd timer或cron每日执行certbot renew –quiet;商业证书最长398天,至少提前30天续期。监控命令:openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/fullchain.pem,返回notAfter仍有效表示30天内不过期;也可用openssl x509 -noout -enddate -in fullchain.pem提取到期日接入告警。微信小程序在开发者工具勾选不校验合法域名只能临时调试,真机必须使用受信任证书和已备案HTTPS域名。最后把证书配置、证书安装、证书购买记录归档,私钥权限600,备份到受控密钥库。

常见问题

小程序必须用OV或EV证书吗?

不需要。微信小程序要求HTTPS、TLS1.2+、证书受信任且链完整,DV证书即可;关键在域名合法、443可访问、fullchain.pem正确且证书CN/SAN匹配请求域名。

证书最长有效期到底是多久?

公共CA签发的SSL/TLS证书最长398天,Let’s Encrypt为90天。旧文章说默认一年已过时,必须配置自动续期,或用openssl x509 -checkend做提前30天告警。

通配符证书能保护所有二级域名吗?

不能。*.example.com只匹配一级子域如a.example.com,不匹配a.b.example.com,也不自动包含example.com;需要时把example.com加入SAN,或另购多域名证书。

为什么浏览器提示证书链不完整?

通常只部署了站点证书。Nginx/Apache应使用fullchain.pem,顺序为站点证书在前、中间证书在后;中间证书从CA下载,并用openssl s_client -showcerts验证链。

301跳转后出现重定向循环怎么办?

检查Nginx的X-Forwarded-Proto和后端应用是否再次跳转;代理层用$scheme判断,只保留一层301,并清理应用内重复HTTPS跳转规则,再用curl -I http://域名观察Location。

商业证书购买后能退换吗?

多数商业SSL证书为特殊商品,签发后不退换。下单前核对域名、SAN、有效期和服务器类型,并确保有DNS TXT解析权限;同时保留CSR和私钥备份。

内容审核

长期从事 SSL/TLS 证书部署与 HTTPS 运维,负责本站证书选型、安装配置与故障排查内容的编写与审核。