跳到主要内容
HTTPS小程序证书

云服务器 SSL/TLS 证书申请与部署全流程:CSR 生成、Nginx/Apache/Tomcat 配置、CA 信任链与 FTP/MySQL 加固实战

一、问题背景与根因:证书“装了却不受信任”的六类原因

在阿里云、腾讯云、百度云的 ECS 上重装系统、网站搬家、迁移数据之后,运维最常遇到的情况是“证书明明装上去了,客户端却不认”,而不是“证书申请不下来”。典型表现有三类:Chrome 报 NET::ERR_CERT_AUTHORITY_INVALID;curl 报 curl: (60) SSL certificate problem: unable to verify the first certificate;Java 或 Python 客户端报 unable to find valid certification path to requested target。这些报错指向的根因高度集中,按出现频率排序如下。

  • 证书链不完整(占比最高)。只把服务器证书 example.com.crt 写进 ssl_certificate,没有拼接中间证书。桌面浏览器有 AIA 自动补链,所以看起来正常;但 Android、Java、微信小程序、部分 API 网关不会补链,会直接握手失败。
  • 证书与私钥不匹配。重新签发后私钥没换,或者从旧服务器复制了同名文件,Nginx 启动时就会报 key values mismatch。
  • SAN 未覆盖实际域名。只申请了 example.com,用户却访问 www.example.com,于是报 NET::ERR_CERT_COMMON_NAME_INVALID。
  • 服务器时间漂移。ECS 长时间关机后时钟停在过去,证书 notBefore 尚未生效,报 ERR_CERT_DATE_INVALID。
  • 验证通道被挡。安全组没放行 80 端口,或者 WAF 拦截了 /.well-known/acme-challenge/,导致 ACME 的 HTTP-01 校验失败。
  • 有效期政策变化带来的“过期潮”。公有 CA 证书最长有效期自 2020 年 9 月 1 日起为 398 天,Let’s Encrypt 为 90 天;CA/Browser Forum 已通过 SC-081,2026 年 3 月 15 日起降为 200 天,2027 年 3 月 15 日起降为 100 天,2029 年 3 月 15 日起降为 47 天。把续期当成“一年一次的活”,必然出问题。

排查第一步永远是先看服务端实际返回的证书链,而不是先改配置。下面三条命令可以在 1 分钟内判断属于上述哪一类:

# 1) 看服务端返回的证书链(是否只有 1 张)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E 'i:|s:'

# 2) 看有效期与 SAN
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -subject -issuer -dates -ext subjectAltName

# 3) 校验证书链能否被系统信任库验证通过
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted chain.pem example.com.crt

第 1 条命令如果只输出一个 s:(subject),而没有对应的中间证书签发者,基本可以判定链不完整;第 3 条返回 OK 才算真正闭环。后面所有章节都围绕“把这条链补齐并让客户端信任”展开。

二、前置准备:域名解析、时钟同步与 CSR 生成

证书申请失败有一半是准备工作没做。先确认三件事:域名 A 记录已指向 ECS 公网 IP 且已生效(dig +short example.com)、安全组放行 80/443、系统时钟与 NTP 同步(timedatectl set-ntp true && timedatectl status)。时间偏差超过几分钟,ACME 校验和 TLS 握手都会出问题。

然后是生成私钥与 CSR。私钥必须留在自己服务器上,CSR 才是交给 CA 的公开文件。推荐 RSA 2048 或 ECDSA P-256:

mkdir -p /etc/ssl/private/example.com && cd /etc/ssl/private/example.com
umask 077

# RSA 方案
openssl genrsa -out example.com.key 2048
# 或 ECDSA 方案(握手更快、证书更小)
# openssl ecparam -genkey -name prime256v1 -out example.com.key

# 生成 CSR,SAN 必须一次写全,通配符写作 *.example.com
openssl req -new -key example.com.key -out example.com.csr 
  -subj '/C=CN/ST=Shanghai/L=Shanghai/O=Example Tech/OU=Ops/CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com'

# 自检:CSR 签名有效、SAN 正确
openssl req -in example.com.csr -noout -verify
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
chmod 600 example.com.key && chown root:root example.com.key

几个必须注意的细节:CN 现在只作展示用,浏览器和 Java 客户端一律以 SAN 为准,所以 subjectAltName 必须写全所有要用的域名;-nodes 只用于需要免交互的自动化场景,手动签发不必加;私钥权限必须 600 且属主 root,否则 Nginx 虽能启动,但存在越权读取风险。CSR 生成后建议保存一份 openssl req -in example.com.csr -noout -text 的输出,日后核对 CA 是否签错 SAN 时用得上。

如果这台机器是内网环境、需要自建 CA,则跳过本章的公网申请流程,直接看第五章的根证书生成与信任库导入。

三、申请证书:Let’s Encrypt 自动化与商业 CA 两条路径

路径 A:Let’s Encrypt + certbot(免费、90 天、全自动)。适合绝大多数公网 Web 站点,是目前性价比最高的方案。

# Debian/Ubuntu
apt update && apt install -y certbot python3-certbot-nginx
# RHEL/CentOS/Alibaba Cloud Linux
dnf install -y certbot python3-certbot-nginx

# 先演练,确认 80 端口验证能通
certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com --dry-run

# 正式签发,自动改写 Nginx 配置并加 301 跳转
certbot --nginx -d example.com -d www.example.com 
  --agree-tos -m ops@example.com --redirect --keep-until-expiring

# 通配符必须走 DNS-01
certbot certonly --manual --preferred-challenges dns -d '*.example.com' -d example.com

签发成功后文件固定在 /etc/letsencrypt/live/example.com/:fullchain.pem(服务器证书+中间证书)、privkey.pem、chain.pem、cert.pem。Nginx 的 ssl_certificate 必须指向 fullchain.pem,这是新手最常踩的坑。续期由 certbot.timer 自动完成,验证与钩子配置如下:

systemctl list-timers | grep certbot
certbot renew --dry-run
# 续期后自动重载服务
printf '#!/bin/shnsystemctl reload nginxn' > /etc/letsencrypt/renewal-hooks/deploy/reload.sh
chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload.sh

注意 Let’s Encrypt 的限流:同一账号对同一主机名的失败验证为 5 次/小时,重复证书为 5 份/周,超限报 too many failed authorizations recently,此时只能等待,不要反复重试。另外,2025 年起 Let’s Encrypt 已停止 OCSP 响应,转为 CRL,配置里的 ssl_stapling on 对其证书不再产生实际效果。

路径 B:商业 CA(DV/OV/EV)。流程是提交 CSR → 域名或组织验证 → 下载证书包。以 DV 为例,CA 提供 DNS TXT 或文件验证,验证通过后下载的压缩包里通常有 example.com.crt(服务器证书)、ca_bundle.crt(中间证书)、以及可能由 CA 代生成的私钥(务必立即更换为自己的)。部署前先手工拼一次链并校验:

cat example.com.crt ca_bundle.crt > fullchain.pem
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt -untrusted ca_bundle.crt example.com.crt

返回 example.com.crt: OK 才说明链完整。不要把根证书拼进 fullchain,部分客户端会因链中出现自签根而报错。

四、部署配置示例:Nginx / Apache / Tomcat 三套可直接粘贴的配置

证书与私钥统一放到 /etc/nginx/ssl/example.com/ 这类专用目录,私钥 chmod 600、证书 chmod 644。Nginx 配置(含 HTTP 强制跳转与 TLS 1.2/1.3):

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/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: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;
    add_header X-Content-Type-Options nosniff always;

    root /var/www/html;
    index index.html;
}

改完执行 nginx -t && systemctl reload nginx,nginx -t 会直接暴露证书路径错误与私钥不匹配。Apache 2.4 对应写法:

<VirtualHost *:443>
    ServerName example.com
    SSLEngine on
    SSLCertificateFile      /etc/httpd/ssl/example.com.crt
    SSLCertificateKeyFile   /etc/httpd/ssl/example.com.key
    SSLCertificateChainFile /etc/httpd/ssl/ca_bundle.crt   # 2.4.8+ 可把中间证书直接拼进 SSLCertificateFile
    SSLProtocol             all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite          HIGH:!aNULL:!MD5:!3DES
    Header always set Strict-Transport-Security max-age=31536000
</VirtualHost>

校验命令是 apachectl configtest && systemctl reload httpd。Tomcat 不认 PEM,需要先转 PKCS12 再写 Connector:

openssl pkcs12 -export -out example.com.p12 -inkey example.com.key 
  -in fullchain.pem -name example.com -passout pass:changeit
<Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
           SSLEnabled="true" maxThreads="200" scheme="https" secure="true">
  <SSLHostConfig sslProtocol="TLS" protocols="TLSv1.2,TLSv1.3">
    <Certificate certificateKeystoreFile="/etc/tomcat/example.com.p12"
                 certificateKeystorePassword="changeit" certificateKeystoreType="PKCS12" />
  </SSLHostConfig>
</Connector>

需要强调:TLS 1.0/1.1 已被 RFC 8996 正式废弃,任何仍要求兼容旧协议的业务,应通过反向代理单独开一个受限入口,而不是把主站协议版本降回去。

五、CA 证书链与系统信任库:fullchain 拼接、根证书导入与 Java cacerts

服务端配置好只是“能加密”,客户端“敢不敢信”取决于本地信任库。三类对象必须分清:服务器证书(你的域名)、中间证书(CA 签发你的那张,必须随服务端下发)、根证书(内置在操作系统/浏览器,不要下发)。内网自建 CA 的完整流程如下:

# 1) 生成根 CA(有效期 10 年,私钥离线保存)
openssl req -x509 -newkey rsa:4096 -sha256 -days 3650 -nodes 
  -keyout ca.key -out ca.crt -subj '/CN=Example Internal Root CA/O=Example Tech/C=CN'

# 2) 用根 CA 签发服务器证书(注意 extendedKeyUsage 必须为 serverAuth)
openssl req -new -key example.com.key -out example.com.csr -subj '/CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
openssl x509 -req -in example.com.csr -CA ca.crt -CAkey ca.key -CAcreateserial 
  -days 825 -sha256 
  -extfile <(printf 'subjectAltName=DNS:example.com,DNS:www.example.comnextendedKeyUsage=serverAuthn') 
  -out example.com.crt

自签服务器证书的 -days 可以超过 398 天,但公有 CA 不行;内网证书建议不超过 825 天,便于轮换。导入系统信任库后,curl、wget、openssl 才会认这张证书:

# Debian/Ubuntu
cp ca.crt /usr/local/share/ca-certificates/example-internal-ca.crt
update-ca-certificates
# RHEL/CentOS/Alibaba Cloud Linux
cp ca.crt /etc/pki/ca-trust/source/anchors/example-internal-ca.crt
update-ca-trust extract
# 验证
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt example.com.crt

Java 应用不读系统信任库,必须单独导入 cacerts,否则连接内网 HTTPS 或 MySQL TLS 时一定报 PKIX path building failed:

keytool -importcert -noprompt -alias example-ca -file ca.crt 
  -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit
keytool -list -keystore $JAVA_HOME/lib/security/cacerts -storepass changeit | grep example-ca

其他运行时的等价配置:Python requests 用 REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt,Node.js 用 NODE_EXTRA_CA_CERTS=/path/ca.crt,Go 用 SSL_CERT_FILE。公网站点请勿使用自建 CA 对外服务,公网客户端不信任它,用户只会看到一片红色警告。

六、对比表格:证书类型、有效期政策与五种部署形态

选型前先看验证等级。DV 只验证域名控制权,OV 要核验企业工商信息,EV 还要电话回访等严格核验;主流浏览器早已取消绿色地址栏,EV 的“视觉溢价”不再存在,价值主要体现在合规审计上。

维度 DV 域名型 OV 企业型 EV 扩展验证
验证内容 仅域名控制权(DNS TXT / HTTP 文件) 域名 + 企业工商信息 域名 + 企业 + 电话回访等
签发时长 1-10 分钟(可全自动) 1-3 个工作日 3-7 个工作日
典型成本 免费(Let’s Encrypt)至数百元/年 千元级/年 数千元/年
浏览器展示 锁标 锁标 锁标(无绿色地址栏)
适用场景 博客、API、测试、中小站点 电商、企业官网、需合同背书 金融、支付等强合规场景

第二张表是有效期政策,它直接决定你必须做自动化续期,而不是手工换证书:

时间节点 公有 CA 单张证书最长有效期 依据
2020-09-01 起 398 天 现行规则
2026-03-15 起 200 天 CA/Browser Forum SC-081
2027-03-15 起 100 天 同上
2029-03-15 起 47 天 同上
Let’s Encrypt 90 天(另提供 6 天短期证书选项) ACME 自动化续期

第三张表是同一张证书在五种服务上的落盘格式与校验方式,迁移环境时最容易在这里出问题:

服务 证书格式 关键配置项 校验命令
Nginx PEM(fullchain + key) ssl_certificate / ssl_certificate_key nginx -t
Apache PEM(crt + key + chain) SSLCertificateFile / SSLCertificateChainFile apachectl configtest
Tomcat PKCS12 certificateKeystoreFile openssl s_client -connect ip:8443
MySQL PEM(ca/server-cert/server-key) ssl_ca / ssl_cert / ssl_key SHOW VARIABLES LIKE ‘have_ssl’
vsftpd PEM(单文件全链) rsa_cert_file / rsa_private_key_file openssl s_client -starttls ftp

结论很直接:398 天向 200 天、100 天、47 天演进,意味着“每年手动换一次证书”的运维模式彻底失效,必须把签发、部署、重载三步全部脚本化。

七、常见错误排查:9 条真实报错与对应处置

1. curl: (60) SSL certificate problem: unable to verify the first certificate——缺中间证书。执行 cat server.crt ca_bundle.crt > fullchain.pem 后 reload 即可。这是最高频的一条。

2. nginx: [emerg] SSL_CTX_use_PrivateKey("/etc/nginx/ssl/example.com.key") failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)——证书与私钥不配对。比对方法:

openssl x509 -noout -modulus -in fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5
# ECDSA 证书用公钥比对
openssl x509 -in fullchain.pem -noout -pubkey | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5

3. NET::ERR_CERT_COMMON_NAME_INVALID——SAN 未包含当前访问的域名,只能重签,不能靠改配置解决。

4. sslv3 alert handshake failure 或 SSL_ERROR_NO_CYPHER_OVERLAP——协议或套件不匹配。常见于只支持 TLS 1.0 的老设备,或客户端不支持 ECDSA 而站点只部署了 ECDSA 证书。用 openssl s_client -connect example.com:443 -tls1_2 逐版本定位。

5. Problem binding to port 80: Could not bind to IPv4 or IPv6.——certbot 的 standalone 模式与 Nginx 抢 80 端口。改用 --webroot -w /var/www/html,或先 systemctl stop nginx。

6. too many failed authorizations recently——Let’s Encrypt 限流触发,同一主机名每小时最多 5 次失败验证,只能等待,不要继续重试。

7. NET::ERR_CERT_DATE_INVALID——对比 date -u 与 openssl x509 -in fullchain.pem -noout -dates,前者偏差就校时,后者过期就续签。

8. MySQL ERROR 2026 (HY000): SSL connection error: unable to get local issuer certificate——客户端缺 --ssl-ca,或 CA 未导入客户端信任库;用自签证书时需显式指定 CA 文件。

9. vsftpd SSL: error:1408F10B:SSL routines:ssl3_get_record:wrong version number——客户端用明文 FTP 连了 FTPS 端口。FileZilla 需选择“要求显式 FTP over TLS”,命令行需 curl --ftp-ssl --ssl-reqd。

补充一条容易被忽略的:Let’s Encrypt 自 2025 年起停止提供 OCSP 响应,抓包看不到 stapling 属正常现象,不要据此判断证书有问题。

八、效果验证:从命令行到在线扫描的 5 步验收

配置改完不等于交付完成,必须按下面五步逐项验证,任何一步不通过都不算上线。

第 1 步:协议版本与套件。分别用 TLS 1.2 与 TLS 1.3 握手应成功,TLS 1.0 应失败:

openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep 'Protocol|Cipher'
openssl s_client -connect example.com:443 -servername example.com -tls1_3 </dev/null | grep 'Protocol|Cipher'
openssl s_client -connect example.com:443 -servername example.com -tls1   </dev/null   # 期望 handshake failure

第 2 步:证书链与有效期。openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -E 'i:|s:' 应至少输出两段 subject/issuer,说明中间证书已下发。

第 3 步:跳转与 HSTS。curl -sI http://example.com | head -3 应返回 301;curl -sI https://example.com | grep -i strict-transport-security 应看到 max-age=31536000。注意 HSTS 一旦下发不可撤回,首次上线建议先用 max-age=300 灰度。

第 4 步:套件枚举与评级。用 nmap --script ssl-enum-ciphers -p 443 example.com 或 testssl.sh --severity HIGH https://example.com 检查是否残留 RC4、3DES、CBC 套件。SSL Labs 拿 A 级的基本条件是:TLS 1.2+、链完整、启用 HSTS、无已知弱套件。

第 5 步:续期演练与业务复测。certbot renew --dry-run 必须成功,systemctl status certbot.timer 应为 active;再用 openssl s_client 相同参数复测小程序、APP 后端域名,并检查浏览器 Console 是否有 Mixed Content 告警。

九、配套加固:FTP 与 MySQL 的 TLS 配置

网站搬家常要临时开 FTP,用明文传输等于把密码写在公网上。vsftpd 开启显式 FTPS 的配置如下(/etc/vsftpd/vsftpd.conf):

ssl_enable=YES
rsa_cert_file=/etc/ssl/private/example.com/fullchain.pem
rsa_private_key_file=/etc/ssl/private/example.com/example.com.key
force_local_logins_ssl=YES
force_local_data_ssl=YES
ssl_tlsv1_2=YES
ssl_sslv2=NO
ssl_sslv3=NO
require_ssl_reuse=NO
pasv_enable=YES
pasv_min_port=30000
pasv_max_port=30100

重启后安全组需放行 21 端口与 30000-30100 被动端口段,验证命令:openssl s_client -connect 1.2.3.4:21 -starttls ftp,能看到证书链即为成功。注意 vsftpd 只接受单文件 PEM,链与证书必须提前合并。

MySQL 8.0 默认已自动生成自签证书并启用 TLS,但对外网连接应换成正式证书。在 my.cnf 中指定:

[mysqld]
ssl_ca=/etc/mysql/certs/ca.pem
ssl_cert=/etc/mysql/certs/server-cert.pem
ssl_key=/etc/mysql/certs/server-key.pem
require_secure_transport=ON
SHOW VARIABLES LIKE '%ssl%';              -- have_ssl 应为 YES
CREATE USER 'app'@'%' IDENTIFIED BY 'StrongPass!' REQUIRE SSL;
ALTER USER 'app'@'%' REQUIRE SSL;
FLUSH PRIVILEGES;

客户端连接必须显式校验证书:mysql -h db.example.com -u app -p --ssl-mode=VERIFY_CA --ssl-ca=/etc/mysql/certs/ca.pem;若要同时校验主机名,用 --ssl-mode=VERIFY_IDENTITY,此时证书 SAN 必须包含 db.example.com。连接后用 SHOW STATUS LIKE 'Ssl_cipher'; 检查,返回非空值(如 TLS_AES_256_GCM_SHA384)才代表链路真正加密。

常见问题

免费 Let’s Encrypt 证书和付费证书在浏览器里表现有区别吗?

没有区别。两者都是公有 CA 签发,浏览器只校验链是否可信、域名是否匹配、是否在有效期内,不会因为免费而降级展示。差异在于:Let’s Encrypt 只签发 DV,有效期 90 天,必须自动化续期,且不提供商业赔付与人工支持;商业 OV/EV 证书提供组织信息核验、发票与技术支持,适合有合规审计要求的业务。

证书最长有效期到底是 398 天还是 90 天?

两者都对,取决于 CA。398 天是 CA/Browser Forum 对公有 CA 单张证书的当前上限(2020 年 9 月 1 日起生效);Let’s Encrypt 自定的有效期是 90 天。按 SC-081 表决,公有 CA 上限将在 2026 年 3 月 15 日降为 200 天,2027 年 3 月 15 日降为 100 天,2029 年 3 月 15 日降为 47 天。自建内网 CA 不受此限制,但建议不超过 825 天。

为什么浏览器访问正常,Java 或小程序却报证书错误?

典型原因是证书链不完整。桌面浏览器支持 AIA(Authority Information Access)自动补拉中间证书,而 Java、Android 旧版本、微信小程序、多数 API 网关不会补链,只认服务端实际下发的证书。把中间证书拼进 fullchain 并重新下发即可解决,用 openssl s_client -showcerts 确认服务端确实返回了两段以上的证书。

换了服务器,旧证书能直接复制过去用吗?

可以,但必须同时复制证书与私钥,并保证私钥权限为 600、属主为运行服务的用户(如 nginx/root)。迁移后务必执行 nginx -t 与 openssl verify 复核,并用 openssl x509 -noout -modulus 与 openssl rsa -noout -modulus 的输出比对确认配对。如果新服务器换了域名,则需要重新签发,不能沿用。

通配符证书能覆盖几级域名?

一张 *.example.com 只覆盖一级子域,即 www.example.com、api.example.com 有效,而 a.b.example.com 与裸域 example.com 都不在覆盖范围内。要同时覆盖裸域,需在 SAN 中同时写 *.example.com 和 example.com;Let’s Encrypt 的通配符只能通过 DNS-01 验证签发。

HTTP-01 和 DNS-01 该怎么选?

站点能对公网开放 80 端口、且不需要通配符,优先 HTTP-01(配合 --webroot 最简单,不会中断 Nginx 服务)。需要通配符、80 端口被封、或者机器在 NAT/内网之后,则用 DNS-01,通过云解析 API 自动写入 TXT 记录,certbot 对应插件为 certbot-dns-aliyun、certbot-dns-tencentcloud 等。DNS-01 的唯一缺点是 TXT 记录生效有延迟,需预留 60-120 秒的传播等待。

内容审核

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