跳到主要内容
ssl证书按装

HTTPS 证书安装配置完整指南:CSR 生成、ACME 签发、Nginx/Apache/Tomcat 部署与排错

HTTPS 证书安装配置完整指南:CSR 生成、ACME 签发、Nginx/Apache/Tomcat 部署与排错 — 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:

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。

内容审核

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