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 基线要求)。先确认扩展是否存在:
- Wildcard 通配符 SSL 证书安装部署续费申请
- SSL/HTTPS 证书配置 · 证书安装 · 证书申请
- 代购 SSL 证书 · DigiCert / GeoTrust / RapidSSL 单域名与通配符
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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。