跳到主要内容
SSL 证书付费服务

WordPress 建站 SSL 证书安装与 HTTPS 全站迁移实操指南(含搬家、插件调试与报错排查)

WordPress 建站 SSL 证书安装与 HTTPS 全站迁移实操指南(含搬家、插件调试与报错排查) — 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;,两处都改才能彻底解决。

内容审核

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