内部系统 SSL 证书怎么签发部署?私有 CA 实操、Nginx 配置与报错排查
内部系统 SSL 证书最稳妥的做法是自建私有 CA(OpenSSL 3.x 或 step-ca),把根证书通过 GPO、MDM 或镜像预装到所有客户端,叶子证书有效期控制在 397 天以内并自动化轮换。 签发叶子证书时必须写 subjectAltName,DNS 和 IP 都要列全,例如 subjectAltName=DNS:app.internal.example.com,IP:10.20.30.40,否则浏览器报 no alternative certificate subject name matches target host name。 公网 CA 只能签发你拥有且可公网解析的域名子域,例如 internal.example.com 可用 Let's Encrypt DNS-01 免费签发;.local、.internal、.corp 这类内部 TLD 拿不到公网证书。 验证链路是否完整用 openssl s_client -connect app.internal.example.com:443 -CAfile rootCA.crt -verify_return_error,输出 Verify return code: 0 (ok) 才算通过。 Java 不读操作系统信任库,必须单独执行 keytool -importcert -cacerts -alias internal-root -file rootCA.crt,否则报 PKIX path building failed。
内部系统 SSL 证书为什么老是报「不受信任」?根本原因拆解
内部系统 SSL 证书反复报「不受信任」,九成不是证书「签错了」,而是客户端根本没把你自建的根 CA 当成可信锚点。据 Chrome Root Program 与 Mozilla Root Store 的收录数据,主流浏览器/操作系统预装的公共根 CA 约 150 个,你的私有 CA 不在其中,所以链验证必然停在 NET::ERR_CERT_AUTHORITY_INVALID。先按下面这张表定位,别急着重签:
| 根因 | 典型报错 | 一条命令定位 |
|---|---|---|
| 客户端不信任私有根 | Chrome NET::ERR_CERT_AUTHORITY_INVALID;curl unable to get local issuer certificate |
openssl verify -CAfile root.crt server.crt |
| 证书链不完整 | unable to verify the first certificate(OpenSSL 1.1.1+、Safari 尤其严格) |
openssl s_client -connect host:443 -showcerts |
| SAN 缺失 | no alternative certificate subject name matches target host name |
openssl x509 -in server.crt -noout -ext subjectAltName |
| 有效期/时钟偏差 | certificate is not yet valid / has expired |
openssl x509 -in server.crt -noout -dates |
| 内部域名无法签发 | CA 直接拒绝签发 | 见下文域名规则 |
| 信任库各自为政 | 浏览器正常、Java/Node/Python 报错 | 逐库检查(见命令) |
为什么 Nginx 只配叶子证书会挂?因为 ssl_certificate 要求「叶子 + 中间证书」按顺序拼在一个文件里(即 fullchain),服务器只发叶子时,客户端拿不到中间证书就无法补全到根。据 OpenSSL 文档,verify 默认不下载缺失的中间证书,所以会直接失败:
# /etc/nginx/conf.d/intranet.conf —— Nginx 1.19+ 写法
ssl_certificate /etc/nginx/ssl/fullchain.pem; # 顺序:服务器证书在前,中间证书在后
ssl_certificate_key /etc/nginx/ssl/server.key;
ssl_trusted_certificate /etc/nginx/ssl/chain.pem; # 仅用于 OCSP stapling 校验,不发给你客户端
ssl_protocols TLSv1.2 TLSv1.3;
# 拼链(自建 CA 签发场景:叶子 + 中间)
cat server.crt intermediate.crt > fullchain.pem
# 自检:必须输出 fullchain.pem: OK
openssl verify -CAfile root.crt -untrusted intermediate.crt server.crt
SAN 为什么比 CN 更关键?Chrome 58 起完全忽略 CN,只读 subjectAltName(RFC 5280 §4.2.1.6 早已将其定义为扩展必选)。用 IP 访问时必须显式写 IP:10.20.30.40,只写 DNS 名一样会报 SAN 不匹配。签发时用 OpenSSL 3.x 的 -addext 最省事:
openssl req -new -key server.key -out server.csr
-subj "/CN=intranet.corp.example.com"
-addext "subjectAltName=DNS:intranet.corp.example.com,IP:10.20.30.40" # OpenSSL 1.1.1+
有效期和域名规则踩了什么坑?CA/B Forum Baseline Requirements 规定公共 TLS 证书上限 398 天,并已确定 2026-03-15 起缩短至 200 天;私有 CA 虽不受该条款约束,但把内部系统 SSL 证书签成 10 年会让吊销彻底失效,实践建议 90–365 天并做自动化续签。客户端与服务器时间偏差超过 5 分钟即可能触发 not yet valid,用 date -u 对比 openssl x509 -noout -dates。域名侧:.local 属 RFC 6762 mDNS 保留,.internal 于 2024 年被 ICANN 保留为私有用途,.corp、.home 同样无法通过公网验证——只能走私有 CA,或在自有公网域名下用 DNS-01 验证签发。
装了一处就够了吗?不够。系统、Java、Python、Node、容器镜像各有独立信任库,逐条注入:
# Debian/Ubuntu(ca-certificates 包)
cp internal-root.crt /usr/local/share/ca-certificates/ && update-ca-certificates
# RHEL/CentOS/Rocky
cp internal-root.crt /etc/pki/ca-trust/source/anchors/ && update-ca-trust extract
# Java(默认口令 changeit)
keytool -importcert -noprompt -alias internal-root -file internal-root.crt
-keystore "$JAVA_HOME/lib/security/cacerts" -storepass changeit
# Node.js 16+ / Python requests
export NODE_EXTRA_CA_CERTS=/etc/ssl/certs/internal-root.crt
export REQUESTS_CA_BUNDLE=/etc/ssl/certs/internal-root.crt # 或 curl --cacert 同路径
排查顺序建议固定为:openssl s_client -connect host:443 -servername host -showcerts 看服务器发了几张证书 → openssl verify 验证链 → 检查 SAN 与时间 → 最后才怀疑信任库。绝大多数「不受信任」在第 1、2 步就能复现,与证书本身是否「签错」无关。
内部系统 SSL 证书怎么签发?从根 CA 到叶子证书的 6 个步骤
内部系统如果直接向公共 CA 申请证书,就需要把 app.internal.example.com 这类域名暴露在 Certificate Transparency 日志里;反过来,如果使用自签单证书,则每台客户端都要单独信任它,一旦证书轮换就会全部失败。可行做法是自建一套两层私有 CA:用根 CA 离线保存,用中间 CA 日常签发,并把根证书分发到各终端。据 RFC 5280 第 4.2.1.9 节,pathlen 用来限制中间 CA 之下还能嵌套几层 CA;下面 6 步都围绕这条信任链展开。
步骤 1:先定命名空间,再动手生成密钥。应使用自有公网域名的子域,例如 internal.example.com,不要使用 .local、.lan 等未注册后缀。根据 RFC 6761 与 ICANN 2024 年保留 .internal 的建议,这类名字在部分解析器和客户端中行为不一致。SAN 清单要同时列出 DNS 名与 IP,并且通配符只覆盖一层:*.svc.internal.example.com 匹配 a.svc.internal.example.com,但不匹配 a.b.svc.internal.example.com(RFC 6125 第 6.4.3 节)。
# SAN 规划示例(写入叶子证书扩展,见步骤 4)
subjectAltName = DNS:app.internal.example.com,
DNS:*.svc.internal.example.com,
IP:10.20.30.40
步骤 2:生成根 CA(离线,OpenSSL 3.0.13)。根 CA 推荐使用 ECDSA P-384 或 RSA 4096,有效期 3650 天,私钥保存在不联网的机器或离线介质上。
# 生成 P-384 根私钥;-addext 需 OpenSSL 1.1.1+,3.0.x 默认支持
openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-384 -out root.key
# 自签根证书:pathlen:1 表示其下最多再挂 1 层中间 CA
openssl req -x509 -new -key root.key -sha384 -days 3650
-subj "/CN=Example Internal Root CA R1/O=Example/OU=PKI"
-addext "basicConstraints=critical,CA:TRUE,pathlen:1"
-addext "keyUsage=critical,keyCertSign,cRLSign"
-out root.crt
chmod 400 root.key # 私钥权限收紧
步骤 3:生成中间 CA。有效期 1825 天,pathlen:0 表示它不能再签发下级 CA,只能签发终端证书。日常签发只使用中间 CA 的密钥,根 CA 全程不接入网络。
openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-384 -out inter.key
openssl req -new -key inter.key -subj "/CN=Example Internal Issuing CA R1/O=Example" -out inter.csr
cat > inter.ext <<'EOF'
basicConstraints=critical,CA:TRUE,pathlen:0
keyUsage=critical,keyCertSign,cRLSign
subjectKeyIdentifier=hash
authorityKeyIdentifier=keyid:always
EOF
# 用根 CA 签发中间 CA
openssl x509 -req -in inter.csr -CA root.crt -CAkey root.key -CAcreateserial
-days 1825 -sha384 -extfile inter.ext -out inter.crt
步骤 4:生成叶子证书的 CSR 与扩展文件。叶子证书密钥用 RSA 2048 或 ECDSA P-256,有效期 397 天(与 CA/Browser Forum 基线要求的上限一致,便于将来切换到公共 CA),并且 serverAuth 与 SAN 必填;只写 CN 的证书会被 Chrome 直接判为 NET::ERR_CERT_COMMON_NAME_INVALID。
openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 -out app.key
openssl req -new -key app.key -subj "/CN=app.internal.example.com" -out app.csr
cat > app.ext <<'EOF'
basicConstraints=critical,CA:FALSE
keyUsage=critical,digitalSignature
extendedKeyUsage=serverAuth
subjectAltName=DNS:app.internal.example.com,DNS:*.svc.internal.example.com,IP:10.20.30.40
EOF
openssl x509 -req -in app.csr -CA inter.crt -CAkey inter.key -CAcreateserial
-days 397 -sha256 -extfile app.ext -out app.crt
| 对比项 | RSA 4096 | ECDSA P-384 / P-256 |
|---|---|---|
| 公钥 / 签名长度 | 约 550 B / 512 B | 约 97 B / 96 B(P-384)、64 B(P-256) |
| 握手 CPU 开销 | 较高,验签约慢 5–10 倍 | 低,移动端与高并发网关更省电 |
| 兼容性 | 几乎所有客户端,包括老设备 | 需客户端支持 TLS 1.2+ 与 ECDSA 套件 |
| 建议用途 | 需要兼容老旧终端的内部系统 | 根/中间 CA 与新建内部服务 |
步骤 5:签发并拼接 fullchain。顺序必须为叶子证书在前、中间证书在后;根证书不要放进服务端链,否则会增大握手包并触发部分客户端的链长度告警。
cat app.crt inter.crt > fullchain.crt # 叶子在前,中间在后
openssl verify -CAfile root.crt -untrusted inter.crt app.crt
# 期望输出:app.crt: OK
步骤 6:分发根证书并部署。把 root.crt 推到各平台的信任库,这一步不做,客户端就会报 curl: (60) SSL certificate problem: unable to get local issuer certificate。
# Ubuntu / Debian(文件名必须以 .crt 结尾)
sudo cp root.crt /usr/local/share/ca-certificates/example-internal-root.crt
sudo update-ca-certificates
# RHEL / CentOS / Rocky
sudo cp root.crt /etc/pki/ca-trust/source/anchors/example-internal-root.crt
sudo update-ca-trust extract
# Java 应用(JDK 9+ 用 -cacerts;JDK 8 用 -keystore $JAVA_HOME/jre/lib/security/cacerts)
keytool -importcert -noprompt -alias example-internal-root
-file root.crt -cacerts -storepass changeit
# Windows:GPO → 计算机配置 → 策略 → Windows 设置 → 安全设置
# → 公钥策略 → 受信任的根证书颁发机构 → 导入
# /etc/nginx/conf.d/app.conf(Nginx 1.18+ / 1.24 均适用)
server {
listen 443 ssl;
server_name app.internal.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.crt; # 叶子+中间,顺序不可颠倒
ssl_certificate_key /etc/nginx/ssl/app.key;
ssl_protocols TLSv1.2 TLSv1.3; # 参考 Mozilla SSL Configuration Generator 中间配置
ssl_session_cache shared:SSL:10m; # 默认 off,内部高并发建议开启
}
# 校验并热加载:nginx -t 失败时不会影响正在运行的进程
sudo nginx -t && sudo systemctl reload nginx
若 nginx -t 报 SSL_CTX_use_certificate_chain_file() failed (SSL: error:0A00018E:SSL routines::ca md too weak),说明链中混入了使用 SHA-1 签名的旧中间证书,需要用 openssl crl2pkcs7 -nocrl -certfile fullchain.crt | openssl pkcs7 -print_certs -noout 逐张检查签发算法后重新拼接。后续小节会分别展开 CRL/OCSP 吊销配置、证书轮换自动化与 mTLS 双向认证。
具体配置怎么写?OpenSSL 3.0、Nginx 1.24 与 Java 17 命令示例
根 CA、中间 CA 和叶子证书的完整命令怎么写?
OpenSSL 3.0 的 req 子命令支持 -addext(1.1.1 起引入),可以把扩展直接写进自签证书,避免事后再用 openssl x509 -extfile 补签。据 OpenSSL 3.0 openssl-req(1) 手册,-addext 仅在生成自签名证书(-x509)时生效:
# 1) 生成根 CA(10 年,pathlen:1 表示其下还能挂一级中间 CA)
openssl req -x509 -new -nodes -newkey rsa:4096 -sha256 -days 3650
-keyout rootCA.key -out rootCA.crt
-subj '/C=CN/O=Example/CN=Example Internal Root CA'
-addext 'basicConstraints=critical,CA:TRUE,pathlen:1'
-addext 'keyUsage=critical,keyCertSign,cRLSign'
-addext 'subjectKeyIdentifier=hash'
# 2) 生成中间签发 CA 的 CSR,再用根 CA 签(5 年,pathlen:0 表示不能再签 CA)
openssl req -new -newkey rsa:4096 -nodes -keyout intermediate.key
-out intermediate.csr -subj '/C=CN/O=Example/CN=Example Internal Issuing CA'
printf 'basicConstraints=critical,CA:TRUE,pathlen:0nkeyUsage=critical,keyCertSign,cRLSignnsubjectKeyIdentifier=hashnauthorityKeyIdentifier=keyid,issuern' > ca.ext
openssl x509 -req -in intermediate.csr -CA rootCA.crt -CAkey rootCA.key
-CAcreateserial -out intermediate.crt -days 1825 -sha256 -extfile ca.ext
# 3) 叶子证书:先出 CSR 与私钥,再用中间 CA 签
openssl req -new -newkey rsa:2048 -nodes -keyout app.key -out app.csr
-subj '/C=CN/O=Example/CN=app.internal.example.com'
openssl x509 -req -in app.csr -CA intermediate.crt -CAkey intermediate.key
-CAcreateserial -out app.crt -days 397 -sha256 -extfile leaf.ext
leaf.ext 内容(缺 basicConstraints 时部分客户端会把叶子当 CA 或直接拒绝,subjectAltName 缺 IP 项则浏览器与 curl 都会报主机名不匹配):
basicConstraints=critical,CA:FALSE
keyUsage=critical,digitalSignature,keyEncipherment
extendedKeyUsage=serverAuth
subjectAltName=DNS:app.internal.example.com,DNS:*.svc.internal.example.com,IP:10.20.30.40
authorityKeyIdentifier=keyid,issuer
subjectKeyIdentifier=hash
注意 openssl x509 -req 不会从 CSR 继承扩展,必须显式 -extfile,这是私有 CA 签发最常见的踩坑点。397 天来自 CA/Browser Forum 对公有证书的上限,内部 CA 不受约束,但沿用可让客户端兼容性保持一致。
Nginx 1.24 的 ssl 段怎么写?为什么 stapling 必须关?
server {
listen 443 ssl;
server_name app.internal.example.com;
ssl_certificate /etc/nginx/ssl/fullchain.crt; # 叶子 + 中间 CA 拼接,顺序不能反
ssl_certificate_key /etc/nginx/ssl/app.key;
ssl_protocols TLSv1.2 TLSv1.3;
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,1.11.0 起
ssl_session_cache shared:SSL:10m; # 默认 none,不开启则每次全握手
ssl_session_timeout 1d; # 默认 5m
ssl_stapling off; # 默认 off,私有 CA 无公网 OCSP 必须保持关闭
# add_header Strict-Transport-Security "max-age=31536000" always; # 仅在全部子域均已 HTTPS 时启用
}
据 Nginx 官方 ngx_http_ssl_module 文档,1.23.4 起 ssl_protocols 默认值已改为 TLSv1.2 TLSv1.3,但仍建议显式声明以免跨版本漂移。私有 CA 没有可公网访问的 OCSP responder,开启 ssl_stapling on 后 Nginx 会持续解析不到响应,日志出现 ssl_stapling: OCSP response not found,部分客户端还会因 stapling 失败降级校验。HSTS 属于”加错就难回滚”的配置,只有确认 includeSubDomains 覆盖的每个子域都有有效证书后再加。证书链顺序写反时报错为 nginx: [emerg] SSL_CTX_use_certificate_chain_file() failed (SSL: error:0A00018E:SSL routines::ca md too weak)(多为误用 SHA-1 旧证书)或握手期 unable to get local issuer certificate。
Java 17 如何信任内部 CA?
# -cacerts 等价于 -keystore $JAVA_HOME/lib/security/cacerts,默认口令 changeit
keytool -importcert -trustcacerts -cacerts -alias internal-root
-file rootCA.crt -storepass changeit -noprompt
# 验证是否入库
keytool -list -cacerts -alias internal-root -storepass changeit
导入后必须重启 JVM,运行中的进程不会重读 truststore;重复导入会报 keytool error: java.lang.Exception: Certificate not imported, alias <internal-root> already exists,需先 -delete。Tomcat 若走 JSSE 连接器,确认 server.xml 的 certificateFile 指向 fullchain.crt、certificateKeyFile 指向 app.key。典型报错 sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target 即根 CA 未入 truststore。
容器与 Python 怎么补信任链?
# Dockerfile(Debian/Ubuntu 基础镜像)
COPY rootCA.crt /usr/local/share/ca-certificates/internal-root.crt # 文件名必须以 .crt 结尾
RUN update-ca-certificates # 生成 /etc/ssl/certs/ca-certificates.crt
# Python requests 默认读 certifi,可覆盖环境变量而不动镜像
export REQUESTS_CA_BUNDLE=/etc/ssl/certs/ca-certificates.crt
据 Python requests 文档,REQUESTS_CA_BUNDLE 优先级高于 certifi 内置 cacert.pem;直接追加到 site-packages/certifi/cacert.pem 会在升级 certifi 时丢失。未配置时报 SSLError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate。
| 信任库位置 | 适用运行时 | 生效方式 | 常见坑 |
|---|---|---|---|
| /etc/ssl/certs/ca-certificates.crt | 系统 OpenSSL、curl、wget | update-ca-certificates 后立即生效 | 只放根证书,放中间证书无效 |
| $JAVA_HOME/lib/security/cacerts | JVM、Tomcat、Spring Boot | 需重启 JVM | 默认口令 changeit;重装 JDK 会覆盖 |
| certifi 的 cacert.pem | Python requests / httpx | 随解释器启动加载 | 升级 certifi 即丢失 |
| 镜像内 /usr/local/share/ca-certificates | 容器内全部进程 | 构建阶段执行 update-ca-certificates | 多阶段构建需在最终阶段执行 |
公网 CA、私有 CA 还是自签名?内部系统证书方案对比表
内网服务到底该用公网 CA、私有 CA,还是自签名?先给出可执行的判断规则:服务数量超过 20 个、需要吊销或轮换能力、或者存在审计要求时,选私有 CA;只有 1–2 台测试机时,自签名更省事;对外暴露的域名绝不能用内部 CA 签发,否则外部用户一定报 NET::ERR_CERT_AUTHORITY_INVALID。下表是四类方案的可验证参数对比。
| 方案 | 典型工具/版本 | 适用场景 | 客户端信任成本 | 单张有效期 | 年成本 |
|---|---|---|---|---|---|
| 公网 DV | Let’s Encrypt ACME v2 + certbot 2.11 | 自有公网域名的子域,如 *.internal.example.com |
无需装根 | 90 天 | 0 元 |
| 公网 OV | DigiCert / GlobalSign | 对外门户、合规审计 | 无需装根 | 398 天 | 2000–8000 元 |
| 私有 CA | OpenSSL 3.0 / step-ca 0.27 / AD CS | 纯内网、大量微服务 | 需预装根证书 | 建议 ≤397 天 | 0 元 + 人力 |
| 自签名 | openssl req -x509 |
临时测试、单机 | 每台手动信任 | 365 天 | 0 元 |
| mkcert | mkcert v1.4.4 | 本地开发 | 仅本机信任 | 约 2 年 | 0 元 |
为什么私有 CA 的叶证书也建议不超过 397 天?据 CA/Browser Forum 基线要求,公网 TLS 证书有效期上限自 2020 年 9 月起为 398 天;私有 CA 虽不受约束,但把有效期保持在同一量级,可以让“公网/内网”两套流程共用同一套轮换脚本与监控告警,避免内网证书过期三个月无人察觉。Let’s Encrypt 文档明确其证书固定 90 天有效期,目的是推动自动化续期而非手工运维。
- 能用公网域名就别用内部 TLD。走 Let’s Encrypt DNS-01 可免费全自动签发,但证书会进入 CT 日志,内部子域会被公开枚举,敏感系统需先评估。确需内部 TLD 时优先
.internal(ICANN 于 2024 年批准保留为私有网络专用),避开.local,后者与 mDNS/Bonjour 冲突。 - 合规场景:金融、医疗内网若要求 OV 或国密,选对应 CA。SM2 证书需要客户端与负载均衡同时支持,Nginx 需编译国密模块或前置支持 SM2 的网关。
- 成本参考:公网 OV 单域名约 2000–8000 元/年,通配符约 5000–15000 元/年;私有 CA 软件成本接近 0,真实开销在根证书分发(GPO/MDM)、轮换与吊销维护的人力。
# 方案 A:公网域名子域走 Let's Encrypt DNS-01 通配符(certbot ≥2.0)
# 适用:*.internal.example.com 属于你自有公网域名;90 天自动续期
certbot certonly --dns-cloudflare
-d '*.internal.example.com' -d internal.example.com
--server https://acme-v02.api.letsencrypt.org/directory
# 注意:--manual 模式无法自动续期,仅用于一次性验证
# 方案 B:OpenSSL 3.0 自建根 CA(3.x 中 req -x509 的 -days 默认仅 30 天,必须显式指定)
openssl req -x509 -newkey rsa:3072 -sha256 -days 3650 -nodes
-keyout ca.key -out ca.crt
-subj "/CN=Corp Internal Root CA/O=Example"
-addext "basicConstraints=critical,CA:TRUE"
-addext "keyUsage=critical,keyCertSign,cRLSign"
# 方案 C:本地开发用 mkcert,根证书只写入本机信任库
mkcert -install
mkcert "*.dev.example.com" localhost
选错方案最典型的症状是客户端报 curl: (60) SSL certificate problem: unable to get local issuer certificate——这几乎总是“服务端用了私有 CA 或自签名证书,而客户端信任库没有对应根证书”,而不是证书本身签发错误。反过来,如果浏览器对内部地址报 ERR_CERT_COMMON_NAME_INVALID,则要检查 SAN 扩展里是否真的写了该主机名(OpenSSL 3.x 生成自签名证书时默认不含 SAN,需加 -addext "subjectAltName=DNS:host.internal")。
上线后常见的 6 个报错信息与排查命令
这六条报错基本覆盖了内部 CA 上线后 80% 的工单。每条都给出原始报错文本、判定依据和可直接复制的命令,先定位再改配置,别一上来就重签证书。
1. curl 报 SSL certificate problem: unable to get local issuer certificate
这是”链不全”的典型症状:服务端只发了叶子证书,中间证书没带上;或者客户端 trust store 里没有内部根。先用 -showcerts 数一数服务端到底发了几张证书。
# 看服务端下发的完整证书链;输出中每个 -----BEGIN CERTIFICATE----- 代表一张证书
openssl s_client -connect app.internal.example.com:443
-servername app.internal.example.com -showcerts </dev/null
# 只有 1 张且非自签根 → 缺中间证书,重新拼链
cat app.crt intermediate.crt > fullchain.crt # 顺序:叶子在前,中间在后
# 用内部根单独验证(绕过系统 trust store)
curl -v --cacert rootCA.crt https://app.internal.example.com/healthz
据 OpenSSL 文档,ssl_certificate 指令只接受单个文件,链必须按”叶子→中间”顺序拼进同一个 PEM;Nginx 1.14+ 与 OpenSSL 1.1.1+ 行为一致。
2. Java 报 PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
JVM 不走操作系统信任库,只认 cacerts(默认路径 $JAVA_HOME/lib/security/cacerts,默认口令 changeit),里面没有你的内部根。
# JDK 9+ 用 -cacerts;JDK 8 改为 -keystore $JAVA_HOME/jre/lib/security/cacerts
keytool -importcert -cacerts -alias internal-root
-file rootCA.crt -storepass changeit -noprompt
# 验证导入结果
keytool -list -cacerts -alias internal-root
cacerts 在 JVM 启动时一次性读入,导入后必须重启应用;容器化场景下每个镜像都要重复这一步,或用 -Djavax.net.ssl.trustStore=/opt/certs/truststore.p12 显式指定。
3. Nginx 报 SSL_CTX_use_certificate_chain_file(...) failed (SSL: error:0B080074:x509 certificate routines:X509_check_private_key:key values mismatch)
证书与私钥不配对,最常见于续签时只换了 .crt 没换 .key。用模数(RSA)或公钥(ECDSA)比对:
# RSA 证书:两个 md5 必须完全一致
openssl x509 -noout -modulus -in app.crt | openssl md5
openssl rsa -noout -modulus -in app.key | openssl md5
# ECDSA 证书没有 modulus,改用公钥比对
openssl x509 -noout -pubkey -in app.crt | openssl md5
openssl pkey -in app.key -pubout | openssl md5
nginx -t # 改完先语法检查,再 systemctl reload nginx
4. Chrome 报 NET::ERR_CERT_AUTHORITY_INVALID 或 NET::ERR_CERT_COMMON_NAME_INVALID
前者是根证书没进系统受信任根:Windows 打开 certlm.msc(本地计算机存储)→”受信任的根证书颁发机构”→ 导入 rootCA.crt,注意别导到”个人”存储区。Linux 桌面 Chrome 读 NSS 库,需 certutil -d sql:$HOME/.pki/nssdb -A -t "C,," -n internal-root -i rootCA.crt。后者是 SAN 没写对——据 RFC 6125 及 CA/Browser Forum 基线要求,Chrome 58 起完全忽略 CN,只校验 SAN:
openssl x509 -in app.crt -noout -text | grep -A1 "Subject Alternative Name"
# 签发时显式加 SAN(OpenSSL 1.1.1+ 支持 -addext)
openssl req -new -key app.key -subj "/CN=app.internal.example.com"
-addext "subjectAltName=DNS:app.internal.example.com,DNS:app" -out app.csr
5. Go 报 x509: certificate signed by unknown authority,Python 报 SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED] certificate verify failed: unable to get local issuer certificate
精简基础镜像(debian-slim、alpine)里根本没有内部根。构建时注入:
# Debian / Ubuntu 基础镜像
COPY rootCA.crt /usr/local/share/ca-certificates/internal-root.crt
RUN update-ca-certificates # 生成 /etc/ssl/certs/ca-certificates.crt
# Alpine 基础镜像
# COPY rootCA.crt /usr/local/share/ca-certificates/
# RUN apk add --no-cache ca-certificates && update-ca-certificates
# 临时验证(Go 额外识别 SSL_CERT_FILE / SSL_CERT_DIR)
export SSL_CERT_FILE=/etc/ssl/certs/internal-root.crt
6. 报 certificate has expired or is not yet valid
先排除时钟问题,再怀疑证书本身。虚拟机休眠、容器宿主机漂移几分钟就足以触发 notBefore 校验失败。
date -u # 客户端与服务端各跑一次对比
openssl x509 -in app.crt -noout -dates # 看 notBefore / notAfter
openssl s_client -connect app.internal.example.com:443 2>/dev/null
| openssl x509 -noout -dates # 看线上实际生效的那张
内部 CA 建议:根 10 年、中间 5 年、叶子 ≤398 天(对齐 CA/B Forum SC-42 对公共证书的上限,便于将来切换公共信任时不用改流程)。
| 报错关键字 | 问题层 | 首查命令 |
|---|---|---|
| unable to get local issuer certificate | 服务端证书链 / 客户端信任库 | openssl s_client -showcerts |
| PKIX path building failed | JVM cacerts | keytool -list -cacerts |
| key values mismatch | 证书与私钥不配对 | openssl x509 -modulus 对比 |
| CERT_AUTHORITY_INVALID | 根证书未受信任 | certlm.msc / certutil -L |
| CERT_COMMON_NAME_INVALID | SAN 缺失或写错 | openssl x509 -text |
| unknown authority / VERIFY_FAILED | 容器内无根证书 | update-ca-certificates |
| expired or not yet valid | 时钟漂移 / 有效期 | date -u + -dates |
怎么确认配置真的生效?从 openssl s_client 到浏览器的 6 层验证
证书装上、Nginx 能起来,并不等于配置生效——openssl s_client 握手成功只证明服务端愿意协商,不代表链路可信、主机名匹配、客户端信任库认得你。内部系统 SSL 证书的验收必须分层做,下面 6 层按依赖顺序排列,任一层失败都不要往后跳。
第 1 层:链路验证(证书链是否闭合)
# -servername 必加:内部系统常用 SNI 区分多站点,不加会拿到默认 server 的证书
# -verify_return_error:验证失败立即中断握手;默认关闭,只打印警告后继续
# OpenSSL 1.1.1+ 支持该参数,3.0 起额外输出 "Verification: OK/FAILED" 一行
openssl s_client -connect app.internal.example.com:443
-servername app.internal.example.com
-CAfile rootCA.crt -verify_return_error </dev/null
# 通过标准(两行都要有):
# Verify return code: 0 (ok)
# Verification: OK
# 失败典型输出:verify error:num=20:unable to get local issuer certificate
# (服务端没配 ssl_certificate 的中间 CA,即 chain 不完整)
第 2 层:SAN 验证(主机名/IP 是否都在证书里)
openssl x509 -in app.crt -noout -text | grep -A1 'Subject Alternative Name'
# 期望输出形如:
# X509v3 Subject Alternative Name:
# DNS:app.internal.example.com, IP Address:10.20.30.40
据 CA/Browser Forum 基线要求与 RFC 6125(由 RFC 9525 进一步细化),CN 字段已不再作为身份依据,SAN 里没有的地址一律视为不匹配。纯内网用 IP 访问时,SAN 必须显式写入 IP: 条目,而不是 DNS:。
第 3 层:curl 验证(客户端视角)
# 显式指定根证书,绕过系统信任库,先证明"证书本身没问题"
curl -v --cacert /etc/ssl/certs/internal-root.crt
https://app.internal.example.com/healthz
# 期望:< HTTP/2 200
# 再去掉 --cacert,此时应当失败——失败才是预期结果
curl -v https://app.internal.example.com/healthz
# Linux/GnuTLS 构建:curl: (60) SSL certificate problem: unable to get local issuer certificate
# Windows 自带 curl(Schannel):curl: (60) schannel: SEC_E_UNTRUSTED_ROOT
第二条命令如果也返回 200,说明根证书已被塞进系统信任库(update-ca-certificates 或 update-ca-trust 执行过),这是内网客户端批量部署的正常状态;若报错,则确认信任库尚未安装,需要推送 rootCA.crt 到各终端。
第 4 层:服务验证(配置与服务是否真的在跑)
nginx -t # 期望:syntax is ok / test is successful
# 注意:nginx -t 只校验语法,不校验证书与私钥是否配对
systemctl status nginx --no-pager # 期望:active (running)
ss -lntp | grep ':443' # 期望:nginx 进程在 0.0.0.0:443 或 [::]:443 监听
# 补一条 nginx -t 查不出来的:证书与私钥模数必须一致
openssl x509 -noout -modulus -in app.crt | openssl md5
openssl rsa -noout -modulus -in app.key | openssl md5
第 5 层:浏览器验证(最终用户视角)
Chrome/Edge 开发者工具 → Security 面板应显示 Certificate – valid and trusted,点击可看到完整链;Firefox 在地址栏锁图标 → 更多信息 → 查看证书 → 证书层级。Windows 端用 certlm.msc 打开「受信任的根证书颁发机构 → 证书」,能列出 Example Internal Root CA 才算域内分发成功;macOS 对应「钥匙串访问 → 系统 → 证书」。
第 6 层:非标端口 / 纯 IP 场景用 testssl.sh 扫描
# testssl.sh 3.2;--severity 默认 LOW,设为 HIGH 可过滤 INFO/LOW 噪音
./testssl.sh --severity HIGH https://10.20.30.40:8443
# 重点看三组结论:
# certificate validity → 有效期、是否过期
# chain of trust → 是否 "Chain of trust: OK"
# TLS 1.2 / TLS 1.3 → 协议版本是否全部 offered
Mozilla 的 Server Side TLS 指南建议内部服务最低保留 TLS 1.2,禁用 TLS 1.0/1.1;testssl.sh 报 TLS 1.1 offered 时,应在 Nginx 的 ssl_protocols 中显式写 TLSv1.2 TLSv1.3。
| 失败现象 | 最可能的根因(按概率排序) |
|---|---|
| s_client 报 num=20 / num=21 | Nginx 的 ssl_certificate 只放了叶证书,缺中间 CA;或 -CAfile 指向了错误根 |
| curl 200 但浏览器报 NET::ERR_CERT_AUTHORITY_INVALID | 浏览器所在机器的信任库未导入根证书(第 3 层第二条命令同理) |
| ERR_CERT_COMMON_NAME_INVALID | SAN 缺当前访问用的域名或 IP,与 CN 无关 |
| nginx -t 通过但 443 无监听 | server 块未 listen 443 ssl;,或 reload 未生效(systemctl reload nginx) |
证书到期怎么办?内部 CA 的自动化轮换与长期治理
内部 CA 最常出的事故是”没人记得的那张证书过期了”:根证书放在运维抽屉里、中间证书签完就没人管、叶子证书散落在十几台虚拟机上。治理思路只有一条——把有效期压短,把续期交给自动化,把”到期时间”变成可观测指标。
各级证书的有效期该设多长?
据 CA/Browser Forum Ballot SC-081 的路线图,公有 TLS 证书上限将从 398 天逐步收紧(2026-03-15 起 200 天、2027-03-15 起 100 天、2029-03-15 起 47 天);Apple 平台自 2020-09-01 起也要求服务端证书有效期不超过 825 天。内部 CA 虽然不受这些规则强制约束,但客户端兼容性和运维习惯都要求你跟随收紧。建议的分级如下:
| 层级 | 有效期 | 轮换周期 | 关键约束 |
|---|---|---|---|
| 根 CA | 3650 天(10 年) | 提前 6 个月评估 | 私钥离线保存,轮换成本最高 |
| 中间 CA | 1825 天(5 年) | 提前 90 天签发新中间证书 | 日常签发只用中间 CA,根私钥不开机 |
| 叶子证书 | 90 天(推荐),上限 397 天 | 到期前 30 天自动续 | 短有效期可替代 CRL/OCSP |
怎么快速判断一张证书还剩多少天?
# -checkend 接受秒数,2592000 = 30 天
openssl x509 -checkend 2592000 -noout -in /etc/nginx/ssl/app.crt
# 剩余 > 30 天:输出 "Certificate will not expire",退出码 0
# 剩余 ≤ 30 天:输出 "Certificate will expire",退出码 1
echo $? # 可直接用于脚本分支和监控探针
注意 -checkend 只读 notAfter,不校验证书链是否完整、私钥是否匹配;链校验要另跑 openssl verify -CAfile ca-chain.crt app.crt。
自动化签发用什么?
据 smallstep 文档,step-ca 0.27 起内置 ACME provisioner,叶子证书可直接用 certbot/acme.sh 走 ACME 协议续期,无需自建签发接口。Kubernetes 场景下 cert-manager 1.15 提供 CA Issuer(CA 证书+私钥放在 Secret 里)、Vault PKI Issuer 和 AWS PrivateCA Issuer 三种私有签发方式,声明式续期最省心:
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
name: internal-app
namespace: prod
spec:
secretName: internal-app-tls
duration: 2160h # 90 天
renewBefore: 720h # 到期前 30 天续期;默认是 duration 的 2/3
commonName: app.internal.example.com
dnsNames:
- app.internal.example.com
- app.prod.svc.cluster.local # 集群内访问必须进 SAN,CN 不参与匹配
issuerRef:
name: internal-ca
kind: ClusterIssuer
非 Kubernetes 的 Nginx 机器怎么安全轮换?
#!/usr/bin/env bash
set -euo pipefail
D=/etc/nginx/ssl; NAME=app; DOMAIN=app.internal.example.com
openssl req -new -newkey rsa:2048 -nodes -keyout "$D/$NAME.key.new"
-out /tmp/$NAME.csr -subj "/CN=$DOMAIN"
-addext "subjectAltName=DNS:$DOMAIN"
openssl ca -batch -config /etc/ssl/ca/intermediate.cnf
-extensions server_cert -days 90 -in /tmp/$NAME.csr -out "$D/$NAME.crt.new"
cp -a "$D/$NAME.crt" "$D/$NAME.crt.bak.$(date +%F)"
mv "$D/$NAME.crt.new" "$D/$NAME.crt"; mv "$D/$NAME.key.new" "$D/$NAME.key"
if nginx -t 2>/tmp/nginx-t.err; then
systemctl reload nginx # reload 不断连接,不要用 restart
find "$D" -name "$NAME.crt.bak.*" -mtime +7 -delete # 旧证书留 7 天
else
mv "$D/$NAME.crt.bak.$(date +%F)" "$D/$NAME.crt"
cat /tmp/nginx-t.err >&2; exit 1
fi
批量执行要避开业务高峰,并按机器分批 reload,避免所有节点同时重新加载。
吊销该用 CRL 还是干脆不做?
openssl ca -config /etc/ssl/ca/intermediate.cnf -gencrl -out /etc/nginx/ssl/internal.crl
# nginx.conf 中:
# ssl_crl /etc/nginx/ssl/internal.crl; # 仅对 ssl_verify_client 的客户端证书生效
关键细节:Nginx 的 ssl_crl 只作用于 mTLS 客户端证书校验,无法用来”吊销”自己对外提供的服务端证书——客户端是否查 CRL 取决于证书里的 CRL Distribution Points,而内网客户端普遍不查。所以更务实的策略是 90 天叶子证书 + 自动续期,把吊销需求降到接近零;确有泄露场景再手工 openssl ca -revoke 并重新生成 CRL。
怎么统一监控所有内部系统ssl证书的到期时间?
Prometheus blackbox_exporter 的 probe_ssl_earliest_cert_expiry 指标给出链上最早到期的绝对时间戳(Unix 秒),一条规则覆盖全部目标。采集内网自签证书时常报 x509: certificate signed by unknown authority,需在模块里指定 CA 或显式跳过校验:
modules:
https_internal:
prober: http
http:
tls_config:
ca_file: /etc/blackbox/internal-root.crt # 或 insecure_skip_verify: true
# 告警规则
- alert: InternalCertExpiringSoon
expr: probe_ssl_earliest_cert_expiry - time() < 30 * 86400
for: 1h
labels: { severity: warning }
annotations:
summary: "{{ $labels.instance }} 证书剩余 {{ $value | humanizeDuration }}"
Grafana 面板按 issuer(签发 CA)和 SAN 分组,能一眼看出哪套中间 CA 下的证书集体临近到期。
台账要不要维护?
要,但只记 5 个字段:SAN、签发 CA、到期日、部署位置、负责人。每季度用 openssl x509 -noout -subject -issuer -dates 扫一遍线上端口,与台账比对,找出”未登记证书”——这类证书恰恰是过期事故的高发区。根证书轮换前至少提前 6 个月评估客户端覆盖情况:内网 IoT 设备、Java keystore、移动端 App 内置的信任库往往无法热更新,需要预留发版窗口。
可以用于临时测试或单机,但每台客户端都要手动导入,无法吊销,Chrome 仍会提示不安全;生产环境建议私有 CA 或公网域名子域,至少做到根证书可统一分发。
只有你拥有且可公网解析的域名子域可以,例如 internal.example.com,用 DNS-01 验证;.local、.internal、.corp 这类内部 TLD 无法签发,因为 CA 无法完成域名控制权验证。
Java 使用独立的 cacerts 信任库,不读操作系统根证书;用 keytool -importcert -cacerts -alias internal-root -file rootCA.crt 导入后重启 JVM 即可。
通常是服务端只发了叶子证书。把中间证书拼进 fullchain:cat app.crt intermediate.crt > fullchain.crt,Nginx 的 ssl_certificate 指向 fullchain.crt 后执行 nginx -t 和 systemctl reload nginx。
私有 CA 软件成本接近 0,主要是根证书分发和轮换人力;公网 OV 单域名约 2000-8000 元/年,通配符约 5000-15000 元/年,优势是免装根、可审计、外部客户端天然信任。
不能。通配符只匹配一层,*.internal.example.com 匹配 app.internal.example.com,不匹配 app.svc.internal.example.com,也不匹配裸域 internal.example.com。
叶子证书建议 90-397 天并自动化续期;中间 CA 5 年,根 CA 10 年。公共证书受 CA/B Forum 限制,2026-03-15 起最长 200 天,内部 CA 虽不受限,但缩短有效期能降低吊销依赖。
本文由 sslgood.com 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。