Let’s Encrypt SSL 证书 IIS 安装部署教程:PFX 转换、自动续期与证书链排错
问题背景与根因:IIS 部署 Let’s Encrypt 为什么总在“链”和“绑定”上翻车
Let’s Encrypt 是免费 DV 证书,有效期 90 天,通过 ACME 协议自动签发和续期;公共 TLS 证书受 CA/B Forum 约束,单张最长有效期 398 天,因此“一次导入管一年”在 Let’s Encrypt 场景不成立。IIS 的证书存储使用 PKCS#12(.pfx),要求同时包含叶子证书、中间证书和私钥;而 ACME 客户端默认输出 PEM 格式的 cert.pem、chain.pem、fullchain.pem、privkey.pem。直接把 cert.pem 转 PFX,浏览器可能正常,但 curl、Java、微信小程序会报证书链不完整。
第二个根因是 IIS 绑定记录的是证书 Thumbprint,续期后新证书已导入,但站点绑定仍指向旧证书;第三个根因是 Windows Server 2012 R2/2016 的 Schannel 可能未启用 TLS 1.2,导致小程序和旧客户端握手失败。还有 SNI 绑定、443 端口重复绑定、URL Rewrite 模块缺失等。本文按“生成/转换 → 导入绑定 → 重定向与 TLS → 验证排错”给出可执行命令,关键词包括 Let’s Encrypt、IIS、PFX、fullchain、中间证书、Schannel、TLS 1.2、SNI、自动续期。
先明确一个判断标准:IIS 导入 PFX 后,浏览器锁图标只代表本机信任链通过;真正要验证的是外部客户端能否拿到“叶子证书 + 中间证书”。如果 PFX 只含叶子证书,curl 会报 unable to get local issuer certificate,Java 会报 PKIX path building failed。部署前务必确认 fullchain.pem 已包含中间证书,或用 -certfile chain.pem 补齐。
完整实操步骤:用 win-acme 申请并生成 IIS 可用的 PFX
Windows 原生推荐 win-acme(WACS),它可直接写 IIS 绑定并创建续期任务。下载解压后以管理员打开 PowerShell,执行:
cd C:/tools/win-acme
.wacs.exe --target iis --host example.com --installation iis --store pfxfile --pfxfilepath C:/certs/example.com.pfx --pfxpassword "StrongPass123" --accepttos --emailaddress admin@example.com
若已有 PEM 文件,用 OpenSSL 转换。fullchain.pem 已含中间证书,直接作为 -in;若只有 cert.pem 和 chain.pem,则使用 -in cert.pem -certfile chain.pem:
openssl pkcs12 -export -out C:/certs/example.com.pfx -inkey C:/certs/privkey.pem -in C:/certs/fullchain.pem -passout pass:StrongPass123
openssl pkcs12 -info -in C:/certs/example.com.pfx -noout
检查证书与私钥是否匹配:
openssl x509 -noout -modulus -in C:/certs/cert.pem | openssl md5
openssl rsa -noout -modulus -in C:/certs/privkey.pem | openssl md5
两个 MD5 必须一致。若用 acme.sh,可在 WSL/Git Bash 执行 acme.sh –issue -d example.com -w C:/inetpub/wwwroot,再用 –install-cert 输出 key/fullchain 并调用转换脚本。注意 PFX 密码不要用特殊字符导致命令行解析失败;win-acme 的 –installation iis 会自动导入并更新绑定,但仍建议后续用 netsh 核对。
将 PFX 导入 IIS 并完成 HTTPS 绑定
GUI 路径:IIS 管理器 → 服务器证书 → 导入,选择 PFX,输入密码,证书存储选“个人/My”。站点 → 绑定 → 添加 → 类型 https、端口 443、主机名 example.com、勾选“需要服务器名称指示”、选择证书。PowerShell 导入并取 Thumbprint:
Import-PfxCertificate -FilePath C:/certs/example.com.pfx -CertStoreLocation Cert:LocalMachineMy -Password (ConvertTo-SecureString -String 'StrongPass123' -AsPlainText -Force)
$cert = Get-ChildItem Cert:LocalMachineMy | Where-Object {$_.Subject -like '*example.com*'} | Sort-Object NotAfter -Descending | Select-Object -First 1
$cert | Select-Object Subject,NotAfter,Thumbprint
创建绑定并关联证书。已有绑定先删除,避免 0x800700B7:
New-WebBinding -Name 'Default Web Site' -Protocol https -Port 443 -HostHeader example.com -SslFlags 1
netsh http delete sslcert hostnameport=example.com:443
netsh http add sslcert hostnameport=example.com:443 certhash=$($cert.Thumbprint) appid='{4dc3e181-e14b-4a21-b022-59fc669b0914}' certstorename=MY
netsh http show sslcert hostnameport=example.com:443
SslFlags 1 表示 SNI。多站点共用 443 必须用 SNI,否则第二个站点无法绑定。验证输出中的 Certificate Hash 与 $cert.Thumbprint 一致,Application ID 为上述 GUID。若用 win-acme 的 –installation iis,会自动完成导入和绑定,但仍建议核对 netsh 输出,并确认站点绑定列表里 https 绑定的证书是续期后的新 Thumbprint。
配置示例:HTTP 跳转 HTTPS、TLS 1.2 与续期任务
先安装 IIS URL Rewrite 模块,站点根目录 web.config 示例:
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<system.webServer>
<rewrite>
<rules>
<rule name="Redirect to HTTPS" stopProcessing="true">
<match url="(.*)" />
<conditions>
<add input="{HTTPS}" pattern="off" ignoreCase="true" />
</conditions>
<action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="Permanent" />
</rule>
</rules>
</rewrite>
</system.webServer>
</configuration>
启用 TLS 1.2(管理员 CMD,执行后重启):
reg add "HKLM\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server" /v Enabled /t REG_DWORD /d 1 /f
reg add "HKLM\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server" /v DisabledByDefault /t REG_DWORD /d 0 /f
reg add "HKLM\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client" /v Enabled /t REG_DWORD /d 1 /f
reg add "HKLM\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client" /v DisabledByDefault /t REG_DWORD /d 0 /f
shutdown /r /t 0
续期任务:win-acme 默认创建计划任务,检查任务计划程序中 WACS 任务;若手动转换,需在续期后重新执行 Import-PfxCertificate 并更新 netsh 绑定。可写 PowerShell 脚本:Import-PfxCertificate …;$cert=…;netsh http update sslcert hostnameport=example.com:443 certhash=… appid=… certstorename=MY。注意 update 不改变绑定主机名,续期后必须让脚本和 IIS 绑定都指向新证书。
对比表格:IIS 部署方式与证书格式怎么选
表 1:部署方式对比。
| 方式 | 适用环境 | 续期 | IIS 绑定 | 注意事项 |
|---|---|---|---|---|
| win-acme | Windows/IIS | 自动计划任务 | 可自动更新 | 推荐;注意 PFX 密码和任务账户权限 |
| Certbot | 跨平台/Webroot | 需配置续期钩子 | 需转换 PFX 并脚本绑定 | Windows 支持有限,适合已有 Linux 经验 |
| acme.sh | Linux/WSL/Git Bash | 自动 cron | 需转换 PFX 并脚本绑定 | 轻量;注意路径与权限 |
| IIS 手动导入 | 一次性测试 | 手动 | GUI 绑定 | 易漏中间证书,续期易忘 |
表 2:证书格式对比。
| 格式 | IIS 支持 | 内容 | 典型用途 |
|---|---|---|---|
| PFX/PKCS12 | 直接导入 | 叶子证书+中间证书+私钥 | IIS 绑定、Windows 证书存储 |
| PEM fullchain | 需转换 | 叶子证书+中间证书 | Nginx/Apache、ACME 输出 |
| PEM cert | 需转换且易缺链 | 仅叶子证书 | 不推荐单独用于 IIS |
| DER/CER | 需转换 | 二进制证书 | 部分设备导入 |
选择原则:IIS 生产环境优先 win-acme + PFX;已有 Certbot 证书时,用 fullchain.pem 转 PFX,不要用 cert.pem 单独转;多站点共用 443 必须 SNI,且每个主机名绑定各自证书。
常见错误排查:真实报错与定位命令
1)curl: (60) SSL certificate problem: unable to get local issuer certificate。原因 PFX 只含叶子证书。用 fullchain.pem 重新转换,或临时 curl –cacert chain.pem 验证。2)Java:PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target。同上,检查中间证书。3)导入 PFX 报 The specified network password is not correct. (0x80070056)。密码错误或 PFX 损坏,用 openssl pkcs12 -info -in example.com.pfx -noout 验证。4)netsh add sslcert 报 The SSL certificate is invalid. 0x800b0109。证书未受信任或链缺失。5)绑定报 Cannot create a file when that file already exists. (0x800700B7)。先 netsh http delete sslcert hostnameport=example.com:443。6)续期后仍旧证书。Get-ChildItem Cert:LocalMachineMy 看 NotAfter,netsh http show sslcert 看 Hash,再 iisreset。7)浏览器 NET::ERR_CERT_AUTHORITY_INVALID。检查是否自签或链不完整。8)小程序 request:fail ssl hand shake error。启用 TLS 1.2 并确认链完整。定位顺序:先 openssl s_client 看链,再 netsh 看绑定,最后看 IIS 日志和 Schannel 事件。
效果验证:从本机到外部的 5 个检查
1)浏览器访问 https://example.com,确认锁图标和证书有效期。2)curl -I https://example.com,期望 HTTP/2 200 或 HTTP/1.1 200。3)curl -v https://example.com 2>&1 | findstr /C:"SSL certificate",确认 verify ok。4)openssl s_client -connect example.com:443 -servername example.com -showcerts,输出 Verify return code: 0 (ok),并检查证书链至少两张。5)netsh http show sslcert hostnameport=example.com:443,核对 Certificate Hash 与 IIS 绑定一致。6)PowerShell 检查到期:Get-ChildItem Cert:LocalMachineMy | Where-Object {$_.Subject -like ‘*example.com*’} | Select-Object Subject,NotAfter,Thumbprint。7)用外部网络或 SSL Labs 测试,目标 A 级;本机信任库可能掩盖链问题,必须从另一台机器验证。若 curl 正常但小程序失败,重点查 TLS 1.2 和中间证书。
常见问题
Let’s Encrypt 证书有效期为 90 天,公共 TLS 证书最长有效期为 398 天。IIS 部署后应配置 win-acme 或 acme.sh 自动续期,并在续期后更新 PFX 与 IIS 绑定,避免 90 天后过期。
IIS 证书存储使用 PKCS#12 格式,PFX 可同时包含叶子证书、中间证书和私钥。fullchain.pem 只有证书链,没有私钥,必须用 openssl pkcs12 -export 转换并设置密码后才能导入 IIS。
先查 IIS 绑定证书 Thumbprint 是否为新证书,再执行 netsh http show sslcert 核对 Hash,最后 iisreset。若用 win-acme,确认计划任务已运行且 –installation iis 成功更新绑定。
这是证书链不完整,通常是把 cert.pem 而不是 fullchain.pem 转成了 PFX。重新用 fullchain.pem 转换并导入,或用 curl –cacert chain.pem 临时验证中间证书是否正确。
Windows Server 2012 R2 及更早版本可能默认未启用 TLS 1.2。需在 Schannel 注册表 Server/Client 下设置 Enabled=1、DisabledByDefault=0,然后重启服务器,再用 openssl s_client -tls1_2 验证。