网站 HTTPS 一键部署实战:SSL 证书申请、安装配置、排错与验证全指南
一、问题背景:为什么“一键 HTTPS”经常变成一堆报错
HTTP 是明文协议,数据在链路任意一跳都可能被读取或篡改,常见的运营商插广告、DNS 劫持跳转、公共 WiFi 抓包都属于此类。主流浏览器已对 HTTP 页面在地址栏标注“不安全”,搜索引擎对 HTTPS 站点优先抓取与展示,微信小程序、支付宝、Apple ATS 等平台也强制要求 HTTPS 接口。因此 HTTPS 不再是可选项,而是网站上线的基础配置。
但真实运维中,“一键配置”往往落地成一串报错,根因集中在六类:
- 证书链不完整:只上传了域名证书,没带中间证书,PC 端正常但 Android 或 curl 直接报
unable to get local issuer certificate。 - 证书与私钥不匹配:申请时换了密钥对,Nginx 启动直接
key values mismatch。 - 443 端口未放行:云厂商安全组、firewalld、iptables 任一层没开,表现为连接被拒。
- 页面硬编码 http:// 资源:证书没问题,但 CSS、JS、图片走 http,触发混合内容拦截,页面错乱。
- 协议版本过低:仍开启 TLSv1.0/1.1,被现代浏览器判定为弱协议。
- 忘记续期:这是最高频的线上事故。
关于有效期必须纠正一个过时认知:自 2020 年 9 月 1 日起,Apple 与 Chrome 要求 TLS 服务器证书有效期不超过 398 天,CA 实际普遍按 365 天或 397 天签发,早期“买三年、配一次管三年”的方案已经失效。Let’s Encrypt 免费证书固定 90 天,2025 年起还额外提供 6 天短期证书选项。这意味着自动化续期是 HTTPS 部署的必选环节,而不是可选项。
二、动手前的准备:证书选型、私钥与 CSR 生成
先明确三件事:保护哪些域名、需要什么验证级别、用什么方式续期。
验证级别:DV 只验证域名控制权,10 分钟内可签发;OV 需核验企业工商信息并电话回访,通常 1–2 个工作日;EV 核验最严格(营业执照、企业电话、DUNS 编号等),约 1–3 个工作日。需要提醒的是,Chrome、Edge 自 2019 年起已取消 EV 证书的绿色地址栏,EV 的价值转为证书主体中展示企业全称,而非视觉标识。
覆盖范围:单域名证书只保护一个 FQDN;多域名(SAN)证书可在一张证书里写入多个域名;通配符 *.example.com 只匹配一级子域,不覆盖裸域 example.com,也不覆盖 a.b.example.com,下单时务必按实际域名清单核对。
生成私钥与 CSR(在服务器上执行,私钥不落地第三方):
mkdir -p /etc/nginx/ssl && cd /etc/nginx/ssl
# RSA 2048(兼容性最好);追求性能可用 ECDSA P-256
openssl genrsa -out example.com.key 2048
# 或:openssl ecparam -genkey -name prime256v1 -out example.com.key
chmod 600 example.com.key
openssl req -new -key example.com.key -out example.com.csr
-subj '/C=CN/ST=Guangdong/L=Shenzhen/O=Example Tech Co., Ltd./OU=IT/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
提交 CSR 前先自检,确认 SAN 与主体无误:
openssl req -in example.com.csr -noout -subject -text | grep -A1 'Subject Alternative Name'
CA 签发后会给你两个文件:域名证书(如 example.com.crt)与中间证书(如 chain.crt 或 ca_bundle.crt)。部署时使用的必须是完整链:
cat example.com.crt chain.crt > fullchain.pem
openssl verify -CAfile chain.crt fullchain.pem # 应输出 OK
三、Nginx 一键部署 HTTPS 的完整实操步骤
以下步骤在 CentOS/Ubuntu 通用,命令可直接复制执行。
步骤 1:放行 443 端口
# firewalld
firewall-cmd --permanent --add-service=https && firewall-cmd --reload
# ufw
ufw allow 443/tcp
# 云服务器还需在控制台安全组入方向放行 TCP:443(0.0.0.0/0)
步骤 2:放置证书,目录 /etc/nginx/ssl/,需三个文件:fullchain.pem、example.com.key,私钥权限 600、属主 root。
步骤 3:写入站点配置 /etc/nginx/conf.d/example.conf:
server {
listen 443 ssl;
http2 on; # Nginx 1.25.1+ 写法;旧版写 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:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305;
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' always;
root /var/www/example;
index index.html;
}
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
步骤 4:校验并热加载
nginx -t && systemctl reload nginx
nginx -t 是唯一的安全网:配置有语法或证书路径错误时它直接拒绝加载,不会影响正在运行的服务。请勿用 restart 代替 reload,reload 是平滑重载,不中断现有连接。
步骤 5:自动化续期(Let’s Encrypt 场景)
certbot --nginx -d example.com -d www.example.com --renew-hook 'systemctl reload nginx'
certbot renew --dry-run # 演练,必须返回成功
若使用 acme.sh:acme.sh --install-cert -d example.com --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/fullchain.pem --reloadcmd 'systemctl reload nginx',其 cron 任务会自动在到期前 30 天续签。
四、Apache、Tomcat 与面板环境配置示例
Apache(httpd 2.4):
<VirtualHost *:443>
ServerName example.com
DocumentRoot /var/www/example
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
# Apache 2.4.8 及以上无需 SSLCertificateChainFile,fullchain 已含中间证书
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256
SSLHonorCipherOrder off
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
修改后执行 apachectl configtest,返回 Syntax OK 再 systemctl reload httpd。
Tomcat 不直接读 PEM,需先转 PKCS12:
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key
-out example.com.p12 -name tomcat -CAfile chain.crt -caname root -passout pass:ChangeMe123
然后在 conf/server.xml 中配置 Connector:
- Wildcard 通配符 SSL 证书安装部署续费申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
- SSL域名证书申请 · 小程序证书 · 国外SSL证书
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol"
SSLEnabled="true" maxThreads="200" scheme="https" secure="true"
keystoreFile="/opt/tomcat/conf/example.com.p12"
keystoreType="PKCS12" keystorePass="ChangeMe123" SSLProtocol="TLSv1.2,TLSv1.3" />
宝塔等面板:站点设置 → SSL → 其他证书,把 fullchain.pem 内容粘贴到“证书(PEM 格式)”,私钥内容粘贴到“私钥(KEY 格式)”,保存后开启“强制 HTTPS”。面板会自动写 301 跳转并部署续期任务。
若站点前面还有 CDN 或负载均衡,证书应同时部署在边缘节点;回源段可用自签或源站证书,但要确认 CDN 已开启“回源 HTTPS”,否则源站仍收明文。Nginx 作为反代时,后端要读真实协议需加 proxy_set_header X-Forwarded-Proto $scheme;,否则程序生成的回调地址会退回 http,引发跳转死循环。
五、证书类型与部署方式对比表
选型时把“验证级别”和“覆盖范围”分开看,能避免九成买错的情况。
| 类型 | 验证内容 | 签发时长 | 有效期上限 | 适用场景 |
|---|---|---|---|---|
| DV(免费 Let’s Encrypt) | 域名控制权 | 1–3 分钟 | 90 天 | 个人站、测试环境、内部系统 |
| DV(付费) | 域名控制权 | 10 分钟 | 398 天 | 中小企业官网、博客 |
| OV | 企业工商信息 + 电话回访 | 1–2 工作日 | 398 天 | 电商、SaaS、需要展示企业主体的站点 |
| EV | 营业执照 + 企业电话 + DUNS 等 | 1–3 工作日 | 398 天 | 金融、政务、招投标场景(无绿色地址栏) |
| 通配符 | 域名控制权(DNS-01) | 10 分钟 | 398 天 | 多子域统一管理,不覆盖裸域与多级子域 |
部署方式对比:
| 方式 | 典型工具 | 续期 | 优点 | 风险点 |
|---|---|---|---|---|
| 手动上传 | 控制台 + scp | 人工 | 可控、适合内网 | 极易忘记续期 |
| ACME 自动 | certbot / acme.sh | cron 自动 | 零成本、全自动 | HTTP-01 需 80 端口可访问 |
| 面板一键 | 宝塔、1Panel | 自动 | 可视化、附带跳转配置 | 面板版本差异导致路径不一致 |
| CDN 托管 | 云厂商证书服务 | 平台托管 | 边缘卸载、支持国密/ECC | 回源段常被忽略 |
实践建议:面向公网的主站用 OV 或付费 DV + ACME 自动续期双轨;内网与测试环境一律 Let’s Encrypt;子域超过 5 个时改用通配符 + DNS-01 验证,可省去逐个签发的运维成本。
六、常见报错排查(含真实报错原文)
1. nginx: [emerg] PEM_read_bio_X509_AUX(...) failed (SSL: error:0909006C:PEM routines:get_name:no start line:Expecting: TRUSTED CERTIFICATE)
证书文件格式或内容错误:多为把私钥误填进 ssl_certificate,或复制时缺失 -----BEGIN CERTIFICATE----- 头。用 head -1 fullchain.pem 检查首行。
2. nginx: [emerg] 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.pem | openssl md5openssl rsa -noout -modulus -in example.com.key | openssl md5
两行 md5 必须相同,否则重签或找回原私钥。
3. curl: (60) SSL certificate problem: unable to get local issuer certificate
典型缺中间证书。用 openssl s_client -connect example.com:443 -servername example.com -showcerts 查看返回的证书条数,只有 1 条即为链不完整,把 chain.crt 拼接进 fullchain 后 reload。
4. 浏览器 NET::ERR_CERT_DATE_INVALID / ERR_CERT_COMMON_NAME_INVALID
前者是证书过期或服务器时间不准(timedatectl 校准 NTP);后者是访问的域名不在证书 SAN 列表中,例如只签了裸域却用 www 访问。
5. Mixed Content: The page at 'https://example.com/' was loaded over HTTPS, but requested an insecure resource 'http://cdn.example.com/a.js'. This request has been blocked.
这不是证书问题。全站检索硬编码:grep -rn 'http://' /var/www/example --include='*.html' --include='*.php' --include='*.css',改为 https:// 或协议相对 //;数据库中的富文本字段需单独 UPDATE;兜底可加 add_header Content-Security-Policy 'upgrade-insecure-requests';。
6. curl: (7) Failed to connect to example.com port 443: Connection refused
服务未监听或被拦截。依次查 ss -lntp | grep 443、systemctl status nginx、安全组与 firewalld 规则。
7. SSL_ERROR_RX_RECORD_TOO_LONG
用 https 访问了一个跑着 HTTP 服务的端口。常见于 CDN 回源协议配错,或 Nginx 把 443 写成了普通 listen 443;(缺 ssl 参数)。
七、部署后效果验证与续期监控
配置完成后不要只看浏览器绿锁,按下面四组命令逐项验证。
# 1) 跳转是否正确(应返回 301 且 Location 为 https)
curl -I http://example.com
# 2) 证书主体、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 3) 是否成功下发完整链(应看到至少 2 条证书)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
# 4) 弱协议必须握手失败
openssl s_client -connect example.com:443 -tls1_1 </dev/null 2>&1 | grep -i 'handshake failure'
再用浏览器访问 SSL Labs(https://www.ssllabs.com/ssltest/),目标评级 A 或 A+;若出现 B,多为仍支持 TLSv1.0/1.1 或使用 SHA-1 签名。注意:Let’s Encrypt 已于 2025 年停止提供 OCSP 响应,对 LE 证书开启 ssl_stapling on; 不会有实际收益,可关闭以减少握手开销。
续期监控是长期可靠性的关键,建议加两条巡检:
# 剩余有效期不足 30 天则返回非 0,可接入告警
openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/fullchain.pem || echo 'CERT EXPIRING'
# 每月演练一次自动续期流程
certbot renew --dry-run
systemctl list-timers | grep certbot # 确认定时器存在(新版 certbot 用 systemd timer 而非 cron)
最后做一次业务回归:登录、支付回调、上传、第三方 OAuth 回调地址,逐一确认没有因协议切换导致 302 死循环或回调失败。若站点同时服务国内与海外用户,建议开启 TLSv1.3 与 session ticket 复用,可将握手往返从 2-RTT 降至 1-RTT,移动端首屏收益明显。
常见问题
可以。Let’s Encrypt 签发的是 DV 证书,浏览器信任链与付费 DV 完全一致,加密强度相同,区别只在于无商业赔付承诺、有效期 90 天必须自动续期。面向公众的企业官网、电商前台完全够用;若合同或合规要求展示企业实名信息、需要发票与技术支持 SLA,再选 OV 或 EV。
自 2020 年 9 月 1 日起,Apple 与 Chrome 要求 TLS 服务器证书有效期不超过 398 天,CA 实际按 365 或 397 天签发;Let’s Encrypt 固定 90 天,2025 年起另提供 6 天短期证书选项。因此必须配置自动续期与到期告警,不能靠人工记日期。
可以,但两个域名都必须写进证书的 SAN 字段。申请时一起提交为多域名证书,或在 Nginx 中让两个 server_name 共用这张含双名字的证书。若只签了裸域,访问 www 会报 ERR_CERT_COMMON_NAME_INVALID。
不能。*.example.com 只匹配一级子域,如 a.example.com、b.example.com,不匹配 a.b.example.com,也不匹配裸域 example.com。需要覆盖多级子域时,应把具体域名逐个加入 SAN 列表,或分别签发多张通配符证书。
不需要。证书绑定的是域名而非 IP,迁移后把私钥与 fullchain.pem 一起搬到新环境即可。但若同时更换了私钥、原证书即将到期,或改用新的 CDN 节点,建议重新签发,并在新环境用 openssl s_client 完整验证一次证书链与协议版本。