WordPress 建站 SSL 证书安装与 HTTPS 全站迁移实操指南(含搬家、插件调试与报错排查)
问题背景与根因:WordPress 站点为什么上了证书仍然”不安全”
很多 WordPress 站点在”看起来已经装了 SSL 证书”之后,地址栏依旧被浏览器标记为不安全。根因通常不是证书本身,而是 HTTPS 只覆盖了首页入口,站内资源仍在走 HTTP;或者证书链、SNI、反向代理协议头三者之一配置不完整。典型表现有三类:
- 地址栏有锁,但 DevTools Console 报
Mixed Content,图片、字体、JS 被浏览器拦截; - 访问 https 直接报
NET::ERR_CERT_COMMON_NAME_INVALID(域名不匹配)或NET::ERR_CERT_AUTHORITY_INVALID(缺中间证书); - 开启强制 HTTPS 后整站陷入
ERR_TOO_MANY_REDIRECTS死循环,后台完全无法登录。
WordPress 的特殊之处在于,站点地址并不只存在于配置文件里:wp_options 表的 siteurl 与 home 两条记录、文章正文与摘要中的绝对链接、主题 Customizer 与小工具里序列化后的数组,都硬编码了 http://。序列化字符串带长度前缀(如 s:22:"http://example.com/a"),用 SQL 的 UPDATE ... REPLACE() 直接替换会让声明长度与实际内容不符,PHP 反序列化失败,结果就是小工具整块消失、页面白屏、主题设置被重置。这是站点搬家后”证书装好了但页面崩了”的头号根因。
动手之前先做三件事确认现状,把输出记录下来,后面每一步都用它做前后对比:
curl -sI http://example.com | head -5
curl -sI https://example.com | head -5
wp option get home --path=/var/www/html
如果第一条返回 HTTP/1.1 200 OK 而不是 301,说明还没有做强制跳转;如果第二条报 curl: (60) SSL certificate problem,说明证书链或域名绑定有问题;如果第三条返回 http:// 开头,说明数据库里的站点地址还没改,此时任何强制 HTTPS 的配置都会引发重定向循环。
前置准备:DNS、端口与证书类型选择(398 天与 90 天规则)
签发之前先确认三件事:域名解析、端口占用、证书类型。任何一项没准备好,Certbot 都会在验证阶段失败。
DNS 检查:dig +short example.com A 与 dig +short www.example.com 必须指向本机公网 IP。特别小心 AAAA 记录——如果域名配了 IPv6 记录但服务器并未监听 443,Let’s Encrypt 验证服务器会优先走 IPv6 并超时,报 Timeout during connect (likely firewall problem)。这个报错有 90% 不是防火墙问题,而是 AAAA 记录指向了错误主机。
端口检查:
ss -lntp | grep -E ':80|:443'
ufw status | grep -E '80|443'
curl -I http://example.com/.well-known/acme-challenge/test
如果 80 端口被面板(宝塔、aaPanel)或其他 Web 服务占用,改用 DNS-01 验证或 webroot 方式,不要强行 --standalone,那会因端口冲突直接失败。
证书类型与有效期:按 CA/Browser Forum 现行规则,所有公共信任证书最长有效期 398 天(2020 年 9 月起生效);Let’s Encrypt 免费证书固定 90 天。注意新规已经排期:2026 年起上限降至 200 天,之后收紧到 100 天,最终 47 天。这意味着”一年一装”的做法已不可持续,自动续期是硬性要求而非可选项。选型建议:个人博客、测试环境、绝大多数企业展示站用 Let’s Encrypt 完全够用;需要 SLA、发票、商业支持或金融/政企合规审计的选 OV 证书。
备份是硬性前置动作:
cd /var/www/html
wp db export ../backup-$(date +%F-%H%M).sql
tar czf ../wp-files-$(date +%F).tar.gz wp-content wp-config.php
同时确认运行环境:wp core version、php -v、openssl version。PHP 7.4 以下建议先升级,因为部分 SSL 插件与 OpenSSL 3.x 的 cipher 套件不兼容,会在主题 functions.php 中抛 openssl_cipher_iv_length(): Unknown cipher algorithm。
实操步骤一:用 Certbot 申请 Let’s Encrypt 证书并配置自动续期
以 Ubuntu 22.04/24.04 + Nginx 为例,命令可直接粘贴执行。第一步安装并签发:
sudo apt update
sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d example.com -d www.example.com
--agree-tos -m admin@example.com --no-eff-email --redirect
--nginx 插件会自动改写 server 块并注入 301 跳转;如果站点结构复杂、不希望 Certbot 改配置,用 webroot 只签证书:
sudo certbot certonly --webroot -w /var/www/html
-d example.com -d www.example.com
证书落在 /etc/letsencrypt/live/example.com/:fullchain.pem = 站点证书 + 中间证书,privkey.pem 是私钥,chain.pem 仅中间证书(供 OCSP stapling 使用)。Nginx/Apache 一律指向 fullchain.pem,只配 cert.pem 会导致 Android 老版本、Java 客户端、微信内置浏览器报证书不受信任。
第二步验证自动续期。Certbot 安装时会注册 systemd timer:
systemctl list-timers | grep certbot
sudo certbot renew --dry-run
sudo certbot certificates
只有输出 Congratulations, all simulated renewals succeeded 才算通过。certbot certificates 会列出每张证书的到期时间,务必确认 VALID: 90 days 且 Domains 包含所有需要的域名。若服务器无 systemd,用 cron 兜底:
0 3 * * * /usr/bin/certbot renew --quiet --deploy-hook "systemctl reload nginx"
第三步(可选),多域名或通配符场景改用 acme.sh,它支持 DNS API 验证,不依赖 80 端口:
curl https://get.acme.sh | sh -s email=admin@example.com
~/.acme.sh/acme.sh --issue -d example.com -d '*.example.com' --dns dns_dp
~/.acme.sh/acme.sh --install-cert -d example.com
--key-file /etc/nginx/ssl/example.com.key
--fullchain-file /etc/nginx/ssl/example.com.pem
--reloadcmd "systemctl reload nginx"
注意 acme.sh 默认 CA 是 ZeroSSL,如需 Let’s Encrypt 要加 --server letsencrypt。无论用哪种工具,续期都依赖 80/443 或 DNS API 长期可用,不要在上线后关闭 80 端口,否则 90 天后续期静默失败,站点会在某个凌晨直接掉线。
配置示例:Nginx 与 Apache 的 HTTPS + 301 跳转完整配置
下面是可直接使用的 Nginx 配置,包含 80→443 跳转、TLS 1.2/1.3、HSTS、OCSP stapling 与 WordPress 伪静态:
server {
listen 80;
listen [::]:80;
server_name example.com www.example.com;
location /.well-known/acme-challenge/ { root /var/www/html; }
location / { return 301 https://example.com$request_uri; }
}
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on; # nginx < 1.25.1 写成 listen 443 ssl http2;
server_name example.com www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
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;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 1d;
ssl_session_tickets off;
ssl_stapling on;
ssl_stapling_verify on;
resolver 223.5.5.5 8.8.8.8 valid=300s;
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;
root /var/www/html;
index index.php index.html;
location / { try_files $uri $uri/ /index.php?$args; }
location ~ .php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}
}
Apache 2.4 对应配置:
<VirtualHost *:80>
ServerName example.com
Redirect permanent / https://example.com/
</VirtualHost>
<VirtualHost *:443>
SSLEngine on
SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem
# Apache 2.4.8+ 使用 fullchain 后无需 SSLCertificateChainFile
Protocols h2 http/1.1
Header always set Strict-Transport-Security "max-age=31536000"
DocumentRoot /var/www/html
</VirtualHost>
改完必须先做语法检查再 reload:
sudo nginx -t && sudo systemctl reload nginx
sudo apachectl configtest && sudo systemctl reload apache2
两个细节容易踩坑:一是 HSTS 一旦下发 includeSubDomains,所有子域必须都有有效证书,否则子域直接无法访问,建议先用 max-age=300 试跑一周再拉满;二是 ssl_stapling 必须配合 ssl_trusted_certificate 和可用的 resolver,否则 Nginx 日志会刷 SSL_do_handshake() failed (SSL: error:...:ocsp verify failed) 并拖慢握手。
实操步骤二:站点搬家/换域名后,安全地把数据库里的 http 换成 https
换域名是”SSL 问题”的高发场景,但多数时候证书没错,是数据库里的绝对地址没换。正确做法是用 WP-CLI 的 search-replace,它按序列化规则重算字符串长度;UPDATE wp_posts SET post_content = REPLACE(...) 会破坏数据,坚决不用。
第一步,先 dry-run 看清楚要改多少行:
cd /var/www/html
wp option get home
wp option get siteurl
wp search-replace 'http://old.com' 'https://new.com' --all-tables --precise --dry-run
wp search-replace 'http://www.old.com' 'https://new.com' --all-tables --precise --dry-run
--precise 是关键参数,强制走 PHP 反序列化再重新序列化;--all-tables 覆盖插件自建表(WooCommerce、表单插件等)。确认行数无误后去掉 --dry-run 执行,并加 --skip-columns=guid 避免改动 RSS 的 GUID——GUID 变更会让老订阅者重复收到旧文章。
wp search-replace 'http://old.com' 'https://new.com' --all-tables --precise --skip-columns=guid
wp cache flush
wp rewrite flush --hard
wp transient delete --all
第二步,在 wp-config.php 中锁定域名并强制后台 HTTPS(放在 require_once ABSPATH . 'wp-settings.php'; 之前):
define('WP_HOME', 'https://example.com');
define('WP_SITEURL', 'https://example.com');
define('FORCE_SSL_ADMIN', true);
// 位于 Nginx/CDN 反向代理之后必须加,否则后台无限跳转
if (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') {
$_SERVER['HTTPS'] = 'on';
}
第三步,Apache 环境在 .htaccess 中补跳转规则(放在 WordPress 默认规则之前):
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301]
</IfModule>
如果同时装了 Really Simple SSL 这类插件,它会再写一遍跳转规则,两者叠加就是 ERR_TOO_MANY_REDIRECTS。二选一,不要都开。另外换域名后证书必须重新签发:Let’s Encrypt 证书绑定 SAN 列表,旧证书不含新域名,浏览器照样报 NET::ERR_CERT_COMMON_NAME_INVALID,签发时加 --expand 即可把新域名并入同一张证书。
插件与主题调试:混合内容(Mixed Content)的定位与修复
证书装好、跳转正常,仍会有页面”半截不安全”。打开 DevTools → Console,典型报错是:
Mixed Content: The page at 'https://example.com/' was loaded over HTTPS,
but requested an insecure element 'http://example.com/wp-content/uploads/2024/05/banner.jpg'.
This request has been blocked; the content must be served over HTTPS.
定位分三层:数据库、主题/插件代码、外部资源。
数据库层:
wp db query "SELECT ID, post_title FROM wp_posts
WHERE post_content LIKE '%http://example.com%' AND post_status='publish' LIMIT 20;"
wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise
主题 Customizer 的设置存在 wp_options 的 theme_mods_* 中,同样是序列化数据,先用 wp option get theme_mods_yourtheme --format=json 检查,再走 search-replace,不能手改。
代码层:主题 functions.php 或插件里硬编码的地址最顽固,全局搜一遍:
grep -rn "http://example.com" wp-content/themes/ wp-content/plugins/
--include="*.php" --include="*.js" --include="*.css" | head -30
WordPress 官方推荐用 home_url()、content_url()、get_template_directory_uri() 代替硬编码;CSS 中的 url(http://...) 改成 url(https://...) 或协议相对写法。
兜底层:临时用 CSP 强制升级不安全请求,可在不改代码的情况下止血:
add_header Content-Security-Policy "upgrade-insecure-requests" always;
注意这是浏览器端补救,不影响搜索引擎抓到的链接,正式修复仍要改数据与代码。调试插件时还有高频坑:缓存/压缩插件(Autoptimize、WP Rocket)把合并后的 CSS/JS 缓存在 wp-content/cache/,改完数据库必须清缓存,否则页面源码里依旧是旧的 http 地址。
wp cache flush
wp rocket clean --confirm
rm -rf wp-content/cache/*
最后扫描整站残留引用:curl -s https://example.com | grep -oE 'http://[^"]+' | sort -u | head -20,输出为空才算干净。
方案对比:证书类型与部署工具怎么选
选型不要只看价格。下表按现行有效期规则整理,其中”最长 398 天”是 CA/Browser Forum 对所有公共信任证书的硬上限,Let’s Encrypt 固定 90 天,且后续规则会进一步收紧到 47 天,因此”是否支持 ACME 自动续期”比”有效期多长”更值得关注。
| 对比项 | Let’s Encrypt (DV) | 商业 DV | OV / EV |
|---|---|---|---|
| 有效期 | 90 天(强制自动续期) | 最长 398 天 | 最长 398 天 |
| 费用 | 免费 | 约 100–800 元/年 | 1000–5000 元/年 |
| 签发时长 | 1–2 分钟 | 10 分钟–数小时 | 1–5 个工作日 |
| 验证方式 | HTTP-01 / DNS-01 | DNS / 文件验证 | 组织信息核验 + 电话回访 |
| 浏览器信任 | 全平台信任 | 全平台信任 | 全平台信任(EV 已不显示绿色地址栏) |
| 自动续期 | 原生 ACME | 部分支持 ACME | 多为手动 CSR |
| 适用场景 | 博客、测试、企业展示站 | 需要发票与 SLA | 金融、政企合规审计 |
部署工具的选择直接影响后续维护成本:
| 方式 | 安装命令 | 续期机制 | 通配符 | 适用场景 |
|---|---|---|---|---|
| certbot + nginx 插件 | apt install certbot python3-certbot-nginx | systemd timer | 需 DNS 插件 | 单机 Nginx/Apache |
| certbot webroot | certbot certonly –webroot | systemd timer | 需 DNS 插件 | 已有自定义配置 |
| acme.sh | curl https://get.acme.sh | sh | cron | 支持 DNS API | 无 80 端口、多域名 |
| 面板一键 | 宝塔/aaPanel 界面操作 | 面板计划任务 | 支持 | 运维经验较少 |
| 手动 CSR | openssl req -new -newkey rsa:2048 -nodes | 手动 | 支持 | OV/EV 商业证书 |
手动 CSR 的完整命令是 openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj "/CN=example.com",提交给 CA 后拿回证书,务必把 CA 提供的中间证书与站点证书按顺序拼成 fullchain 再部署。对绝大多数 WordPress 站点,certbot --nginx 或面板一键是最省事的组合,只有在无 80 端口或需要泛域名时才值得上 acme.sh + DNS API。
常见错误排查:真实报错、根因与修复命令
| 报错信息 | 根因 | 修复动作 |
|---|---|---|
| NET::ERR_CERT_COMMON_NAME_INVALID | 证书 SAN 不含当前访问域名(只签 example.com 却访问 www) | certbot –expand -d example.com -d www.example.com |
| NET::ERR_CERT_AUTHORITY_INVALID / curl: (60) unable to get local issuer certificate | 只部署叶子证书,缺中间证书 | 改用 fullchain.pem |
| ERR_TOO_MANY_REDIRECTS | siteurl 仍为 http;CDN 为 Flexible;插件与 .htaccess 重复跳转 | 改 siteurl、CDN 切 Full (strict)、删重复规则 |
| nginx: [emerg] cannot load certificate … BIO_new_file() failed | 路径写错、证书未签发、权限不足 | ls -l /etc/letsencrypt/live/example.com/ 核对 |
| Challenge failed for domain … Timeout during connect | 80 端口不通或 AAAA 记录指向错误主机 | 放行 80、修正 AAAA 或改 DNS-01 |
| too many failed authorizations recently | Let’s Encrypt 失败次数限流 | 等待 1 小时后重试,先本地排查 |
| 525 SSL handshake failed(Cloudflare) | 回源 443 未监听或源站证书过期 | 检查源站、更新证书、回源端口设 443 |
排查时优先用这两条命令拿到事实,而不是猜:
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'
curl -sIL http://example.com | grep -iE '^(HTTP/|location)'
第一条输出应为 2 或以上(叶子证书 + 中间证书),只输出 1 就是链不完整。第二条如果出现多个 301 且 Location 在 http/https 之间来回跳,就是典型循环,直接去查 wp option get home 与 CDN 的 SSL 模式。另外 nginx: [emerg] cannot load certificate 有一个隐蔽原因:/etc/letsencrypt/live/ 与 archive/ 是符号链接目录,若把证书复制到其他路径却忘了同步更新,续期后指向的仍是旧文件,表现为”续期成功但浏览器提示证书已过期”。建议始终引用 live/ 下的原始路径,或使用 --deploy-hook 在续期后自动拷贝并 reload。
效果验证:6 项检查确认 HTTPS 真正生效
| 检查项 | 命令 | 期望结果 |
|---|---|---|
| 强制跳转 | curl -sI http://example.com | head -3 | 301 + Location: https://example.com/ |
| 证书链完整 | openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/null 2>&1 | grep ‘Verify return code’ | Verify return code: 0 (ok) |
| 有效期 | openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -dates | notAfter 在 90 天以内 |
| 站点地址 | wp option get home | https://example.com |
| 数据库残留 | wp db query “SELECT COUNT(*) FROM wp_posts WHERE post_content LIKE ‘%http://example.com%’;” | 0 |
| 综合评级 | curl -s “https://api.ssllabs.com/api/v3/analyze?host=example.com&publish=off&all=done” | jq -r ‘.endpoints[0].grade’ | A 或 A+ |
SSL Labs 的 API 首次调用会返回 IN_PROGRESS,需要轮询几次才有评级;如果评级是 B 或更低,通常是因为仍支持 TLS 1.0/1.1,或者没有开启 HSTS。部署完成后还要建立到期监控,最轻量的做法是每周跑一次 certbot certificates 并把结果发到运维邮箱:
certbot certificates | grep -E 'Certificate Name|Expiry Date'
# 或用 openssl 直接算剩余天数
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -checkend 604800 && echo OK || echo "7 天内到期"
-checkend 604800 表示检查证书是否在 7 天内过期,返回非 0 即告警,可直接接入 Zabbix/Prometheus 的 command check。最后再跑一次全站抓取确认没有混合内容:curl -s https://example.com | grep -c 'http://',理想值是 0。
常见问题
Let’s Encrypt 证书只有 90 天,能不能申请一年期的?
不能。90 天是 Let’s Encrypt 的固定策略,而 398 天是 CA/Browser Forum 对所有公共信任证书的硬上限,商业 CA 也不能突破。更需要注意的是,行业规则已排期在未来几年把上限逐步压缩到 200 天、100 天直至 47 天,因此正确做法不是找长有效期证书,而是把续期彻底自动化:Certbot 的 systemd timer 或 acme.sh 的 cron 必须验证通过(certbot renew --dry-run),并配置 --deploy-hook 在续期后自动 reload Web 服务。
装了 SSL 插件后网站打不开或反复跳转,怎么快速恢复?
先停掉插件恢复访问:把 wp-content/plugins/really-simple-ssl/ 目录改名即可强制停用,然后排查三处——wp option get home 是否已是 https、.htaccess 里是否有多条 RewriteCond %{HTTPS} 规则、CDN 的 SSL 模式是否为 Flexible。Flexible 模式下 CDN 回源用 HTTP,而源站又强制跳 HTTPS,就会形成无限循环,改成 Full (strict) 即可。
换域名搬家后图片全部 404,是证书没装好吗?
不是。证书只负责传输加密,与资源路径无关。图片 404 说明数据库里仍存着旧域名的绝对地址,或者 wp-content/uploads 目录没有完整迁移。用 wp search-replace 'http://old.com' 'https://new.com' --all-tables --precise --dry-run 先看影响行数,确认后再执行;如果是目录缺失,检查 wp option get upload_path 与实际文件路径是否一致。
通配符证书能同时覆盖 example.com 和 www.example.com 吗?
不能完全覆盖。*.example.com 匹配 www.example.com、blog.example.com 这类一级子域,但不匹配裸域 example.com,也不匹配 a.b.example.com。正确做法是签发时同时带上两个标识:acme.sh --issue -d example.com -d '*.example.com' --dns dns_dp,得到一张包含裸域和泛域名的 SAN 证书。
免费证书和付费证书在浏览器里显示有区别吗?
没有。加密强度取决于 TLS 协议版本与 cipher 套件配置,与证书价格无关;EV 证书早就不显示绿色公司名,所有 DV/OV/EV 在地址栏都是同一把锁。付费证书的差异在于组织信息核验、保修赔付、SLA 响应、发票与商业支持,以及部分老旧客户端对特定 CA 根证书的兼容性。企业展示站用 Let’s Encrypt 完全合规,金融、政企招标场景才需要 OV/EV。
后台开启强制 HTTPS 后无法登录,提示重定向过多怎么办?
这是反向代理场景的经典问题:Nginx/CDN 终止了 TLS,PHP 收到的仍是 HTTP/1.1,WordPress 认为当前不是 HTTPS,于是把登录页又跳回 https,形成循环。在 wp-config.php 中加入对 HTTP_X_FORWARDED_PROTO 的判断并设置 $_SERVER['HTTPS'] = 'on',同时在 Nginx 的 location 段补 proxy_set_header X-Forwarded-Proto $scheme;,两处都改才能彻底解决。