跳到主要内容
IIS

JoySSL 证书 IIS 部署实战:PFX 导入、443 绑定、证书链排查与验证

问题背景与根因:IIS 部署 SSL 为什么常卡在 PFX 与证书链

IIS 不直接读取 Nginx/Apache 常用的 PEM 私钥文件,而是通过 Windows HTTP.sys 与 Schannel 调用本地计算机证书存储中的 PFX(PKCS#12)。PFX 必须同时包含服务器证书、中间证书和私钥;只导入叶子 .cer 会出现浏览器正常而 curl/Java/小程序报 SSL certificate problem: unable to get local issuer certificate。另一个根因是绑定仍指向旧证书指纹:续期后只替换文件、未更新 IIS 443 绑定,netsh http show sslcert hostnameport=example.com:443 仍显示旧 Thumbprint。第三类是协议与主机名:多站点共用 443 未启用 SNI,或旧版 Windows Server 未启用 TLS 1.2,客户端报 SEC_E_ILLEGAL_MESSAGE。还需注意有效期规则:公共 TLS 证书单张上限自 2026-03-15 起为 200 天,此前为 398 天;Let’s Encrypt 默认 90 天。部署前用 openssl x509 -in example.com.crt -noout -dates 核对 notBefore/notAfter,避免上线即过期。先用 openssl pkcs12 -info -in example.com.pfx -noout 查看是否包含私钥和多级证书;若只有一级,回到 CA 下载 fullchain。IIS 管理器里服务器证书导入的是计算机账户个人存储,不是当前用户存储,选错存储会导致绑定列表看不到证书。

准备工作:从 JoySSL 下载文件到生成 IIS 可用的 PFX

从 JoySSL 控制台下载 example.com.crt、example.com.key、fullchain.pem 或直接下载 PFX。先核对证书与私钥:openssl x509 -in example.com.crt -noout -subject -issuer -dates;openssl x509 -in example.com.crt -noout -modulus | openssl md5;openssl rsa -in example.com.key -noout -modulus | openssl md5,两个 MD5 必须一致。验证证书链:openssl verify -CAfile root.pem -untrusted intermediate.pem example.com.crt,输出 OK 才继续。生成 PFX:openssl pkcs12 -export -out example.com.pfx -inkey example.com.key -in fullchain.pem -certfile chain.pem -name 'example.com-2026' -passout pass:'StrongPass!2026'。参数说明:-in fullchain.pem 放服务器证书加中间证书,-certfile chain.pem 可补充中间证书,-name 便于 IIS 识别,-passout 为导入密码。生成后检查:openssl pkcs12 -info -in example.com.pfx -noout。若 CA 直接给 PFX,跳过转换但仍要核对指纹和到期日。注意公共证书现行上限 200 天、Let’s Encrypt 90 天,续期文件不要与旧文件混放,建议按 example.com-2026.pfx 命名并保留旧文件至少一个验证周期。

完整实操:IIS 管理器导入 PFX 并绑定 443

打开 IIS 管理器 → 服务器节点 → 服务器证书 → 导入,选择 C:/certs/example.com.pfx,输入导出密码,证书存储选个人/My。站点 → 绑定 → 添加 → 类型 https、端口 443、主机名 example.com,SSL 证书选刚导入项;多站点必须勾选需要服务器名称指示(SNI)。PowerShell 可复现:$pwd = ConvertTo-SecureString -String 'StrongPass!2026' -AsPlainText -Force;$cert = Import-PfxCertificate -FilePath 'C:/certs/example.com.pfx' -CertStoreLocation Cert:/LocalMachine/My -Password $pwd;New-WebBinding -Name 'Default Web Site' -Protocol https -Port 443 -HostHeader 'example.com' -SslFlags 1;(Get-WebBinding -Name 'Default Web Site' -Protocol https -HostHeader 'example.com').AddSslCertificate($cert.Thumbprint,'My')。若用 netsh 绑定:netsh http add sslcert hostnameport=example.com:443 certhash=<Thumbprint> appid={GUID} certstorename=MY。完成后执行 iisreset /noforce 或回收应用程序池,再核对 netsh http show sslcert hostnameport=example.com:443。生产变更前先导出 netsh http show sslcert > sslcert-backup.txt,确认新绑定可访问后再删除旧证书,避免回滚困难。

配置示例:web.config 强制 HTTPS 与 TLS 1.2 注册表

安装 IIS URL Rewrite 模块后,在站点根目录 web.config 加入规则,把 HTTP 301 到 HTTPS:

<configuration><system.webServer><rewrite><rules><rule name='RedirectToHTTPS' 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>

注意 {R:1} 保留路径,若站点在子目录需调整 url。Windows Server 旧版本还需启用 TLS 1.2:New-Item -Path 'HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server' -Force;New-ItemProperty -Path 'HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server' -Name Enabled -Value 1 -PropertyType DWord -Force;New-ItemProperty -Path 'HKLM:\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Server' -Name DisabledByDefault -Value 0 -PropertyType DWord -Force。重启服务器或 Restart-Service HTTP 后用 openssl s_client -connect example.com:443 -tls1_2 验证。若同时禁用 TLS 1.0/1.1,先确认旧客户端与内部系统兼容,避免支付、报表等老接口中断。

方案对比:GUI、PowerShell 与 netsh 绑定方式

三种入口都能完成 443 绑定,但适用场景不同:

方式 适用场景 关键命令/入口 风险点
IIS 管理器导入 PFX 单站点、首次部署 服务器证书→导入→站点绑定 443→SNI 选错当前用户存储,绑定列表看不到证书
PowerShell Import-PfxCertificate 批量、自动化 Import-PfxCertificate + New-WebBinding + AddSslCertificate 未设置 SslFlags=1 时多站点串证
netsh http add sslcert 排查 HTTP.sys 绑定、非 IIS 服务 hostnameport=example.com:443 certhash=… appid={GUID} Thumbprint 旧、appid 冲突
PFX 与 PEM IIS 用 PFX;Nginx 用 fullchain+key openssl pkcs12 -export 只导叶子证书导致链不完整

生产建议:先在预发导入新 PFX,使用不同主机名或端口验证,再切换绑定;变更前导出 netsh http show sslcert > sslcert-backup.txt。多站点共用 443 优先 SNI 而不是独立 IP;IIS 8+ 支持 SNI,老客户端不支持时再评估独立 IP。证书有效期方面,公共 TLS 证书 2026-03-15 起上限 200 天,Let’s Encrypt 默认 90 天,续期必须更新 Thumbprint,不能只覆盖磁盘文件。

常见错误排查:真实报错与定位命令

curl: (60) SSL certificate problem: unable to get local issuer certificate 表示证书链不完整,执行 openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 看返回证书数量,应至少包含服务器证书和中间证书;PFX 用 fullchain 重导。浏览器报 NET::ERR_CERT_AUTHORITY_INVALID 或 SEC_ERROR_UNKNOWN_ISSUER 同上,优先检查是否误用叶子证书。导入 PFX 报 The specified network password is not correct 是密码错,重新导出并确认 -passout。报 A specified logon session does not exist. It may already have been terminated 多与 IIS 绑定证书私钥权限或存储位置有关,确认导入到 LocalMachine/My,必要时在 certlm.msc 给 IIS_IUSRS 读私钥权限。证书与私钥不匹配用 openssl x509 -in example.com.crt -noout -modulus | openssl md5 与 openssl rsa -in example.com.key -noout -modulus | openssl md5 对比。续期不生效先看 netsh http show sslcert hostnameport=example.com:443 的 Thumbprint 是否旧,更新绑定后 iisreset /noforce。报 SEC_E_ILLEGAL_MESSAGE 检查 TLS 1.2 注册表与客户端协议。

效果验证:浏览器、curl、OpenSSL 与 netsh 四层核验

浏览器无锁或警告先看开发者工具 Security 面板;curl -I https://example.com 应返回 200/301 且无证书错误;curl -vI https://example.com 2>&1 | grep -E 'subject|issuer|SSL certificate verify' 看 verify ok。OpenSSL 核验:openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt -verify_return_error </dev/null,输出 Verify return code: 0 (ok);再取日期:openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -subject -issuer -dates。IIS 本机执行 netsh http show sslcert hostnameport=example.com:443 核对 Certificate Hash、Application ID、DS Mapper Usage。换一台机器或手机 4G 访问,避免本机信任库掩盖链缺失。Java/小程序还要检查各自信任库和 SNI,必要时用 keytool -list -cacerts 确认根证书存在。最终把到期日、Thumbprint、验证命令输出记录到变更单。

常见问题

确认 PFX 内含中间证书,用 fullchain.pem 重新导出;执行 openssl s_client -showcerts 检查返回证书是否至少两级;不要把仅叶子证书的 .cer 直接当 PFX 导入。


分别执行 openssl x509 -in example.com.crt -noout -modulus | openssl md5 和 openssl rsa -in example.com.key -noout -modulus | openssl md5,两个 MD5 必须一致;不一致说明证书、私钥或 CSR 不是同一对。


导入新 PFX 后重新编辑 443 绑定选择新证书,或更新 netsh sslcert 的 certhash;用 netsh http show sslcert 核对 Thumbprint,再执行 iisreset /noforce。


公共 TLS 证书单张上限自 2026-03-15 起为 200 天,此前为 398 天;Let’s Encrypt 默认 90 天。实际到期日以 openssl x509 -dates 和 CA 签发结果为准。


在 IIS 绑定中填写主机名并启用 SNI,PowerShell 设置 SslFlags=1;不支持 SNI 的老客户端需独立 IP 或独立端口。绑定后逐个域名用 openssl s_client -servername 验证。

内容审核

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