跳到主要内容
基础知识

内部系统 SSL 证书怎么签发部署?私有 CA 实操、Nginx 配置与报错排查

内部系统ssl证书 — 内部系统 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 安全团队基于生产环境实战经验撰写,关键结论均经过技术复核。

内容审核

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