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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。