跳到主要内容
SSL 证书付费服务

SSL证书配置完整指南:从申请、CSR生成到Nginx/宝塔部署与排错

SSL证书配置完整指南:从申请、CSR生成到Nginx/宝塔部署与排错 — SSL证书配置完整指南:从申请、CSR生成到Nginx/宝塔部署与排错

问题背景与根因:为什么HTTP站点必须升级到HTTPS

从2017年1月1日起,Chrome对未使用TLS的页面在地址栏标记「不安全」;苹果App Store的ATS标准要求所有iOS应用默认走HTTPS;微信小程序的wx.request只接受https域名。更关键的是协议层面的淘汰:TLS 1.0/1.1已被RFC 8996废弃,Chrome 84起、Firefox 74起、Safari 13.1起在握手阶段直接拒绝;HTTP/2与HTTP/3在主流浏览器中只在TLS上协商,纯HTTP站点无法享受多路复用。根因是HTTP明文传输:中间人可以注入广告脚本、篡改下载包、窃取Cookie与表单密码,这不是靠前端JS能补救的。

很多老站点以为「装上证书就完事」,实际踩坑点集中在三处:一是证书链不完整,浏览器报颁发机构无效;二是私钥与证书不匹配,Nginx直接起不来;三是页面里写死了http://的图片与JS,触发混合内容拦截。先做一次现状检查:

curl -I http://example.com
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates
curl -svo /dev/null https://example.com 2>&1 | grep -i "SSL certificate"

第一条返回200且无跳转,说明站点仍是纯HTTP;第二条若报no peer certificate available或wrong version number,说明443端口没有正确加载证书或根本没监听;第三条出现SSL certificate verify ok才是完整链路。检查结果决定后续动作:没有证书走申请流程,有证书但报错走排错流程。

SSL证书申请:类型选择、CSR生成与398天有效期规则

先明确两个硬约束。第一,CA/Browser Forum规定公有信任的TLS服务器证书最长有效期398天(自2020年9月1日起执行),市面上宣传的「两年证书」本质是CA用同一密钥对签发两张398天的证书分批下发,需要你按时间替换,不是一张证书用两年。第二,Let’s Encrypt免费证书有效期90天,且苹果从iOS 13 / macOS 10.15起要求服务器证书必须包含SAN扩展、有效期不超过825天,仅靠CN字段的旧证书已无法通过校验。

类型选择上:个人站、博客、API网关选DV单域名或通配符;企业对外门户、需要展示组织信息的选OV。EV证书从2019年起Chrome已不再显示绿色公司名,只剩证书详情里的组织字段,性价比很低。通配符*.example.com只覆盖一级子域,a.b.example.com不在保护范围,且通配符不匹配裸域example.com,必须额外加一条SAN。

用OpenSSL 1.1.1及以上生成私钥与CSR(一条命令同时产生key和csr):

openssl req -new -newkey rsa:2048 -sha256 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"

把CSR提交给CA,完成域名验证(DNS TXT记录、HTTP文件校验或管理员邮箱),下载后会得到三个文件:example.com.crt(站点证书)、ca_bundle.crt(中间证书)、example.com.key(私钥,绝不外传)。私钥必须与CSR成对,重新生成CSR会让旧私钥作废。如果不想付费,用acme.sh申请Let’s Encrypt:

curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --issue -d example.com -d www.example.com --webroot /www/wwwroot/example
~/.acme.sh/acme.sh --install-cert -d example.com --key-file /etc/nginx/ssl/example.com.key 
  --fullchain-file /etc/nginx/ssl/fullchain.crt --reloadcmd "nginx -s reload"

--install-cert会写入自动续期任务,90天到期前30天自动重签并reload,这是免费证书必须做的动作。

Nginx安装配置SSL证书:完整可执行步骤

第一步确认SSL模块已编译进去,输出中没有--with-http_ssl_module就需要重装或换包:

nginx -V 2>&1 | tr ' ' 'n' | grep http_ssl_module

第二步把证书放到固定目录并收紧权限。fullchain.crt必须是「站点证书 + 中间证书」按顺序拼接,顺序错了浏览器一样报错:

mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
cat example.com.crt ca_bundle.crt > fullchain.crt
chmod 600 example.com.key
chown root:root example.com.key
openssl x509 -in fullchain.crt -noout -issuer -subject -dates

第三步写server块。关键参数:ssl_protocols只保留TLSv1.2与TLSv1.3;ssl_ciphers用Mozilla的intermediate套件;ssl_session_cache提升握手性能;80端口单独一个server做301跳转。

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    http2 on;
    server_name example.com www.example.com;

    ssl_certificate     /etc/nginx/ssl/fullchain.crt;
    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;
    ssl_session_tickets off;

    add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

    root /www/wwwroot/example;
    index index.html index.php;
}

注意http2 on;是Nginx 1.25.1之后的新写法,旧版本要写成listen 443 ssl http2;,写错会报unknown directive "http2"。改完执行校验再平滑重载,nginx -t通过才reload,否则线上直接中断:

nginx -t && systemctl reload nginx
ss -lntp | grep ':443'

Apache与宝塔面板的证书安装配置

Apache需要mod_ssl与mod_headers。Debian/Ubuntu用a2enmod ssl headers,CentOS确认httpd.conf里有LoadModule ssl_module modules/mod_ssl.so。Apache 2.4.8之后不再需要SSLCertificateChainFile,把中间证书拼进SSLCertificateFile即可;低于该版本必须单独指定,否则Android 4.x与部分Java客户端会握手失败。

<VirtualHost *:80>
    ServerName example.com
    Redirect permanent / https://example.com/
</VirtualHost>

<VirtualHost *:443>
    ServerName example.com
    DocumentRoot /var/www/example

    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/fullchain.crt
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    # Apache < 2.4.8 才需要下面一行
    # SSLCertificateChainFile /etc/httpd/ssl/ca_bundle.crt

    SSLProtocol             -all +TLSv1.2 +TLSv1.3
    SSLCipherSuite          HIGH:!aNULL:!MD5:!3DES
    SSLHonorCipherOrder     off
    Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>

校验命令是apachectl configtest,输出Syntax OK再systemctl reload httpd(Debian系是apache2)。

宝塔面板用户不需要碰配置文件:进入「网站 → 设置 → SSL」,把fullchain.crt全文粘到「证书(PEM格式)」,example.com.key全文粘到「私钥(KEY格式)」,保存后打开「强制HTTPS」。面板会把文件写到/www/server/panel/vhost/cert/example.com/下的fullchain.pem与privkey.pem,并自动在Nginx配置里注入ssl_certificate。使用面板内置Let’s Encrypt申请时,续期任务在「计划任务」里,类型为「Let’s Encrypt续签」,默认每天执行一次;若续签失败,先检查80端口是否被CDN或其他进程占用,HTTP-01验证必须能从公网访问/.well-known/acme-challenge/。

常见粘贴错误:把ca_bundle放在站点证书前面、把key的BEGIN行漏掉、Windows记事本另存带BOM。保存后提示证书内容不正确基本都是格式问题。

证书类型与部署方式对比表

选型不要只看价格,验证方式与维护成本才是长期成本。下表按当前规则(证书最长398天、Let’s Encrypt 90天)整理:

方案 验证方式 有效期 浏览器信任 覆盖范围 参考价格 适用场景
DV单域名 DNS/HTTP文件 最长398天 是 1个域名+指定SAN 100–300元/年 个人站、测试环境
DV通配符 DNS TXT 最长398天 是 *.example.com一级子域 800–1200元/年 多子域业务、SaaS租户
OV单域名 DNS+组织审核 最长398天 是 1个域名 800–2000元/年 企业门户、支付回调
Let’s Encrypt HTTP-01/DNS-01 90天(自动续) 是 单域名或通配符 0元 有自动化能力的站点
自签名证书 无 自定义 否 任意 0元 内网、本地开发

部署方式上,手工上传适合证书数量少、变更不频繁的场景;acme.sh / certbot适合域名多、需要无人值守续期的场景;云厂商的证书托管适合已有负载均衡(SLB/CLB)的架构,证书在LB上终止,后端回源用HTTP或自签证书。要注意:如果前面套了CDN,证书必须同时部署在CDN边缘节点和源站,只装源站会出现「CDN回源526」。

常见错误排查:真实报错与修复命令

下面五类报错覆盖了绝大多数现场问题,按报错原文检索即可定位。

1)nginx: [emerg] cannot load certificate … BIO_new_file() failed (SSL: error:0200100D:system library:fopen:Permission denied)。不是路径写错,而是Nginx worker进程读不到文件。用namei -l /etc/nginx/ssl/fullchain.crt检查每一级目录的执行权限;SELinux开启时执行chcon -t httpd_config_t /etc/nginx/ssl/*.crt。

2)SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)。证书与私钥不配对。用模数比对:

openssl x509 -noout -modulus -in fullchain.crt | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5

两个MD5必须一致,不一致说明下载时拿错了key文件,或重新签发后没替换私钥。ECDSA证书没有modulus,改用openssl x509 -noout -pubkey -in fullchain.crt | openssl md5与openssl pkey -pubout -in example.com.key | openssl md5比对公钥。

3)浏览器报NET::ERR_CERT_COMMON_NAME_INVALID。访问的域名不在证书SAN列表里。检查openssl x509 -in fullchain.crt -noout -text | grep -A1 "Subject Alternative Name",缺www就补签。注意通配符不覆盖裸域,也不覆盖二级子域。

4)NET::ERR_CERT_AUTHORITY_INVALID或curl: (60) SSL certificate problem: unable to get local issuer certificate。证书链不完整,缺中间证书。用openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null数一下返回几张证书,正常应≥2张。修复方式就是把站点证书和ca_bundle按顺序cat成一个文件。

5)SSL_ERROR_NO_CYPHER_OVERLAP / handshake failure。客户端与服务端没有共同协议或套件:老客户端只支持TLS 1.0而你已禁用,或用了ECDSA证书却配置纯RSA套件。用openssl s_client -connect example.com:443 -tls1_2与-tls1_3分别验证。另外页面里http://资源导致的Mixed Content不算证书错误,但同样会让锁标消失,可在Nginx加add_header Content-Security-Policy "upgrade-insecure-requests";兜底。

效果验证:命令行、浏览器与自动化巡检

配置完成必须做四层验证,缺一层就可能在上线后出问题。

第一层,证书本身。确认颁发者、有效期、SAN与签名算法:

openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -issuer -subject -dates -ext subjectAltName

第二层,协议与套件。确认TLS 1.0/1.1已被拒绝,1.2/1.3可用:

for v in tls1 tls1_1 tls1_2 tls1_3; do
  echo -n "$v: "; echo | openssl s_client -connect example.com:443 -servername example.com -$v 2>&1 | grep -q "Cipher is" && echo OK || echo FAIL
done

预期tls1与tls1_1为FAIL,tls1_2与tls1_3为OK。

第三层,HTTP层行为。确认80跳443、HSTS头存在、无混合内容:

curl -sI http://example.com | head -n 3          # 期望 301 Location: https://...
curl -sI https://example.com | grep -i strict-transport-security
curl -s https://example.com | grep -o 'http://[^"]*' | head

第四层,第三方评级。SSL Labs会给出协议、套件、证书链、HSTS的综合评级,目标A及以上:

curl -s "https://api.ssllabs.com/api/v3/analyze?host=example.com&all=done" | head -c 400

浏览器侧按F12 → Security面板,能看到Connection - secure (strong cipher)才算通过;点开证书应显示完整链(站点证书 → 中间证书 → 根证书)。

最后加一条巡检,30天内到期就告警,避免398天和90天两种有效期混用后忘记续期:

#!/bin/bash
DOMAIN=example.com
END=$(echo | openssl s_client -connect $DOMAIN:443 -servername $DOMAIN 2>/dev/null 
  | openssl x509 -noout -enddate | cut -d= -f2)
LEFT=$(( ($(date -d "$END" +%s) - $(date +%s)) / 86400 ))
[ $LEFT -lt 30 ] && echo "证书剩余 $LEFT 天,请续期" | mail -s "SSL告警 $DOMAIN" ops@example.com

写成crontab0 8 * * * /opt/check_ssl.sh即可。

常见问题

免费Let’s Encrypt证书和付费DV证书在加密强度上有区别吗?

没有。两者的加密算法(RSA 2048 / ECDSA P-256)、TLS协议版本、密码套件完全一样,浏览器地址栏都显示锁标。区别在有效期(Let’s Encrypt 90天,付费证书最长398天)、是否提供人工客服与赔付保障、是否支持通配符与OV组织审核。免费证书的唯一成本是必须做自动化续期,一旦cron失效就会在90天后过期。

通配符证书能覆盖二级子域吗?裸域要不要单独加?

不能。*.example.com只匹配a.example.com这一级,不匹配a.b.example.com,也不匹配example.com本身。如果业务同时使用裸域与多级子域,签发时要在SAN里同时写*.example.com和example.com,或者对多级子域单独签发。

证书装好了,浏览器还是显示「不安全」怎么办?

先按F12 → Security看具体原因。最常见的是混合内容:页面里还有http://的图片、JS、CSS,锁标会降级为不安全。用grep找出硬编码的http://改成相对协议//或https://,或在Nginx加Content-Security-Policy: upgrade-insecure-requests。其次是证书链不完整(缺中间证书)和域名不在SAN列表。

证书最长有效期为什么是398天?「两年证书」是骗人的吗?

398天是CA/Browser Forum基线要求规定的公有信任证书上限(2020年9月1日起生效)。市面上宣传的两年期产品,实际是CA签发两张398天的证书,到期前需要你替换,并非一张证书用满两年。买多年套餐时务必确认续期方式,否则第二张证书没安装,站点会直接过期。

换服务器或迁移网站,证书能直接拷过去吗?

可以,证书与服务器IP无关,只与域名和私钥配对。迁移时把fullchain.crt与example.com.key一起拷走,在新机器上重做权限(key设为600),改配置里的路径后执行nginx -t校验。私钥绝不能泄露,拷贝用scp或加密传输,不要放在公开目录或代码仓库里。

宝塔面板Let’s Encrypt续签失败怎么排查?

先看面板「计划任务」里续签任务的日志。最常见原因是80端口不通(防火墙或安全组未放行、CDN回源改了端口),HTTP-01验证需要公网能访问/.well-known/acme-challenge/;其次是域名解析未指向当前服务器;再次是Nginx配置里80端口的server_name没包含该域名。DNS-01方式可绕开80端口限制,适合不能开放HTTP的环境。

内容审核

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