跳到主要内容
基础知识

OpenSSL 生成自签名证书实操:SAN、有效期与报错排查

openssl 生成自签名证书 — OpenSSL 生成自签名证书实操:SAN、有效期与报错排查
核心结论

用 OpenSSL 3.0.x 生成自签名证书的最小命令是 openssl req -x509 -newkey rsa:2048 -sha256 -days 365 -nodes -keyout key.pem -out cert.pem -subj '/CN=example.local',生产环境还应加 -addext 'subjectAltName=DNS:example.local,IP:127.0.0.1'。 自签名证书默认不被操作系统和浏览器信任,适合内网 HTTPS、开发测试、mTLS 与设备管理;对外站点应优先用 Let's Encrypt 的 90 天免费证书或商业 CA。 OpenSSL 1.1.1 起 req 支持 -addext;1.1.0 及更早版本需在 openssl.cnf 中写 [v3_req] 和 [alt_names],否则 Chrome 58+/Go 1.15+ 会报 x509: certificate relies on legacy Common Name field, use SANs instead。 测试证书有效期建议 30-90 天,内网 365 天;公网 CA 证书受 398 天上限约束,自签名用于内网仍应建立 30 天到期监控与轮换流程。 验证是否生效用 openssl verify -CAfile example.local.crt example.local.crt 应返回 OK,再用 openssl s_client -connect 127.0.0.1:443 -servername example.local -CAfile example.local.crt 检查 Verify return code: 0 (ok)。

为什么 OpenSSL 生成自签名证书后浏览器仍提示不安全?

浏览器提示“不安全”,是因为证书“没签名”吗?不是。自签名证书的 issuer 与 subject 完全相同——签名者就是它自己。TLS 握手仍然能完成密钥交换并加密流量,失败的是身份校验这一步:客户端拿到叶证书后,会沿着 X.509 的签发者链一路向上找,直到命中一个预先配置在本机信任库中的根证书。自签名证书既是叶也是根,而 Chrome、Firefox、Windows 证书存储、macOS Keychain 都不认识它,链条在第一步就断了。据 RFC 5280 第 6 节对认证路径验证的定义,信任锚必须由客户端事先配置,服务器无法“自证清白”。

具体会看到哪些报错?三种客户端给出三种措辞,本质都是 OpenSSL 的 X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT(数值 18):

  • Chrome / Edge:NET::ERR_CERT_AUTHORITY_INVALID,可点“高级 → 继续前往”绕过,但地址栏永久显示红色警告。
  • curl:curl: (60) SSL certificate problem: self-signed certificate。
  • openssl s_client:Verify return code: 18 (self-signed certificate)。

怎样生成一张“浏览器以外都认”的证书并验证它?关键是把 SAN 写进去。据 RFC 6125,服务身份应当用 subjectAltName 标识;Chrome 58+ 与 Go 1.15+ 已完全忽略 CN,只有 CN 的证书会报 x509: certificate relies on legacy Common Name field, use SANs instead。以下命令适用于 OpenSSL 1.1.1 及以上(req 自该版本起支持 -addext):

# -x509 直接输出自签名证书;-days 默认仅 30 天,生产/测试建议显式指定
# -nodes 表示私钥不加密(便于服务自动加载);-sha256 规避弱摘要告警
openssl req -x509 -newkey rsa:2048 -nodes 
  -keyout server.key -out server.crt 
  -days 397 -sha256 
  -subj "/C=CN/O=Dev/CN=dev.internal" 
  -addext "subjectAltName=DNS:dev.internal,DNS:*.dev.internal,IP:192.168.1.10" 
  -addext "basicConstraints=critical,CA:FALSE" 
  -addext "keyUsage=critical,digitalSignature,keyEncipherment" 
  -addext "extendedKeyUsage=serverAuth"

# 确认 SAN 已写入(应有 DNS:dev.internal, DNS:*.dev.internal, IP Address:192.168.1.10)
openssl x509 -in server.crt -noout -text | grep -A1 "Subject Alternative Name"

# 自签名场景下,必须把证书本身当作信任锚显式传入,否则依旧是 error 18
openssl verify -CAfile server.crt server.crt
# server.crt: OK

# 客户端侧同样要指定信任锚,才能通过校验
curl --cacert server.crt https://dev.internal:8443/

老版本 OpenSSL 怎么办?1.1.0 及更早版本没有 -addext,必须写配置文件,否则 SAN 会静默丢失:

# openssl.cnf —— 适用于 OpenSSL 1.0.2 / 1.1.0
[req]
distinguished_name = dn
x509_extensions    = v3_req   # 关键:把扩展挂到自签名证书上
prompt             = no
[dn]
CN = dev.internal
[v3_req]
subjectAltName   = @alt_names
basicConstraints = critical,CA:FALSE
[alt_names]
DNS.1 = dev.internal
DNS.2 = *.dev.internal
IP.1  = 192.168.1.10

# 调用:openssl req -x509 -newkey rsa:2048 -nodes -keyout server.key 
#        -out server.crt -days 397 -sha256 -config openssl.cnf

为什么用 SHA-1 会握手失败?OpenSSL 3.0.x 的默认安全级别(SECLEVEL)为 1,但 Debian/Ubuntu 在 /etc/ssl/openssl.cnf 中常改为 2,此时 SHA-1 签名的证书会被拒绝,报 ca md too weak。统一加 -sha256 即可,也可临时用 -cipher 'DEFAULT@SECLEVEL=1' 调试。

方案 浏览器是否信任 典型有效期 成本 适合场景
自签名叶证书 否,需手动导入或 --cacert 自定义,默认 30 天 0 本地开发、IoT 设备、单机测试
内部 CA(自建根 + 签发叶证书) 导入根证书后信任 根 10 年、叶 90–397 天 0,需运维 内网 HTTPS、mTLS、K8s admission webhook
Let’s Encrypt 是 90 天,ACME 自动续期 0 面向公众的站点与服务
商业 OV 证书 是 1–2 年 约 200–3000 元/年 电商、金融等需组织身份背书的场景

什么时候可以接受“不安全”提示?内网管理后台、开发联调、mTLS 双向认证中的客户端证书、Kubernetes admission webhook(caBundle 直接注入自签 CA)、邮件服务 TLS,这些场景的信任锚由运维集中分发,自签名完全够用。但不建议把自签名证书直接挂到面向公众的官网——它无法防中间人、无法自动轮换、每台客户端都要单独导入。设备一多,正确做法是自建一套内部 CA,用同一张根证书签发所有叶证书,而不是给每台设备各生成一张自签名证书。

第一步:确认 OpenSSL 版本、目录与私钥权限(含命令)

在动手写 openssl.cnf 之前,先花两分钟确认运行环境,可以省掉后面 80% 的“证书明明生成了却不被信任”的排查。据 OpenSSL 官方文档,openssl version -a 会同时打印编译参数与 OPENSSLDIR,后者决定了默认配置文件路径——很多“改了配置不生效”的问题,根源就是编辑了 /etc/ssl/openssl.cnf,而二进制实际读取的是 /usr/local/ssl/openssl.cnf。

# 查看版本、编译日期、默认配置目录(注意 OPENSSLDIR 这一行)
openssl version -a
# 典型输出:
# OpenSSL 3.0.13 30 Jan 2024 (Library: OpenSSL 3.0.13 30 Jan 2024)
# built on: ...
# OPENSSLDIR: "/usr/lib/ssl"

# 确认 -addext 是否可用(1.1.1 及以上才有)
openssl req -help 2>&1 | grep -w addext

版本差异直接决定你走哪条命令路径。低于 1.1.1 的版本没有 -addext 参数,必须回到配置文件里手写 [v3_req] 段,否则生成的证书不含 SAN,现代浏览器与 Go/Java 客户端一律拒绝。

发行版 默认 OpenSSL 版本 能否用 -addext 备注
Ubuntu 22.04 LTS 3.0.10 可以 配置文件在 /usr/lib/ssl/openssl.cnf
Ubuntu 20.04 LTS 1.1.1f 可以 1.1.1 系列首个 LTS 版本
RHEL 9 / Rocky 9 3.0.x 可以 系统级 crypto-policies 可能禁用 SHA-1
RHEL 8 / CentOS 8 1.1.1k 可以 需注意 FIPS 模式下 1024 位 RSA 被拒
CentOS 7 1.0.2k 不可以 已 EOL,建议先升级或改用容器内的新版

接着建工作目录并收紧默认权限。umask 077 必须在生成私钥之前执行,它让新建文件默认就是 600,而不是事后补救——事后 chmod 之间那段窗口期,密钥可能已被其他用户读到。

# 建目录,仅 root 可进入
mkdir -p /etc/ssl/selfsign && cd /etc/ssl/selfsign
umask 077          # 后续新建文件默认 600,目录默认 700

# 生成完成后统一校准权限(.crt 可公开,.key 必须私有)
chmod 600 *.key
chmod 644 *.crt
chown root:root *.key

文件名要按用途分开,别把私钥和证书塞进同一个 .pem:Nginx 的 ssl_certificate 指令期望的是证书链(叶子证书在前、中间证书在后),ssl_certificate_key 单独指向私钥;混在一个文件里虽然 OpenSSL 能解析,但排查握手失败时你会分不清是哪一段出错。建议命名为 example.local.key、example.local.csr、example.local.crt。

权限还要匹配 Web 服务器的读取方式,这一点最容易被忽略:

服务端 读取私钥的进程身份 推荐权限 说明
Nginx master 以 root 读取,再降权到 worker root:root + 600 worker 不需要直接访问 key
Apache httpd 子进程以 www-data/apache 直接读取 root:www-data + 640 用 600 会报 AH02217: ssl_stapling_init_cert 之前就启动失败

最后校对时间。证书的 notBefore/notAfter 完全依赖签发机的系统时钟,据 Let’s Encrypt 文档与 RFC 5280 的约定,校验方通常会留出少量时钟偏移容忍度,但偏差超过 5 分钟就很容易触发 x509: certificate has expired or is not yet valid——容器里尤其常见,因为镜像默认 UTC 而业务机是本地时区,或宿主机休眠后时钟漂移。

# 统一用 UTC 查看,避免时区干扰
date -u
timedatectl status | grep -E "Time zone|synchronized"   # systemd 系统
# 容器内确认是否挂载了宿主时钟
docker run --rm debian:12 date -u

私钥永远不要提交进 Git;在仓库根目录加一行 *.key 到 .gitignore,比事后 git filter-repo 清洗历史便宜得多。

第二步:一条命令生成带 SAN 的自签名证书(OpenSSL 1.1.1/3.0.x)

很多人第一次用 openssl 生成自签名证书 都会掉进同一个坑:证书 CN=example.local 写得没错,浏览器却报 ERR_CERT_COMMON_NAME_INVALID。原因是自 Chrome 58 / RFC 5280 起,CN 已不再参与主机名校验,客户端只看 SAN(subjectAltName)。所以正确做法是:一条命令同时产出私钥、证书和 SAN 扩展。

下面这条命令在 OpenSSL 1.1.1 与 3.0.x 上均可直接运行(-addext 从 1.1.1 引入,1.0.2 不支持,需改用 -extfile):

# 生成 2048 位 RSA 私钥 + 自签名证书,SAN 同时覆盖两个域名和一个 IP
openssl req -x509 -newkey rsa:2048 -sha256 -days 365 -nodes 
  -keyout example.local.key -out example.local.crt 
  -subj '/C=CN/ST=Beijing/L=Beijing/O=Example/OU=IT/CN=example.local' 
  -addext 'subjectAltName=DNS:example.local,DNS:www.example.local,IP:127.0.0.1' 
  -addext 'basicConstraints=critical,CA:FALSE' 
  -addext 'keyUsage=critical,digitalSignature,keyEncipherment' 
  -addext 'extendedKeyUsage=serverAuth'

# 若用 ECDSA(P-256),keyUsage 必须去掉 keyEncipherment,否则用途与算法不匹配
openssl req -x509 -newkey ec -pkeyopt ec_paramgen_curve:P-256 -sha256 -days 365 -nodes 
  -keyout example.local.key -out example.local.crt 
  -subj '/CN=example.local' 
  -addext 'subjectAltName=DNS:example.local,IP:127.0.0.1' 
  -addext 'basicConstraints=critical,CA:FALSE' 
  -addext 'keyUsage=critical,digitalSignature' 
  -addext 'extendedKeyUsage=serverAuth'

参数逐个说清:-x509 表示直接输出自签名证书而非 CSR;-newkey rsa:2048 在生成证书的同时生成私钥(2048 位是当前下限,低于此值 Chrome 会报 ERR_CERT_WEAK_KEY);-sha256 指定签名摘要,默认值在 1.1.1/3.0 已是 SHA-256,显式写出的好处是脚本可读;-days 365 设有效期,从生成时刻起算;-nodes 是 -noenc 的历史别名,OpenSSL 3.0 文档标注其为 deprecated,含义是私钥不做口令加密,适合 Nginx 无人值守启动。特别提醒:OpenSSL 3.0 的 req -x509 默认会写入 basicConstraints=critical,CA:TRUE(1.1.1 不写),这会让证书被当作 CA 使用,务必用上面的 CA:FALSE 显式覆盖。

算法 生成参数 keyUsage 应包含 典型错误
RSA 2048/3072 -newkey rsa:2048 digitalSignature,keyEncipherment 缺 keyEncipherment 时部分 TLS 1.2 套件握手失败
ECDSA P-256 -newkey ec -pkeyopt ec_paramgen_curve:P-256 仅 digitalSignature 多写 keyEncipherment,严格校验的客户端可能拒绝

生成后必须验证,别直接丢给 Web 服务器:

# 查看主体/签发者/有效期/SAN,四项一次看全
openssl x509 -in example.local.crt -noout -subject -issuer -dates -ext subjectAltName
# 期望输出(subject 与 issuer 完全相同即为自签名):
# subject=C = CN, ST = Beijing, L = Beijing, O = Example, OU = IT, CN = example.local
# issuer=C = CN, ST = Beijing, L = Beijing, O = Example, OU = IT, CN = example.local
# notBefore=Jun  1 00:00:00 2025 GMT
# notAfter=Jun  1 00:00:00 2026 GMT
# X509v3 Subject Alternative Name:
#     DNS:example.local, DNS:www.example.local, IP Address:127.0.0.1

私钥格式也值得确认一下。head -1 example.local.key 若输出 -----BEGIN PRIVATE KEY-----,说明是 PKCS#8;OpenSSL 3.0 的 genrsa/req -newkey 默认都输出 PKCS#8,1.1.1 的 req -newkey 同样如此。Nginx、Apache、HAProxy 都能直接读,但部分老旧设备或 Java 旧版本只认 PKCS#1:

# OpenSSL 3.0:用 -traditional 转成 PKCS#1(BEGIN RSA PRIVATE KEY)
openssl rsa -in example.local.key -traditional -out example.local.pkcs1.key
# OpenSSL 1.1.1:无 -traditional 选项,rsa 命令默认就输出 PKCS#1
openssl rsa -in example.local.key -out example.local.pkcs1.key

有效期怎么定?测试环境 30–90 天足够,逼自己走一遍轮换流程;内网服务 365 天比较平衡;设备固件可放宽到 825 天(对应 Apple 平台对 TLS 证书的历史上限),但要评估固件升级成本。注意区分:据 Let’s Encrypt 与 CA/Browser Forum 基线要求,公信 CA 签发的 TLS 证书有效期上限为 398 天,这条规则约束的是公共信任链,自签名证书用于内网不受其直接管辖;但据 Apple 支持文档,iOS/macOS 仍会按系统策略校验证书链与有效期,所以上线前用目标客户端实测一次,比看任何文档都可靠。

第三步:用 openssl.cnf 生成可复用的 CSR 与证书(适合多域名/自动化)

如果同一套证书要签十几张、还要塞进 CI 脚本,命令行里一长串 -addext 很快会失控——把扩展集中写进 openssl.cnf,CSR、自签证书、内部 CA 签发三条路径就能复用同一份配置。下面这份配置在 OpenSSL 1.1.1 与 3.x 上均可直接使用(default_bits 默认 2048、default_md 在 1.1.1 起默认 sha256、x509 -req 的 -days 默认仅 30 天,务必显式给出):

# openssl.cnf —— 一份配置同时服务 CSR、自签证书与 CA 签发
[ req ]
default_bits       = 2048          # 默认密钥长度
default_md         = sha256        # 1.0.2 默认 sha1,必须显式覆盖
prompt             = no            # 关闭交互,全部字段取自 [dn]
distinguished_name = dn
req_extensions     = v3_req        # 让 CSR 自带 SAN
x509_extensions    = v3_req        # 供 req -x509 直接出证书时使用

[ dn ]
C  = CN
ST = Zhejiang
L  = Hangzhou
O  = Example Internal
OU = IT Lab
CN = example.local                 # 仅作标识,现代浏览器只认 SAN

[ v3_req ]
basicConstraints = critical, CA:FALSE
keyUsage         = critical, digitalSignature, keyEncipherment
extendedKeyUsage = serverAuth, clientAuth
subjectAltName   = @alt_names

[ alt_names ]
DNS.1 = example.local
DNS.2 = www.example.local
DNS.3 = *.example.local
IP.1  = 127.0.0.1
IP.2  = ::1

生成私钥与 CSR,然后先验证再签名——这是整个流程里最容易漏掉的一步:

# 生成私钥(-nodes = 私钥不加密,便于服务免交互读取)
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.local.key -out example.local.csr -config openssl.cnf

# 检查 CSR 的 Requested Extensions 是否真的带上了 SAN
openssl req -in example.local.csr -noout -text | grep -A4 'Requested Extensions'

正常输出形如 X509v3 Subject Alternative Name: DNS:example.local, DNS:www.example.local, IP Address:127.0.0.1。若这里为空,后面签出来的证书一定没有 SAN,Chrome 会直接抛 NET::ERR_CERT_COMMON_NAME_INVALID——自 Chrome 58 起 CN 已被忽略,这也正是 RFC 5280 要求 SAN 承载主机名的原因。

# 自签证书:-extfile 与 -extensions 必须同时给,缺一个 SAN 就丢
openssl x509 -req -in example.local.csr -signkey example.local.key 
  -sha256 -days 365 -out example.local.crt 
  -extfile openssl.cnf -extensions v3_req

# 复核有效期与 SAN 是否落到证书里
openssl x509 -in example.local.crt -noout -dates -ext subjectAltName

需要给多台内网机器签发时,改为一次性建内部 CA(-addext 是 req 的选项,x509 -req 并不支持):

# 1) 自签根 CA,有效期 10 年,basicConstraints 必须 critical CA:TRUE
openssl req -x509 -newkey rsa:3072 -sha256 -days 3650 -nodes 
  -keyout ca.key -out ca.crt -subj '/CN=Example Internal CA' 
  -addext 'basicConstraints=critical,CA:TRUE' 
  -addext 'keyUsage=critical,keyCertSign,cRLSign'

# 2) 用 CA 签服务器证书(-CAcreateserial 生成 ca.srl,缺失会报错)
openssl x509 -req -in server.csr -CA ca.crt -CAkey ca.key -CAcreateserial 
  -days 365 -sha256 -extfile openssl.cnf -extensions v3_req -out server.crt

# 3) 验证链路:输出 server.crt: OK
openssl verify -CAfile ca.crt server.crt

把 CN/SAN 提成变量后即可批量签发;注意每张证书必须独立生成私钥,复用同一私钥会让单点泄露直接波及全部主机:

CN="api.example.local"
SAN="DNS:api.example.local,DNS:www.example.local,IP:127.0.0.1"
openssl req -new -newkey rsa:2048 -nodes -keyout "$CN.key" -out "$CN.csr" 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example Internal/OU=IT Lab/CN=$CN" 
  -addext "subjectAltName=$SAN"          # 覆盖 cnf 中的 [alt_names]
openssl x509 -req -in "$CN.csr" -signkey "$CN.key" -sha256 -days 365 
  -extfile openssl.cnf -extensions v3_req -out "$CN.crt"
OpenSSL 版本 req -addext x509 -req -extfile/-extensions 实操建议
1.0.2(已 EOL) 不支持 仅 -extfile + 配置文件内 [v3_req] 全部扩展只能写进 cnf,无法用 -subj 之外的快捷参数
1.1.1(LTS) 支持,仅限 req 支持 CSR 阶段可用 -addext,签发阶段仍走 -extfile
3.0 / 3.2+ 支持,可多次叠加 支持 x509 -req 推荐仍用 -extfile,便于审计与复现

排查时记住两个高频现象:openssl x509 -req 少了 -extensions 只会打印 Certificate request self-signature ok 却静默丢掉 SAN;用自签证书做 openssl verify 时出现 error 18 at 0 depth lookup: self signed certificate 属预期行为,需要 -CAfile 指向该证书本身或改用内部 CA 签发的链路。另外,内部自签证书不受 CA/Browser Forum 的 398 天公开证书期限约束,但仍建议把 -days 控制在 365~825 之间并纳入到期监控。

参数与方案选型:RSA、ECDSA、有效期和 SAN 怎么选?

选型其实只回答四个问题:密钥算法、摘要、有效期、SAN 怎么写。用 openssl 生成自签名证书 时这四项都在同一条 req 命令里,先看对比表再抄命令,能少走很多弯路。

方案 关键命令参数 PEM 体积(私钥 / 证书) TLS 兼容性 推荐场景
RSA 2048 -newkey rsa:2048 约 1.7 KB / 1.2 KB TLS 1.2、1.3,几乎所有旧设备 旧系统、内网打印机/IoT、兼容基线
ECDSA P-256 ecparam -name prime256v1 -genkey 约 0.2 KB / 0.7 KB OpenSSL 1.0.2+、现代浏览器 新部署、低功耗设备、追求握手性能
RSA 3072 / 4096 -newkey rsa:3072(或 4096) 约 3.2 KB / 1.7 KB 起 同 RSA 2048 合规要求(如等保、FIPS 场景)
RSA + ECDSA 双证书 Nginx 1.11.0+ 配置多条 ssl_certificate 两份证书共存 由服务端按客户端能力协商 公网高流量,兼顾兼容与性能

最常用的两条命令如下(-addext 需要 OpenSSL 1.1.1+;1.0.2 及更早版本没有该选项,只能用 -config 配合 [v3_req] 段):

# 方案 A:RSA 2048,一步生成私钥+自签名证书
# -nodes(OpenSSL 3.0 起等价写法为 -noenc)表示私钥不加密
# -days 默认仅 30 天,务必显式指定;-sha256 显式声明摘要
openssl req -x509 -newkey rsa:2048 -nodes 
  -keyout rsa2048.key -out rsa2048.crt 
  -days 365 -sha256 
  -subj "/C=CN/O=Lab/CN=example.local" 
  -addext "subjectAltName=DNS:example.local,DNS:*.example.local,IP:192.168.1.10"

# 方案 B:ECDSA P-256,先出密钥再签证书
openssl ecparam -name prime256v1 -genkey -noout -out ecdsa.key
openssl req -x509 -new -key ecdsa.key -out ecdsa.crt 
  -days 365 -sha256 -subj "/CN=example.local" 
  -addext "subjectAltName=DNS:example.local,DNS:*.example.local"

# 核对结果:签名算法、密钥长度、到期时间、SAN
openssl x509 -in rsa2048.crt -noout -text | grep -E "Signature Algorithm|Public-Key|Not After|DNS:"

摘要算法:OpenSSL 1.1.0 起 req 默认摘要已是 SHA-256,但 1.0.2 时代默认 SHA-1,所以显式写 -sha256 最稳。不要用 -sha1:OpenSSL 3.0 默认安全级别提高后,用 SHA-1 签名会直接失败,报错形如 ca md too weak(见 OpenSSL 3.0 config 文档中 CipherString/SECLEVEL 说明)。SHA-256 输出 256 位;需要更高安全等级时用 -sha384,证书体积只增加几十字节,代价可以忽略。

有效期:-days 的默认值是 30 天,测试环境 30–90 天足够;内网服务 365 天较常见;设备侧若受 Apple 平台 825 天上限约束(Apple 支持文档对 TLS 服务器证书的要求),自签也要评估后再定。注意公网 CA 受 CA/Browser Forum 基线要求约束,上限 398 天(Let’s Encrypt 自 2020-09 起执行),自签名证书虽不受此限,但把内部证书也压到 398 天以内,能让轮换流程提前跑通。续期没有 -renew 概念,用完全相同的 SAN 重新签发、替换文件,旧文件保留 7 天用于回滚。

SAN 写法:单张证书建议不超过 100 个 SAN,实践中 5–20 个最易维护。通配符 *.example.local 只覆盖一级子域,不覆盖 example.local 本身,因此要同时写 DNS:example.local,DNS:*.example.local。现代浏览器和 Go、Java 客户端都只看 SAN,CN 已不作为校验依据,别指望 -subj "/CN=..." 顶替。

私钥加密:生产环境可用 -aes256 加密私钥,但 Nginx/Apache 启动时需要密码文件或交互输入,容器化场景不友好;自动化场景常用 -nodes 配合 chmod 600,用文件权限换可运维性。CA 私钥必须离线保存。另外 openssl genpkey -algorithm ED25519 也能出密钥,体积小、签名快,但旧客户端兼容性必须实测,不要默认用于全站。

常见错误与排查:这些报错分别怎么修?

本地起 HTTPS 之后报错五花八门,但绝大多数可以归到四类:信任链问题、身份字段问题、文件格式问题、时间与算法问题。先用一条命令定位,别急着改配置。

典型报错 根因 一条诊断命令
curl: (60) SSL certificate problem: self-signed certificate 客户端信任库没有这张证书 curl --cacert example.local.crt https://example.local/
x509: certificate relies on legacy Common Name field 证书缺 SAN 扩展 openssl x509 -in example.local.crt -noout -text
X509_check_private_key:key values mismatch 证书与私钥不成对 openssl x509 -noout -modulus -in example.local.crt | openssl md5
PEM routines:get_name:no start line 文件不是 PEM 或路径写错 head -1 example.local.crt
verify error:num=18:self-signed certificate 自签名的预期输出,不是故障 openssl verify -CAfile example.local.crt example.local.crt

Q:浏览器报 NET::ERR_CERT_AUTHORITY_INVALID,curl 报 (60),是不是证书生成错了?

不是。这是自签名的定义性结果:没有第三方 CA 为它背书。据 Let’s Encrypt 文档,公共信任库只接受由受信根证书签发的证书,自签证书必须由你手动加入信任库。正确做法是让客户端把这张证书当作 CA 来验证,而不是关掉校验:

# 1) 用证书本身作为信任锚验证(推荐用于测试)
curl --cacert example.local.crt https://example.local/ -v

# 2) Linux 导入系统信任库(Debian / Ubuntu)
sudo cp example.local.crt /usr/local/share/ca-certificates/example.local.crt
sudo update-ca-certificates

# 3) RHEL / CentOS / Fedora
sudo cp example.local.crt /etc/pki/ca-trust/source/anchors/
sudo update-ca-trust

# 4) 验证是否生效,不再需要 --cacert
curl -I https://example.local/

-k / --insecure 只是让 curl 跳过验证,它不会让浏览器信任,更不能带进生产环境——一旦上线,你就失去了对中间人攻击的检测能力。

Q:Go / Chrome 报 “certificate relies on legacy Common Name field, use SANs instead”,怎么办?

Chrome 58 起不再回退到 CN(Common Name)匹配主机名,Go 1.15 起同样强制要求 SAN(RFC 6125 与 CA/Browser Forum 基线要求)。先确认扩展是否存在:

openssl x509 -in example.local.crt -noout -text | grep -A1 "Subject Alternative Name"
# 期望输出:X509v3 Subject Alternative Name:
#             DNS:example.local, IP Address:127.0.0.1

如果没有输出,就用 -addext 重新签发(该参数要求 OpenSSL 1.1.1 及以上,OpenSSL 3.x 同样适用):

openssl req -x509 -newkey rsa:2048 -nodes 
  -keyout example.local.key -out example.local.crt 
  -days 397 -sha256 
  -subj "/CN=example.local" 
  -addext "subjectAltName=DNS:example.local,DNS:*.example.local,IP:127.0.0.1"

注意 openssl req -x509 的 -days 默认值只有 30 天,不显式指定很快会过期;Apple 从 2020-09-01 起要求 TLS 服务端证书有效期不超过 398 天,本地调试建议直接写 397。

Q:Nginx 起不来,报 SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch

证书和私钥不是同一对密钥。用模数(RSA)或公钥指纹(ECDSA/Ed25519)对比,两行输出必须完全一致:

# RSA
openssl x509 -noout -modulus -in example.local.crt | openssl md5
openssl rsa  -noout -modulus -in example.local.key | openssl md5

# ECDSA / Ed25519:比较 DER 编码公钥的 SHA-256
openssl pkey -in example.local.key -pubout -outform der | openssl sha256
openssl x509 -in example.local.crt -pubkey -noout | openssl pkey -pubin -outform der | openssl sha256

Q:unable to load certificate / get_name:no start line 是什么原因?

十有八九是文件不是 PEM,或者把 DER 当成了 PEM,也可能是 ssl_certificate 路径指向了别的文件。PEM 是 Base64 文本,首行必须是 -----BEGIN CERTIFICATE-----:

file example.local.crt          # 期望:ASCII text,而不是 data
head -1 example.local.crt       # 期望:-----BEGIN CERTIFICATE-----

# DER 转 PEM
openssl x509 -inform DER -in cert.der -out cert.pem
# 顺便校验证书结构是否完整
openssl x509 -in cert.pem -noout -subject -issuer -dates

Q:openssl verify 报 num=18:self-signed certificate,算失败吗?

这是预期结果,说明验证链止于自签名根。把它自己当 CA 验证就应返回 OK:

openssl verify -CAfile example.local.crt example.local.crt
# 期望:example.local.crt: OK

# 真正模拟客户端握手,-servername 触发 SNI
openssl s_client -connect 127.0.0.1:443 -servername example.local 
  -CAfile example.local.crt </dev/null

Q:certificate has expired / ca md too weak 怎么处理?

前者先对时区,后者是摘要算法过弱(SHA-1 已被主流客户端拒绝):

date -u
openssl x509 -noout -dates -subject -in example.local.crt
# 过期就用 -days 重签,并显式指定 -sha256
openssl req -x509 -newkey rsa:2048 -nodes -sha256 -days 397 
  -keyout example.local.key -out example.local.crt 
  -subj "/CN=example.local" -addext "subjectAltName=DNS:example.local"

若必须兼容极老的客户端,OpenSSL 3.0 可在密码套件后加 @SECLEVEL=1 临时降低安全级别,但这会削弱整体强度,仅限离线环境短时使用。用 openssl 生成自签名证书 时养成默认带 -sha256 -addext 的习惯,上面这些报错基本不会出现。

如何验证自签名证书已生效?openssl verify、s_client 与 curl 三种方法

证书签发完不等于生效,中间任何一环(SAN 漏写、链不完整、服务端没加载新文件)都会让浏览器继续报警。下面按“本地解析 → 链验证 → 服务端握手 → HTTP 层 → 到期监控”的顺序,用 openssl verify、s_client 和 curl 三条路径交叉确认。以下命令基于 OpenSSL 1.1.1 及以上(-ext 选项在 1.1.1 引入),OpenSSL 3.x 行为一致。

第一步:本地解析,先确认它确实是自签名证书。

# subject 与 issuer 完全一致 = 自签名;指纹用于比对服务器上部署的是不是同一个文件
openssl x509 -in example.local.crt -noout 
  -subject -issuer -dates -fingerprint -sha256 -ext subjectAltName

# 典型输出(关键行)
# subject=CN = example.local
# issuer=CN = example.local
# notBefore=Mar  1 00:00:00 2025 GMT
# notAfter=Mar  1 00:00:00 2026 GMT
# SHA256 Fingerprint=3A:1F:...
# X509v3 Subject Alternative Name:
#     DNS:example.local, DNS:*.example.local, IP Address:127.0.0.1

据 RFC 5280,现代客户端只认 subjectAltName 里的 DNS/IP,CN 已不再参与主机名匹配(RFC 6125 明确了这一点)。所以这里若只看到 CN 而没有 SAN 扩展,Chrome 会直接报 NET::ERR_CERT_COMMON_NAME_INVALID。

第二步:链验证。自签名证书自己就是根,所以 -CAfile 和待验证文件是同一个:

openssl verify -CAfile example.local.crt example.local.crt
# example.local.crt: OK

# 若是多级内部 CA(根 + 中间),把中间证书放进 -untrusted
openssl verify -CAfile ca-chain.pem -untrusted intermediate.pem server.crt
# server.crt: OK

返回 error 18 at 0 depth lookup: self-signed certificate 说明你把叶子证书当成了 CA;error 20: unable to get local issuer certificate 则通常是中间证书缺失。

第三步:真实握手。verify 只验证文件,s_client 验证“服务端实际吐出来的链”:

# -servername 触发 SNI,-showcerts 打印完整链,</dev/null 让命令立即退出而非等待输入
openssl s_client -connect 127.0.0.1:443 -servername example.local 
  -CAfile example.local.crt -showcerts </dev/null

# 关注三行
# Verify return code: 0 (ok)
# Protocol  : TLSv1.3
# Cipher    : TLS_AES_256_GCM_SHA384

若显示 Verify return code: 19 (self-signed certificate in certificate chain),就是漏了 -CAfile;据 OpenSSL s_client(1) 手册,-CAfile 用于指定受信 CA 集合,不加则按系统默认信任库校验。

第四步:HTTP 层闭环。

curl --cacert example.local.crt -I https://example.local/
# HTTP/2 200

curl -I https://example.local/          # 故意不加 --cacert
# curl: (60) SSL certificate problem: self-signed certificate

“加了成功、不加报 60”才说明链按预期工作;如果加了 --cacert 仍失败,多半是域名解析到了别的机器。

第五步:到期监控。-checkend 参数单位是秒,返回码 0 表示在指定时间内不会过期,非 0 表示会过期:

# 2592000 = 30 天;每天跑一次,返回 1 就告警
openssl x509 -checkend 2592000 -noout -in example.local.crt; echo $?
# 0
方法 验证层级 成功标志 能发现 发现不了
openssl verify 文件级链 : OK 缺中间证书、自签根未受信 服务端是否加载了新证书
s_client TLS 握手 Verify return code: 0 (ok) SNI 不匹配、协议/套件协商失败 HTTP 层重定向与路径问题
curl --cacert 应用层端到端 HTTP/2 200 DNS 指向错误、反向代理未透传 浏览器特有的信任库差异

浏览器侧最后确认:Chrome 打开 DevTools → Security 面板,可直接读到 Subject、Issuer、Valid from/to 与 SAN 列表;把 example.local.crt 手动导入系统/浏览器信任库后,地址栏应变为正常的锁标识。Firefox 使用独立的 NSS 信任库,必须在 about:preferences#privacy → 证书管理器 → “证书颁发机构”里单独导入,否则即使系统信任了,Firefox 仍会报 SEC_ERROR_UNKNOWN_ISSUER。

生产落地:Nginx/Apache 配置、信任导入与轮换建议

证书生成好了,Nginx 怎么配才不踩坑?自签名证书只有一张叶子证书、没有中间链,ssl_certificate 直接指向 .crt 即可,千万不要再 cat 拼接别的文件。另需注意 nginx 1.25.1 起 listen ... http2 已被废弃,会打印告警 the "listen ... http2" directive is deprecated, use the "http2" directive instead。

# /etc/nginx/conf.d/example.local.conf  (nginx ≥ 1.25.1)
server {
    listen 443 ssl;                       # 旧版本(<1.25.1)写成 listen 443 ssl http2;
    http2 on;                             # 1.25.1+ 独立指令
    server_name example.local;
    ssl_certificate     /etc/ssl/selfsign/example.local.crt;
    ssl_certificate_key /etc/ssl/selfsign/example.local.key;   # 权限 600、属主 root
    ssl_protocols       TLSv1.2 TLSv1.3;  # TLSv1/1.1 已被 RFC 8996 正式废弃
    ssl_prefer_server_ciphers off;        # nginx 默认即 off,TLS1.3 由客户端选套件
    ssl_session_cache   shared:SSL:10m;
    add_header Strict-Transport-Security "max-age=31536000" always;
}
nginx -t && systemctl reload nginx
# 成功输出:
# nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
# nginx: configuration file /etc/nginx/nginx.conf test is successful

如果误把私钥路径填进 ssl_certificate,nginx -t 会直接失败:cannot load certificate ... PEM_read_bio_X509_AUX() failed (SSL: error:...:PEM lib:no start line)——这类报错八成是文件内容或权限问题,而不是证书本身过期。

Apache 2.4 怎么配?协议排除语法需 Apache ≥ 2.4.7;apachectl configtest 返回 Syntax OK 才算通过,Mozilla SSL Configuration Generator 生成的片段可直接套用。

<VirtualHost *:443>
    ServerName example.local
    SSLEngine on
    SSLCertificateFile    /etc/ssl/selfsign/example.local.crt
    SSLCertificateKeyFile /etc/ssl/selfsign/example.local.key
    SSLProtocol           all -SSLv3 -TLSv1 -TLSv1.1
</VirtualHost>

apachectl configtest && systemctl reload httpd   # Debian/Ubuntu 用 apache2

怎么让系统信任这张自签名证书?各平台信任库互相独立,需分别导入;注意 Firefox 使用自带的 NSS 库,不走系统库(可在 about:config 打开 security.enterprise_roots.enabled 读取系统根)。

# Debian/Ubuntu:后缀必须是 .crt,否则 update-ca-certificates 忽略
sudo cp example.local.crt /usr/local/share/ca-certificates/example.local.crt
sudo update-ca-certificates          # 输出 "1 added",写入 /etc/ssl/certs/ca-certificates.crt

# RHEL 8+ / CentOS Stream(p11-kit 提供)
sudo trust anchor example.local.crt

# Windows(管理员权限)
certutil -addstore -f Root example.local.crt

# macOS(系统钥匙串,需 sudo 并在弹窗输入密码)
sudo security add-trusted-cert -d -r trustRoot 
  -k /Library/Keychains/System.keychain example.local.crt

到期前怎么自动发现并轮换?openssl x509 -checkend 2592000(2592000 秒 = 30 天)在证书仍安全时返回 0,即将过期返回非 0,可直接用于监控与自动化。重新签发时务必带上与原证书完全一致的 SAN,否则浏览器会报 NET::ERR_CERT_COMMON_NAME_INVALID。

#!/usr/bin/env bash
set -euo pipefail
CERT=/etc/ssl/selfsign/example.local.crt
KEY=/etc/ssl/selfsign/example.local.key
if ! openssl x509 -checkend 2592000 -noout -in "$CERT"; then
  cp "$CERT" "$CERT.bak.$(date +%F)"     # 旧文件保留 7 天用于回滚
  openssl req -x509 -newkey rsa:3072 -nodes -sha256 -days 365 
    -keyout "$KEY.new" -out "$CERT.new" 
    -subj "/CN=example.local" 
    -addext "subjectAltName=DNS:example.local,DNS:*.example.local,IP:10.0.0.10"  # OpenSSL ≥1.1.1
  mv "$CERT.new" "$CERT"; mv "$KEY.new" "$KEY"; chmod 600 "$KEY"
  nginx -t && systemctl reload nginx
fi

安全边界在哪?自签名根私钥一旦泄露,等于整条信任链失守——攻击者可为你内网任意域名签发被信任的证书。因此 CA 私钥建议 3072 位 RSA 或 P-384 ECDSA,离线保存、权限 chmod 600,且不要在多台设备上复用同一私钥;生产内网可考虑 openssl ca 或 step-ca 拆分根/中间证书。

方案 有效期 成本 续期方式 适用场景
自签名 自定义(建议 ≤365 天) 0 元 手动/脚本 + reload 内网、测试、IoT、mTLS 实验
Let’s Encrypt 90 天 0 元 ACME(RFC 8555)自动续期 公网 Web 服务
商业 OV/EV 398 天以内(CA/B Forum 上限) 约 200–3000 元/年 人工或 API 对外电商、需组织验证

据 Let’s Encrypt 文档,其证书固定 90 天有效期正是为了推动自动化续期;据 RFC 5280,自签名证书的 basicConstraints 若不设 CA:TRUE,导入信任库后仍无法签发下级证书——这也是用 openssl 生成自签名证书 做私有 CA 时最常被忽略的一步。

因为自签名证书不在浏览器或操作系统的信任库中,TLS 加密能建立,但身份链验证失败,Chrome 报 NET::ERR_CERT_AUTHORITY_INVALID。测试时可用 curl –cacert cert.crt 或手动导入信任库;对外站点应改用 Let's Encrypt 或商业 CA。

OpenSSL 手工可控,适合内网、设备和自动化脚本,但需自己分发信任;mkcert 会生成本地根并自动导入开发机信任库,适合本地开发;Let's Encrypt 是公信 CA,90 天免费并支持 ACME 自动续期,适合公网站点。

这是 Chrome 58+ 或 Go 1.15+ 要求 SAN 的提示。用 openssl x509 -in cert.crt -noout -text 检查是否有 X509v3 Subject Alternative Name,没有就加 -addext 'subjectAltName=DNS:example.local,IP:127.0.0.1' 或配置文件 [alt_names] 重新签发。

测试环境建议 30-90 天,内网服务可用 365 天,设备固件可到 825 天但需评估轮换;公网 CA 证书受 398 天上限约束。用 -days 参数设置,并配合 openssl x509 -checkend 2592000 做 30 天到期监控。

Debian/Ubuntu 放到 /usr/local/share/ca-certificates/ 后执行 update-ca-certificates;RHEL 用 trust anchor cert.crt;Windows 用 certutil -addstore -f Root cert.crt;macOS 用 sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain cert.crt。导入前确认证书来源可信。

说明 ssl_certificate 指向的证书与 ssl_certificate_key 指向的私钥不匹配。用 openssl x509 -noout -modulus -in cert.crt | openssl md5 与 openssl rsa -noout -modulus -in key.pem | openssl md5 比对;ECDSA 则比较 openssl pkey -pubout -outform der | openssl sha256 的输出。

技术上可以配置,但所有未导入信任库的访客都会看到证书警告,不适合面向公众的官网或电商。公网建议用 Let's Encrypt 的 90 天免费证书并自动续期,或购买 200-3000 元/年的商业 OV 证书。


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

内容审核

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