跳到主要内容
IIS

Let’s Encrypt 证书 IIS 部署实战:PFX 转换、HTTPS 绑定、证书链排错与自动续期

一、问题背景与根因:IIS 部署 Let’s Encrypt 为什么总在“格式”和“证书链”上出错

把 Let’s Encrypt 证书装到 IIS 上失败,几乎从来不是“证书本身有问题”,而是四类根因叠加。

根因 1:格式不匹配。ACME 客户端(certbot、acme.sh、Win-ACME)产出的是 PEM 四件套:cert.pem、chain.pem、fullchain.pem、privkey.pem;而 IIS 管理器的“导入证书”对话框只认 PFX(PKCS#12),且必须输入非空密码。把 PEM 直接拖进去,IIS 会静默不识别,站点绑定列表里根本选不到这张证书。

根因 2:证书链缺失。fullchain.pem = 叶子证书 + 中间证书(Let’s Encrypt 当前为 R10/R11、E5/E6 系列)。只拿 cert.pem 导出 PFX,得到的是一张“Chrome 能忍、curl / Java / 微信小程序不能忍”的证书。2021 年 DST Root CA X3 交叉签名到期,更是让一批未更新根证书的 Windows Server 2012 直接报 NET::ERR_CERT_AUTHORITY_INVALID。

根因 3:有效期短。Let’s Encrypt 固定 90 天,一年至少续期 4 次。同时,公共 TLS 证书单张最长有效期已从沿用多年的 398 天收紧为 200 天(CA/B Forum SC-081,2026-03-15 起生效,2027 年进一步降到 100 天)。这意味着“手工申请、手工导入”的做法在 IIS 上已经完全不可行。

根因 4:协议与绑定模型。Windows Server 2012 / 2012 R2 默认未启用 TLS 1.2,握手阶段就会被现代客户端拒绝;同一台机器 443 端口跑多个站点,必须在绑定中勾选 SNI,否则后绑定的站点会把前面站点的证书“串”掉;使用 ipport=0.0.0.0:443 的 IP 绑定只能挂一张证书。

结论:IIS 场景的正确路线是「PFX 转换 + 证书链校验 + Win-ACME 自动续期 + SNI 绑定」,下面按顺序给出可执行命令。

二、准备证书文件:PEM 四件套转 PFX 的可执行流程

目标:产出一个同时包含叶子证书、中间证书、私钥的 PFX,且私钥能被 IIS 工作进程读取。以下命令在 Linux/WSL 或 Git Bash 中执行,文件放在同一目录。

2.1 校验私钥与证书是否匹配

# RSA 证书:比对模数(两个 md5 必须一致)
openssl x509 -noout -modulus -in cert.pem | openssl md5
openssl rsa  -noout -modulus -in privkey.pem | openssl md5

# ECDSA 证书:比对公钥(Let's Encrypt 默认签发 ECDSA P-256)
openssl x509 -in cert.pem -pubkey -noout | openssl md5
openssl pkey -in privkey.pem -pubout | openssl md5

模数/公钥不一致,说明申请过程中私钥被重新生成过(常见于 certbot 与 acme.sh 混用),必须重新签发,任何格式转换都救不回来。

2.2 校验证书链是否完整

openssl verify -CAfile chain.pem -untrusted chain.pem cert.pem
# 期望输出:cert.pem: OK

若报 error 20 at 0 depth lookup: unable to get local issuer certificate,说明 chain.pem 里缺中间证书,重新从 ACME 客户端目录取 chain.pem,不要用系统自带 CA 包替代。

2.3 导出 PFX(含完整链)

cat cert.pem chain.pem > fullchain.pem
openssl pkcs12 -export -out example.com.pfx 
  -inkey privkey.pem -in fullchain.pem 
  -keypbe AES-256-CBC -certpbe AES-256-CBC -macalg sha256

注意 -in 已经指向 fullchain,不要再加 -certfile chain.pem,否则中间证书会重复打包,部分老旧 Windows 版本导入时报 0x80092002。加密算法显式指定 AES-256-CBC + SHA256,是为了兼容 Windows Server 2012 R2 之后的 PFX 解析器(RC2/40 位的老算法在 2019 之后已被默认禁用)。

2.4 导入到本地计算机证书存储

$pwd = ConvertTo-SecureString -String 'P@ssw0rd!' -AsPlainText -Force
Import-PfxCertificate -FilePath C:certsexample.com.pfx `
  -CertStoreLocation Cert:LocalMachineMy -Password $pwd

必须导入 LocalMachineMy(本地计算机个人),导入到 CurrentUserMy 会在 IIS 绑定时报 0x80070520。导入后执行 certutil -store My example.com,确认输出里有 证书链 且私钥可读。

三、完整实操:Win-ACME 签发并自动绑定 IIS

Win-ACME 是目前 Windows/IIS 场景下唯一原生集成 IIS 的 ACME 客户端:certbot 官方无 IIS 部署插件,acme.sh 需要 WSL 或 Git Bash,都无法直接写 IIS 绑定。

步骤 1:下载与解压。获取 win-acme.v2.x.x.x64.pluggable.zip,解压到 C:win-acme,不要在压缩包内直接运行(临时目录会被清理,续期任务找不到程序)。

步骤 2:交互式签发(首次推荐)。以管理员身份运行 wacs.exe → 选 M(Create certificate (full options))→ 选择 IIS 站点 → 勾选域名 → 验证方式选 [http-01] Self-hosting(临时占用 80 端口)或 File system(站点目录可写)→ 存储选 PEM + PFX → 安装选 IIS → 完成后自动创建计划任务。

步骤 3:命令行无人值守签发(可直接复制执行)。

wacs.exe --target iis --host example.com --installation iis ^
  --email admin@example.com --accepttos ^
  --validation filesystem --webroot C:inetpubwwwroot ^
  --pfxpassword "P@ssw0rd!"

参数含义:--target iis 从 IIS 站点读取主机名;--installation iis 自动创建/更新 443 绑定;--validation filesystem 把验证文件写入 webroot 的 .well-knownacme-challenge,不占用 80 端口;--accepttos 表示接受 ACME 服务条款。

步骤 4:已有 PFX 时手工绑定。

$thumb = (Get-ChildItem Cert:LocalMachineMy |
  Where-Object {$_.Subject -like '*CN=example.com*'}).Thumbprint
netsh http add sslcert hostnameport=example.com:443 certhash=$thumb `
  appid={4dc3e181-e14b-4a21-b022-59fc669b0914} certstorename=MY

hostnameport=域名:443 会创建 SNI 绑定,同一 443 端口可挂多个域名;写成 ipport=0.0.0.0:443 则是 IP 绑定,只能挂一张证书。appid 可填任意 GUID,习惯上沿用 IIS 的 {4dc3e181-e14b-4a21-b022-59fc669b0914}。

步骤 5:验证续期任务。

Get-ScheduledTask -TaskName 'win-acme*' | Select-Object TaskName,State
Start-ScheduledTask -TaskName 'win-acme renew (acme-v02.api.letsencrypt.org)'

Win-ACME 续期成功后直接替换 IIS 绑定,无需重启 IIS;只有手工覆盖 PFX 文件的场景才需要 iisreset /noforce 或 Restart-Service W3SVC。建议先用 --baseuri https://acme-staging-v02.api.letsencrypt.org/directory 在测试环境跑通,避免触发正式环境的速率限制(同一域名每周 50 张)。

四、配置示例:强制 HTTPS、TLS 1.2/1.3 与验证路径放行

证书装好只是第一步,还要保证 HTTP 自动跳转、旧协议关闭、ACME 验证路径不被重定向拦截。以下 web.config 放在站点根目录,规则顺序不能颠倒:LetsEncryptExclude 必须在 ForceHTTPS 之前,否则 http-01 验证请求会被 301 到 https,Win-ACME 报 Authorization failed。

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <system.webServer>
    <rewrite>
      <rules>
        <rule name="LetsEncryptExclude" stopProcessing="true">
          <match url="^.well-known/acme-challenge/.*" />
          <action type="None" />
        </rule>
        <rule name="ForceHTTPS" stopProcessing="true">
          <match url="(.*)" />
          <conditions logicalGrouping="MatchAll">
            <add input="{HTTPS}" pattern="off" ignoreCase="true" />
          </conditions>
          <action type="Redirect" url="https://{HTTP_HOST}/{R:1}" redirectType="Permanent" />
        </rule>
      </rules>
    </rewrite>
    <httpProtocol>
      <customHeaders>
        <remove name="X-Powered-By" />
        <add name="Strict-Transport-Security" value="max-age=31536000; includeSubDomains" />
      </customHeaders>
    </httpProtocol>
  </system.webServer>
</configuration>

HSTS 头务必在“全站 HTTPS 已验证无误”之后再加,且 max-age 先从小值(如 300)试跑,否则回退成本很高。

启用 TLS 1.2 / 1.3 并关闭 TLS 1.0/1.1(管理员 PowerShell,执行后重启服务器生效):

foreach ($p in @('TLS 1.2','TLS 1.3')) {
  $path = "HKLM:SYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocols$pServer"
  New-Item -Path $path -Force | Out-Null
  New-ItemProperty -Path $path -Name 'Enabled' -Value 1 -PropertyType DWord -Force | Out-Null
  New-ItemProperty -Path $path -Name 'DisabledByDefault' -Value 0 -PropertyType DWord -Force | Out-Null
}
foreach ($p in @('TLS 1.0','TLS 1.1')) {
  $path = "HKLM:SYSTEMCurrentControlSetControlSecurityProvidersSCHANNELProtocols$pServer"
  New-Item -Path $path -Force | Out-Null
  New-ItemProperty -Path $path -Name 'Enabled' -Value 0 -PropertyType DWord -Force | Out-Null
  New-ItemProperty -Path $path -Name 'DisabledByDefault' -Value 1 -PropertyType DWord -Force | Out-Null
}

如果 web.config 里的 rewrite 节点报“无法读取配置节”,说明该节被锁定,执行:%windir%system32inetsrvappcmd.exe unlock config -section:system.webServer/rewrite/rules。此外,使用 .NET Framework 4.x 的老站点还需设置 SchUseStrongCrypto=1 与 SystemDefaultTlsVersions=1,否则应用层仍会协商到 TLS 1.0。

五、方案对比:IIS 场景下四种证书来源怎么选

IIS 生态里可选的不只是 Win-ACME。下表按“能否原生写 IIS 绑定”“续期机制”“输出格式”等维度横向对比,结论直接决定你后续的运维成本。

维度 Win-ACME Certbot acme.sh 商业 DV 证书
IIS 原生集成 内置 --installation iis 无,需手工转 PFX 并绑定 无,需 WSL/Git Bash 手工导入 PFX
自动续期 Windows 计划任务(自动创建) cron / systemd timer cron 人工,到期前邮件提醒
单张有效期 90 天 90 天 90 天 最长 200 天(2026-03 起)
输出格式 PFX / PEM / Central SSL PEM PEM PFX / PEM
验证方式 http-01 / tls-alpn-01 / dns-01 http-01 / dns-01 http-01 / dns-01 / tls-alpn-01 域名或组织验证
典型适用 单机或多站点 IIS Linux 反向代理后端 NAS、路由器、嵌入式 需要 OV/EV 或 SLA 保障

选型建议:纯 Windows 环境选 Win-ACME,它是唯一能把“申请—转换—绑定—续期”全流程自动化的方案;如果站点前置了 Nginx/HAProxy 做 TLS 终止,则后端 IIS 只跑 HTTP,用 certbot 更顺手;内网隔离、80 端口不可达的场景,三种客户端都应改用 dns-01 验证(Win-ACME 支持阿里云、Cloudflare、DNSPod 等插件)。

还有一点容易被忽略:Let’s Encrypt 是 DV 证书,不含组织信息、不提供赔付。面向公众的电商、支付类站点如果合规要求 OV/EV,则应采购商业证书;但商业证书 200 天的上限同样意味着续期流程必须自动化,只是把 ACME 客户端换成了厂商提供的脚本或控制台 API。

六、常见错误排查:6 个真实报错与修复命令

报错 1:curl: (60) SSL certificate problem: unable to get local issuer certificate,或 Java 侧 sun.security.validator.ValidatorException: PKIX path building failed: unable to find valid certification path to requested target。
原因:服务器只下发了叶子证书,中间证书缺失。修复:openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null,正常应输出 2 张以上证书;若只有 1 张,用 fullchain.pem 重新导出 PFX 并重建绑定。

报错 2:浏览器提示 NET::ERR_CERT_AUTHORITY_INVALID,但同一证书在别的机器正常。
原因:旧版 Windows Server 的“受信任的根证书颁发机构”存储里没有 ISRG Root X1。修复:Import-Certificate -FilePath isrgrootx1.der -CertStoreLocation Cert:LocalMachineRoot,或在组策略中启用“根证书自动更新”。

报错 3:IIS 绑定证书时报 A specified logon session does not exist. It may already have been terminated. (Exception from HRESULT: 0x80070520)。
原因:证书导入到了 CurrentUserMy,或私钥 ACL 未授予 IIS。修复:删除后重新导入 Cert:LocalMachineMy;再执行 certutil -repairstore My <指纹>;必要时给 C:ProgramDataMicrosoftCryptoRSAMachineKeys 下对应文件添加 NETWORK SERVICE 读取权限。

报错 4:netsh http add sslcert 返回 Error: 183 当文件已存在时,无法创建该文件。
原因:该 hostnameport 已有绑定。修复:先 netsh http delete sslcert hostnameport=example.com:443,再重新 add;批量排查用 netsh http show sslcert 输出全部绑定与指纹。

报错 5:访问站点返回 HTTP Error 500.19 - Internal Server Error,配置错误显示 This configuration section cannot be read because it is locked。
原因:rewrite 或 httpProtocol 节被锁定。修复:appcmd unlock config -section:system.webServer/rewrite/rules(httpProtocol 同理替换节名),然后 iisreset /noforce。

报错 6:Win-ACME 输出 Authorization failed,详情为 Fetching http://example.com/.well-known/acme-challenge/xxx: Connection refused 或返回 301。
原因:80 端口被防火墙拦截,或站点重定向规则把验证请求跳到了 https。修复:放行入站 80;在 web.config 中把 LetsEncryptExclude 规则置于重定向规则之前(见第四节);或改用 --validation filesystem 直接写文件。

另外,续期后站点仍显示旧证书,先跑 netsh http show sslcert hostnameport=example.com:443 核对 Certificate Hash 是否等于新证书指纹,再看是否误用了中央证书存储(Central SSL)路径下的旧文件。

七、效果验证:从命令行到在线扫描的三层确认

验证要分三层:本机可达性、证书链与协议、外部视角。只看浏览器地址栏的锁形图标是不够的——本机信任库会掩盖证书链缺失问题。

第一层:HTTP 状态与校验结果(Linux/macOS/WSL)。

curl -sS -o /dev/null -w "%{http_code} verify=%{ssl_verify_result}n" https://example.com
# 期望:200 verify=0(非 0 表示校验失败)

第二层:证书链、有效期与 SAN。

# 服务器实际下发的证书数量(应 ≥ 2)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c "BEGIN CERTIFICATE"

# 有效期、颁发者、SAN
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null |
  openssl x509 -noout -dates -issuer -subject -ext subjectAltName

# 用系统信任库完整校验(无输出即通过)
openssl s_client -connect example.com:443 -servername example.com -verify_return_error 
  -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null

第三层:协议版本与 Windows 侧确认。

# TLS 1.2 应成功;TLS 1.0/1.1 应报 no protocols available
openssl s_client -connect example.com:443 -servername example.com -tls1_2 </dev/null | grep Protocol
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null

# 证书剩余天数与 IIS 绑定指纹
$c = Get-ChildItem Cert:LocalMachineMy | Where-Object {$_.Subject -match 'example.com'} |
     Sort-Object NotAfter | Select-Object -Last 1
"$($c.Thumbprint) 剩余 $([math]::Round(($c.NotAfter - (Get-Date)).TotalDays)) 天"
netsh http show sslcert hostnameport=example.com:443

剩余天数低于 30 天说明自动续期没跑起来,检查计划任务的 Last Run Result 是否为 0x0,以及运行账户是否有 IIS 配置写入权限。最后用 SSL Labs(ssllabs.com/ssltest/analyze.html?d=example.com)做外部扫描,正常应拿到 A 或 A+;若出现 “Chain issues: Incomplete”,回到第二节重新导出 PFX。建议把剩余天数检查接入 Zabbix/Prometheus 告警,阈值设为 21 天,避免 90 天周期内的一次任务失败演变成线上事故。

常见问题

固定 90 天,不需要手工。Win-ACME 安装时会自动创建计划任务,通常在到期前约 30 天续期并直接更新 IIS 绑定;建议每季度执行一次 wacs.exe –renew –force 做演练,确认任务状态为 Ready。


通常是证书落在“当前用户”存储或私钥不可被 IIS 读取。应导入 Cert:LocalMachineMy,导出 PFX 时勾选“允许导出私钥”,并给私钥文件加 NETWORK SERVICE 读取权限,然后删除旧绑定重新执行 netsh http add sslcert。


证书链不完整,服务器只下发了叶子证书。用包含中间证书的 fullchain.pem 重新导出 PFX 并重建绑定;可用 openssl s_client -showcerts 确认返回两张以上证书,再核对 IIS 绑定指纹是否指向新证书。


绑定时必须勾选“需要服务器名称指示(SNI)”,或用 netsh http add sslcert hostnameport=域名:443 逐条添加。未启用 SNI 时 443 端口只能绑定一张证书,后绑定的站点会导致其他域名串用错误证书。


不是。CA/B Forum SC-081 已把公共 TLS 证书单张上限压缩到 200 天(2026-03-15 起生效),2027 年进一步降到 100 天;Let’s Encrypt 一直固定 90 天,因此自动化续期已是必选项而非优化项。


先执行 netsh http show sslcert hostnameport=域名:443 核对 Certificate Hash 是否等于新证书指纹;若使用中央证书存储,确认 PFX 文件已被覆盖;手工替换文件的场景还需 iisreset /noforce 或重启 W3SVC 才会加载新证书。

内容审核

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