跳到主要内容
ssl证书按装

SSL证书购买、安装与配置全流程实战:从CSR到HTTPS验收与故障排查

SSL证书购买、安装与配置全流程实战:从CSR到HTTPS验收与故障排查 — SSL证书购买、安装与配置全流程实战:从CSR到HTTPS验收与故障排查

一、问题背景与根因:HTTPS 异常为何总在证书层暴露

网站启用 HTTPS 后出现不安全提示、接口调用失败或部分浏览器打不开,根因通常集中在证书层:证书过期、域名与 SAN 不匹配、证书链不完整、私钥与证书不配对、SNI 未命中、443 端口未放行,以及证书安装正确但网站程序仍引用 http 资源。公共 TLS 证书最长有效期为 398 天,Let’s Encrypt 证书有效期为 90 天,二者都要求建立到期监控和续期流程,不能把安装当成一次性工作。

腾讯云 SSL 证书方案中,购买+配置服务提供证书购买并赠送配置;证书安装服务只做 SSL 证书配置安装,证书需用户自行购买;故障排查服务范围是证书配置异常、证书无法正常工作。验收标准以访问域名能成功加载对应 SSL 证书为准。若配置后因程序兼容导致 HTTPS 页面不能正确显示,需要自行检查网站程序或联系程序服务商。

先做快速定位:

openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
curl -Iv https://example.com
date -u

第一条命令检查 SNI、证书链和有效期,第二条命令查看 TLS 握手与 HTTP 状态,第三条命令核对 UTC 时间,避免服务器时间偏差导致证书误判为未生效或已过期。

二、证书购买前的选型与 CSR 准备

购买前先确定域名覆盖范围:单域名证书只保护一个 FQDN;通配符证书 *.example.com 覆盖同一级子域名,不覆盖 a.b.example.com;多域名证书通过 SAN 覆盖多个不同域名。DV 只验证域名控制权,签发快;OV 增加组织身份审核;EV 展示组织信息但浏览器 UI 差异已弱化。腾讯云控制台进入 SSL 证书,选择申请证书,填写域名、验证方式、联系人,DNS 验证需添加 TXT 或 CNAME 记录,文件验证需在网站根目录放置指定文件。

如自行生成 CSR,可使用:

openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj /C=CN/ST=Beijing/L=Beijing/O=Example/CN=example.com
openssl req -in example.com.csr -noout -subject -text | grep -A1 SubjectAlternativeName

生成后妥善保存私钥,CSR 提交给 CA。若需要 SAN,可在 OpenSSL 配置中加入 subjectAltName=DNS:example.com,DNS:www.example.com。DNS 验证可用:

dig +short TXT _dnsauth.example.com
dig +short CNAME _dnsauth.example.com

审核通过后下载 Nginx 格式证书,通常得到 fullchain.pem 与 key 文件;Apache 则使用 crt、key 和 chain。其他平台证书也可按同样思路做域名验证辅助和安装部署。

三、完整实操步骤:腾讯云 SSL 证书申请、下载与 Nginx 安装

第一步备份现有配置:

sudo tar czf /root/nginx-ssl-backup-$(date +%F-%H%M).tar.gz /etc/nginx

第二步创建证书目录并上传腾讯云下载的 Nginx 证书:

sudo mkdir -p /etc/nginx/ssl
sudo cp example.com.fullchain.pem /etc/nginx/ssl/
sudo cp example.com.key /etc/nginx/ssl/
sudo chmod 600 /etc/nginx/ssl/example.com.key
sudo chown root:root /etc/nginx/ssl/example.com.key

第三步校验证书与私钥是否匹配:

openssl x509 -noout -modulus -in /etc/nginx/ssl/example.com.fullchain.pem | openssl md5
openssl rsa -noout -modulus -in /etc/nginx/ssl/example.com.key | openssl md5

两个 MD5 必须一致。第四步编辑站点配置,把 ssl_certificate 指向 fullchain,把 ssl_certificate_key 指向私钥。第五步执行:

sudo nginx -t
sudo systemctl reload nginx
sudo ss -lntp | grep 443

若 nginx -t 报 cannot load certificate,先检查路径、PEM 格式和文件权限;若报 key values mismatch,回到第三步核对私钥。最后用浏览器和 curl 验收,确认域名成功加载对应证书,HTTP 自动跳转 HTTPS。

四、配置示例:Nginx 与 Apache 的 HTTPS 关键参数

Nginx 最小可用配置如下:

server {
 listen 80;
 server_name example.com www.example.com;
 return 301 https://$host$request_uri;
}
server {
 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 HIGH:!aNULL:!MD5;
 ssl_session_cache shared:SSL:10m;
 ssl_session_timeout 10m;
 add_header Strict-Transport-Security max-age=31536000;
 location / { root /var/www/html; index index.html; }
}

HSTS 会强制浏览器后续使用 HTTPS,建议先确认全站 HTTPS 和子域可用后再加。OCSP stapling 可选:ssl_stapling on; ssl_stapling_verify on; ssl_trusted_certificate 指向完整链。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/example.com.chain.pem
</VirtualHost>

修改后执行 nginx -t 或 apachectl configtest,再 reload。证书链不完整时,浏览器可能正常而 curl、Java、Android 客户端报 unable to get local issuer certificate。

五、证书类型与服务方案对比表格

证书选型不能只看价格,应结合域名数量、验证级别、有效期和运维能力。公共 TLS 证书最长有效期 398 天,Let’s Encrypt 为 90 天,到期前应自动续期或设置监控。下表用于快速对照:

类型 覆盖范围 验证方式 有效期 适用场景
DV 单域名 一个 FQDN DNS/文件验证 最长 398 天 测试、内部系统、个人站点
DV 通配符 *.example.com 同一级 DNS 验证 最长 398 天 多个同级子域
OV/EV 单域名或多域名 SAN 组织审核+域名验证 最长 398 天 企业官网、合规场景
Let’s Encrypt 单域名/多域名 HTTP-01/DNS-01 90 天 自动化运维、成本敏感

服务方案对比:

服务 包含内容 不包含 验收口径
SSL 证书购买+配置 腾讯云证书购买、赠送证书配置 网站程序改造 域名成功加载对应证书
证书安装服务 SSL 证书配置安装 证书本身、程序兼容处理 HTTPS 可加载证书
故障排查服务 证书配置异常、证书无法正常工作排查 业务代码与程序兼容问题 证书恢复可用
其他平台辅助 域名验证辅助、安装部署、HTTPS 异常排查 平台账号安全责任 按约定验收

六、常见错误排查:真实报错与命令定位

浏览器报 NET::ERR_CERT_COMMON_NAME_INVALID 或 Firefox 报 SSL_ERROR_BAD_CERT_DOMAIN,通常是证书 SAN 未包含当前访问域名。执行:

openssl x509 -in /etc/nginx/ssl/example.com.fullchain.pem -noout -subject -issuer -dates -ext subjectAltName

确认 CN 和 SAN。报 certificate has expired 时,用 openssl x509 -noout -dates 检查 notBefore/notAfter,并核对服务器 UTC 时间。curl 报 curl: (60) SSL certificate problem: unable to get local issuer certificate 或客户端报 unable to verify the first certificate,说明中间证书缺失,应使用 fullchain 而不是仅站点证书。

Nginx 启动报 nginx: [emerg] cannot load certificate,常见于路径错误、文件不是 PEM、权限不足;报 SSL_CTX_use_PrivateKey_file() failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch) 说明证书与私钥不匹配,用 modulus MD5 对比。Cloudflare 源站报 526 表示源站证书无效,报 522 多为源站 443 不通。排查顺序:

sudo nginx -t
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
curl -Iv https://example.com
sudo ss -lntp | grep 443
sudo journalctl -u nginx -n 50 --no-pager

先排除证书路径、链、私钥、端口和防火墙,再判断是否为网站程序兼容问题。

七、效果验证与交付验收

安装完成后不能只看浏览器锁标。先做证书链验证:

openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null
openssl s_client -connect www.example.com:443 -servername www.example.com -showcerts </dev/null | openssl x509 -noout -subject -issuer -dates

再验证 HTTP 跳转和响应头:

curl -I http://example.com
curl -Iv https://example.com
curl -Iv https://www.example.com

检查 301/308 是否指向 HTTPS,证书是否覆盖访问域名。端口与进程:

sudo ss -lntp | grep 443
sudo systemctl status nginx --no-pager
sudo nginx -t

到期监控可用:

openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/example.com.fullchain.pem

返回 not expired 表示 30 天内不过期。验收标准以访问域名能成功加载对应 SSL 证书为准;若证书加载成功但 HTTPS 页面显示异常,通常是网站程序仍引用 http 资源或程序兼容问题,需要自行检查网站程序或联系程序服务商。

八、服务流程、数据备份与安全注意事项

标准服务流程为:购买服务—提交需求—需求确认—进行作业—作业验收—服务质保。提交需求时,如对操作有特别注意事项,应详细说明,例如指定证书目录、维护窗口、不能重启的服务、负载均衡与 CDN 回源方式。实施前必须备份:

sudo tar czf /root/nginx-backup-$(date +%F-%H%M).tar.gz /etc/nginx /var/www
sudo cp -a /etc/nginx /root/etc-nginx-copy-$(date +%F)

变更后保留 nginx -t 输出和 curl -Iv 结果,便于验收和回滚。服务过程中如沟通云账号、密码等机密信息,建议服务结束后及时变更密码、回收临时账号并检查登录日志。

证书安装服务仅包含 SSL 证书配置安装,证书需用户自行购买;购买+配置服务才包含腾讯云证书购买并赠送配置。故障排查范围包括证书配置异常、证书无法正常工作,不包含网站程序兼容和代码改造。生产环境建议建立 30 天到期提醒,Let’s Encrypt 用 certbot 自动续期,公共证书按 398 天最长有效期提前规划更换,避免因过期导致接口、支付回调和小程序请求失败。

sudo certbot renew --dry-run
sudo systemctl list-timers | grep certbot

常见问题

公共 TLS 证书最长有效期为 398 天,Let’s Encrypt 证书为 90 天。建议到期前 30 天续期,并设置 openssl x509 -checkend 监控,避免过期导致 HTTPS 中断。

不包含。证书安装服务仅提供 SSL 证书配置安装,证书需用户自行购买;SSL 证书购买+配置服务才包含腾讯云证书购买并赠送配置。验收以域名成功加载证书为准。

先查证书 SAN 是否覆盖访问域名、有效期、证书链是否完整、私钥是否匹配、443 端口是否放行。若证书已正确加载但页面异常,多为网站程序兼容或混合内容问题。

不能。*.example.com 只覆盖 www.example.com 这一级,不覆盖 a.b.example.com。多级子域需单独申请通配符或把域名加入 SAN,购买前要核对域名清单。

包含证书配置异常、证书无法正常工作,如路径错误、证书链缺失、私钥不匹配、端口未放行等。不包含网站程序兼容、代码改造和业务系统自身问题。

内容审核

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