跳到主要内容
基础知识

CSR 文件怎么生成?OpenSSL、IIS 与 keytool 实操步骤及报错排查

csr文件怎么生成 — CSR 文件怎么生成?OpenSSL、IIS 与 keytool 实操步骤及报错排查
核心结论

生成 CSR 的核心命令是 `openssl req -new -newkey rsa:2048 -nodes -keyout example.com.key -out example.com.csr -subj '/CN=example.com' -addext 'subjectAltName=DNS:example.com,DNS:www.example.com' -sha256`,OpenSSL 1.1.1/3.x 可直接执行;私钥留在本地,只提交 CSR 给 CA。 验证 CSR 用 `openssl req -in example.com.csr -noout -verify -text`,应看到 `verify OK`、`sha256WithRSAEncryption` 和 DNS SAN;没有 SAN 的 CSR 不要提交。 公网 Web 常用 RSA 2048(兼容广)或 ECDSA P-256(握手快);NIST SP 800-57 对 2048 位 RSA 的评估使用期到 2030 年前后,之后评估 3072 位或 ECDSA。 Let's Encrypt 由 Certbot 2.x 等 ACME 客户端自动生成私钥与 CSR,90 天有效;商业 DV 常见 ¥0-¥500/年,OV ¥800-¥3000/年,EV ¥2000-¥8000/年,人工审核 1-7 个工作日。 生成后执行 `chmod 600 example.com.key`,私钥不进 Git;线上用 `openssl s_client -connect example.com:443 -servername example.com` 检查 `Verify return code: 0 (ok)` 与 TLS 1.2/1.3。

问题背景与根本原因:CSR 文件怎么生成,为什么总在“提交证书”这一步卡住?

“CSR 文件怎么生成”这个问题本身并不复杂,真正让人卡住的,是生成之后在 CA 页面提交时出现的各种异常。先把概念理清,绝大多数“提交失败”都能自己定位。

CSR 是 PKCS#10 格式的证书签名请求,规范见 RFC 2986。它的结构只有三块:公钥、主体信息(DN,含 CN/O/OU/C 等)、扩展项(最常见的是 SAN),最后用对应私钥对整段内容做一次签名,证明“我确实持有这把私钥”。据 RFC 2986 第 4 节,CA 校验签名通过后才会据此签发证书——所以 CA 只需要 CSR,永远不需要也不应该拿到私钥。把 .key 一起发给 CA 或上传到在线工具,等于把身份交给对方。

提交时卡住,通常不是“命令不会写”,而是把三个文件混为一谈:

文件 典型扩展名 里面有什么 能否公开
私钥 .key / .pem RSA/ECDSA 私钥本体 绝对不可外泄
CSR .csr / .req 公钥 + DN + SAN + 私钥签名 可交给 CA
证书 .crt / .cer / .pem 公钥 + DN + SAN + CA 签名 公开部署

第二个高频误区在命令参数上。OpenSSL req 子命令里,-key 表示复用已有私钥,-newkey 才会现场新建私钥。只写 -new 而漏掉 -key/-newkey,OpenSSL 会退回到读取 openssl.cnf 里 default_keyfile 的路径,常常直接报 req: Error on options or in configuration file 或提示找不到私钥。

第三个误区是只填 CN。据 RFC 5280 第 4.2.1.6 节,subjectAltName 才是标识证书适用域名的标准扩展;Chrome 58、Firefox 48 之后 CN 已完全不再参与域名匹配。CSR 里没有 DNS 类型的 SAN,即使签发成功,浏览器仍会报 NET::ERR_CERT_COMMON_NAME_INVALID。同理,摘要算法要显式写 -sha256:OpenSSL 1.1.1/3.x 的 req 默认已是 SHA-256,但沿用旧脚本或自定义配置时可能落到 SHA-1,而主流公共 CA 早已拒绝 SHA-1 签名的请求(CA/Browser Forum 基线要求)。

版本差异也会直接决定命令能不能跑:-addext 需要 OpenSSL 1.1.1 及以上,1.0.2 只能写配置文件;IIS 10 用 certreq -new,Java 8u301+/11+ 用 keytool -certreq,两者输出的同样是 PKCS#10。成本与周期上,据 Let’s Encrypt 文档,DV 证书免费、有效期 90 天,Certbot 2.x 一条命令即可完成 key+CSR+签发;商业 DV 常见 ¥0–¥500/年、OV ¥800–¥3000/年、EV ¥2000–¥8000/年,OV/EV 因需人工核验企业资质,通常 1–7 个工作日。

# 适用 OpenSSL 1.1.1 / 3.x:一条命令生成私钥 + CSR(含 SAN,SHA-256)
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key         # 新建私钥,务必 chmod 600
  -out example.com.csr            # 输出 PKCS#10 请求
  -subj "/C=CN/O=Example Ltd/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com" 
  -sha256                          # 显式指定摘要,避免落到 SHA-1

# 提交前自检:确认签名算法与 SAN 都在
openssl req -in example.com.csr -noout -text | grep -E "Signature Algorithm|DNS:"

最后一条实用判据:用 openssl req -in xxx.csr -noout -verify -key xxx.key 能同时校验 CSR 签名是否有效、CSR 与私钥是否配对。这一步过了再提交,能挡掉大半“CA 页面报格式错误”的往返。

完整实操步骤:从私钥到可提交 CSR 的 6 步(OpenSSL 3.x)

如果你已经决定用 OpenSSL 走一遍流程,下面这套 6 步可以原样复制执行:从版本确认、私钥生成、配置文件、签发请求,到自检和提交,每一步都给出可验证的输出特征。据 OpenSSL 3.x 的 req(1) 手册,-sha256 自 3.0 起已是默认摘要算法,显式写出只是为了留下审计痕迹;CSR 本身的格式由 RFC 2986(PKCS#10)定义,CA 只接受其中携带公钥与签名、绝不包含私钥的文件。

  1. 确认版本与文件默认权限。1.1.1 系列已于 2023-09-11 结束公共支持,遗留环境至少应确认是 1.1.1w;生产环境建议 OpenSSL 3.0.x 或 3.2.x。umask 077 必须在生成私钥之前执行,否则后续 .key 会按默认 umask 落到 644,等于把私钥暴露给同机所有用户。
# 第 1 步:版本与 umask
openssl version -a          # 期望输出形如:OpenSSL 3.0.13 30 Jan 2024 (Library: OpenSSL 3.0.13 ...)
umask 077                   # 之后新建文件权限 = 600,目录 = 700
umask                       # 回显 0077 表示生效
  1. 生成 RSA 私钥。genpkey 的 rsa_keygen_bits 在 OpenSSL 3.x 中默认 2048,因此不加该参数也得到 2048 位;genpkey 输出的是 PKCS#8(-----BEGIN PRIVATE KEY-----),而老版本 genrsa 输出 PKCS#1(-----BEGIN RSA PRIVATE KEY-----),个别老 CA 或导入工具对后者更友好,可追加 -traditional。
# 第 2 步:2048 位 RSA 私钥(PKCS#8 格式)
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -out example.com.key
# 需要 PKCS#1 兼容格式时:
# openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:2048 -traditional -out example.com.key
ls -l example.com.key       # 应为 -rw------- (600)
密钥长度选型:耗时基于普通 2 vCPU 云主机实测区间,随 CPU 与熵源波动
密钥长度 生成耗时 安全强度 握手签名开销 兼容性 适用场景
RSA 2048 约 0.1–0.5 s ≈112 位 基准 全部客户端 通用站点;Let’s Encrypt 默认签发 2048 位
RSA 3072 约 0.5–2 s ≈128 位 约 2.5× 绝大多数 合规过渡、中长期证书
RSA 4096 约 1–3 s(低配机可达 10 s+) ≈140 位以上 约 6× 全部客户端 根/中间 CA、离线长期签名
  1. 写配置文件。prompt = no 是关键:否则 openssl req 会忽略 [dn] 里的预设值转为交互提问,在自动化脚本里直接挂死。据 CA/Browser Forum Baseline Requirements,subjectAltName 是校验域名的唯一依据,Chrome 58 起已不再回退到 CN,所以 [alt_names] 必须写全主域名与所有别名。
# 第 3 步:example.com.cnf
[req]
distinguished_name = dn
req_extensions     = req_ext
prompt             = no

[dn]
CN = example.com
O  = Example Ltd
C  = CN

[req_ext]
subjectAltName = @alt_names

[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
  1. 生成 CSR。注意 -nodes 只在 -newkey 现场生成新私钥时才有效(含义是”不给新私钥加密”),对 -key 指定的既有私钥没有作用,写进去会被忽略;私钥本身已加密时,用 -passin 提供口令而非 -nodes。
# 第 4 步:签发 CSR
openssl req -new -key example.com.key -out example.com.csr -config example.com.cnf -sha256
# 私钥带口令时的非交互写法(口令文件权限同样设为 600):
# openssl req -new -key example.com.key -out example.com.csr -config example.com.cnf 
#   -sha256 -passin file:pass.txt
  1. 自检三项内容,缺一不可。摘要算法、公钥长度、SAN 扩展都要看;很多”CA 审核不通过”其实在本地这一步就能发现。顺便用公钥哈希确认 CSR 与私钥配对,避免提交错文件。
# 第 5 步:查看 CSR 内容
openssl req -in example.com.csr -noout -text
# 期望看到(节选):
#   Public-Key: (2048 bit)
#   Signature Algorithm: sha256WithRSAEncryption
#   Requested Extensions:
#       X509v3 Subject Alternative Name:
#           DNS:example.com, DNS:www.example.com

# 校验 CSR 与私钥是否配对:两条命令输出哈希应完全一致
openssl req -in example.com.csr -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout | openssl sha256
  1. 只提交 CSR,私钥不离机。把 example.com.csr 的完整 PEM 文本(含 -----BEGIN CERTIFICATE REQUEST----- 头尾)贴给 CA 即可;example.com.key 留在原机并确认 chmod 600,不要通过聊天工具、邮件或工单附件明文传输。签发完成后下载服务器证书 .crt 与中间链文件,后续部署时证书链不完整会直接导致部分 Android 与 Java 客户端握手失败。

常见报错及其根因:

# 1) 老版本 OpenSSL(1.1.1 及更早)的 .rnd 警告,非致命;3.x 已改用系统 CSPRNG,不再需要该文件
Can't load /root/.rnd into RNG
140736267418688:error:2406F079:random number generator:RAND_load_file:Cannot open file

# 2) req_extensions 指向的 section 名不存在或大小写不一致
Error loading request extension section req_ext

# 3) 私钥被截断、带 BOM 或粘贴时丢了头尾行(OpenSSL 3.x 错误格式)
Could not read private key from example.com.key
40B7F2A1:error:1E08010C:DECODER routines::unsupported

第 3 条在从网页或聊天窗口复制私钥时尤其常见:CRLF 混入或首行 -----BEGIN 前多了空格都会触发 DECODER routines::unsupported,用 file example.com.key 与 head -c 40 example.com.key | xxd 可以快速确认。这套流程产出的 CSR 同样适用于 ACME 之外的商业 CA;如果你走 Let’s Encrypt,客户端会在 ACME 流程中自行生成密钥与 CSR,此时更值得关注的是证书透明度日志(CT)与自动续期策略,而不是手工粘贴 CSR。

配置与命令示例:OpenSSL、IIS certreq、Java keytool 的具体写法

OpenSSL 3.x 怎么用一条命令生成 CSR 和私钥?

据 OpenSSL 官方手册,从 1.1.1 起 req 子命令支持 -addext,可以完全不交互地一次生成私钥和带 SAN 的 CSR。2048 位 RSA + SHA-256 是目前兼容性最好的默认组合(OpenSSL 3.x 的默认摘要已是 SHA-256,但显式写上可避免老配置文件覆盖):

# 一次生成私钥 + CSR,全程无交互;-nodes 表示私钥不加密(便于 Web 服务器自动加载)
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key 
  -out example.com.csr 
  -subj '/C=CN/O=Example Ltd/CN=example.com' 
  -addext 'subjectAltName=DNS:example.com,DNS:www.example.com' 
  -sha256
# 自检:确认 SAN 已写入 CSR,输出里应出现 X509v3 Subject Alternative Name
openssl req -in example.com.csr -noout -text | grep -A1 'Alternative Name'
# 核对公钥与私钥是否配对(两条输出的 MD5 必须一致)
openssl req -noout -modulus -in example.com.csr | openssl md5
openssl rsa -noout -modulus -in example.com.key | openssl md5

坑在这里:-addext 在 OpenSSL 1.0.2 上并不存在,CentOS 7 自带 1.0.2k,执行会直接报 req: Unknown option or number of arguments for -addext,随后提示 req: Use -help for summary.。此时只能回退到配置文件方式:

# openssl.cnf 片段:注意 [req] 段里写的是 req_extensions,不是 extensions
[req]
distinguished_name = dn
req_extensions     = req_ext        # 关键:req 命令只认这一项
prompt             = no
[dn]
C  = CN
O  = Example Ltd
CN = example.com
[req_ext]
subjectAltName = @alt_names
[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com

用 openssl req -new -key example.com.key -config openssl.cnf -out example.com.csr 时,CSR 扩展只读取 req_extensions;命令行上传 -extensions req_ext 是给 openssl x509 -req 签发阶段用的,混用会导致“签出来的证书没有 SAN”,Chrome 报 NET::ERR_CERT_COMMON_NAME_INVALID。

Windows Server / IIS 10 怎么做?IIS 管理器不生成 CSR 文件,它把请求写进 Windows 证书存储,要用 certreq 才落地成文件。新建 request.inf:

; request.inf —— 适用 Windows Server 2016+ / Windows 10+
[NewRequest]
Subject       = "CN=example.com, O=Example Ltd, C=CN"
KeyLength     = 2048
Exportable    = TRUE
MachineKeySet = TRUE      ; 私钥存机器存储,IIS 才能直接绑定
ProviderName  = "Microsoft RSA SChannel Cryptographic Provider"
[Extensions]
2.5.29.17 = "{text}DNS=example.com&DNS=www.example.com"
certreq -new request.inf example.com.csr

Java 环境(OpenJDK 11/17)用 keytool:先生成密钥对进 PKCS#12,再导出 CSR,两步不可合并:

keytool -genkeypair -alias example -keyalg RSA -keysize 2048 
  -sigalg SHA256withRSA -dname 'CN=example.com, O=Example Ltd, C=CN' 
  -ext SAN=dns:example.com,dns:www.example.com 
  -keystore example.p12 -storetype PKCS12 -validity 365
keytool -certreq -alias example -keystore example.p12 
  -file example.com.csr -sigalg SHA256withRSA

注意 keytool 的 -dname 不带 SAN,SAN 必须用 -ext 单独加;漏掉这一步,证书同样会被浏览器判定为域名不匹配。

Nginx 和 Apache 需要生成 CSR 吗?不需要。它们只消费证书与私钥,CSR 是交给 CA 的中间产物。部署时 Nginx 写 ssl_certificate /etc/nginx/ssl/fullchain.pem;(含中间证书链)与 ssl_certificate_key /etc/nginx/ssl/example.com.key;,Apache 对应 SSLCertificateFile 与 SSLCertificateKeyFile。

用 Let’s Encrypt 还要手工敲 openssl 吗?通常不用。按 Let’s Encrypt 官方文档,Certbot 2.x 会自行创建私钥与 CSR 并完成 ACME 校验:certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com。只有企业内网 CA 或 CA 要求手工提交 CSR 的流程,才需要上面这些文件。

维度 OpenSSL 3.x certreq(IIS 10) keytool(OpenJDK 17)
运行环境 Linux/macOS/Windows Windows Server 2016+ 任意安装 JRE 的系统
私钥存放 .key 文件(PEM) Windows 证书存储 PKCS#12 密钥库
SAN 写法 -addext 或 req_extensions [Extensions] 2.5.29.17 -ext SAN=dns:...
最低版本要求 1.1.1(1.0.2 无 -addext) Windows 10 / 2016 JDK 7+ 支持 -ext
默认摘要 SHA-256 SHA-256 需显式 -sigalg

参数对比与方案选型:RSA 2048/3072/4096、ECDSA P-256/P-384 与 SAN 怎么选?

一句话结论:公网 Web 站点在没有特殊合规要求时,选 RSA 2048 或 ECDSA P-256;若终端里还混着未打补丁的 Windows 7、Android 4.x,只选 RSA 2048。下表把五个候选放在同一坐标系里对比,数据依据 OpenSSL 3.x 实测与 NIST SP 800-57 Part 1 Rev.5 的安全强度对照。

维度 RSA 2048 RSA 3072 RSA 4096 ECDSA P-256 ECDSA P-384
安全强度 约 112 位 约 128 位 约 152 位 约 128 位 约 192 位
兼容性 最广 广 广但握手慢 TLS 1.2+ 主流 较新
CSR 生成耗时 0.1–1s 0.5–3s 1–10s <0.1s <0.2s
适用场景 通用/老客户端 合规增强 少用 现代 Web/移动 高安全

为什么不是“越大越好”?RSA 4096 的握手与签名运算量约为 2048 的 6–7 倍,在移动端和高并发网关上是实打实的 CPU 成本;而 ECDSA P-256 用 256 位密钥就达到 RSA 3072 的 128 位强度,握手包体也更小。代价是兼容性:Windows Server 2012 R2 之后的 Schannel 才比较稳妥地处理 ECDSA 证书,更老的 IIS 环境导入 ECDSA 证书时常见“证书链不完整”或绑定失败。据 NIST SP 800-57 Part 1 Rev.5,112 位强度(RSA 2048)的使用期限到 2030 年底,之后应评估迁移到 RSA 3072 或 ECDSA P-256/P-384。

SAN 怎么写才不会漏域名?一个 CSR 可以携带多个 DNS 名称,用逗号分隔且不能有空格:DNS:example.com,DNS:www.example.com,DNS:api.example.com。通配符 DNS:*.example.com 只覆盖一级子域,既不包括裸域 example.com,也不包括 a.b.example.com,因此实务中通常写成 DNS:example.com,DNS:*.example.com。据 Let’s Encrypt 官方速率限制文档,单张证书默认最多 100 个 SAN 名称,同一注册域名每周最多签发 50 张证书,所以把上百个域名塞进一张 CSR 前先算清楚额度;商业通配符 DV 证书常见价格区间为每年 ¥300–¥1500,多域名 SAN 证书则按域名数阶梯计价。

# RSA 2048 + SAN,一步生成私钥与 CSR(OpenSSL 1.1.1 及以上支持 -addext)
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key 
  -out example.com.csr 
  -subj "/C=CN/ST=Beijing/L=Beijing/O=Example Ltd/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com,DNS:api.example.com" 
  -sha256        # 显式指定摘要,OpenSSL 1.1.1+ 默认值即 sha256

# ECDSA P-256:先生成 EC 私钥,再签发 CSR
openssl ecparam -genkey -name prime256v1 -out example.com.ec.key
openssl req -new -key example.com.ec.key -out example.com.ec.csr 
  -subj "/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:*.example.com" 
  -sha256        # 输出 ecdsa-with-SHA256,切勿用 -sha1

提交前务必自检签名算法与 SAN,这条命令能把关键字段一次打出来:

openssl req -in example.com.csr -noout -text | grep -E "Signature Algorithm|Public Key Algorithm|NIST CURVE|DNS:"
# RSA 输出示例:
#         Signature Algorithm: sha256WithRSAEncryption
#         Public Key Algorithm: rsaEncryption
#             DNS:example.com, DNS:www.example.com, DNS:api.example.com
# ECDSA 输出示例:
#         Signature Algorithm: ecdsa-with-SHA256
#         Public Key Algorithm: id-ecPublicKey
#             NIST CURVE: P-256

真实报错:error:0D07A780:asn1 encoding routines:ASN1_mbstring_ncopy:illegal characters——几乎都是 -addext 里逗号后加了空格,或 SAN 中混入中文域名未做 punycode 转换。另一条 req: Unknown option or ciphersuite addext 说明 OpenSSL 版本低于 1.1.1,需改用 -config 文件里的 [req_extensions] subjectAltName=@alt_names 写法。

最后确认 CA 侧接受度:提交 CSR 前先看 CA 的算法支持列表,部分 OV/EV 流程仍以 RSA 2048/3072 为主,ECDSA 可能被拒或要求重签。CSR 本身只是把公钥和主体信息做自签名封装,最终证书的密钥算法由 CSR 里的公钥决定——这也是“csr文件怎么生成”看似是格式问题、实则是选型问题的原因。

常见错误与排查:真实报错信息与对应命令

排查 CSR 相关报错,第一步永远是确认你手里的文件到底是哪一种。私钥、CSR、证书三者都是 Base64 文本(PEM 格式),肉眼看起来很像,混用是最高频的故障源。先记住这三条判别命令,后面所有报错都从这里出发:

# 1. 看文件头部标识:PRIVATE KEY / CERTIFICATE REQUEST / CERTIFICATE
head -n 1 example.com.key example.com.csr

# 2. 校验私钥是否可用(不输出内容,只验证结构)
openssl pkey -in example.com.key -noout -text

# 3. 校验 CSR 签名是否自洽
openssl req -in example.com.csr -noout -verify

报错:unable to load Private Key / PEM_read_bio_PrivateKey。OpenSSL 1.1.1 与 3.x 在读取私钥失败时都会抛出这类信息,原因基本只有三种:路径写错、私钥带口令但没提供密码、或者把 .csr 当成了 .key。验证时用 openssl pkey(3.x 推荐,替代旧的 openssl rsa);若私钥是 AES 加密的,必须加 -passin:

# 加密私钥:显式传入口令,pass: 表示明文,file: 表示从文件读,env: 表示从环境变量读
openssl pkey -in example.com.key -noout -text -passin pass:'YourPassphrase'

# 若提示 bad decrypt,说明口令错误或文件损坏——先 cp 备份,不要在原文件上反复试
cp -a example.com.key example.com.key.bak

bad decrypt 属于不可逆操作风险点:某些旧脚本会用 openssl rsa -in ... -out ... 原地“修复”,一旦口令不对可能写坏原文件。据 OpenSSL 官方文档,pkey 子命令在 1.0.0 起提供,是读取 PKCS#8/PKCS#1 私钥的统一入口。

报错:Error adding request extensions / X509V3_EXT_nconf_nid。这是配置文件三段式没对齐。必须同时存在:[req] 段里的 req_extensions = req_ext、被引用的 [req_ext] 段、以及 SAN 用的 subjectAltName = @alt_names 与对应的 [alt_names] 段。任何一处拼写不一致(例如写成 req_extention)都会触发该错误。

# /etc/ssl/example.com.cnf —— 三段必须互相指向
[req]
distinguished_name = dn
req_extensions     = req_ext      # 名字必须与下面的段名完全一致
prompt             = no

[dn]
CN = example.com

[req_ext]
subjectAltName = @alt_names      # @ 表示引用下面的段

[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com

报错:No such file or directory(指向 .cnf)。在 systemd 单元、cron 或 CI runner 中,工作目录与你交互式 shell 不同,相对路径必然失效。统一改用绝对路径:

openssl req -new -newkey rsa:2048 -nodes 
  -keyout /etc/ssl/private/example.com.key 
  -out /etc/ssl/certs/example.com.csr 
  -config /etc/ssl/example.com.cnf

Windows / IIS:certreq -new 报 The request contains no certificate template information。这通常出现在对接企业 AD CS 的场景,CA 强制要求请求中携带模板名。在 request.inf 的 [RequestAttributes] 下补一行(模板名须与 CA 上实际存在的模板一致,WebServer 是常见默认名):

; request.inf 片段
[RequestAttributes]
CertificateTemplate=WebServer

; 生成请求并提交
certreq -new request.inf example.com.csr

Java:keytool error: java.lang.Exception: Alias <example> does not exist。keytool 的 -alias 区分大小写,且必须与当初 -genkeypair 时完全一致。先列别名再申请:

# PKCS12 是 JDK 9 起的默认 keystore 类型,旧版本需显式 -storetype
keytool -list -v -keystore example.p12 -storetype PKCS12

keytool -certreq -alias example -keystore example.p12 
        -storetype PKCS12 -file example.com.csr

提交后 CA 报 CSR signature verification failed。几乎都是编辑器(尤其 Windows 记事本)改写了换行符,或复制时截断了 -----END CERTIFICATE REQUEST----- 尾行。据 Let’s Encrypt 文档,CSR 的 DER 结构一经改动签名即失效,必须在本地先自检,看到 verify OK 才提交。

报错关键字 最可能原因 定位命令
unable to load Private Key 路径错 / 未给口令 / 文件类型错 openssl pkey -in key -noout -text
bad decrypt 口令错误或文件损坏 先 cp 备份,再 -passin 重试
X509V3_EXT_nconf_nid req_extensions 与段名不匹配 检查 [req]/[req_ext]/[alt_names]
No such file or directory -config 用了相对路径 改为绝对路径
no certificate template information AD CS 模板名缺失 inf 中加 CertificateTemplate
Alias does not exist 别名大小写或拼写不符 keytool -list 先查
CSR signature verification failed 换行符被改写 / 内容截断 openssl req -in csr -noout -verify

顺带一提,CSR 只承载公钥与身份属性,私钥永远不离开本机——这也是为什么 openssl req -new -key 与 -newkey 两条路径都必须妥善保管 .key;后续无论是申请 DV 证书、配置 OCSP Stapling,还是做证书链拼接,都以这把私钥为根。

效果验证方法:如何确认 CSR 正确、证书链已生效?

把 CSR 交给 CA 之前先做一轮本地自检,比等签发失败再返工便宜得多。csr文件怎么生成这一步各家工具(OpenSSL / IIS / keytool)产出的格式一致,但验证手段通用。先验证 CSR 自身的签名与主题:

# 1) 校验 CSR 自签名完整性;OpenSSL 1.1.1+ / 3.x 均支持 -verify
openssl req -in example.com.csr -noout -verify
# 期望输出:Certificate request self-signature verify OK
# 若密钥文件与 CSR 不配套,会报:
#   verify failure
#   .../req.c:xxx:error:...:ASN1 lib:...:verify error

# 2) 以 RFC2253 规范格式打印主题,避免 CN 顺序歧义
openssl req -in example.com.csr -noout -subject -nameopt RFC2253
# 期望输出:subject=CN=example.com
# 注意:CN 长度上限 64 字符(X.509 定义),且现代浏览器只认 SAN,CN 仅供展示

第二步确认私钥和 CSR 里的公钥是同一对。原理是比对 SubjectPublicKeyInfo 的哈希,两份 PEM 编码必须一致,否则哈希天然不同:

# 提取 CSR 内公钥的 SHA-256
openssl req -in example.com.csr -noout -pubkey | openssl sha256
# 提取私钥对应公钥的 SHA-256(-pubout 输出 SPKI PEM,与上面编码一致)
openssl pkey -in example.com.key -pubout | openssl sha256

# 证书签发后,用 modulus 再对一次(仅 RSA 适用)
openssl x509 -in example.com.crt -noout -modulus | openssl sha256
openssl rsa  -in example.com.key -noout -modulus | openssl sha256

两行输出相同即匹配。若不同,说明 CSR 与私钥不是一对,此时提交上去签发的证书装到服务器上会直接握手失败。ECDSA 证书没有 modulus,改用 openssl x509 -pubkey -noout | openssl sha256。

SAN 是当前证书的强制项。据 CA/Browser Forum Baseline Requirements(自 2017 年起),公有 CA 签发的证书必须包含 subjectAltName,缺失时 Chrome 报 NET::ERR_CERT_COMMON_NAME_INVALID。检查:

# 3) 检查 SAN 列表;OpenSSL 1.1.1+ 的 req -text 会完整展开扩展
openssl req -in example.com.csr -noout -text | grep -A2 'Subject Alternative Name'
# 期望看到:DNS:example.com, DNS:www.example.com
# 若完全没有输出该段落,说明生成 CSR 时漏了 -addext 或配置文件缺 subjectAltName,
# 不要提交,重新生成

下面这张表把上面几项收敛成一份可勾选的清单:

检查项 关键命令参数 通过标准 失败含义
CSR 签名 req -noout -verify verify OK CSR 被截断或编码损坏
公钥匹配 -pubkey | sha256 两枚哈希相同 CSR 与私钥非同一密钥对
SAN 完整性 -text | grep -A2 SAN 含全部 DNS 名 浏览器 CN 不匹配告警
链与协议 s_client -showcerts Verify return code: 0 (ok) 缺中间证书,报 20 (unable to get local issuer certificate)

证书装好后再做线上验证。s_client 要显式带 -servername 触发 SNI,否则虚拟主机场景下拿到的可能是默认站点证书:

# 4) 线上握手与链验证
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null
# 关注三行:Protocol(TLSv1.2 / TLSv1.3)、Verify return code: 0 (ok)、
# 以及输出里出现的中间 CA 证书块(链应至少两级,根证书不必下发)

# 5) 证书有效期、签发者与 SAN 一次性核对
openssl x509 -in fullchain.pem -noout -dates -issuer -subject -ext subjectAltName

# 6) OCSP stapling:若配置了装订,这里应返回实际响应
openssl s_client -connect example.com:443 -servername example.com -status </dev/null
# 输出 "OCSP response: no response sent" 表示服务器未装订,不等于证书无效

最后用外部视角复核:Chrome 开发者工具 Security 面板应显示 Certificate - valid;curl -I https://example.com 返回 200 且无证书告警(curl -v 会打印 SSL certificate verify ok)。据 Mozilla Server Side TLS 指南,生产环境应关闭 TLS 1.0/1.1,可用 testssl.sh --protocols example.com 或 SSL Labs 扫描确认;但涉及协议下线这类变更,务必先在预发环境跑一遍,再推生产。回看前面 csr文件怎么生成 的步骤,你会发现验证成本远低于重新签发的等待时间。

ACME 自动化与 CSR 的边界:Let's Encrypt、企业 CA 与手动 CSR 怎么配合?

ACME 把 CSR 变成了一个”看不见的中间产物”。据 RFC 8555(ACME 协议)定义,客户端在 finalize 请求中提交 DER 格式的 CSR,CA 据此签发证书;而 CSR 里的公钥对应的私钥,从生成到落盘全程留在你自己的服务器上。理解这条边界,是判断”该自动化还是该手动”的关键。

Certbot 到底在后台做了什么?

Certbot 2.x 在首次签发时会自动创建账号密钥、域名私钥(默认 RSA 2048,可用 --key-type ecdsa --elliptic-curve secp256r1 改为 ECDSA P-256),再用该私钥生成 CSR 并完成 HTTP-01 或 DNS-01 挑战。证书落地路径固定为:

# Certbot 2.x 默认输出布局(--cert-name 决定目录名)
/etc/letsencrypt/live/example.com/fullchain.pem   # 证书链,Web 服务器应引用此文件
/etc/letsencrypt/live/example.com/privkey.pem     # 私钥,权限 0600
/etc/letsencrypt/live/example.com/chain.pem       # 中间证书
/etc/letsencrypt/archive/example.com/             # 真实文件,live/ 下是软链接
# 注意:archive 目录内每次续期生成新文件(cert1.pem、cert2.pem…),便于回滚

# 续期演练:不实际签发,只验证挑战与钩子是否可用
certbot renew --dry-run

# 查看当前证书的 SAN 与到期时间
openssl x509 -in /etc/letsencrypt/live/example.com/cert.pem -noout -text | grep -A1 "Subject Alternative Name"

适用版本:Certbot 2.0 起 --dry-run 默认走 staging 环境,避免触发正式环境的速率限制(据 Let’s Encrypt 文档,同一注册域名每周 50 张重复证书)。

为什么不该把私钥上传到”证书代管面板”?

很多托管面板要求你粘贴私钥来”帮你申请”。这在安全上等价于把身份凭证交给第三方:一旦面板被入侵,攻击者可对任意流量做中间人解密。合规做法是让面板本身充当 ACME 客户端——它自己生成密钥、自己完成挑战,你只授予最小权限的 API Token。反过来说,如果你确实需要手动提交 CSR 给第三方 CA(企业内网 CA、代码签名、EV 证书),那就必须走下面这条路径。

企业 CA / EV / 代码签名:手动 CSR 三件套

这些流程通常不接受 ACME,必须人工提交 CSR。此时请保留完整的证据链:

# 1) 生成私钥(RSA 3072,兼顾兼容性与强度)
openssl genpkey -algorithm RSA -pkeyopt rsa_keygen_bits:3072 -out example.com.key
chmod 600 example.com.key

# 2) 生成 CSR,同时指定 SAN(必须写在 -addext 中,CN 已不被现代浏览器采信)
openssl req -new -key example.com.key -out example.com.csr 
  -subj "/C=CN/O=Example Ltd/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

# 3) 校验 CSR 签名并导出 SHA-256 指纹,记入审计台账
openssl req -in example.com.csr -noout -verify
openssl req -in example.com.csr -noout -pubkey | openssl pkey -pubin -outform DER | openssl dgst -sha256
# 输出示例:SHA2-256(stdin)= 9f2c...(与私钥指纹一一对应)

建议把 .key、.csr、生成时使用的 .cnf(若用了配置文件)以及生成时间、指纹一并归档。CSR 本身可复用——同一密钥对可向不同 CA 提交,但只要 SAN 列表有任何变更,就必须重新生成,因为 SAN 是签名覆盖的内容。

自动化与手动的取舍

场景 CSR 由谁生成 私钥位置 推荐周期
公网 Web(Let’s Encrypt) ACME 客户端自动 本机磁盘,不出网 60–90 天自动续期
企业内网 CA(AD CS 等) 管理员手动 本机 / HSM 1 年,随密钥轮换
EV / 代码签名 手动,常配 USB Token 硬件令牌内 1–3 年
第三方代管面板 面板(若其为 ACME 客户端) 面板服务器 需评估信任边界

密钥轮换策略上,RSA 2048 建议每 1–2 年评估一次是否升级到 3072 或切换 ECDSA P-256;证书续期时同步换钥,可以限制单把私钥泄露的影响面。签发完成后别忘了配置联动:启用 TLS 1.2/1.3、加 HSTS、开 OCSP stapling。Mozilla SSL Configuration Generator 的 “intermediate” 档位可作为 Nginx/Apache 的基线,但它默认假设较新的客户端,面向老旧终端(如嵌入式设备、旧版 Android)时需回退到 “old” 档并单独测试握手。

如果你只是想在自动化流程里补一个手动 CSR(例如给负载均衡器预置证书),那”csr文件怎么生成”这一步依然绕不开 OpenSSL 或 keytool;但请记住,CSR 只是公钥的载体,真正需要被严格保护、并且在自动化中绝不外传的,是那个 .key 文件。

密钥权限、备份与轮换:CSR 生成后的运维清单

私钥落地后第一件事做什么?先把权限收到“只有 root 能读”。PEM 格式的私钥是明文(RFC 7468 定义的就是未加密的 Base64),能读该文件的进程就等于拿到了站点身份。据 OpenSSL 文档,genrsa、req -newkey 按 umask(常见 022)创建文件,默认就是 644,必须显式修正。很多人只关心 csr 文件怎么生成,却漏掉了这一步:

# 目录 700、私钥 600 且属主 root;CSR 与证书链可公开读
install -d -m 700 -o root -g root /etc/ssl/private/example.com
chown root:root example.com.key
chmod 600 example.com.key
chmod 644 example.com.csr fullchain.pem

# 验证私钥与证书确实配对(轮换时最容易贴错文件)
openssl x509 -in example.com.crt -noout -pubkey | openssl sha256
openssl pkey -in example.com.key -pubout      | openssl sha256

Nginx 的 master 进程以 root 打开私钥、worker 继承文件描述符,所以 600 root:root 是正常配置;若在容器里以非 root 运行并看到 nginx: [emerg] cannot load certificate key ... BIO_new_file() failed (SSL: error:8000000D:system library::Permission denied),那是进程本身没有读权限,而不是密钥损坏。至于 Git,.key 一旦入库就必须视为泄露:

printf '*.keyn*.p12n*.pfxn' >> .gitignore
git ls-files '*.key'   # 输出非空 = 历史中已有私钥,需 filter-repo 清理并重签证书

备份怎么做才不算“裸奔”?私钥至少两份离线加密副本,与在线主机物理隔离。age 与 gpg 都能直接对管道加密,无需先落地明文压缩包:

# age:单文件密钥,无 Web of Trust 负担
age-keygen -o backup-age.key                            # 生成密钥对,公钥形如 age1qz...
tar -czf - example.com.key | age -r age1qz... > example.com.key.age
age -d -i backup-age.key example.com.key.age > example.com.key   # 恢复

# gpg 等价做法(AES256 对称加密)
gpg --symmetric --cipher-algo AES256 example.com.key     # 产出 example.com.key.gpg
gpg -d example.com.key.gpg > example.com.key

CSR 本身不含私钥、可以公开,但建议与证书一起归档并保留 13 个月:90 天证书一年续 4 次,13 个月足以覆盖跨年的完整审计周期。

什么时候该重新生成 CSR?新 CSR 不等于新私钥——同一把密钥可以反复签 CSR,只有怀疑泄露时才必须换钥。这也是 csr 文件怎么生成的第二个高频场景,判断依据如下:

场景 有效期 建议动作 依据
Let’s Encrypt / ACME 90 天 剩余 30 天(第 60 天)自动续期 Let’s Encrypt 文档建议到期前 30 天续期
商业 DV/OV 证书 ≤398 天 到期前 30–60 天提交新 CSR CA/Browser Forum Baseline Requirements
内部 CA 自定义 剩余 1/3 生命周期时 需同步 CRL/OCSP
certbot certificates      # 查看每张证书的到期日与剩余天数
certbot renew --dry-run   # 演练续期,不改动线上文件

商业证书拖到最后一周才换,容易撞上 OCSP 响应或中间链变更导致的中断,留 30–60 天才有回滚余地。

怎么每天确认证书没过期?直接对线上端口取值,比读本地文件更可靠,能发现“部署了旧文件”这类问题:

# -servername 触发 SNI;</dev/null 防止 s_client 挂起等待输入
openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -enddate -issuer
# 输出示例:notAfter=Aug 12 03:14:07 2026 GMT

# 剩余天数 < 21 天告警,可放进 cron 或 systemd timer 每日执行
end=$(openssl s_client -connect example.com:443 -servername example.com </dev/null 2>/dev/null 
  | openssl x509 -noout -enddate | cut -d= -f2)
days=$(( ( $(date -d "$end" +%s) - $(date +%s) ) / 86400 ))
[ "$days" -lt 21 ] && echo "WARN: 仅剩 ${days} 天"

要不要开 FIPS?普通网站不必默认开启。OpenSSL 3.x 把 FIPS 做成可加载 Provider,openssl list -providers 默认只显示 default;启用需用 openssl fipsinstall 生成配置并在 openssl.cnf 中加载 fips,代价是 MD5、部分椭圆曲线等算法被禁用、握手兼容性下降。只有合规审计明确要求时才启用,并用 openssl ciphers -provider fips 核对实际可用套件。生成私钥的环境本身也应限制登录(跳板机 + sudo 审计),避免密钥材料进入 shell 历史。

不需要。CA 只需要 CSR 来签发证书,私钥必须留在你自己的服务器或密钥库中。把 .key 发给任何人都会扩大私钥泄露面,后续应通过文件权限、离线备份和审计控制访问。

可以填,但不要只依赖 CN。Chrome 58+、Firefox 48+ 后证书匹配以 SAN 为主,CSR 里应写入 `subjectAltName=DNS:example.com,DNS:www.example.com`。CN 仍可保留为 `example.com`,便于旧系统识别。

技术上同一私钥和 CSR 可向不同 CA 申请,但 CSR 中的 SAN 列表是固定的,域名变化必须重新生成。生产环境不建议长期复用同一私钥,证书轮换时同步轮换密钥更便于控制风险。

通常不需要。Certbot 2.x 等 ACME 客户端会自动生成私钥、CSR 并完成 HTTP-01/TLS-ALPN-01 挑战。只有企业 CA、代码签名或 CA 明确要求上传 CSR 的流程,才需要按本文命令手工生成。

先确认 `-key` 路径指向 .key 而不是 .csr,再用 `openssl pkey -in example.com.key -noout -text` 检查文件是否可读。若私钥有密码,命令要加 `-passin pass:…` 或 `-passin file:pass.txt`;出现 `bad decrypt` 时优先从备份恢复。

公网 Web 用 RSA 2048 仍常见,兼容性广;NIST SP 800-57 对 2048 位 RSA 的评估使用期到 2030 年前后。4096 位握手和签名更慢,除非合规要求,否则优先评估 ECDSA P-256 或按 CA 要求选 3072 位。

通配符写 `DNS:*.example.com`,它只覆盖 `www.example.com`、`api.example.com` 这类一级子域,不覆盖 `example.com`,也不覆盖 `a.b.example.com`。需要根域名时同时加入 `DNS:example.com`。


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

内容审核

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