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

Windows Nginx 配置 SSL 证书全流程:CSR 生成、nginx.conf 参数、报错排查与生效验证(2025 版)

windows nginx 配置 ssl 证书 — Windows Nginx 配置 SSL 证书全流程:CSR 生成、nginx.conf 参数、报错排查与生效验证(2025 版)
核心结论

在 Windows 上完成 Nginx 配置 SSL 证书只需三步:把 fullchain 证书与私钥放进 C:/nginx/conf/ssl/、在 server 块写 listen 443 ssl 与 ssl_certificate/ssl_certificate_key、nginx -t 通过后执行 nginx -s reload,正常耗时 15-30 分钟。 nginx/Windows 1.27.3 官方包已内置 http_ssl_module 与 OpenSSL 3.x,用 nginx -V 2>&1 | findstr http_ssl_module 可验证;若报 unknown directive "ssl",说明用的是被裁剪的第三方构建。 ssl_certificate 必须指向“服务器证书+中间证书”拼接的 fullchain 文件,顺序写反或只配服务器证书,浏览器会报 NET::ERR_CERT_AUTHORITY_INVALID,Android 与 Java 客户端握手失败。 Windows 路径要写成正斜杠 C:/nginx/conf/ssl/example.com.pem,直接写单反斜杠会被当成转义符,nginx 启动报 BIO_new_file() failed (SSL: error:80000002:system library::No such file or directory)。 验证生效看三条:nginx -t 输出 test is successful;curl.exe -I https://example.com --tlsv1.2 返回 HTTP/2 200;openssl s_client -connect example.com:443 显示 Verify return code: 0 (ok)。

Windows 上 Nginx 配置 SSL 证书为什么总出问题?6 个根本原因

Windows 上给 nginx 配 SSL 失败,绝大多数不是证书本身有问题,而是”环境假设”错了。先跑一条命令确认你的二进制到底支持不支持 TLS:

:: 在 nginx.exe 所在目录执行(1.27.x 与 1.14 通用)
nginx -V 2>&1 | findstr http_ssl_module

:: 期望输出(nginx.org 官方 Windows 包 1.27.3 的典型结果)
::   --with-http_ssl_module
:: 若无任何输出,说明该二进制未编译 SSL 模块,
:: 配置里一写 ssl_certificate 就会报错:
::   nginx: [emerg] unknown directive "ssl_certificate"

据 nginx.org 下载页说明,官方 nginx/Windows 压缩包默认包含 http_ssl_module;但第三方集成面板、1.14 时代的老包或自行裁剪的二进制不一定包含。这也是”windows nginx 配置 ssl 证书”求助里占比最高的原因。

原因二:路径反斜杠被当成转义符。nginx.conf 里 C:nginxconfssla.pem 会被解析成 C:nginxconfssla.pem,报 BIO_new_file() failed (SSL: error:80000002:system library::No such file)。nginx 官方《Windows versions》文档确认 Windows 版接受正斜杠,建议统一写成 C:/nginx/conf/ssl/a.pem。

原因三:只配了服务器证书,漏了中间证书。CA 下发的包通常是 example.com.crt、ca_bundle.crt、example.com.key。桌面 Chrome 会自行补链,所以看起来”正常”,但 Android 7 以下与 Java 8 客户端会报 unable to get local issuer certificate。正确做法是按”服务器证书在前、中间证书在后”拼接:

:: Windows CMD 拼接 fullchain(顺序不可颠倒)
copy /b example.com.crt+ca_bundle.crt fullchain.crt

:: nginx.conf 片段(nginx 1.27.x 语法,默认 ssl_protocols 为 TLSv1.2 TLSv1.3)
server {
    listen              443 ssl;
    server_name         example.com;
    ssl_certificate     C:/nginx/conf/ssl/fullchain.crt;  # 含中间证书
    ssl_certificate_key C:/nginx/conf/ssl/example.com.key;
}

原因四:架构限制带来的性能误判。据 nginx 官方文档,Windows 版仅启动 1 个 worker 进程并使用 select 连接模型,TLS 握手无法多核并行,压测 QPS 常在数百到一千量级。配置没错却”慢”,应前置云 SLB 或 IIS ARR 做 TLS 卸载。

原因五:私钥被占用或 NTFS ACL 未授权。私钥被 IIS 或证书管理器打开、或 ACL 只授权了当前登录用户,nginx 以服务方式运行时读不到,error.log 出现 Permission denied。用 icacls 显式授权:

:: 授予 SYSTEM 与 Network Service 只读权限
icacls C:nginxconfsslexample.com.key /grant "SYSTEM:(R)" "NETWORK SERVICE:(R)"

原因六:443 端口被 http.sys 占用。装过 IIS 的服务器上,netstat -ano | findstr :443 会看到 PID 4,此时 nginx 启动报 bind() to 0.0.0.0:443 failed (10013: Permission denied),需先停掉 IIS 的 https 绑定。

现象/报错 根因 验证命令 修复方向
unknown directive “ssl_certificate” 二进制缺 http_ssl_module nginx -V 2>&1 | findstr http_ssl_module 换 nginx.org 官方 Windows 包
BIO_new_file() failed 反斜杠转义或路径错 nginx -t 改用正斜杠路径
客户端证书链不完整 未拼接中间证书 openssl s_client -connect example.com:443 -showcerts 使用 fullchain.crt
Permission denied(读私钥) ACL 或文件占用 icacls 私钥路径 授权 SYSTEM / 服务账户
bind() … failed (10013) http.sys 占用 443 netstat -ano | findstr :443 停 IIS 站点或前置代理

Windows Nginx 配置 SSL 证书的完整实操步骤(8 步,约 30 分钟)

下面这 8 步是能一次性走通的顺序,全程约 30 分钟。前提是域名解析已指向服务器公网 IP——证书签发与 openssl s_client 验证都依赖这一点。若你此前只在 Linux 上做过 windows nginx 配置 ssl 证书,请注意 Windows 版的路径分隔符、信号机制与权限模型都不同,下文会逐条标出差异。

步骤 1|准备运行环境:从 nginx.org/en/download.html 下载 nginx/Windows 1.27.3 稳定版 zip,解压到 C:nginx(路径禁止含中文与空格,否则 -p 前缀参数解析会出错)。在该目录打开 PowerShell 验证:

cd C:nginx
.nginx.exe -v
# 期望:nginx version: nginx/Windows-1.27.3
.nginx.exe -V 2>&1 | findstr http_ssl_module
# 期望输出含:--with-http_ssl_module(官方预编译包默认已带,无需自行编译)

步骤 2|准备证书文件:把服务器证书与中间证书按「服务器证书在前、中间证书在后」的顺序合并(RFC 5246 规定服务器必须在握手中发送完整链,顺序错误会导致 Android/Java 客户端报 unable to get local issuer certificate),与私钥一起放入 C:nginxconfssl。若手上是 .pfx 或 DER 格式 .cer,先用 OpenSSL 3.x 转换:

# PFX → PEM(-nodes 表示私钥不加密,便于 nginx 免密加载)
openssl pkcs12 -in example.pfx -nodes -out combined.pem
# DER 格式 .cer → PEM
openssl x509 -inform DER -in example.cer -out example.com.crt
# 合并全链(cmd 下用 copy /b 二进制拼接,两个文件均须以换行结尾)
copy /b server.crt+ca-bundle.crt example.com.fullchain.pem

步骤 3|没有证书时先生成 CSR:按 RFC 5280 的 PKCS#10 格式生成 2048 位 RSA 私钥与 CSR,-addext 写入 SAN(Chrome 58 起不再识别 CN,只认 SAN):

openssl req -new -newkey rsa:2048 -nodes ^
  -keyout example.com.key -out example.com.csr ^
  -subj "/C=CN/ST=Guangdong/L=Shenzhen/O=Example Ltd/CN=example.com" ^
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"
# 提交前自查 SAN 是否写入成功
openssl req -in example.com.csr -noout -text | findstr /C:"DNS:"

据 Let’s Encrypt 文档,DV 证书通常 5–15 分钟自动签发;OV/EV 需 CA 人工核验营业执照,一般 1–3 个工作日。

步骤 4|修改 conf/nginx.conf:在 http {} 块内新增 80 跳转与 443 业务两个 server。注意 nginx 的相对路径基于 prefix(C:nginx)而非 conf 目录,证书路径建议直接写绝对路径:

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;      # 全站强制 HTTPS
}
server {
    listen 443 ssl;
    http2 on;                                  # nginx ≥1.25.1 独立指令;旧版写 listen 443 ssl http2;
    server_name example.com www.example.com;

    ssl_certificate     C:/nginx/conf/ssl/example.com.fullchain.pem;
    ssl_certificate_key C:/nginx/conf/ssl/example.com.key;
    ssl_protocols       TLSv1.2 TLSv1.3;
    ssl_session_cache   shared:SSL:10m;
    ssl_session_timeout 10m;

    location / { root html; index index.html; }
}

nginx 1.25.1 起沿用 listen 443 ssl http2; 会在 nginx -t 时告警:"listen ... http2" directive is deprecated, use the "http2" directive instead。关键指令的默认值与取值对比如下(数据来自 nginx 官方指令文档):

指令 nginx 1.27 默认值 本方案取值 影响
ssl_protocols TLSv1.2 TLSv1.3(1.23.4 起) TLSv1.2 TLSv1.3 显式声明,防止版本升级导致默认值漂移
ssl_session_cache none shared:SSL:10m 约容纳 4 万个会话,显著减少完整握手
ssl_session_timeout 5m 10m 会话复用窗口
ssl_prefer_server_ciphers off(1.23.4 起) off TLS 1.3 下该指令不生效

步骤 5|放行端口并收紧权限:Windows 防火墙默认拦截入站 443,同时私钥默认继承父目录 ACL,普通用户可读:

netsh advfirewall firewall add rule name="Nginx HTTPS 443" dir=in action=allow protocol=TCP localport=443
:: /inheritance:r 断开继承,仅保留 SYSTEM 与管理员只读
icacls "C:nginxconfsslexample.com.key" /inheritance:r /grant:r "SYSTEM:(R)" /grant:r "BUILTINAdministrators:(R)"

若用 NSSM/WinSW 把 nginx 注册为服务,worker 进程以服务账户运行,需额外授予该账户 (R),否则启动时报 BIO_new_file() failed (SSL: error:8000000D:system library::Permission denied)。

步骤 6|检查、重载与验证:这是 windows nginx 配置 ssl 证书 最容易翻车的一步,务必先 -t 再 reload:

cd C:nginx
.nginx.exe -t
# 期望:syntax is ok / test is successful
.nginx.exe -s reload
curl.exe -I https://example.com
# 期望:HTTP/2 200(或 HTTP/1.1 200),且无证书告警
echo. | openssl s_client -connect example.com:443 -servername example.com -brief
# 期望:Verify return code: 0 (ok),Protocol version: TLSv1.3

Windows 版的 -s reload 通过命名事件通知 master 进程,若返回 could not open error event,说明进程以其他用户启动,需 nginx -s stop 后重启。

步骤 7|配置自动续期:Let’s Encrypt 证书有效期 90 天,官方建议剩余 30 天时续期。用 win-acme 生成 PEM 并在续期后自动重载:

wacs.exe --target manual --host example.com,www.example.com ^
  --validation filesystem --webroot C:nginxhtml ^
  --store pemfiles --pemfilespath C:nginxconfssl ^
  --installation script --script "C:nginxreload.cmd"
:: reload.cmd 内容:C:nginxnginx.exe -s reload

步骤 8|留一份可回滚快照:改配置前先备份,重载失败可 30 秒内还原:

copy C:nginxconfnginx.conf C:nginxconfnginx.conf.bak-20250101
:: 回滚:copy /y nginx.conf.bak-20250101 nginx.conf && nginx.exe -s reload

配置是否真正生效,以 openssl s_client 输出的 Verify return code: 0 (ok) 与浏览器锁标为准,而非仅凭 nginx -t 通过——后者只校验语法,不校验证书链完整性与私钥匹配性。

Windows Nginx 配置 SSL 证书:nginx.conf 片段与 OpenSSL 命令示例

为什么 CSR 一定要在 Windows 服务器本机生成?因为私钥永远不该离开这台机器:CSR 里只含公钥和身份信息,交给 CA 签发后,CA 返回的证书必须和本地私钥配对才能用。用 OpenSSL 3.5 一行就能同时产出私钥与 CSR(Windows 上可用 winget install ShiningLight.OpenSSL.Light 安装,装完 openssl version 应显示 OpenSSL 3.5.x):

:: 在 C:nginxconfssl 下生成 2048 位 RSA 私钥 + CSR
:: -nodes(OpenSSL 3.x 亦可写 -noenc)表示私钥不加密:nginx 启动时无法交互输入口令
:: -addext 需 OpenSSL 1.1.1 及以上;不加 SAN 现代浏览器会直接报 NET::ERR_CERT_COMMON_NAME_INVALID
openssl req -new -newkey rsa:2048 -sha256 -nodes ^
  -keyout C:/nginx/conf/ssl/example.com.key ^
  -out    C:/nginx/conf/ssl/example.com.csr ^
  -subj "/C=CN/ST=Shanghai/O=Example/CN=example.com" ^
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

:: 提交前自检 CSR 里的 SAN 是否写全(据 openssl-req(1) 手册)
openssl req -in C:/nginx/conf/ssl/example.com.csr -noout -text | findstr /C:"DNS:"

拿到证书后常遇到格式不匹配。nginx 只认 PEM(Base64 文本),而 Windows IIS/国密工具导出的多是 DER 或 PFX,转换命令如下:

:: DER(.cer/.crt 二进制) → PEM
openssl x509 -in cert.cer -inform DER -out cert.pem
:: PFX/PKCS#12 → 单个 PEM,含证书链与私钥
openssl pkcs12 -in cert.pfx -nodes -out all.pem
:: 拆分:私钥段到 .key,证书段(含中间证书)到 .fullchain.pem
:: 转换后务必确认首行
type cert.pem   :: 期望输出 -----BEGIN CERTIFICATE-----
格式 常见扩展名 编码 nginx 可直接用 转换命令
PEM .pem .crt .key Base64 文本 是 —
DER .cer .der 二进制 否 openssl x509 -inform DER
PKCS#12 .pfx .p12 二进制(含私钥+口令) 否 openssl pkcs12 -nodes
PKCS#7 .p7b Base64/二进制 否(仅证书链) openssl pkcs7 -print_certs

下面是最小可用的 nginx.conf 片段,语法适用于 nginx 1.25.1+(该版本起 http2 on; 取代了 listen 443 ssl http2;,据 nginx 官方 ngx_http_ssl_module 文档):

server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;
}
server {
    listen 443 ssl;
    http2 on;
    server_name example.com www.example.com;
    ssl_certificate     C:/nginx/conf/ssl/example.com.fullchain.pem;  # 必须含中间证书
    ssl_certificate_key C:/nginx/conf/ssl/example.com.key;
    ssl_protocols TLSv1.2 TLSv1.3;                                    # 默认值仅 TLSv1.2/1.3(1.23.4+)
    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 off;                                    # 默认 off,交给客户端选更优套件
    ssl_session_cache shared:SSL:10m;                                 # 默认 none,10m 约缓存 4 万个会话
    ssl_session_timeout 1d;
    ssl_session_tickets off;                                          # 关闭 ticket 换取前向保密
    add_header Strict-Transport-Security "max-age=31536000" always;
    root C:/www/site;
    index index.html;
}

注意 ssl_ciphers 只作用于 TLS 1.2,TLS 1.3 套件由 OpenSSL 编译期固定、无法在此调整,用 openssl ciphers -v 可核对实际生效列表。

改完配置怎么确认生效?按顺序执行以下四条:

nginx -t -p C:nginx           :: 只检查语法与证书路径,不重载
nginx -s reload                 :: 平滑重载,新证书立即生效
nginx -T -p C:nginx > C:tempnginx-dump.txt   :: 导出完整生效配置,用于比对 include 顺序
nginx -V 2>&1                   :: 查看编译参数,确认 built with OpenSSL 版本

为什么加了 OCSP stapling 就报错?典型报错是 no resolver defined to resolve "ocsp.example.com",原因是 ssl_stapling on; 需要自己解析 OCSP 地址,必须补 resolver:

ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate C:/nginx/conf/ssl/chain.pem;   # 需含根+中间证书
resolver 223.5.5.5 119.29.29.29 valid=300s;            # 缺这行即报 no resolver defined

据 Let’s Encrypt 2025 年公告,其证书已停止提供 OCSP 响应,因此对 LE 证书配置这三行会在 error.log 打印 ssl_stapling ignored, "" does not have an OCSP responder 类 warn,可直接删除,转而依赖证书内嵌的 CRL 分发点。

最后别忘了权限收敛与防火墙复核——私钥被 IIS_IUSRS 读到是常见越权风险:

:: 断开继承,仅 SYSTEM 与 Administrators 可读
icacls "C:nginxconfsslexample.com.key" /inheritance:r /grant:r "SYSTEM:R" "Administrators:R"
:: 复核 443 放行规则是否存在且已启用
netsh advfirewall firewall show rule name="Nginx HTTPS 443"

验证阶段可用 curl -vI https://example.com 观察 SSL certificate verify ok,或用 openssl s_client -connect example.com:443 -servername example.com -showcerts 确认返回的是完整链而非只有叶证书。

Windows Nginx 配置 SSL 证书的参数对比与方案选型表

问:从 IIS 导出的 .pfx 能直接喂给 nginx 吗?不能。nginx 只解析 PEM(Base64 文本)格式,而 Windows 证书管理器、IIS 绑定导出默认给的是 PKCS#12(.pfx,二进制且私钥带密码保护)。据 OpenSSL 官方文档,pkcs12 子命令是转换的唯一标准路径;注意 -nodes 的含义是”私钥不做 DES 加密”,否则 nginx 启动时会因等待密码而挂起。

格式 典型扩展名 编码 是否含私钥 nginx 可用 常见来源
PEM .pem / .crt / .key Base64 文本 分离存放 是(唯一支持) Let’s Encrypt、CA 签发包
DER .cer / .der 二进制 否 否,需 openssl x509 -inform der 转 PEM Windows 导出、Java keystore
PKCS#12 .pfx / .p12 二进制容器 是 否,需转换 IIS、Windows 证书管理器
# 适用 OpenSSL 3.x(Windows 版默认安装于 C:Program FilesOpenSSL-Win64bin)
# 方式一:整体导出为单个 PEM(含私钥+证书+中间链)
openssl pkcs12 -in a.pfx -nodes -out a.pem
# 方式二(推荐):拆分,nginx 要求 cert 与 key 分开两个文件
openssl pkcs12 -in a.pfx -clcerts -nokeys -out cert.pem   # 叶子证书
openssl pkcs12 -in a.pfx -cacerts -nokeys -out chain.pem  # 中间证书
openssl pkcs12 -in a.pfx -nocerts -nodes -out privkey.pem # 未加密私钥

# 转换后必须收敛 ACL:去掉继承,仅授予 SYSTEM 与管理员只读
icacls "C:nginxconfsslprivkey.pem" /inheritance:r /grant:r "SYSTEM:(R)" "Administrators:(R)"

ACL 这一步在 Windows 上不能省:nginx/Windows 若以服务方式运行,默认身份是 LocalSystem;用 NSSM 注册成自定义账号时,要把上面的 SYSTEM 换成该账号,否则会报 BIO_new_file() failed (SSL: error:8000000D:system library::Permission denied)。

问:免费证书和付费证书怎么选?据 Let’s Encrypt 官方文档,其 DV 证书有效期 90 天、支持 ACME 自动续期、无域名数量上限,是 Windows 上最省成本的选择;OV/EV 的增量价值在于单位信息审核、合规审计与保修条款,而非浏览器 UI——Chrome 自 2019 年起已不再在地址栏展示 EV 单位名。

类型 2025 年国内参考价 有效期 审核内容 适用场景
Let’s Encrypt DV 免费 90 天 域名控制权 个人站、内部系统、可自动续期
商业 DV 约 100–400 元/年 1 年 域名控制权 需要发票、SLA、技术支持
OV 约 800–2500 元/年 1 年 营业执照核验 对外业务系统、招投标资质
EV 约 2000–8000 元/年 1 年 严格主体核验 金融、支付合规、高额保修

问:ssl_protocols 写哪些版本?nginx 1.23.4 起该指令默认值已由 TLSv1 TLSv1.1 TLSv1.2 改为 TLSv1.2 TLSv1.3(见 nginx CHANGES)。Mozilla 服务器端 TLS 配置指南将 TLS 1.0/1.1 归入”Old”配置并建议禁用,PCI DSS v4.0 亦不接受 TLS 1.1 及以下。

取值 客户端覆盖 握手性能 风险/限制
TLSv1.2 TLSv1.3 >99% 在用客户端 1.3 为 1-RTT 推荐默认
仅 TLSv1.3 Win7、Android 6 以下、早期 JDK 8 不支持 最快 老客户端直接握手失败
含 TLSv1.1 全覆盖 — 不符合 PCI DSS,Mozilla 标记为 Old

问:RSA 还是 ECDSA?据 Mozilla 与 Cloudflare 的实测数据,ECDSA P-256 的握手耗时比 RSA 2048 低约 30%–50%,证书体积也小得多;但 TLS 1.2 下部分老客户端只认 RSA。nginx 支持同时挂两张证书,按客户端 signature_algorithms 自动择优:

# 顺序无关,nginx 按客户端能力选择;两对指令必须成对出现
ssl_certificate     C:/nginx/conf/ssl/fullchain_ecdsa.pem;   # ECDSA P-256 优先
ssl_certificate_key C:/nginx/conf/ssl/privkey_ecdsa.pem;
ssl_certificate     C:/nginx/conf/ssl/fullchain_rsa.pem;     # RSA 2048 兜底
ssl_certificate_key C:/nginx/conf/ssl/privkey_rsa.pem;

问:ssl_session_cache 在 Windows 上怎么填?该指令默认值为 none(等价 off,每次完整握手),ssl_session_timeout 默认 5m。nginx/Windows 只有 1 个 worker 进程,shared 的跨进程共享优势实际用不上,但 shared:SSL:10m 仍是通用写法(1MB ≈ 4000 个会话,10MB 约 4 万),便于日后平滑迁到 Linux。

取值 含义 内存 Windows 适用性
off / none 禁用缓存,每次完整握手 0 仅调试用
builtin:1000 单 worker 内缓存 1000 个会话 进程内 可用,但无跨 worker 收益
shared:SSL:10m 共享内存 10MB,约 4 万会话 10MB 通用推荐,利于迁移

问:TLS 在哪一层终结?

方案 证书存放 吞吐上限 运维成本
nginx/Windows 直接终结 TLS 本地 PEM 文件 单 worker,约数百至 1000 QPS 低,改配置需 reload
IIS ARR 反代到 nginx Windows 证书存储(PFX) 受 IIS 与 ARR 双重限制 中,可复用 SNI 与证书向导
云 SLB/CLB 卸载,回源 HTTP 云控制台上传 由云实例弹性决定 最低,nginx 只监听 80

只有一台 Windows 机器且 QPS 长期低于 500 时,直接终结 TLS 最省事;一旦出现并发握手排队(表现为 worker_connections are not enough 或首字节延迟随并发线性上升),优先考虑把 TLS 上移到云负载均衡,而不是继续调 worker_processes——nginx/Windows 的该指令被固定为 1,写了也不生效。

Windows Nginx 配置 SSL 证书后常见报错与排查清单

Windows 上 nginx 配置出错时,进程会直接退出,不会像 Linux 那样由 systemd 保留日志。因此排查第一步始终是在 cmd.exe 里手动执行一次 nginx -t,让 [emerg] 原文打印在控制台。下面按 2025 年最高频的六条报错逐条给出判定命令与修复路径。

报错关键字 根因 一条命令定位
unknown directive “ssl” nginx.exe 未编译 http_ssl_module nginx -V 2>&1 | findstr http_ssl_module
BIO_new_file() failed 路径或文件名不匹配 dir C:nginxconfssl
PEM_read_bio_X509_AUX() failed 文件是 DER 或空文件 openssl x509 -in cert.cer -inform DER -noout -subject
key values mismatch 证书与私钥非同一对 比对两次 -modulus | openssl md5
bind() … 10013 443 被 http.sys/IIS 占用 netstat -ano | findstr :443
ERR_CERT_AUTHORITY_INVALID 缺中间证书或顺序颠倒 openssl s_client -showcerts

1. nginx: [emerg] unknown directive “ssl”——是不是下错了安装包?

该报错意味着当前 nginx.exe 编译时没有 http_ssl_module,因此任何 ssl_certificate 指令都无法识别。据 nginx.org 官方文档,官方 nginx/Windows 构建默认包含该模块;网上流传的“绿色版”“精简版”常为缩小体积把它裁掉。验证方法:

REM 必须在 cmd.exe 中执行;PowerShell 的 2>&1 是重定向语法,需写成 cmd /c "nginx -V 2>&1 | findstr http_ssl_module"
cd C:nginx
nginx -V 2>&1 | findstr http_ssl_module
REM 输出含 --with-http_ssl_module 才算支持;完全无输出即确认缺失,请换用 nginx.org 官方 Windows 包
nginx -v   REM 顺带确认版本号,2025 年主线为 1.27.x

2. BIO_new_file() failed … No such file or directory——文件明明在,为什么找不到?

三类原因最常见:反斜杠未转义("C:nginxconfsslx.pem" 里的 n 会被当换行)、文件名大小写不符、记事本把文件存成了 .pem.txt。据 nginx 文档,Windows 下推荐统一写正斜杠:ssl_certificate C:/nginx/conf/ssl/example.com.fullchain.pem;。逐项核对:

dir C:nginxconfssl
REM 核对大小写与真实扩展名(资源管理器默认隐藏已知扩展名,先关掉该选项)
type C:nginxconfsslexample.com.fullchain.pem | more
REM 能正常打印内容说明文件可读,再回头查 nginx.conf 里的路径拼写
nginx -t

3. PEM_read_bio_X509_AUX() failed … no start line——证书格式不对?

OpenSSL 只解析 PEM(Base64 编码 + 头尾标记行)。据 OpenSSL 文档,no start line 表示首行不是 -----BEGIN CERTIFICATE-----,多半是从 IIS 导出的 DER/.cer 二进制,或文件内容为空。先探测再转换:

REM 能输出 subject 说明是 DER,需要转换;报错则大概率是空文件或文本损坏
openssl x509 -in example.com.cer -inform DER -noout -subject
openssl x509 -inform DER -in example.com.cer -out example.com.pem
REM 转换后用记事本打开,确认首行是 -----BEGIN CERTIFICATE-----

4. SSL_CTX_use_PrivateKey() failed … key values mismatch——证书和私钥不配对?

这通常发生在续签之后:新证书已覆盖,私钥仍是旧的。用模数哈希比对,fullchain.pem 取第一张(服务器证书)的模数:

openssl x509 -noout -modulus -in example.com.fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in example.com.key | openssl md5
REM 两个 MD5 必须完全一致;不一致就把与证书同批次签发的私钥重新放回 conf/ssl

5. bind() to 0.0.0.0:443 failed (10013: Permission denied)——端口被谁占了?

10013 是 Windows 的 WSAEACCES,与防火墙无关,多数是 443 已被内核态 http.sys 抢占(IIS、SQL Server Reporting Services、部分 VPN/代理客户端都会注册)。

netstat -ano | findstr :443
tasklist /FI "PID eq 4"
REM PID 为 4(System)说明是 http.sys 在监听,而非普通进程
netsh http show sslcert
REM 列出所有 443 证书绑定;停掉对应 IIS 站点,或 netsh http delete sslcert 后重启 nginx

6. 浏览器报 NET::ERR_CERT_AUTHORITY_INVALID、App 握手失败——缺中间证书?

据 Let’s Encrypt 文档,应部署 fullchain.pem(服务器证书在前、中间证书在后,顺序不可颠倒),只放 cert.pem 时桌面浏览器常靠 AIA 自动补链,但 Android、Java、微信小程序不会。验证链长度:

openssl s_client -connect example.com:443 -servername example.com -showcerts
REM 数 "BEGIN CERTIFICATE" 出现次数:≥2 才完整,仅 1 条即缺中间证书
REM 同时看结尾 Verify return code: 0 (ok);出现 unable to get local issuer certificate 即链断裂

协议与套件侧建议参照 Mozilla SSL Configuration Generator 的 intermediate 档:ssl_protocols TLSv1.2 TLSv1.3;(TLSv1.2 对应 RFC 5246,TLSv1.3 对应 RFC 8446),关闭 TLSv1/1.1 可同时规避一批旧客户端握手报错。

怎么验证 Windows Nginx 的 SSL 证书配置已经生效?

改完 nginx.conf 并不等于线上已经生效:Windows 上 Nginx 是 master/worker 模型,重载失败时旧进程仍在用旧证书对外服务,浏览器看起来”一切正常”。所以要分四层验证——配置能否加载、TLS 握手实际协商了什么、证书链是否完整、外部扫描器怎么判。

第一步:语法与加载验证(最容易被跳过)

:: 在 C:nginx 目录下执行,-p 指定 prefix,避免相对路径解析错位
cd /d C:nginx
nginx -t -p C:nginx
:: 期望输出:nginx: configuration file C:nginx/conf/nginx.conf test is successful

nginx -s reload
:: 重载后立刻查日志,SSL 相关 emerg 必须为空
type C:nginxlogserror.log | findstr /i "ssl emerg"

注意 nginx -t 不只是查语法,它会真正打开 ssl_certificate 与 ssl_certificate_key 指向的文件。据 Nginx 官方文档,Windows 版路径建议写绝对路径并统一用正斜杠(C:/nginx/conf/ssl/fullchain.pem),写错时的典型报错是 cannot load certificate "..." : PEM_read_bio_X509_AUX() failed 或 SSL_CTX_use_certificate_chain_file() failed。这一条通过,才说明证书文件可读、指令合法。

第二步:命令行握手验证(看真实协商结果)

:: Windows 10 1803 起内置 curl.exe(早期 7.x,Win11/新版为 8.x,用 curl.exe --version 确认)
curl.exe -I https://example.com --tlsv1.2 -v
:: 关键两行:SSL connection using TLSv1.3 / TLS_AES_256_GCM_SHA384
::           HTTP/2 200

:: 验证旧协议确实关闭:注意 --tlsv1.1 是"最低版本",单用会协商到 1.3
curl.exe -I https://example.com --tlsv1.1 --tls-max 1.1
:: 期望失败:error:0A00042E:SSL routines::tlsv1 alert protocol version

很多人只写 --tlsv1.1 就以为测了旧协议,其实 curl 的 --tlsv1.x 系列是”最低版本下限”,必须叠加 --tls-max 1.1 才能真正触发失败。看到 TLSv1.3 说明 ssl_protocols 至少含 TLSv1.2/1.3(Nginx 1.23.4 起默认值已是 TLSv1.2 TLSv1.3),看到 HTTP/2 200 说明 listen 443 ssl; 上叠加的 http2 生效。

第三步:证书链与有效期核对

:: Windows 无自带 openssl,可用 Git for Windows 的 usrbinopenssl.exe 或 Win64 OpenSSL 3.x
echo. | openssl s_client -connect example.com:443 -servername example.com 2>&1 | findstr "Verify return code"

:: 核对签发对象与有效期,Let's Encrypt 证书应为约 90 天区间
openssl s_client -connect example.com:443 -servername example.com 2>nul | openssl x509 -noout -subject -dates
Verify return code 含义 对应修复
0 (ok) 证书链完整、可信 无需处理
21 (unable to verify the first certificate) 缺中间证书,只部署了站点证书 改用 fullchain.pem 或手动拼接中间证书
20 (unable to get local issuer certificate) 根证书不在本地信任库 检查是否误把根证书拼进链
10 (certificate has expired) 证书过期 续期并 reload
62 (hostname mismatch) 证书 SAN 不含该域名 重新签发含 SAN 的证书

第四步:跳转、状态码与第三方复核

:: HTTP 应 301 到 HTTPS
curl.exe -I http://example.com
:: 期望:HTTP/1.1 301 Moved Permanently + Location: https://example.com/

:: PowerShell 复核状态码
(Invoke-WebRequest https://example.com -UseBasicParsing).StatusCode   # 期望 200

最后做一次外部视角复核:把域名提交到 Qualys SSL Labs(ssllabs.com/ssltest),跑完整扫描,目标评级 A 及以上,重点看 Certificate Chain(是否 “Chain issues: None”)与 Protocols(TLS 1.0/1.1 应为 No)两项;国内网络可用 MySSL 复核证书链完整性与 TLS 1.3 支持情况。SSL Labs 有结果缓存,改配置后需等缓存过期或用”Clear cache”重新扫描,否则会看到旧结果。

进阶:Windows Nginx 多站点 SNI 与 SSL 证书自动续期

多个域名共用一个 443 端口,Nginx 凭什么知道该返回哪张证书?

靠 SNI(Server Name Indication,RFC 6066 定义的 TLS 扩展)。客户端在 ClientHello 里明文带上目标主机名,Nginx 用这个值与各 server 块的 server_name 比对,再决定加载哪一组 ssl_certificate / ssl_certificate_key。所以 Windows 上做 windows nginx 配置 ssl 证书的多站点,正确姿势是”一站点一 server 块”,而不是把所有证书塞进一个块里。注意 Nginx 1.25 起 listen 443 ssl http2; 中的 http2 已废弃,会打印 [warn] the "listen ... http2" directive is deprecated,需改用独立的 http2 on;。

# C:nginxconfnginx.conf  —— 适用于 Nginx 1.25.5 / 1.27.x(Windows 版)
# 关键:路径一律用正斜杠,避免反斜杠被当作转义符

# ① 默认站点:给不支持 SNI 的老客户端(Windows XP、Java 6 等)兜底
server {
    listen              443 ssl default_server;
    server_name         _;
    ssl_certificate     C:/nginx/conf/ssl/main.example.com.fullchain.pem;
    ssl_certificate_key C:/nginx/conf/ssl/main.example.com.key;
    ssl_protocols       TLSv1.2 TLSv1.3;      # 默认值 TLSv1.2 TLSv1.3(1.23.4 起)
    return              444;                   # 兜底站点直接断开,避免误暴露内容
}

# ② 站点 A
server {
    listen              443 ssl;
    http2               on;                    # 1.25.1+ 的新写法
    server_name         shop.example.com;
    ssl_certificate     C:/nginx/conf/ssl/shop.example.com.fullchain.pem;
    ssl_certificate_key C:/nginx/conf/ssl/shop.example.com.key;
    ssl_session_cache   shared:SSL:10m;        # 默认 none,多站点务必显式开启
    ssl_session_timeout 1d;
}

# ③ 站点 B
server {
    listen              443 ssl;
    server_name         api.example.com;
    ssl_certificate     C:/nginx/conf/ssl/api.example.com.fullchain.pem;
    ssl_certificate_key C:/nginx/conf/ssl/api.example.com.key;
}

漏写证书会直接启动失败,报错长这样:nginx: [emerg] no "ssl_certificate" is defined for the "listen ... ssl" directive in C:nginxconfnginx.conf:12。改完先 C:nginxnginx.exe -t 验证语法,再 -s reload。据 Mozilla SSL Configuration Generator 的建议,TLS 1.0/1.1 早已列入”Old”配置并被主流浏览器弃用,Windows Server 2012 R2 以下的系统需先补注册表才能启用 TLS 1.2。

证书 90 天就过期,能不能签完自动重载?

能。win-acme(2.2.9 及以上)在安装环节提供”后置脚本”钩子:交互运行 wacs.exe 选 M(完整选项)→ 输入域名 → 存储方式选 PEM → 输出目录填 C:nginxconfssl → 安装步骤选”运行脚本”,脚本填 C:nginxnginx.exe,参数填 -p C:nginx -s reload。等价的无交互命令:

# win-acme 2.2.9+ ;--store pemfiles 会输出 fullchain.pem 与 key.pem 两个文件
C:win-acmewacs.exe --source manual --host shop.example.com ^
  --store pemfiles --pemfilespath C:nginxconfssl ^
  --installation script ^
  --script "C:nginxnginx.exe" --scriptparameters "-p C:nginx -s reload"

如果用 acme.sh(3.1.x),在 Git Bash 或 WSL 里执行,路径同样必须用正斜杠:

acme.sh --issue -d example.com -d www.example.com -w C:/nginx/html 
  --install-cert -d example.com 
  --key-file       C:/nginx/conf/ssl/example.com.key 
  --fullchain-file C:/nginx/conf/ssl/example.com.fullchain.pem 
  --reloadcmd      "C:/nginx/nginx.exe -p C:/nginx/ -s reload"
对比项 win-acme acme.sh
运行环境 原生 Windows,无需 Bash Git Bash / WSL / Cygwin
当前主版本 2.2.9+(.NET 6/8 依赖) 3.1.x
PEM 输出 --store pemfiles 输出 fullchain + key --install-cert 显式指定两个文件路径
自动续期 安装时默认注册 Windows 计划任务 需自行挂到 schtasks 或 cron
日志位置 C:ProgramDatawin-acmeLogs ~/.acme.sh/acme.sh.log

续期任务具体怎么排?

Let’s Encrypt 官方文档明确证书有效期 90 天,并建议在剩余 30 天时续期——也就是第 60 天。win-acme 自带的计划任务已满足,若手动接管可用:

schtasks /create /tn "nginx-cert-renew" /sc daily /st 03:30 ^
  /tr "C:win-acmewacs.exe --renew --baseuri https://acme-v02.api.letsencrypt.org/directory" /ru SYSTEM /rl HIGHEST

失败时到 C:ProgramDatawin-acmeLogs 翻最新日志;acme.sh 则看 acme.sh --cron 的退出码。注意以 SYSTEM 身份运行的任务,工作目录与交互用户不同,这是后面”reload 不生效”的头号原因。

续期成功了,为什么浏览器还显示旧证书?

因为证书文件落盘 ≠ Nginx 加载。先用 OpenSSL 看文件本身的到期时间,再对比线上实际下发的证书:

# 1) 看磁盘上证书的生效区间(notBefore / notAfter)
openssl x509 -in C:/nginx/conf/ssl/example.com.fullchain.pem -noout -dates -subject

# 2) 看线上真正下发的证书(-servername 触发 SNI,必须带,否则拿到默认站点证书)
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null | openssl x509 -noout -dates

若第 1 步的 notAfter 已后移、第 2 步没变,就是 reload 没打到正确的实例:一是命令缺 -p C:nginx,Nginx 会去默认 prefix 找配置;二是 Nginx 以 Windows 服务方式(如 nssm / WinSW)运行,服务的工作目录与手动执行的目录不同,应改为 nssm restart nginx 或调用服务的重载接口。顺带一提,SNI 站点若把主域名 server 设成 default_server,老客户端至少能拿到一张有效证书,而不是握手失败——这也是 RFC 6066 兼容性设计里最常见的兜底手法。

Windows Nginx 配置 SSL 证书的安全加固与性能参数建议

HSTS 能不能一上来就写 max-age=31536000?

不能。HSTS 是浏览器侧的单向承诺,据 RFC 6797,一旦响应头被缓存,在 max-age 到期前浏览器会把所有 http:// 请求本地改写为 https://,服务端无法远程撤回。稳妥做法是分三阶段灰度,先给 300 秒便于快速回滚:

# C:/nginx/conf/conf.d/example.conf —— 第 1 周:小范围观察
server {
    listen 443 ssl;
    server_name www.example.com;

    # 300 秒:出问题最多等 5 分钟即可回退
    add_header Strict-Transport-Security "max-age=300" always;
    # 暂时不加 includeSubDomains:blog.example.com 还没部署证书
}

观察期内重点看浏览器控制台是否出现混合内容告警,原文形如 Mixed Content: The page at 'https://www.example.com/' was loaded over HTTPS, but requested an insecure element 'http://cdn.example.com/a.js'. This request has been blocked。确认全站资源(含 CDN、字体、埋点)都已走 HTTPS 后,再把 max-age 调到 31536000 并追加 includeSubDomains。顺序不能反:includeSubDomains 一旦下发,任何未配证书的子域都会被浏览器直接阻断,用户看不到”继续访问”按钮,只能等 max-age 过期或在 chrome://net-internals/#hsts 手动删除域名记录。

ssl_ciphers 里写了 TLS 1.3 套件为什么不生效?

因为 TLS 1.3 的套件协商由 OpenSSL 3.x 的 TLS 1.3 ciphersuites 固定(RFC 8446 规定 TLS_AES_128_GCM_SHA256 为强制实现),nginx 的 ssl_ciphers 只影响 TLS 1.2 及以下。这也是 Windows Nginx 配置 SSL 证书时最常见的误解之一。据 Mozilla Server Side TLS 指南的 intermediate(中间兼容)档,正确写法是 ssl_prefer_server_ciphers off,把套件选择权交给客户端:

ssl_protocols TLSv1.2 TLSv1.3;          # 默认 TLSv1.2 TLSv1.3
# Mozilla intermediate 档 TLS 1.2 套件列表
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-CHACHA20-POLY1305:ECDHE-RSA-CHACHA20-POLY1305:DHE-RSA-AES128-GCM-SHA256:DHE-RSA-AES256-GCM-SHA384;
ssl_prefer_server_ciphers off;         # 默认 off,TLS 1.3 下服务端偏好反而降低兼容性
ssl_ecdh_curve X25519:prime256v1:secp384r1;   # 默认 auto
# 确实要收窄 TLS 1.3 套件时(nginx ≥ 1.19.4 才支持 ssl_conf_command)
ssl_conf_command Ciphersuites TLS_AES_256_GCM_SHA384:TLS_CHACHA20_POLY1305_SHA256:TLS_AES_128_GCM_SHA256;

验证:nginx -V 2>&1 | findstr OpenSSL 查看内置 OpenSSL 版本(官方 Windows 包为 OpenSSL 3.x),openssl ciphers -v -s -tls1_3 列出实际可用的 TLS 1.3 套件。注意 ssl_ciphers 默认值是 HIGH:!aNULL:!MD5。

会话票据关掉会不会明显拖慢握手?

会降低复用率,但换来前向安全。票据密钥长期不换,等于把历史会话的钥匙一直留在磁盘上;关闭后靠 ssl_session_cache 复用,实测首字节影响通常在个位数毫秒。若因移动端弱网必须保留票据,就用 48 字节随机密钥并定期轮换,长度不符时 nginx 会拒绝启动并报 [emerg] ssl_session_ticket_key "...ticket.key" must be 48 or 80 bytes:

ssl_session_cache shared:SSL:10m;   # 默认 none,10m 约可缓存 4 万个会话
ssl_session_timeout 1d;             # 默认 5m
ssl_session_tickets off;            # 默认 on
# 保留票据时:openssl rand 48 > C:/nginx/conf/ticket-2025q1.key
# 新版 nginx 支持写多条 ssl_session_ticket_key 做轮换,新密钥放最前面
# ssl_session_ticket_key C:/nginx/conf/ticket-2025q1.key;

ssl_buffer_size 和 worker_connections 怎么调才不踩坑?

指令 默认值 建议值 代价
ssl_buffer_size 16k 4k(大文件/首字节敏感) 握手包数增加,小响应反而不划算
ssl_session_tickets on off 复用率下降
ssl_session_timeout 5m 1d(配合 shared 缓存) 内存占用上升
worker_connections 512 1024 Windows 官方构建基于 select,受 FD_SETSIZE=1024 约束

nginx 官方 Windows 文档明确说明:Windows 版只用 select() 事件模型,多 worker 时实际只有一个在工作。所以并发上限基本等于单 worker 的 worker_connections,且不宜超过 1024。压测时若日志出现 nginx: [warn] 1024 worker_connections are not enough,说明连接已打满,应优先减少长连接占用而不是盲目加大数值。

怎么统计还有多少客户端在用 TLS 1.2?证书快过期怎么提前知道?

在 server 块里自定义日志格式,把协议与套件落盘,后续用 PowerShell 一行统计:

log_format ssl_ext '$remote_addr [$time_local] "$request" $status '
                   'proto=$ssl_protocol cipher=$ssl_cipher sni=$ssl_server_name';
access_log logs/example.access.log ssl_ext;
# 统计 TLS 1.2 占比(PowerShell)
# (Select-String -Path logsexample.access.log -Pattern 'proto=TLSv1.2').Count
# 每日巡检:读取 notAfter,剩余不足 15 天告警
$end  = & openssl s_client -connect www.example.com:443 -servername www.example.com 2>$null |
        Select-String 'notAfter=' | ForEach-Object { ($_ -split 'notAfter=')[1] }
$days = [int]([datetime]::Parse($end) - (Get-Date)).TotalDays
if ($days -lt 15) { Write-EventLog -LogName Application -Source NginxSSL -EventId 1001 -EntryType Warning -Message "证书剩余 $days 天" }

据 Let’s Encrypt 现行策略,证书有效期已缩短至 90 天并计划进一步压缩,15 天告警阈值意味着手工续期窗口只剩两周;把上述脚本挂进任务计划程序每日执行,比依赖邮件提醒更可靠。

官方 nginx/Windows 1.27.3 包已内置 http_ssl_module 并链接 OpenSSL 3.x,不需要自行编译。执行 nginx -V 2>&1 | findstr http_ssl_module 能看到 –with-http_ssl_module 即可确认。若没有输出,说明用的是第三方裁剪包,换官方包即可。

多数情况是 ssl_certificate 只指向了服务器证书,没有拼接中间证书。把服务器证书与中间证书按“服务器证书在前、中间证书在后”合并成 fullchain 文件,再重载 nginx。可用 openssl s_client -connect 域名:443 -showcerts 检查返回的证书条数,正常应至少 2 条。

ssl_certificate、ssl_protocols 等指令完全一致,差别在路径写法(Windows 建议用正斜杠)、进程模型(Windows 版只有 1 个 worker 且用 select 模型)、服务化方式(需 WinSW 或 nssm 注册服务)。证书文件本身在两端通用,都是 PEM 格式。

不能,nginx 只读取 PEM 格式。用 openssl pkcs12 -in cert.pfx -nodes -out all.pem 转换成 PEM 后,再从文件中拆出证书链与私钥分别配置。作为对比,IIS 更习惯直接导入 PFX,所以同一张证书在 IIS 与 nginx 上的文件准备方式并不相同。

语法检查通过只代表配置可解析,不代表 443 端口真的由 nginx 在监听。先用 netstat -ano | findstr :443 确认监听进程 PID 是否对应 nginx.exe,常见情况是 IIS 的 http.sys 仍占用 443。其次确认已执行 nginx -s reload 而不是只改了文件,最后检查 Windows 防火墙是否放行 TCP 443。

配置写法完全一样,都是 PEM 格式的 fullchain 加私钥。差别在有效期与运维成本:Let's Encrypt 为 90 天,必须做自动续期与 reload;商业 DV 通常 1 年、OV/EV 1-2 年,价格从每年百元级到数千元级,附带人工审核与技术支持。

先确认 nginx 版本,1.25.1 起要用独立的 http2 on; 指令,写在 server 块内;1.25.0 及更早才用 listen 443 ssl http2;。然后用 curl.exe -I https://example.com -v 查看响应协议是否为 HTTP/2,若仍是 HTTP/1.1,检查是否有前置代理把协议降级。


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

内容审核

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