跳到主要内容
ssl证书按装

HTTPS 开启 SSL 证书部署完整指南:申请、Nginx/Apache/IIS 配置、排错与验证

HTTPS 开启 SSL 证书部署完整指南:申请、Nginx/Apache/IIS 配置、排错与验证 — HTTPS 开启 SSL 证书部署完整指南:申请、Nginx/Apache/IIS 配置、排错与验证

一、问题背景与根因:HTTPS 不是只装一张证书

很多旧教程和代部署文案仍写“免费 SSL 证书有效期一年”,这在公共信任 TLS 证书场景已经过时。CA/Browser Forum 规则下,公共 TLS 证书有效期上限曾为 398 天,但 2026-03-15 起已缩短为 200 天,2027-03-15 起进一步缩短为 100 天;Let’s Encrypt 仍为 90 天,阿里云、腾讯云等免费 DV 证书通常为 90 天或 3 个月,且多为单域名,具体以控制台为准。HTTPS 开启失败的根因通常不是“没点开启按钮”,而是域名匹配、证书有效期、信任链完整性、私钥匹配、协议与端口监听这五类问题之一。

原文提到代申请、代配置 Apache、Nginx、IIS,并要求提供服务器账号密码。技术上可以代部署,但安全做法是先做快照或备份,再提供临时 sudo 账号或 SSH key,限定可登录来源 IP,部署完成后立即禁用。不要长期提供 root 密码。代申请证书还需要域名解析权限,DNS-01 验证通常要添加 TXT 记录,操作时间约 10~15 分钟;HTTP-01 验证则要求 80 端口可访问且 Web 根目录可写。

部署前先确认证书文件:openssl x509 -noout -dates -subject -issuer -in /etc/nginx/ssl/example.com.fullchain.pem。重点看 Not Before、Not After、Subject 的 CN/SAN 是否包含实际访问域名,Issuer 是否受信任。Nginx 必须配置 fullchain 而不是仅站点证书,否则部分安卓、Java 客户端会报证书链不完整。HTTPS 是 TLS 握手、证书链、私钥、SNI、防火墙和 Web 配置共同作用的结果,任何一环错误都会表现为浏览器警告或 curl 失败。

二、申请证书:Let’s Encrypt 与云厂商免费证书

推荐优先使用 acme.sh 自动化申请 Let’s Encrypt 证书,有效期 90 天,可自动续期。安装并签发:

curl https://get.acme.sh | sh -s email=admin@example.com
source ~/.bashrc
acme.sh --issue -d example.com -d www.example.com --webroot /var/www/html
acme.sh --install-cert -d example.com --key-file /etc/nginx/ssl/example.com.key --fullchain-file /etc/nginx/ssl/example.com.fullchain.pem --reloadcmd 'systemctl reload nginx'

如果使用 DNS 验证,可申请通配符证书,例如阿里云 DNS API 场景:export Ali_Key=你的Key; export Ali_Secret=你的Secret; acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'。DNS 记录生效后 acme.sh 会自动写入续期任务。检查续期:crontab -l | grep acme 或 systemctl list-timers | grep acme,并用 acme.sh --cron --force 做一次强制演练。

云厂商免费证书适合单域名测试或短期业务:在控制台申请 DV 证书,完成 DNS 或文件验证后,下载 Nginx 格式通常得到 .pem 和 .key,下载 IIS 格式通常得到 .pfx。若使用自有 CSR,可执行:openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/CN=example.com',提交 CSR 后保存私钥。注意免费证书不是一年有效,必须设置到期提醒;商业 OV/EV 证书也要按当前 200 天上限规划续期,不能再按 398 天旧规则排期。

三、Nginx 完整配置示例:HTTP 跳转与 TLS 参数

以下配置包含 80 跳转、443 监听、TLS 1.2/1.3、fullchain 证书和 HSTS。HSTS 首次上线建议先用较短 max-age 测试,确认全站 HTTPS 后再逐步加长。

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/example.com.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-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305';
    ssl_prefer_server_ciphers off;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;
    add_header Strict-Transport-Security 'max-age=31536000' always;
    root /var/www/html;
    index index.html;
}

执行 nginx -t && systemctl reload nginx。若 Nginx 版本低于 1.25.1,http2 on; 可能不识别,可改为 listen 443 ssl http2;。私钥权限建议 chmod 600 /etc/nginx/ssl/example.com.key,属主为 root。证书路径必须绝对路径,且 Nginx worker 进程可读。配置多个站点时,每个 443 server 块都要有证书和 key,或使用默认证书兜底;SNI 场景下客户端不带 SNI 时会落到默认 server,容易看到错误证书。

四、Apache 与 IIS 配置示例

Apache 2.4 先启用模块:a2enmod ssl rewrite && apachectl configtest && systemctl reload apache2。虚拟主机示例:

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile /etc/apache2/ssl/example.com.fullchain.pem
    SSLCertificateKeyFile /etc/apache2/ssl/example.com.key
    RewriteEngine On
    RewriteCond %{HTTPS} !=on
    RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]
</VirtualHost>

Apache 2.4.8 及以上通常把站点证书和中间证书合并到 fullchain 文件即可,不再单独写 SSLCertificateChainFile。若仍使用旧版本,需要额外配置中间证书。IIS 需要导入包含私钥和完整链的 PFX。PowerShell 示例:

$pwd = ConvertTo-SecureString -String 'PfxPassword' -AsPlainText -Force
$cert = Import-PfxCertificate -FilePath C:/ssl/example.com.pfx -CertStoreLocation Cert:\LocalMachine\My -Password $pwd
New-WebBinding -Name 'Default Web Site' -Protocol https -Port 443 -HostHeader 'example.com' -SslFlags 1
(Get-WebBinding -Name 'Default Web Site' -Protocol https -HostHeader 'example.com').AddSslCertificate($cert.Thumbprint,'my')
netsh http show sslcert hostnameport=example.com:443

IIS 常见问题是只导入了站点证书,没有把中间证书放入 Intermediate Certification Authorities,导致部分客户端链不完整。PFX 导出时应勾选包含私钥和证书链。绑定后必须用 netsh http show sslcert 确认证书哈希与绑定端口一致。Apache 和 IIS 修改配置后都要先做语法检查,再 reload 或重启,避免直接中断线上 HTTPS。

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

方案 有效期 验证方式 续期 适用场景
Let’s Encrypt 90 天 HTTP-01 或 DNS-01 acme.sh 自动 个人站、生产站、通配符
云厂商免费 DV 通常 90 天或 3 个月 DNS 或文件 控制台/API 手动或自动 单域名测试、短期业务
商业 DV/OV/EV 当前上限 200 天,2027-03-15 起 100 天 域名/组织验证 手动或 ACME 企业品牌、合规场景
自签名证书 自定义 无公共验证 手动 内网、测试,不适合公网
部署方式 需要提供 风险控制 建议
自助部署 服务器登录权限 自行审计命令 首选,便于长期维护
代部署 临时账号或 SSH key、域名解析权限 先快照、限 IP、部署后禁用 急事可协商时间,不建议给长期 root 密码

原文“免费证书有效期一年”的说法必须修正:公共信任证书不再按一年规划,Let’s Encrypt 为 90 天,云免费 DV 多为 90 天/3 个月。398 天是旧上限,2026-03-15 起已进入 200 天阶段。选择方案时不要只看价格,要看自动续期能力、证书链完整性、是否支持通配符、是否能通过 API 更新。生产站优先 Let’s Encrypt 加 acme.sh,或使用云厂商 ACME/API 自动续期;内网可用自签但必须把根证书分发到客户端信任库。

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

  • curl: (60) SSL certificate problem: unable to get local issuer certificate:多为缺中间证书。Nginx 的 ssl_certificate 要指向 fullchain.pem,而不是仅 cert.pem。用 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 查看返回链数量。
  • NET::ERR_CERT_DATE_INVALID:证书过期或服务器时间错误。执行 openssl x509 -noout -dates -in fullchain.pem,并用 date -u 检查系统时间。
  • nginx: [emerg] cannot load certificate ... PEM_read_bio_X509_AUX:no start line:路径错误、文件不是 PEM 或权限不足。执行 ls -l、head -1 fullchain.pem,确认首行是 BEGIN CERTIFICATE。
  • AH02565: Certificate and private key do not match:证书和私钥不匹配。分别执行 openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in key.pem | openssl md5,两个哈希必须一致。
  • SSL_ERROR_RX_RECORD_TOO_LONG:443 端口实际跑的是 HTTP 或反向代理协议错。检查 ss -lntp | grep ':443' 和 Nginx 是否写了 listen 443 ssl;。
  • IIS 绑定后仍提示证书错误:用 netsh http show sslcert hostnameport=example.com:443 核对哈希,并确认中间证书已导入 Intermediate Certification Authorities。

排查顺序建议从外到内:先用 curl 和 openssl 看握手与证书链,再看 Web 配置语法,最后看防火墙、安全组和 CDN。若使用 CDN,证书要同时部署在源站和 CDN,否则回源可能报 526 或证书不匹配。混合内容问题看浏览器 Console 的 Mixed Content 报错,需把 http:// 资源改为 https:// 或相对协议。

七、效果验证与上线检查清单

部署完成后执行以下验证:curl -I https://example.com 应返回 200 或业务正常状态码;curl -I http://example.com 应返回 301 并跳转到 https;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' 确认监听。再用浏览器开发者工具查看 Security 面板,确认无混合内容、证书链完整。

检查自动续期:systemctl list-timers | grep acme 或 crontab -l | grep acme,并执行 acme.sh --cron --force 演练。续期后必须 reload Web 服务,否则旧证书仍在内存中。HSTS 首次上线建议 max-age=300 观察,再改 31536000;开启 includeSubDomains 前确认所有子域都支持 HTTPS。最后做快照并记录证书路径、到期日、续期命令和回滚步骤。

常见问题

不能按一年规划。公共信任 TLS 证书旧上限 398 天已过时,2026-03-15 起上限 200 天,2027-03-15 起 100 天;Let’s Encrypt 为 90 天,云厂商免费 DV 通常 90 天或 3 个月,必须自动续期。

不必。建议先做快照,提供临时 sudo 账号或 SSH key,限制来源 IP,部署后立即禁用。代申请还需 DNS 解析权限,可临时授权 TXT 记录,完成后回收权限。

通常是缺中间证书。Nginx 的 ssl_certificate 要指向 fullchain.pem,包含站点证书和中间证书;Apache 用合并后的 fullchain,IIS 把中间证书导入 Intermediate Certification Authorities。

分别对证书和私钥取 modulus 哈希:openssl x509 -noout -modulus -in cert.pem | openssl md5 与 openssl rsa -noout -modulus -in key.pem | openssl md5,两个结果一致才匹配。

Let’s Encrypt 支持通配符,但必须用 DNS-01 验证,且通配符只覆盖一级子域;多域名可在一张证书里写多个 SAN。云厂商免费 DV 多为单域名,是否支持多域名以控制台产品说明为准。

内容审核

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