跳到主要内容
安装配置教程

phpStudy SSL证书安装教程:Apache 与 Nginx 配置、证书链和报错排查

phpstudy ssl证书安装 — phpStudy SSL证书安装教程:Apache 与 Nginx 配置、证书链和报错排查
核心结论

phpStudy 安装 SSL 证书的核心是:把 fullchain.crt 与 private.key 放到非 Web 根目录,在 Apache 2.4.x 的 443 VirtualHost 写 SSLCertificateFile/SSLCertificateKeyFile,或在 Nginx 1.15.x 的 server 写 ssl_certificate/ssl_certificate_key,然后 httpd -t 或 nginx -t 检查并重启。 证书链不完整是 NET::ERR_CERT_AUTHORITY_INVALID 和 curl: (60) unable to get local issuer certificate 的高频原因;Nginx 的 ssl_certificate 必须指向站点证书加中间证书合并后的 fullchain.crt。 443 未生效先查 netstat -ano | findstr :443 和云安全组;浏览器报 ssl_error_rx_record_too_long 多为 443 被 HTTP 服务占用或端口映射错误。 验证用 openssl s_client -connect example.com:443 -servername example.com -showcerts,看到 Verify return code: 0 (ok) 且协议为 TLSv1.2/TLSv1.3 才算链路正常。 Let's Encrypt 证书有效期 90 天,建议 60 天续期;商业 DV 约 0-200 元/年,OV 约 500-2000 元/年,续期后必须重启 Apache/Nginx。

为什么 phpStudy 装完 SSL 证书仍提示不安全?

问:证书文件明明已经上传到 phpStudy 目录,浏览器还是显示“不安全”,第一步该查什么?

先查 443 端口有没有真的被监听。phpStudy v8.1 的“网站”模板生成 vhost 时只写入 80 端口——Apache 是 <VirtualHost *:80>,Nginx 是 listen 80;。你把证书传到目录却没新增 443 的 vhost,浏览器访问走的仍是 HTTP,地址栏自然不会出现锁形图标。Apache 侧还要确认 httpd.conf 中 LoadModule ssl_module modules/mod_ssl.so 与 Listen 443 两行未被 # 注释。改完必须在面板点“重启”,只保存不重启不会生效。

# Apache 2.4.x:phpStudy v8.1 → 网站 → 管理 → 修改 vhosts.conf
<VirtualHost *:443>
    DocumentRoot "D:/phpstudy_pro/WWW/example.com"
    ServerName   example.com
    ServerAlias  www.example.com
    SSLEngine on
    # Apache 2.4.8+ 推荐:站点证书 + 中间证书合并为 fullchain.crt 交给此行
    SSLCertificateFile    "D:/phpstudy_pro/Extensions/Apache2.4.39/cert/fullchain.crt"
    SSLCertificateKeyFile "D:/phpstudy_pro/Extensions/Apache2.4.39/cert/private.key"
    # SSLCertificateChainFile 在 2.4.8+ 已被 SSLCertificateFile 取代,勿重复配置
</VirtualHost>

# Nginx 1.15+(phpStudy 自带版本):conf/vhosts/example.com.conf
server {
    listen 443 ssl;                 # 1.25+ 可写 listen 443 ssl; http2 on;
    server_name example.com www.example.com;
    ssl_certificate     D:/phpstudy_pro/Extensions/Nginx1.15.11/conf/cert/fullchain.crt;
    ssl_certificate_key D:/phpstudy_pro/Extensions/Nginx1.15.11/conf/cert/private.key;
    ssl_protocols       TLSv1.2 TLSv1.3;   # 默认值随版本不同,显式声明更稳
}

问:vhost 也配好了,为什么 Chrome 还是报 NET::ERR_CERT_COMMON_NAME_INVALID?

域名不匹配。证书的 SAN(Subject Alternative Name)必须逐条包含你实际访问的域名,example.com 与 www.example.com 是两个条目,签证书时要一起写。据 CA/Browser Forum 基线要求与 RFC 5280,Chrome 58 起已完全忽略仅含 CN 的旧式证书,只认 SAN,所以只有 CN 的证书必然报此错。用 openssl x509 -text -noout -in fullchain.crt | grep -A1 "Subject Alternative Name" 可直接核对。

问:桌面浏览器正常,Android、Java 客户端和 curl 却报 unable to get local issuer certificate,问题在哪?

证书链不完整——只上传了站点证书,缺中间证书。Let’s Encrypt 与多数 CA 的签发文件包里 fullchain.crt 才是“站点证书 + 中间证书”的拼接结果,Apache 2.4.8+ 与 Nginx 的 ssl_certificate 都应指向它。桌面 Chrome 会走 AIA 自动补链,所以掩盖了问题。验证:openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt fullchain.crt,返回 OK 才算完整。

问:私钥和证书不配对会报什么错?怎么快速确认?

Apache 启动失败并提示 SSL Library Error: ... key values mismatch,Nginx 则是 PEM_read_bio_PrivateKey() failed(也可能是 SSL_CTX_use_PrivateKey 失败)。比对两个模数 MD5,必须完全一致:

openssl x509 -noout -modulus -in fullchain.crt | openssl md5
openssl rsa  -noout -modulus -in private.key   | openssl md5
# 两行输出相同 = 配对;不同 = 下错了证书或私钥文件

问:还有哪些“看起来像证书问题”的坑?

端口与防火墙:Windows 防火墙入站规则要放行 TCP 443,云服务器安全组同样要放行 443,否则外网连不上,浏览器直接超时而非报证书错。混合内容:HTTPS 页面里残留的 http:// 图片、JS、CSS 会被 Chrome DevTools Console 标为 Mixed Content,锁图标变成“不安全”。WordPress 可用 WP-CLI 批量替换:

wp search-replace 'http://example.com' 'https://example.com' 
  --all-tables --precise --skip-columns=guid
现象/报错 最可能原因 一步验证
地址栏无锁,仍是 http:// 没有 443 vhost,或改完未重启 netstat -ano | findstr :443
NET::ERR_CERT_COMMON_NAME_INVALID SAN 缺当前访问域名 openssl x509 -text -noout 查 SAN
unable to get local issuer certificate 未使用 fullchain.crt openssl verify 返回非 OK
key values mismatch / PEM_read_bio_PrivateKey() failed 证书与私钥不配对或私钥带密码 比对 modulus 的 MD5
页面能开但显示“不安全” Mixed Content DevTools → Console 搜 Mixed Content

完整实操步骤:phpStudy v8.1 安装 SSL 证书的 6 个步骤

phpStudy 面板上的“SSL”开关只是帮你改配置文件,真正决定成败的是证书链是否完整、私钥路径是否落在 Web 根目录、以及 httpd.conf 里的 mod_ssl 有没有被注释掉。下面这套 phpstudy ssl证书安装 流程按“先备份、再验证、后启用”的顺序推进,Apache 与 Nginx 各给一份可直接粘贴的配置,末尾附两平台的指令对照表。

步骤 1 · 备份虚拟主机目录并确认真实版本

phpStudy v8.1 默认捆绑 Apache 2.4.39 与 Nginx 1.15.11,但目录名不一定等于你正在跑的版本,改配置前先以二进制自报的版本为准。

:: 以管理员身份运行 CMD,先整目录备份,出错可整块回滚
xcopy "C:phpstudy_proExtensionsApache2.4.39confvhosts" "C:phpstudy_proExtensionsApache2.4.39confvhosts_bak" /E /I /H
xcopy "C:phpstudy_proExtensionsNginx1.15.11confvhosts"   "C:phpstudy_proExtensionsNginx1.15.11confvhosts_bak"   /E /I /H
:: 确认实际版本,输出形如 Server version: Apache/2.4.39 (Win64) 与 nginx version: nginx/1.15.11
"C:phpstudy_proExtensionsApache2.4.39binhttpd.exe" -v
"C:phpstudy_proExtensionsNginx1.15.11nginx.exe" -v

注意 nginx -v 的版本信息写到 stderr,在 CMD 里看到提示符先回来、文字后出现是正常的。

步骤 2 · 申请证书并整理成四个文件

向 CA 或云厂商签发后,把压缩包整理为 example.com.crt(叶证书)、example.com.key(私钥)、fullchain.crt(叶证书+中间证书)、chain.pem(仅中间证书)。据 Let’s Encrypt 文档,其下发的 fullchain.pem 已含中间证书,直接对应 fullchain.crt,无需自己拼接。用 OpenSSL 做三项自检:

openssl x509 -in fullchain.crt -noout -subject -issuer -dates
# 输出示例:subject=CN = example.com / issuer=C = US, O = Let's Encrypt, CN = R3 / notAfter=...
# 1) 链里至少有 2 张证书(缺中间证书是手机端报错的头号原因)
grep -c "BEGIN CERTIFICATE" fullchain.crt
# 2) 证书与私钥是否配对:两条命令输出的 MD5 必须完全一致
openssl x509 -in fullchain.crt -noout -pubkey | openssl md5
openssl pkey -in private.key -pubout | openssl md5

步骤 3 · 建立独立证书目录并收紧 NTFS 权限

私钥绝不能放在 C:phpstudy_proWWW 下——Apache 默认允许读取站点目录内的任意文件,.key 会被 GET /private.key 直接下载。放到扩展目录,并断掉继承、只留 SYSTEM 读权限:

mkdir "C:phpstudy_proExtensionssslexample.com"
:: 去掉父目录继承的 Everyone/Users 权限,仅保留 SYSTEM 读、管理员完全控制
icacls "C:phpstudy_proExtensionssslexample.com" /inheritance:r /grant:r "SYSTEM:(R)" "Administrators:(F)"

步骤 4 · Apache:新增 443 虚拟主机

在 conf/vhosts 下新建 example.com_443.conf:

<VirtualHost *:443>
    ServerName example.com
    DocumentRoot "C:/phpstudy_pro/WWW/example.com"
    SSLEngine on
    # fullchain.crt 已含中间证书,Apache 2.4.8 起 SSLCertificateChainFile 已废弃,不要再写
    SSLCertificateFile    "C:/phpstudy_pro/Extensions/ssl/example.com/fullchain.crt"
    SSLCertificateKeyFile "C:/phpstudy_pro/Extensions/ssl/example.com/private.key"
    # 2.4.35 起默认 SSLProtocol 为 all -SSLv3,这里显式只留 TLS 1.2/1.3
    SSLProtocol -all +TLSv1.2 +TLSv1.3
    <Directory "C:/phpstudy_pro/WWW/example.com">
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>
</VirtualHost>

然后确认 httpd.conf 里 LoadModule ssl_module modules/mod_ssl.so 未被 # 注释、且存在 Include conf/vhosts/*.conf,最后跑语法检查:httpd.exe -t,正常输出 Syntax OK。

步骤 5 · Nginx:新增 443 server 块并先测语法

server {
    listen 443 ssl;
    server_name example.com www.example.com;
    ssl_certificate     C:/phpstudy_pro/Extensions/ssl/example.com/fullchain.crt;
    ssl_certificate_key C:/phpstudy_pro/Extensions/ssl/example.com/private.key;
    # Nginx 1.15.11 的默认 ssl_protocols 仍含 TLSv1/TLSv1.1(1.19.4 才改为仅 1.2/1.3),必须显式收紧
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_session_cache shared:SSL:10m;
    root  C:/phpstudy_pro/WWW/example.com;
    index index.php index.html;
}

不要直接点面板重启,先在 Nginx 目录执行 nginx.exe -t。常见真实报错是 nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0909006C:PEM routines:get_name:no start line),十有八九是 ssl_certificate 与 ssl_certificate_key 的路径写反了。

用途 Apache 2.4.39 Nginx 1.15.11
启用 TLS SSLEngine on(默认 off) listen 443 ssl;
证书文件 SSLCertificateFile 指向 fullchain ssl_certificate 指向 fullchain
私钥文件 SSLCertificateKeyFile ssl_certificate_key
协议版本 SSLProtocol,默认 all -SSLv3 ssl_protocols,默认含 TLSv1/1.1
语法自检 httpd -t nginx -t

步骤 6 · 补 80 端口 301 跳转并验证

# Apache:在 example.com_80.conf 的 <VirtualHost *:80> 内加入(需已加载 mod_rewrite)
RewriteEngine On
RewriteCond %{HTTPS} !=on
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]

# Nginx:独立 80 server 块,return 比 rewrite 少一次正则匹配
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
curl -I http://example.com
# 期望:HTTP/1.1 301 Moved Permanently
#       Location: https://example.com/

若返回 200 而非 301,说明 80 端口仍命中旧的默认站点;若 443 能开但浏览器提示证书链不完整,回到步骤 2 用 grep -c 数一遍 fullchain.crt 里的证书张数——这正是 phpstudy ssl证书安装 中最容易被跳过、也最常导致移动端握手失败的一环。协议与加密套件的取舍可参照 Mozilla SSL Configuration Generator 的 intermediate 档位,它给出的正是 TLS 1.2/1.3 + 前向保密套件组合,与上面的 SSLProtocol、ssl_protocols 写法一致。

配置与命令示例:Apache、Nginx 和 IIS 的具体参数怎么写

Apache 2.4.39 的 443 虚拟主机最少要写哪几行?phpStudy v8 自带的 Apache 是 2.4.39 + OpenSSL 1.1.1 组合,SSLProtocol 才认 TLSv1.3 这个关键字(Apache 2.4.36 起引入,需 OpenSSL 1.1.1 支持)。把下面这段追加到 conf/extra/httpd-ssl.conf,或直接写进 httpd.conf 末尾:

# Apache 2.4.39 / phpStudy v8,路径按实际站点替换
Listen 443
<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.example.com
    DocumentRoot C:/phpstudy_pro/WWW/example.com
    SSLEngine on
    # fullchain.crt = 站点证书 + 中间证书,顺序不能反
    SSLCertificateFile C:/phpstudy_pro/Extensions/ssl/example.com/fullchain.crt
    SSLCertificateKeyFile C:/phpstudy_pro/Extensions/ssl/example.com/private.key
    # 禁用 SSLv3/TLS1.0/TLS1.1(PCI DSS 与主流浏览器均已弃用)
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
    SSLHonorCipherOrder on
</VirtualHost>

改完不要直接重启,先在 Apache2.4.39/bin 目录执行 httpd -t,只有输出 Syntax OK 才生效;若报 AH00526: Syntax error ... SSLCertificateFile: file does not exist or is empty,说明路径里的反斜杠或盘符写错了。注意 SSLSessionCache 在 Apache 中默认是 none,生产环境建议加 SSLSessionCache "shmcb:logs/ssl_scache(512000)" 提升握手复用率。

Nginx 1.15.11 的 443 server 怎么写?写入 vhosts.conf 的 server 块内:

server {
    listen 443 ssl;
    server_name example.com www.example.com;
    ssl_certificate     C:/phpstudy_pro/Extensions/ssl/example.com/fullchain.crt;
    ssl_certificate_key C:/phpstudy_pro/Extensions/ssl/example.com/private.key;
    ssl_protocols       TLSv1.2 TLSv1.3;   # 需 OpenSSL 1.1.1 编译,否则报 invalid value
    ssl_ciphers         ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384;
    ssl_prefer_server_ciphers on;
    ssl_session_cache   shared:SSL:10m;    # 默认 none,10m 约可缓存 4 万会话
    ssl_session_timeout 1d;                # 默认 5m
}

同样先校验再重启:nginx -t 必须同时出现 syntax is ok 与 test is successful。Nginx 1.15.11 不支持用 ssl_ciphers 控制 TLS 1.3 套件(ssl_conf_command Ciphersuites 要到 1.19.4 才有),这是很多人以为“加密套件没生效”的真实原因。

80 端口怎么跳 443?Apache 在 80 虚拟主机内写 RewriteEngine On / RewriteCond %{HTTPS} !=on / RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L];Nginx 在 80 server 内一行 return 301 https://$host$request_uri; 即可。务必用 301 而非 302——据 Google 搜索中心文档,301 才会把旧 URL 的权重合并到新地址。

phpStudy 要不要改用 IIS?phpStudy 默认只跑 Apache/Nginx,IIS 属于同机另装的对比方案:

维度 Apache 2.4.39 Nginx 1.15.11 IIS 10(Windows Server)
证书文件形式 crt + key 分文件 crt + key 分文件 含私钥的 .pfx
导入位置 直接引用路径 直接引用路径 certlm.msc →「个人」导入 pfx,「中间证书颁发机构」导入中间证书
校验命令 httpd -t nginx -t netsh http show sslcert 核对证书哈希
适用场景 phpStudy 默认、.htaccess 生态 高并发静态资源 ASP.NET 站点

证书链和私钥怎么自查?用 phpStudy 自带的 OpenSSL 或系统 openssl 依次执行(OpenSSL 1.1.1 及以上):

# 1) 看证书主体、签发者、有效期和 SAN 域名是否含 www
openssl x509 -in fullchain.crt -noout -subject -issuer -dates -ext subjectAltName
# 2) 校验私钥是否完整、是否与证书匹配
openssl rsa -in private.key -check -noout
# 3) 用中间证书验证站点证书,链完整才会返回 0
openssl verify -untrusted chain.pem example.com.crt
# 期望输出:example.com.crt: OK
#          Verify return code: 0 (ok)

据 Let’s Encrypt 文档,链不完整的典型症状是浏览器正常、Android 或 curl 报 unable to get local issuer certificate,因此 fullchain.crt 必须是「站点证书在前、中间证书在后」的拼接顺序(RFC 5280 第 6.1 节定义的认证路径构建规则)。

要不要开 OCSP Stapling?能省掉客户端额外查询,Apache 加 SSLUseStapling on 与 SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"(注意 logs 目录必须已存在,否则 httpd -t 直接失败);Nginx 加 ssl_stapling on;、ssl_stapling_verify on;、ssl_trusted_certificate .../chain.pem; 与 resolver 8.8.8.8 1.1.1.1 valid=300s;。据 Mozilla SSL Configuration Generator,选 “Intermediate” 档(兼容 TLS 1.2 及以上)比 “Modern” 更适合国内仍在使用旧版客户端的场景;这也是 phpstudy ssl证书安装 完成后最常被忽略的一步——证书装上了,但 TLS 版本和 OCSP 参数仍是默认值。

方案选型对比:Apache、Nginx、IIS 与云负载怎么选

“证书下下来了,到底该配在 phpStudy 的 Apache 上、切到 Nginx,还是干脆丢给云负载?”这是 phpstudy ssl证书安装 过程中最容易卡住的一步——选错载体,后面所有配置都是白费功夫。先看一张横向对比表,再谈取舍。

方案 证书文件 配置位置 生效方式 适合场景 注意点
phpStudy Apache 2.4.x fullchain.crt + private.key conf/vhosts/*.conf 面板重启 Apache,先 httpd -t 依赖 .htaccess 的 CMS、多站点 2.4.8+ 把 fullchain 放 SSLCertificateFile,不再依赖 SSLCertificateChainFile
phpStudy Nginx 1.15.x fullchain.crt + private.key conf/vhosts/*.conf 面板重启 Nginx,先 nginx -t 高并发、反向代理 ssl_certificate 必须 fullchain,Windows 路径用 /
IIS 10 .pfx(含私钥) certlm.msc + 站点绑定 443 iisreset 或重启站点 ASP.NET、Windows 集成 中间证书放“中间证书颁发机构”,netsh http show sslcert 核对
云负载 CLB 平台上传证书 监听器 443 平台自动下发 多台后端、统一证书 后端可跑 HTTP,注意透传 X-Forwarded-Proto
宝塔 / 1Panel fullchain.pem + private.key 面板站点 SSL 面板重载 不想手改配置 不要与 phpStudy 同时监听 443

怎么选?单机 Windows 小站、跑 WordPress 或 Discuz 且依赖 .htaccess 伪静态的,用 phpStudy Apache 改 vhost 最直接,改完不必重写重写规则;静态资源多、或要把请求反向代理到 127.0.0.1:8080 的,选 Nginx,它的 ssl_session_cache 与 HTTP/2 支持更省心;生产环境有多台后端时,把证书放云负载、后端只跑 HTTP,续期和私钥保管只在一处维护,成本最低。

成本区间(2024—2025 年公开报价)。据 Let’s Encrypt 官方文档,其证书免费、有效期 90 天,需 ACME 客户端自动续期;商业 DV 单域名约 0—200 元/年;DV 通配符约 300—1000 元/年;OV 约 500—2000 元/年;EV 因浏览器 UI 已不再突出展示组织名,价格通常 2000 元/年以上且需组织验证,新项目基本不必考虑。

兼容性取舍。据 Mozilla Server Side TLS 指南与 RFC 8996(2021 年 3 月,正式弃用 TLS 1.0/1.1),只开 TLS 1.2/1.3 即可覆盖当前 Chrome、Edge、Firefox、Safari。若内部系统仍要兼容 Android 4.x 或 IE 10,应单独评估是否保留 TLS 1.0/1.1,不建议为了老客户端牺牲默认安全配置——这两类客户端本身也不再接收安全更新。

文件格式别搞混。Apache/Nginx 要 PEM 文本格式,扩展名 .crt/.pem 都行;IIS 要 .pfx;Tomcat 要 JKS 或 PKCS12。把 .pfx 直接填给 Nginx 的 ssl_certificate,启动会直接失败:

# 真实报错:nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:...:PEM lib)
# 原因:.pfx 是二进制 PKCS#12,不是 PEM。先转换(OpenSSL 1.1.1 / 3.x 均适用)
openssl pkcs12 -in cert.pfx -nokeys  -out fullchain.crt      # 导出证书(含中间证书)
openssl pkcs12 -in cert.pfx -nocerts -nodes -out private.key # 导出未加密私钥

# 转换后先自检,确认证书链完整、有效期正确
openssl x509 -in fullchain.crt -noout -subject -issuer -dates
openssl verify -CAfile chain.pem fullchain.crt

# 改完配置必须做语法检查,无输出即通过(phpStudy 自带 Apache 2.4.x / Nginx 1.15.x)
httpd -t      # Apache:Windows 下在 Apache/bin 目录执行
nginx -t      # Nginx:Windows 下在 Nginx 根目录执行

顺带一提,Apache 2.4.8 起 SSLCertificateChainFile 已被标记废弃,默认不设置;继续写它不会报错,但会和 SSLCertificateFile 里的链产生重复,部分旧版 OpenSSL 会因此报 X509_STORE_add_cert: certificate already hash。IIS 侧则可用 netsh http show sslcert 核对绑定哈希与 Certificate Hash 是否一致,这是排查“证书装了但浏览器仍提示不受信任”最快的命令。

常见错误与排查:phpStudy 报错信息逐条处理

phpStudy 下的 SSL 报错基本归为三类:文件路径与格式、证书链不完整、协议与套件不匹配。下面按你实际会看到的原始报错逐条拆解,每条都给出验证命令。做 phpstudy ssl证书安装 时先跑 httpd -t 或 nginx -t,比看浏览器提示快得多。

Apache 起不来,日志写 AH00526: Syntax error on line 12 of … SSLCertificateFile: file … does not exist or is empty?

这是 mod_ssl 在加载阶段找不到文件,不是证书内容有问题。Windows 上最常见的坑是反斜杠:C:phpstudy_pro... 里的 p、E 会被当作转义序列,路径就废了,统一改成正斜杠或双反斜杠。其次是文件 0 字节(下载中断)。phpStudy v8.1 自带 Apache 2.4.39,先做语法检查拿行号:

cd C:/phpstudy_pro/Extensions/Apache2.4.39/bin
# -t 只做配置语法检查;报错会精确到文件名+行号,Syntax OK 才算通过
httpd.exe -t -f C:/phpstudy_pro/Extensions/Apache2.4.39/conf/httpd.conf

# 确认证书文件存在且非空
dir C:phpstudy_proExtensionsApache2.4.39confsslfullchain.crt

# vhost 里的正确写法(正斜杠 + 引号)
# SSLCertificateFile    "C:/phpstudy_pro/Extensions/Apache2.4.39/conf/ssl/fullchain.crt"
# SSLCertificateKeyFile "C:/phpstudy_pro/Extensions/Apache2.4.39/conf/ssl/server.key"

注意 SSLCertificateChainFile 从 Apache 2.4.8 起已被 SSLCertificateFile 取代(据 Apache mod_ssl 官方文档),中间证书直接拼进 fullchain.crt,不要再单列一行,否则老配置在新版本里会报重复或失效。

Nginx 报 nginx: [emerg] cannot load certificate … PEM_read_bio_X509_AUX() failed?

OpenSSL 解析不到 PEM 结构。三种原因:文件其实是 DER/PFX 格式、私钥被密码保护、fullchain 里混进了文本说明。逐个排除:

# 正常输出首行应为 -----BEGIN CERTIFICATE-----
openssl x509 -in fullchain.crt -text -noout

# 若是 DER 格式(如从 IIS 导出的 .cer),先转 PEM
openssl x509 -in cert.cer -inform DER -out fullchain.crt -outform PEM

# 私钥带密码会出现 Proc-Type: 4,ENCRYPTED,需先解密
openssl rsa -in server.key -out server.dec.key

浏览器 NET::ERR_CERT_AUTHORITY_INVALID,或 curl 报 curl: (60) SSL certificate problem: unable to get local issuer certificate?

缺中间证书。服务器必须下发「站点证书 + 中间证书」,顺序不能反;根证书不要放,客户端本来就内置(RFC 8446 亦建议省略根证书以减小握手体积)。Windows 下合并与复核:

copy /b example.com.crt+intermediate.crt fullchain.crt
# 段数应为 2;出现 3 段说明把根证书也拼进去了
findstr /c:"BEGIN CERTIFICATE" fullchain.crt

# 以真实握手验证链路是否完整
openssl s_client -connect example.com:443 -servername example.com -showcerts
# 关键行:Verify return code: 0 (ok)

NET::ERR_CERT_COMMON_NAME_INVALID?

你访问的域名不在 SAN 列表里。Chrome 68 起完全忽略 CN 字段,只认 subjectAltName。查一下证书里到底写了什么:

openssl x509 -in fullchain.crt -noout -ext subjectAltName
# 期望:DNS:example.com, DNS:www.example.com, DNS:api.example.com
# OpenSSL 1.0.2 不支持 -ext,退回:
openssl x509 -in fullchain.crt -noout -text | findstr /i "DNS"

重新签发时把主域名、www、以及所有 API 子域一次性写进 SAN,据 Let’s Encrypt 文档,单张证书可容纳 100 个名称,改一次比补签三次省事。

ssl_error_rx_record_too_long 或直接 400 Bad Request?

443 端口上跑的是明文 HTTP:vhost 漏了 SSLEngine on,或者端口转发指错了。定位到进程:

netstat -ano | findstr :443
tasklist | findstr 1234
# 用上一行查到的 PID,确认是 httpd.exe 还是 nginx.exe

如果 443 被 80 端口的 vhost 抢占,检查 httpd-ssl.conf 里的 Listen 443 与 SSLEngine on。云服务器安全组只放行 443/TCP,不要做 443→80 的端口映射,TLS 握手包被转到 HTTP 服务后就是这条报错。

SSL_ERROR_NO_CYPHER_OVERLAP 或 ERR_SSL_VERSION_OR_CIPHER_MISMATCH?

协议或套件没有交集。phpStudy 自带 Nginx 1.15 的默认值是 ssl_protocols TLSv1 TLSv1.1 TLSv1.2,Apache 2.4 默认 SSLProtocol all,都还留着已被主流浏览器废弃的 TLS 1.0/1.1。按 Mozilla Server Side TLS 的 Intermediate 档收紧:

配置项 Apache (mod_ssl) Nginx 默认值
协议 SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1 ssl_protocols TLSv1.2 TLSv1.3; Apache 2.4 为 all;Nginx 1.23.4 之前为 TLSv1 TLSv1.1 TLSv1.2,之后为 TLSv1.2 TLSv1.3
套件 SSLCipherSuite ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256 ssl_ciphers 'ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256'; Nginx 为 HIGH:!aNULL:!MD5
会话复用 SSLSessionCache "shmcb:logs/ssl_scache(512000)" ssl_session_cache shared:SSL:10m; Apache 默认关闭
# 看实际协商结果,而非猜测(Windows 用 echo. | 替代 </dev/null)
openssl s_client -connect example.com:443 -servername example.com -tls1_2 /dev/null | findstr /i "Protocol Cipher"
# 期望:Protocol: TLSv1.2  Cipher: ECDHE-RSA-AES128-GCM-SHA256
# 打印 handshake failure 说明协议被禁;no shared cipher 说明套件不匹配

最后补一个高频但容易被误判的:证书与私钥不匹配,Nginx 报 SSL_CTX_use_PrivateKey() failed (SSL: ... key values mismatch),Apache 报 SSL Library Error: ... key values mismatch。用模数比对一眼确认,输出两行 MD5 必须完全一致:

openssl x509 -in fullchain.crt -noout -modulus | openssl md5
openssl rsa  -in server.key   -noout -modulus | openssl md5

效果验证:如何确认 443 与证书链已生效

问:phpStudy 里改完 vhost、点了重启,怎么确认 443 真的在监听?先在 Windows 命令行跑端口检查,别急着看浏览器。

:: Windows CMD / PowerShell 均可;PID 列在最右侧
netstat -ano | findstr :443

:: 拿到 PID 后确认进程名(示例 PID 5148)
tasklist | findstr 5148

通过标准是出现 0.0.0.0:443 或 [::]:443 且状态为 LISTENING,对应进程为 httpd.exe 或 nginx.exe。如果输出为空,问题一定在配置层,而不是证书层:Apache 需确认 httpd.conf 中 LoadModule ssl_module modules/mod_ssl.so 与 Include conf/extra/httpd-ssl.conf 两行的注释已去掉,vhost 里写的是 <VirtualHost *:443>;Nginx 则要检查 listen 443 ssl; 是否漏了 ssl 参数(漏写会退化成纯 HTTP,端口虽通但握手失败)。这一步没通过,后面所有验证都没有意义。

端口通了,再验 HTTP 语义与重定向闭环:

:: -I 只看响应头;应返回 HTTP/1.1 200 OK 或 301
curl -I https://example.com

:: 明文入口应 301 且 Location 指向 https
curl -I http://example.com

:: -v 打印握手细节,Windows 下 stderr 需合并
curl -vI https://example.com 2>&1 | findstr /C:"SSL certificate verify"

最后一行应输出 SSL certificate verify ok.(curl 7.52+ 的措辞)。Windows 10 1803 起自带 curl.exe,可直接用;若提示找不到命令,用 phpStudy 自带或 Git for Windows 的 curl。想进一步看证书链,OpenSSL 文档推荐的写法是加上 SNI:

:: -servername 传 SNI,-showcerts 打印完整链;< NUL 防止交互挂起
openssl s_client -connect example.com:443 -servername example.com -showcerts < NUL

输出里重点三行:Verify return code: 0 (ok)、Protocol : TLSv1.3、Cipher : TLS_AES_256_GCM_SHA384。TLS 1.3 需 OpenSSL 1.1.1 及以上(RFC 8446,2018 年 8 月发布);若显示 TLSv1.2 而服务端支持 1.3,多半是客户端版本旧。证书链正常时 s_client 的 Certificate chain 段会列出 2–3 张证书(叶证书 + 中间证书,根证书通常不下发);只列 1 张且出现 verify error:num=21:unable to verify the first certificate,就是典型缺中间证书,需把 CA 提供的 ca_bundle 与站点证书按“叶证书在前、中间证书在后”的顺序拼进同一个 .crt,Apache 用 SSLCertificateChainFile、Nginx 用 ssl_certificate 指向该合并文件。这也是 phpstudy ssl证书安装 中最容易翻车的一步。

验证项 命令 / 位置 通过标准 失败通常意味着
端口监听 netstat -ano | findstr :443 0.0.0.0:443 LISTENING vhost 未写 listen 443 ssl 或模块未加载
HTTPS 状态 curl -I https://域名 200 / 301 站点根目录或伪静态配置错
跳转闭环 curl -I http://域名 301 + Location: https:// 未配 Rewrite 或 return 301
证书链 openssl s_client -showcerts verify code 0,链 2–3 张 缺中间证书(num=21)
协议版本 同上,看 Protocol 仅 TLSv1.2 / TLSv1.3 仍开启 TLS1.0/1.1,需改 ssl_protocols

本地命令都通过后,再做外部视角核对。把域名丢进 Qualys SSL Labs 的 SSL Server Test,看 Certificate Path 是否完整、Protocols 是否只列 TLS 1.2 与 1.3;据 SSL Labs 评分文档,目标不是 A+,而是 A 及以上且无 “Chain issues” 告警——A+ 需要 HSTS 与 OCSP Stapling,属于加分项而非正确性。浏览器侧打开 Chrome DevTools → Security 面板,应显示 Certificate – valid and trusted;Console 若报 Mixed Content: The page at 'https://…' was loaded over HTTPS, but requested an insecure resource,说明页面里还有硬编码的 http:// 图片、JS 或 CDN 地址,与证书无关。点地址栏锁图标,核对有效期、签发者、SAN 列表是否与申请信息一致。

证书到期是最隐蔽的故障源,建议上监控而不是靠人记:

:: 解析到期日,输出形如 notAfter=Aug 12 23:59:59 2026 GMT
openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate
:: Windows CMD 把 </dev/null 换成 < NUL

Prometheus 场景可用 blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标(单位:Unix 时间戳秒),配 probe_ssl_earliest_cert_expiry - time() < 86400 * 30 在剩余 30 天时告警;Let’s Encrypt 证书有效期 90 天,30 天阈值留足续签与排障窗口。至此,phpstudy ssl证书安装 的效果才算被端口、协议、证书链、浏览器与监控五个层面同时证实。

证书续期与自动提醒:Let's Encrypt 90 天和商业证书 1 年怎么管

Let’s Encrypt 的 90 天有效期,到底该隔多少天续一次?

据 Let’s Encrypt 官方文档,其证书固定 90 天有效,官方建议在剩余 30 天前完成续期。实践里更稳妥的做法是按 60 天周期续(即剩余 30 天左右触发),原因是:万一续期失败,你还有约 30 天缓冲去排查 DNS、80/443 端口验证或文件权限问题,而不是在到期前几小时才发现站点已经打不开。acme.sh 的默认续期阈值恰好就是 60 天(配置项 Le_RenewalDays=60),certbot 则在 /etc/letsencrypt/renewal/*.conf 中按到期前 30 天触发,两者思路一致。

certbot 与 acme.sh 怎么演练和定时?

# certbot:先演练,不真正签发(适用 certbot 1.x 及以上)
certbot renew --dry-run

# 正式续期;--deploy-hook 只在证书真的更新后才执行
certbot renew --quiet --deploy-hook "systemctl reload nginx"
# 默认续期阈值:剩余 30 天;配置文件在 /etc/letsencrypt/renewal/

# acme.sh:--cron 是给定时任务调用的入口,只在需要时续
~/.acme.sh/acme.sh --cron --home ~/.acme.sh
# 安装/查看默认 cron(每天 0 点执行)
~/.acme.sh/acme.sh --install-cronjob
crontab -l | grep acme.sh   # 0 0 * * * "/home/me/.acme.sh"/acme.sh --cron ...

Windows 上的 phpStudy 没有 cron,怎么每天自动跑?

用任务计划程序每天 03:00 调一个批处理:在 WSL 或 Linux 跳板机上跑 acme.sh,续期成功后把 fullchain.cer、*.key 同步到 C:/phpstudy_pro/Extensions/ssl/example.com/,再校验并重启服务。这也是 phpstudy ssl证书安装 里最容易被忽略的一步——只覆盖文件不重启,旧进程仍在用旧证书。

REM renew.bat —— 由任务计划程序每天 03:00 调用(路径按实际版本目录调整)
wsl -d Ubuntu -- /home/me/.acme.sh/acme.sh --cron --home /home/me/.acme.sh
copy /Y \wsl$Ubuntuhomeme.acme.shexample.com_eccfullchain.cer C:phpstudy_proExtensionssslexample.comfullchain.crt
copy /Y \wsl$Ubuntuhomeme.acme.shexample.com_eccexample.com.key  C:phpstudy_proExtensionssslexample.comprivate.key
"C:phpstudy_proExtensionsApache2.4.39binhttpd.exe" -t && net stop Apache2.4 && net start Apache2.4
REM Nginx 版本改为:nginx.exe -t && nginx.exe -s reload

REM 注册计划任务(/ru SYSTEM 保证无人登录也执行)
schtasks /create /tn "phpStudyCertRenew" /tr "C:phpstudy_prorenew.bat" /sc daily /st 03:00 /ru SYSTEM

免费证书和商业证书的管理节奏有什么不同?

对比项 Let’s Encrypt(certbot / acme.sh) 商业证书(DV/OV/EV)
有效期 90 天 通常 1 年(部分 CA 支持 2 年但主流浏览器不认)
续期触发 剩余 30 天(acme.sh 默认 60 天) 到期前 30 天联系 CA 续费
验证成本 全自动,无需人工 OV/EV 需重新核验组织信息,预留 3–5 个工作日
典型风险 验证失败、端口被拦、忘记重启 联系人离职、发票流程慢、CSR 与私钥不匹配

商业证书续费时要注意:*.example.com 只覆盖一级子域,不覆盖 a.b.example.com;若站点用了多级子域,需申请 *.b.example.com 或写入 SAN。

怎么用一条命令监控到期时间?

# 从外部看真实生效的证书(echo 防止 s_client 挂起)
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null 
  | openssl x509 -noout -enddate
# 输出示例:notAfter=Jun 12 03:14:07 2025 GMT

把 notAfter 解析成时间戳写入监控:剩余小于 30 天告警,小于 7 天升级为紧急告警(此时自动续期多半已经连续失败)。

证书多了怎么不混乱?

建一张清单:域名、SAN 列表、签发者、到期日、绑定端口、配置文件路径(Apache 的 httpd-ssl.conf 或 vhost、Nginx 的 server{ listen 443 ssl; })、负责人。每季度审计一次,重点清理测试域名证书——它们过期后仍挂在生产 vhost 上,会让部分客户端握手失败。这也是 phpstudy ssl证书安装 后最常见的”隐形故障”来源:多个站点共用 443,SNI 指错了证书文件。

Q:TLS 1.2/1.3 都开吗?关掉 TLS 1.0/1.1 会误伤谁?

要开。TLS 1.3 由 RFC 8446(2018 年 8 月)定义,握手压到 1-RTT、只保留 AEAD 套件,能明显降低首字节延迟。禁用旧协议的真实代价见下表:

协议版本 禁用后无法连接的客户端 典型报错
TLS 1.0 IE 6–10、Android 4.3 及以下、Win XP/2003 ERR_SSL_VERSION_OR_CIPHER_MISMATCH
TLS 1.1 IE 11(部分未打补丁环境)、Android 4.4 sslv3 alert handshake failure
TLS 1.2/1.3 保留即可,无兼容负担 —

面向公网默认建议禁用旧版本;内网后台或对接老旧设备的接口可酌情保留 TLS 1.1。这也是 phpStudy SSL 证书安装后最常被漏掉的一步——证书换上了,协议集合还是默认的宽松配置。

# Apache 2.4.x(phpStudy 自带 2.4.39/2.4.48 等),写入 httpd-ssl.conf 或 443 vhost
SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
# 说明:TLS 1.3 需 Apache 2.4.36+ 且链接 OpenSSL 1.1.1+;all 已包含 TLSv1.3
SSLHonorCipherOrder on
SSLCipherSuite HIGH:!aNULL:!MD5:!3DES:!RC4   # 禁用 RC4、3DES、NULL

# Nginx 1.15.x,写入 443 server 块
ssl_protocols TLSv1.2 TLSv1.3;   # TLSv1.3 需 Nginx 1.13.0+ 且 OpenSSL 1.1.1+
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 on;

套件清单取自 Mozilla SSL Configuration Generator 的 intermediate 档,兼顾 Android 4.4+/Java 8+;若只需支持现代浏览器可换 modern 档(仅 TLS 1.3)。

Q:HSTS 能不能一上来就写 31536000?

不能。据 RFC 6797,HSTS 一旦下发,浏览器在 max-age 内会强制把 http:// 升级为 https://,证书出问题就直接白屏且用户无法”继续访问”。先用 5 分钟试水,确认全站(含子域、API、图片域名)都能 HTTPS 后再放大:

# Apache:先小后大
Header always set Strict-Transport-Security "max-age=300"
# 全站验证通过后改为:
# Header always set Strict-Transport-Security "max-age=31536000; includeSubDomains"

# Nginx:
add_header Strict-Transport-Security "max-age=300" always;
# 稳定后:add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

preload 不要急着加——它需要提交到浏览器内置列表,移除周期长达数月。用 curl -I https://你的域名 确认响应头生效,always 参数保证 4xx/5xx 响应也带上该头。

Q:OCSP Stapling 值不值得开?

值得。它让服务器代替客户端去查证书吊销状态并把结果”钉”在握手里,省掉一次额外 DNS + HTTP 请求(Let’s Encrypt 的 OCSP 响应通常可缓存数天)。前提是服务器能出网做 DNS 解析和 HTTP 访问。

# Nginx:chain.pem 必须是「站点证书 + 中间证书」的完整链
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /phpstudy/server/nginx/conf/ssl/example.com_chain.pem;
resolver 8.8.8.8 1.1.1.1 valid=300s;
resolver_timeout 5s;

# Apache:缓存必须用 shmcb 共享内存
SSLUseStapling on
SSLStaplingCache "shmcb:logs/ssl_stapling(32768)"

验证:openssl s_client -connect example.com:443 -status </dev/null | grep -A2 "OCSP Response",看到 Response verify OK 才算成功;显示 no response sent 多半是链文件缺中间证书或 DNS 被墙。

Q:页面还是 http 资源、锁标变灰怎么办?

这是混合内容(mixed content),与协议配置无关。WordPress 用 WP-CLI 全库替换,并核对 wp_options 里的 siteurl 与 home:

wp search-replace 'http://example.com' 'https://example.com' --all-tables --precise --dry-run
# 确认影响行数无误后去掉 --dry-run 正式执行

应急可在 vhost 加 add_header Content-Security-Policy "upgrade-insecure-requests" always;,但这是兜底,不是修复。

Q:改配置前怎么留后路?

先备份:cp example.com_443.conf example.com_443.conf.bak,旧证书文件保留 7 天。回滚流程固定为:恢复配置 → httpd -t 或 nginx -t 语法检查 → 重载服务。跳过检查直接重启,是 phpStudy SSL 证书安装后 443 整站不可用的头号原因。

先查 443 是否真的监听:netstat -ano | findstr :443,再查证书 SAN 是否包含当前域名。若报 NET::ERR_CERT_AUTHORITY_INVALID,优先补中间证书,把 fullchain.crt 给 Apache 的 SSLCertificateFile 或 Nginx 的 ssl_certificate。

单机小站、依赖 .htaccess 的 WordPress/Discuz 用 Apache 更直接,改 443 vhost 即可;静态资源多、需要反向代理或更高并发时用 Nginx。两者证书文件都用 fullchain.crt + private.key,差别在指令名和重启方式。

phpStudy v8.1 面板主要提供证书导入与站点绑定,是否内置自动申请取决于安装包与版本;更稳妥的是用 certbot 或 acme.sh 申请,拿到 fullchain.cer 与 .key 后在 phpStudy 里绑定。Let's Encrypt 90 天有效,续期后要重启 Apache/Nginx。

Nginx 的 ssl_certificate 必须用 fullchain,也就是站点证书加中间证书合并;Apache 2.4.8+ 也建议把 fullchain 放 SSLCertificateFile。不要只放站点证书,否则 Android、Java、curl 常见 unable to get local issuer certificate。

先确认文件是 PEM 文本且未被加密,用 openssl x509 -in fullchain.crt -text -noout 能解析。再看 Nginx 路径是否写成 C:/phpstudy_pro/…,以及 ssl_certificate 是否误填了 .pfx 或只含私钥的文件。改完执行 nginx -t 再重启。

Apache 在 80 vhost 加 RewriteEngine On、RewriteCond %{HTTPS} !=on、RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L];Nginx 在 80 server 加 return 301 https://$host$request_uri;。用 curl -I http://example.com 看到 301 和 Location 为 https 即生效。

不建议。私钥放 C:/phpstudy_pro/WWW 下可能被 https://example.com/private.key 直接下载;应放到 C:/phpstudy_pro/Extensions/ssl/example.com/ 这类非 Web 根目录,并用 icacls 限制为 SYSTEM 与 Administrators 可读。


本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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