HTTPS 证书安装配置完整指南:CSR 生成、ACME 签发、Nginx/Apache/Tomcat 部署与排错
一、问题背景与根因:为什么没上 HTTPS 的站点正在被淘汰
微信小程序的 wx.request 只接受 HTTPS 域名,iOS 的 ATS(App Transport Security)默认阻断明文请求,Chrome/Edge 对 http:// 页面地址栏直接标注「不安全」,而 HTTP/2 与 HTTP/3 在主流服务端实现中本身就依赖 TLS。这不是「加分项」,而是准入条件。
根因有三条:其一,明文 HTTP 可被中间链路任意篡改,运营商注入、DNS 劫持插入广告页,本质都是因为没有加密与完整性校验,这也是所谓「苹果防广告劫持」的真实原理——上 HTTPS 并配合 HSTS 让注入无法落地;其二,身份无法验证,自签名证书无法证明你确实是 example.com,浏览器必然告警;其三,证书有效期在持续缩短,CA/Browser Forum SC-081 已明确:公开信任 TLS 证书最长有效期当前为 398 天,2026-03-15 起降为 200 天,2027-03-15 起降为 100 天,2029-03-15 起降为 47 天;Let’s Encrypt 则固定 90 天。任何「一年一签、到期手动换」的流程都会在半年内失效,必须自动化。
先做三条现状探测,判断你处在哪个阶段:
curl -sI http://example.com | head -1
curl -sI https://example.com | head -1
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -dates -ext subjectAltName
第一条返回 HTTP/1.1 200 说明 80 端口仍在直接提供内容;第二条报 curl: (7) Failed to connect 说明 443 未监听或被安全组拦截;第三条输出 notAfter 即为当前证书到期时间,若不足 30 天请立刻进入续期流程。
二、证书选型:DV/OV/EV 与单域名/多域名/通配符的边界
原文中「EV 证书浏览器地址栏直接显示公司名称」已过时:Chrome 77、Firefox 70 起已取消 EV 的绿色公司名 UI,所有证书在地址栏都只显示锁图标,公司主体信息只能在证书详情里查看。因此为「地址栏显示公司名」而购买 EV 已无意义,选型应回到验证强度与合规要求本身。
| 类型 | 验证内容 | 签发时长 | 地址栏表现 | 典型场景 |
|---|---|---|---|---|
| DV 域名型 | 仅域名控制权(DNS TXT / HTTP 文件 / 邮箱) | 1-10 分钟 | 锁图标 | 个人站、小程序后端、API 网关 |
| OV 企业型 | 域名 + 工商主体人工核验 | 1-5 个工作日 | 锁图标 | 企业门户、对外 SaaS |
| EV 增强型 | 更严格的主体与法律存在核验 | 3-7 个工作日 | 锁图标 | 金融、支付(多为内部合规要求) |
按覆盖范围划分更影响部署:单域名证书只保护 example.com,不包含 www;多域名(SAN)证书一张可挂最多 100 个不同域名;通配符 *.example.com 只覆盖一级子域,能覆盖 a.example.com,不能覆盖 a.b.example.com,也不能覆盖裸域 example.com,实践中通常签成 -d example.com -d *.example.com 两张 SAN 合并。
另一个高频坑:Common Name(CN)字段自 Chrome 58 起被完全忽略,浏览器只认 SAN 扩展。因此 CSR 阶段就必须写入 subjectAltName,否则证书装好了也会报域名不匹配。
三、第一步:生成私钥与 CSR(命令可直接执行)
私钥必须在自己的服务器上生成,绝不把私钥交给任何第三方。RSA 2048 兼容性最好,ECDSA P-256 体积更小、握手更快,现代客户端均支持。
# RSA 2048
openssl genrsa -out example.com.key 2048
# 或 ECDSA P-256(推荐新业务使用)
openssl ecparam -genkey -name prime256v1 -out example.com.key
# 生成 CSR,并把所有域名写进 SAN
openssl req -new -key example.com.key -out example.com.csr
-subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Co Ltd/CN=example.com"
-addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com"
# 校验 SAN 是否写入成功
openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name"
# 校验私钥与证书是否配对(部署后必做)
openssl x509 -noout -modulus -in example.com.crt | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5
两条 md5 输出必须完全一致,否则就是「证书与私钥不匹配」,Nginx 会直接启动失败。私钥权限必须收紧:
chmod 600 example.com.key
chown root:root example.com.key
ls -l example.com.key # -rw------- 1 root root
CSR 文件(.csr)本身不含私钥,可以安全提交给 CA;.key 一旦泄露,任何人可在任意服务器上冒充你的域名,务必纳入密钥管理,禁止提交进 Git。若使用 acme.sh / certbot 等 ACME 工具,可跳过手动 CSR,由工具自动生成密钥与 CSR。
四、第二步:域名验证与证书签发(acme.sh / certbot 实操)
DV 证书的验证方式决定你能否申请通配符:HTTP-01 文件验证只能签单域名,DNS-01 才能签通配符。DNS 验证的原理是在 _acme-challenge.example.com 添加一条 TXT 记录,值为 CA 给出的随机串。
# 手动确认 TXT 是否生效(生效后再点验证)
dig +short TXT _acme-challenge.example.com @8.8.8.8
nslookup -type=TXT _acme-challenge.example.com 223.5.5.5
推荐用 acme.sh 配合 DNS API 全自动签发(以阿里云 DNS 为例):
curl https://get.acme.sh | sh -s email=ops@example.com
source ~/.bashrc
export Ali_Key="LTAI********"
export Ali_Secret="********"
acme.sh --issue --dns dns_ali
-d example.com -d *.example.com
--keylength ec-256
若只有单域名且 80 端口可用,用 certbot 的 webroot 模式更简单:
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
# 证书路径:/etc/letsencrypt/live/example.com/fullchain.pem
两个关键注意点:(1) Let’s Encrypt 对「完全相同域名集合」限流为每周 5 次,反复调试会触发 too many certificates already issued for exact set of domains,调试阶段请加 --staging 或 --server https://acme-staging-v02.api.letsencrypt.org/directory。(2) 签发完成后一定要用 fullchain.pem(叶子证书 + 中间证书),只用 cert.pem 会在 Android 旧版本与部分 Java 客户端上报「无法获取本地颁发者证书」。
五、第三步:Nginx / Apache / Tomcat 配置示例与 443 端口放行
Nginx 是当前最主流的终止点,配置里同时完成 HTTP→HTTPS 301 跳转、TLS 1.2/1.3、HSTS 与 OCSP Stapling:
server {
listen 80;
server_name example.com www.example.com;
return 301 https://$host$request_uri;
}
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/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;
ssl_stapling on;
ssl_stapling_verify on;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
}
Apache 2.4.8 之后 SSLCertificateChainFile 已废弃,中间证书直接拼接进 SSLCertificateFile:
<VirtualHost *:443>
ServerName example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.fullchain.pem
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security "max-age=31536000"
</VirtualHost>
Tomcat 需要先转成 PKCS12:
- APP/小程序 HTTPS · SSL网站加密证书 · CA证书配置
- NGINX / APACHE / TOMCAT / IIS 证书配置 · SSL证书安装
- 服务器维护 · 网站代维护 · 服务器托管代维
openssl pkcs12 -export -in fullchain.pem -inkey example.com.key
-name tomcat -out example.com.p12
# server.xml
<Connector port="443" protocol="org.apache.coyote.http11.Http11NioProtocol" SSLEnabled="true">
<SSLHostConfig>
<Certificate certificateKeystoreFile="conf/example.com.p12"
certificateKeystoreType="PKCS12"
certificateKeystorePassword="YourPass" type="RSA" />
</SSLHostConfig>
</Connector>
云上 ECS 必须额外放行入方向 TCP 443(HTTP-01 验证还需 80),否则配置全对也连不上:
firewall-cmd --add-service=https --permanent && firewall-cmd --reload
ufw allow 443/tcp && ufw allow 80/tcp
ss -lntp | grep -E ':443|:80'
nginx -t && nginx -s reload
六、方案对比:免费 ACME、商业 DV、云托管证书怎么选
原文把「一年有效期证书」当作卖点,如今这个卖点已经不存在——所有公开信任证书都受 398 天上限约束,且很快降到 200 天、100 天。选型应看自动化能力与支持服务,而不是看有效期长短。
| 方案 | 有效期 | 成本 | 自动化 | 适合谁 |
|---|---|---|---|---|
| Let’s Encrypt / ZeroSSL(ACME) | 90 天 | 免费 | 原生支持,cron 自动续期 | 绝大多数站点、API、测试环境 |
| 商业 DV | ≤398 天 | 数百元/年 | 需 API 或手动 | 需要工单支持、OCSP 稳定性保障 |
| 商业 OV/EV | ≤398 天 | 数千元/年 | 多为手动 | 金融、政企合规审计 |
| 云厂商托管证书(CLB/CDN) | 跟随签发方 | 免费额度 + 按量 | 控制台一键部署、自动续期 | 已上云、不想运维证书文件 |
| 自签名证书 | 自定义 | 免费 | 脚本生成 | 仅内网测试,公网必然告警 |
再补充一张 TLS 协议版本对照,方便你判断兼容性取舍:
| 协议 | 状态 | 建议 |
|---|---|---|
| TLS 1.3 | RFC 8446,握手 1-RTT | 必须开启 |
| TLS 1.2 | 仍广泛兼容 | 保留,作为兜底 |
| TLS 1.1 / 1.0 | 已被主流浏览器弃用 | 关闭 |
| SSLv3 及以下 | POODLE 漏洞 | 绝对关闭 |
结论:除非有明确的合规或商务支持需求,DV 证书 + ACME 自动续期是性价比最高的组合;把预算花在监控与自动化上,比花在证书等级上收益更高。
七、常见错误排查(含真实报错信息)
以下报错均来自真实生产环境,按「报错 → 根因 → 修复」对照排查:
| 报错信息 | 根因 | 修复 |
|---|---|---|
curl: (60) SSL certificate problem: unable to get local issuer certificate |
只部署了叶子证书,缺中间证书 | 改用 fullchain.pem,或把 intermediate.crt 追加到 crt 末尾 |
NET::ERR_CERT_COMMON_NAME_INVALID / SSL_ERROR_BAD_CERT_DOMAIN |
证书 SAN 中没有该域名(如漏了 www) | 重新签发并写入完整 SAN 列表 |
curl: (60) no alternative certificate subject name matches target host name |
用 IP 或子域访问了单域名证书 | 补签域名或改用通配符证书 |
nginx: [emerg] cannot load certificate "/etc/nginx/ssl/fullchain.pem": BIO_new_file() failed |
路径错误、文件不存在或 nginx worker 无读权限 | ls -l 确认路径;目录 755、证书 644、私钥 600 |
nginx: [emerg] SSL_CTX_use_PrivateKey(...) failed (SSL: key values mismatch) |
证书与私钥不是同一对 | 用上文 modulus md5 比对,重新匹配 |
NET::ERR_CERT_DATE_INVALID |
证书已过期,或服务器系统时间偏差 | timedatectl 校时;立即续期 |
Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure element 'http://...' |
页面内引用 http 图片/JS/CSS | 资源改 https,或加 Content-Security-Policy: upgrade-insecure-requests |
curl: (7) Failed to connect to example.com port 443: Connection timed out |
安全组/防火墙未放行,或服务未监听 | ss -lntp | grep 443 + 放行入方向 TCP 443 |
too many certificates already issued for exact set of domains |
Let’s Encrypt 每周 5 次同域名集限流 | 换 staging 环境调试,或等待一周 |
nginx: [warn] the "ssl" directive is deprecated, use the "listen ... ssl" directive |
使用了旧版 ssl on; |
删除该行,改为 listen 443 ssl; |
排查顺序建议固定为:端口连通性 → 证书链完整性 → 域名匹配 → 有效期 → 混合内容。用 openssl s_client -connect example.com:443 -servername example.com 观察输出中的 Verify return code,返回 0 (ok) 才算链完整;返回 20 (unable to get local issuer certificate) 就是缺中间证书,返回 10 (certificate has expired) 就是过期。
八、效果验证与续期自动化
部署完成不等于结束,必须做闭环验证。第一组命令验证证书本身:
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates -ext subjectAltName
# 期望:subjectAltName 含全部域名;notAfter 在未来 30 天以上
第二组验证协议与重定向行为:
curl -sI http://example.com | head -3 # 期望 301 且 Location 为 https
curl -sI https://example.com | head -3 # 期望 200 或 301,无证书告警
curl -I --tls-max 1.1 https://example.com # 期望失败:error:0A000102:SSL routines::unsupported protocol
openssl s_client -connect example.com:443 -tls1_1 </dev/null # 期望 handshake failure
第三组把续期做成自动化,这是 90 天与 200 天有效期时代的必选项。acme.sh 用 --install-cert 把证书安装到目标路径并绑定 reload 钩子:
acme.sh --install-cert -d example.com --ecc
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.fullchain.pem
--reloadcmd "nginx -t && nginx -s reload"
# certbot 方案:确认 timer 存在并演练续期
systemctl list-timers | grep certbot
certbot renew --dry-run
最后做一次外部体检:Qualys SSL Labs 应达到 A 或 A+;同时用手机 4G 网络访问一次,确认不是内网 DNS 造成的「本地正常、外网异常」。若使用 CDN 或负载均衡,证书需在 CDN 侧与源站同时部署,且回源协议选 HTTPS,否则源站到 CDN 仍是明文。建议再配一条到期监控:
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -checkend 2592000 # 30 天内到期则返回非 0
把这条命令接入定时任务或监控系统,就能在证书过期前收到告警,彻底避免「节假日证书过期导致全线 502」这类事故。
常见问题
SSL 证书最长有效期到底是多久?
目前公开信任的 TLS 证书最长有效期为 398 天(2020 年 9 月起生效)。按 CA/Browser Forum SC-081 决议,2026-03-15 起降至 200 天,2027-03-15 起降至 100 天,2029-03-15 起降至 47 天。Let’s Encrypt 一直固定为 90 天。任何宣传「多年期证书」的说法,实质都是同一张证书多次重签,仍需按期更换,因此务必配置自动续期。
通配符证书能覆盖多级子域吗?
不能。*.example.com 只匹配一级子域,如 a.example.com、api.example.com,不匹配 a.b.example.com,也不匹配裸域 example.com。若要同时保护裸域和所有一级子域,需在 CSR 与签发命令中同时写 -d example.com -d *.example.com;多级子域只能逐个列入 SAN 或为每级单独签通配符。
HTTP 到 HTTPS 的 301 跳转和 HSTS 应该怎么配?
先在 Nginx/Apache 中配置 80 端口的 return 301 https://$host$request_uri,确认全站资源均为 HTTPS 后,再加 Strict-Transport-Security: max-age=31536000; includeSubDomains。切勿在还有 http 子域服务时直接加 includeSubDomains 与 preload,否则这些子域会被浏览器强制走 HTTPS 而无法访问;建议先用 max-age=300 观察,再逐步放大。
证书装好后浏览器仍提示不安全,最可能是什么原因?
按概率排序:一是缺中间证书导致链不完整(Verify return code: 20);二是页面存在混合内容,HTTPS 页面加载了 http 图片或脚本;三是证书 SAN 未包含当前访问的域名(常见于漏了 www);四是服务器系统时间偏差触发 NET::ERR_CERT_DATE_INVALID;五是 CDN 边缘节点仍缓存旧证书。用 openssl s_client 与浏览器开发者工具的 Security 面板可逐项定位。
免费的 Let’s Encrypt 证书和付费 DV 证书有区别吗?
在浏览器信任层面没有区别,两者都由受信任根 CA 签发,加密强度相同,都能消除「不安全」提示并满足小程序要求。差异在于:免费证书有效期 90 天、依赖自动化续期、无人工工单与赔付承诺;付费 DV 通常提供更长的 398 天有效期、商业支持与更高的签发稳定性保障。对绝大多数站点,免费证书 + 自动续期监控是更优解。
部署 HTTPS 需要开放哪些端口?
业务访问只需入方向 TCP 443。若使用 HTTP-01 文件验证签发或续期,还需开放 80;若使用 DNS-01 验证(推荐,可签通配符),则无需开放 80。云服务器除系统防火墙(firewalld/ufw)外,还必须在安全组入方向放行对应端口,否则会出现 curl: (7) Failed to connect ... port 443: Connection timed out。