网站 HTTPS 全流程实战:SSL 证书申请、域名验证、Nginx/Apache/IIS 安装配置与故障排查
本文把「网站提示不安全」这件事拆成可执行的工程流程:先定位根因,再申请证书、完成域名验证、安装配置、验证生效,最后给出真实报错与修复命令。全部命令可直接复制执行。
一、为什么浏览器提示“不安全”:HTTPS 缺失的四类根因
地址栏出现红色“不安全”,本质上只有两种可能:一是站点仍在用 http:// 明文传输,二是 TLS 握手虽然建立,但证书校验没有通过。前者缺的是加密通道,后者缺的是身份信任。
HTTP 明文传输时,账号密码、Cookie、订单数据会以明文形式经过链路上的每一个代理、路由器和运营商缓存设备,可被截获甚至篡改。部署 SSL 证书后,客户端与服务器先通过 TLS 握手协商会话密钥(TLS 1.3 为 1-RTT,会话恢复可 0-RTT),后续业务数据全部走对称加密(AES-128-GCM / ChaCha20-Poly1305),中间节点只能看到密文。
证书校验失败的四类根因,覆盖了实际故障的 90% 以上:
- 证书链不完整:只部署了服务器证书,漏掉中间证书(Intermediate CA),Android、Java 客户端、curl 直接报
unable to get local issuer certificate; - 域名不匹配:只签了
example.com,用户访问www.example.com;现代浏览器只校验 SAN 扩展,不看 CN; - 证书过期:服务器时间错误或忘记续期,报
NET::ERR_CERT_DATE_INVALID; - 根证书不受信任:使用自签名证书或内部 CA,浏览器报
NET::ERR_CERT_AUTHORITY_INVALID。
另外两类高频问题是:混合内容(Mixed Content),页面本身是 https,但图片、JS、CSS 仍以 http 加载;协议错配,用 https 访问了 80 端口,Firefox 报 SSL_ERROR_RX_RECORD_TOO_LONG。
关于有效期,务必更新认知:CA/Browser Forum 规定,2020 年 9 月 1 日起签发的公开信任 SSL/TLS 证书最长有效期不得超过 398 天(此前为 825 天);Let’s Encrypt 免费证书固定 90 天,官方建议每 60 天续期。CA/B Forum 已通过决议,公开信任证书的最长有效期将继续缩短至 200 天、100 天、最终 47 天,因此手工续期必然失效,自动化续期是唯一可行方案。
二、申请前准备:生成 CSR、保护私钥、选对域名验证方式
商业证书(阿里云、腾讯云、DigiCert、Sectigo 等)申请时需要提交 CSR;Let’s Encrypt 由 ACME 客户端自动生成密钥对,可跳过此步。生成 2048 位 RSA 私钥与 CSR 的命令如下(OpenSSL 1.1.1+ 支持 -addext):
# 1. 生成私钥(务必 600 权限,绝不可外泄)
openssl genrsa -out example.com.key 2048
chmod 600 example.com.key
# 2. 生成 CSR,注意 SAN 必须写全所有要用的域名
openssl req -new -key example.com.key -out example.com.csr
-subj '/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Ltd/CN=example.com'
-addext 'subjectAltName=DNS:example.com,DNS:www.example.com'
# 3. 校验 CSR 内容
openssl req -in example.com.csr -noout -text | grep -A1 'Subject Alternative Name'
若使用 ECDSA(握手更快、证书更小),把第一行换成 openssl ecparam -genkey -name prime256v1 -out example.com.key,其余不变。私钥一旦泄露,任何人可冒充你的站点,因此不要放进代码仓库、不要用聊天工具传输,签发完成后建议 shred -u 删除 CSR 之外的中转文件。
域名验证方式决定了能否自动化,选错会导致续期必须人工介入:
| 验证方式 | 依赖条件 | 支持通配符 | 需要停机 | 自动化难度 |
|---|---|---|---|---|
| HTTP-01 | 80 端口公网可达,返回指定 token 文件 | 否 | 否 | 低(certbot 一键) |
| DNS-01 | 添加 _acme-challenge TXT 记录 |
是 | 否 | 中(需 DNS API) |
| 文件验证 | 网站根目录写入指定文件 | 否 | 否 | 低 |
| 邮件验证 | 接收 admin@ / administrator@ 邮件 | 否 | 否 | 高(纯人工) |
结论:单域名或固定子域用 HTTP-01 最省事;需要泛域名 *.example.com,或源站 80 端口不对外开放(如仅走 CDN 回源),必须用 DNS-01。
三、证书申请与签发:免费 ACME 与商业证书两条路径
路径 A:Let’s Encrypt 免费证书(推荐用于绝大多数站点)
# 安装 certbot(以 nginx 为例)
sudo apt install certbot python3-certbot-nginx -y # Debian/Ubuntu
sudo dnf install certbot python3-certbot-nginx -y # RHEL 系
# 一键签发并自动改写 nginx 配置、强制跳转
sudo certbot --nginx -d example.com -d www.example.com
--agree-tos -m ops@example.com --redirect
# 只签证书不改配置(webroot 方式,适合已有站点)
sudo certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com --agree-tos -m ops@example.com
如果使用 acme.sh(对国产 DNS 厂商 API 支持更全,适合泛域名):
curl https://get.acme.sh | sh -s email=ops@example.com
# 阿里云 DNS 自动验证(需先 export Ali_Key / Ali_Secret)
~/.acme.sh/acme.sh --issue --dns dns_ali -d example.com -d '*.example.com'
# 安装到指定路径并设置续期后自动 reload
~/.acme.sh/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 'nginx -s reload'
路径 B:商业证书。在云厂商证书控制台购买后,粘贴第二步生成的 CSR 与域名,选择 DNS 验证(系统自动写入 TXT 记录),等待签发(DV 分钟级,OV/EV 需 1–7 个工作日人工核验),再下载 Nginx 格式压缩包。注意包里通常有 4 个文件:example.com.pem(含证书链)、example.com.key(私钥)、chain.pem、public.pem,Nginx 的 ssl_certificate 应指向含链的 pem。
四、安装配置:Nginx、Apache、IIS 三套可直接复制的配置
Nginx(/etc/nginx/conf.d/example.com.conf):
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-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;
ssl_stapling on; # 商业证书可开;Let's Encrypt 已于 2025 年停止 OCSP,可关闭
ssl_stapling_verify on;
ssl_trusted_certificate /etc/nginx/ssl/example.com.chain.pem;
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 && nginx -s reload。
Apache(2.4):
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
ServerName example.com
ServerAlias www.example.com
SSLEngine on
SSLCertificateFile /etc/httpd/ssl/example.com.crt
SSLCertificateKeyFile /etc/httpd/ssl/example.com.key
SSLCertificateChainFile /etc/httpd/ssl/example.com.chain.crt
SSLProtocol -all +TLSv1.2 +TLSv1.3
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
Header always set Strict-Transport-Security 'max-age=31536000'
</VirtualHost>
Apache 2.4.8 之后 SSLCertificateChainFile 已废弃,可直接把链拼进 SSLCertificateFile 指向的文件。IIS 需要先合并为 PFX,再在 Windows 上导入绑定:
openssl pkcs12 -export -out example.com.pfx
-inkey example.com.key -in example.com.fullchain.pem
-passout pass:YourPfxPassword
certutil -f -p YourPfxPassword -importpfx C:sslexample.com.pfx
netsh http show sslcert
netsh http add sslcert ipport=0.0.0.0:443 certhash=<证书指纹> appid={4dc3e181-e14b-4a21-b022-59fc669b0914}
IIS 也可在“服务器证书 → 导入”中完成,然后在站点“绑定 → https → SSL 证书”下拉选择,效果等价。
五、证书链、私钥匹配与自动续期:三个最容易出问题的细节
细节 1:证书链必须完整。用系统根证书库独立校验一次,OK 才算链完整:
openssl verify -CAfile chain.pem -untrusted chain.pem example.com.crt
# 期望输出:example.com.crt: OK
# 若报 unable to get local issuer certificate,说明缺中间证书
细节 2:私钥与证书必须配对。比对公钥摘要,两个值必须完全一致:
openssl x509 -noout -pubkey -in example.com.crt | openssl md5
openssl pkey -in example.com.key -pubout | openssl md5
不一致时 Nginx 会直接启动失败并报 X509_check_private_key:key values mismatch,通常是多套证书文件混用导致。
细节 3:续期必须演练。certbot 默认自带 systemd timer,acme.sh 默认写入 crontab,先确认任务存在,再执行一次 dry-run:
systemctl list-timers | grep certbot
certbot renew --dry-run # 只模拟,不真正签发
crontab -l | grep acme # acme.sh 检查
~/.acme.sh/acme.sh --cron # 手动触发一次续期逻辑
常见坑:HTTP-01 续期要求 80 端口仍可访问,若后来把 80 全部 301 到 443 且未给 /.well-known/acme-challenge/ 放行,续期会失败;此时在 80 的 server 块中加 location ^~ /.well-known/acme-challenge/ { root /var/www/html; },或改用 DNS-01。续期成功后必须 reload,否则进程仍加载旧证书——certbot 的 nginx 插件会自动处理,acme.sh 需靠 --reloadcmd。
六、方案对比:证书类型、部署位置怎么选
证书类型直接决定审核成本与信任背书,而加密强度(RSA 2048 / ECDSA P-256)在 DV、OV、EV 之间并无差别:
| 类型 | 验证内容 | 签发时长 | 有效期上限 | 典型场景 |
|---|---|---|---|---|
| DV 域名型 | 仅验证域名控制权 | 分钟级 | 398 天 | 博客、API、测试环境 |
| OV 企业型 | 域名 + 工商主体核验 | 1–3 工作日 | 398 天 | 企业官网、电商、SaaS |
| EV 扩展验证 | 严格人工尽调 | 3–7 工作日 | 398 天 | 金融、政务(浏览器已不再显示绿色公司名) |
| 通配符 | DNS-01 验证主域 | 分钟级 | 398 天 | 大量子域,如 *.example.com |
| IP 证书 | IP 归属验证 | 分钟级 | 398 天 | 内网系统、纯 IP 接口 |
部署位置决定私钥暴露面与续期复杂度:
| 部署位置 | 证书安装处 | 私钥是否落在源站 | 续期方式 | 适用规模 |
|---|---|---|---|---|
| Nginx / Apache 源站 | 源站文件系统 | 是 | certbot / acme.sh | 单机、小流量 |
| 云负载均衡 SLB/CLB | 云控制台上传 | 否 | 控制台或 OpenAPI 更新 | 多台后端横向扩展 |
| CDN / WAF | 边缘节点 | 否 | 云证书服务托管 | 高并发、需防护 |
| Kubernetes Ingress | Secret 资源 | 集群内 | cert-manager 自动签发 | 容器化、频繁扩缩 |
经验法则:源站 80/443 不直接暴露公网时,不要把证书装在源站,交给 SLB/CDN 终结 TLS,源站只信任来自负载均衡的回源流量;反之单机小站直接装在 Nginx 上最简单。
七、常见错误排查:从真实报错到修复命令
nginx: [emerg] cannot load certificate "/etc/nginx/ssl/example.com.pem": PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line)——文件不是 PEM 文本(可能是 DER 或 pfx)。转换:openssl x509 -in example.com.crt -inform DER -out example.com.pem -outform PEM,并确认文件首行为-----BEGIN CERTIFICATE-----。nginx: [emerg] SSL_CTX_use_PrivateKey_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)——证书与私钥不配对,按第五节方法比对公钥 md5。curl: (60) SSL certificate problem: unable to get local issuer certificate——证书链缺失。把ssl_certificate指向 fullchain(服务器证书 + 中间证书,顺序不能颠倒)。- 浏览器
NET::ERR_CERT_DATE_INVALID——证书过期或服务器时间漂移。先timedatectl校准时间,再openssl x509 -noout -dates -in example.com.crt查看 notBefore/notAfter。 NET::ERR_CERT_COMMON_NAME_INVALID——SAN 不含当前域名,如证书只写了example.com,用户访问www.example.com。重新签发时把所有域名写进 SAN,或单独签一张。- Firefox
SSL_ERROR_RX_RECORD_TOO_LONG——用 https 访问了 http 端口。验证:curl -I http://example.com:443,若返回 HTTP 响应即说明 443 被 http 服务占用,检查listen指令与 CDN 回源协议。 - Apache
AH01909: example.com:443:0 server certificate does NOT include an ID which matches the server name——ServerName/ServerAlias与证书 SAN 不一致。 - 控制台
Mixed Content: The page at 'https://example.com/' was loaded over HTTPS, but requested an insecure image 'http://example.com/a.png'——页面内仍有 http 资源。全局修复:add_header Content-Security-Policy 'upgrade-insecure-requests' always;,并逐项替换为相对路径或 https。
排查顺序建议固定为:nginx -t 看配置层 → openssl s_client 看握手层 → 浏览器控制台看页面层,能覆盖 95% 的故障。
八、效果验证:命令行检测与上线检查清单
配置完成后不要只看浏览器,用命令行做可复现的验收:
# 1. 查看证书主体、签发者、有效期
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null
| openssl x509 -noout -subject -issuer -dates
# 2. 校验信任链(期望 Verify return code: 0 (ok))
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null 2>&1
| grep 'Verify return code'
# 3. 查看协商到的协议与加密套件
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null 2>/dev/null
| grep -E 'Protocol|Cipher'
# 4. 确认 80 强制跳转(期望 301/308 且 Location 为 https)
curl -sSI http://example.com | head -3
# 5. 剩余有效期告警(30 天 = 2592000 秒)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null
| openssl x509 -noout -checkend 2592000
&& echo 'OK: 30 天内不会过期' || echo 'WARN: 即将过期'
上线检查清单:① 所有子域与 http 入口均 301 到 https;② 证书链完整,Verify return code 为 0;③ 只启用 TLS 1.2 / 1.3,关闭 TLS 1.0/1.1、SSLv3、RC4、3DES;④ 已下发 HSTS(首次建议 max-age=300 灰度,确认无 http 依赖后加到 31536000);⑤ 页面无混合内容;⑥ 自动续期任务存在且 dry-run 通过;⑦ 用 SSL Labs 或 testssl.sh 复测评级,目标 A 及以上。多机部署时,把证书目录纳入配置管理,避免出现“一台续期成功、另一台仍是旧证书”的静默故障。
常见问题
加密强度完全相同,都是 RSA 2048/ECDSA P-256 与 TLS 1.2/1.3。差别在:免费证书只有 DV 验证、有效期 90 天、无人工客服与赔付条款;付费 OV/EV 证书含企业身份核验、有效期最长 398 天、提供商业保险和技术支持。普通站点用免费证书足够。
可以,但必须在申请时把两个域名都写进 SAN 扩展。现代浏览器只校验 SAN,不再看 CN,若只填了主域,访问 www 子域会报 NET::ERR_CERT_COMMON_NAME_INVALID。签发后无法追加域名,只能重新签发。
这是混合内容问题:页面里仍有 http:// 资源被浏览器拦截。打开控制台查看 Mixed Content 报错定位具体 URL,改为相对路径或 https;临时可用响应头 Content-Security-Policy: upgrade-insecure-requests 自动升级,但根本办法仍是替换资源地址。
先把新证书和私钥上传到新路径,修改配置指向新文件,执行 nginx -t 校验通过后 nginx -s reload 平滑生效(Apache 用 graceful)。reload 不会中断现有连接。用 openssl s_client 确认新证书序列号与有效期后再删除旧文件,避免回滚无据。[/sg_faq_question]
绝大多数是证书链不完整。浏览器会自动补全缺失的中间证书,而 Android、Java、curl、部分 SDK 不会。解决办法是让 ssl_certificate 指向 fullchain 文件(服务器证书在前、中间证书在后),并用 openssl verify -untrusted chain.pem 验证通过。