跳到主要内容
安装配置教程

Ubuntu 安装 SSL 证书完整教程:CSR 生成、Nginx/Apache 配置到生效验证(22.04/24.04)

ubuntu 安装ssl证书 — Ubuntu 安装 SSL 证书完整教程:CSR 生成、Nginx/Apache 配置到生效验证(22.04/24.04)
核心结论

Ubuntu 安装 SSL 证书的本质是把「私钥 + 服务器证书 + 中间证书」放到 /etc/ssl/private 与 /etc/ssl/certs,在 Nginx 1.24 或 Apache 2.4.58 的站点配置里用 ssl_certificate 引用 fullchain、用 ssl_certificate_key 引用私钥,执行 nginx -t && systemctl reload nginx 后约 10 分钟内生效。 证书链必须按「服务器证书 → 中间证书」顺序拼接成 fullchain.pem,漏掉中间证书会让 curl 报 unable to get local issuer certificate、Android 旧版本直接握手失败。 私钥权限必须是 600 且属主 root:root,证书文件 644,否则 Nginx 报 BIO_new_file() failed (SSL: error:8000000D:system library::Permission denied)。 验证命令:openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null | openssl x509 -noout -issuer -dates,输出 notAfter 与 issuer 即代表 Ubuntu 上的 SSL 证书已生效。 Let's Encrypt 证书有效期 90 天,用 certbot 3.x 安装后执行 systemctl list-timers | grep certbot 应能看到 certbot.timer,配合 --deploy-hook "systemctl reload nginx" 可免手工续期。

为什么 Ubuntu 安装 SSL 证书后浏览器仍提示不安全?先定位这 5 个根因

在 Ubuntu 上装完证书却仍看到「不安全」,绝大多数情况并不是证书本身有问题,而是部署链路中某一环没闭合。先明确一个前提:Ubuntu 22.04 自带 OpenSSL 3.0.2,24.04 自带 OpenSSL 3.0.13;apt 源里的 Nginx 分别为 1.18.0 与 1.24.0,Apache 为 2.4.52 与 2.4.58。按 Debian/Ubuntu 惯例,证书应放 /etc/ssl/certs(权限 644)、私钥放 /etc/ssl/private(710,root:root),再在站点配置中引用——只把 .crt 和 .key 上传到服务器,不算完成一次完整的 Ubuntu 安装 SSL 证书。

下面 5 个根因按出现频率排序,每条都给出可直接复制的定位命令。

根因一:证书链不完整。CA 通常返回「服务器证书 + 中间证书」两个文件,只部署前者时,桌面 Chrome 可能照常显示锁标(它会自行补链),但 Android 7 以下、部分 iOS App 内嵌 WebView、Java 8 客户端会直接握手失败,curl 报 unable to get local issuer certificate。验证方式:

# 模拟客户端完整校验,必须输出 "Verify return code: 0 (ok)"
openssl s_client -connect example.com:443 -servername example.com -CAfile /etc/ssl/certs/ca-certificates.crt </dev/null 2>/dev/null | grep 'Verify return code'
# 查看服务端实际下发的证书数量(含中间证书应 ≥2)
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/null 2>/dev/null | grep -c 'BEGIN CERTIFICATE'

根因二:证书与私钥不匹配。Nginx 此时会在 reload 时报 SSL_CTX_use_PrivateKey ... key values mismatch。RSA 证书比对模数 MD5,两者必须完全一致:

openssl x509 -noout -modulus -in /etc/ssl/certs/fullchain.pem | openssl md5
openssl rsa  -noout -modulus -in /etc/ssl/private/example.com.key | openssl md5
# ECDSA(P-256)证书改用公钥文本比对
openssl x509 -noout -pubkey -in fullchain.pem
openssl pkey -pubout -in example.com.key

根因三:改了文件却没重载。Nginx 的证书在 master 进程启动或 reload 时读入内存,覆盖文件后不执行 systemctl reload nginx(等价 nginx -s reload),浏览器拿到的仍是旧证书。用本地文件到期时间与线上实际下发时间对比即可确认:

openssl x509 -noout -enddate -in /etc/ssl/certs/fullchain.pem   # 本地文件 notAfter
echo | openssl s_client -connect example.com:443 -servername example.com 2>/dev/null | openssl x509 -noout -enddate  # 线上实际 notAfter

根因四:域名与 SAN 不匹配。据 Let’s Encrypt 官方公告,自 2025 年 6 月起签发的证书不再写入 CN 字段、只保留 SAN 扩展,因此生成 CSR 时就要用 -addext 同时覆盖裸域和 www,否则 www 访问必然告警:

openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Shanghai/L=Shanghai/O=Example Ltd/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"   # 需 OpenSSL 1.1.1+,Ubuntu 22.04/24.04 均满足

根因五:443 端口没通。Ubuntu 上 ufw status 需出现 443/tcp ALLOW,云主机还要在安全组单独放行;先确认本机监听,再从外网验证链路:

sudo ufw allow 'Nginx Full'        # 同时放行 80 与 443,等效于 ufw allow 443/tcp
sudo ss -lntp | grep ':443'        # 应看到 nginx/apache2 进程在 0.0.0.0:443 或 [::]:443
telnet example.com 443             # 在外部机器执行,连不上说明被安全组或 ufw 拦截
根因 典型报错/现象 一条命令确认
证书链不完整 unable to get local issuer certificate openssl s_client -showcerts
证书与私钥不匹配 Nginx reload 报 key values mismatch openssl x509 -noout -modulus 比对 MD5
未重载服务 浏览器仍显示旧证书/已过期 对比本地与线上 notAfter
SAN 不含该域名 仅 www 或仅裸域告警 NET::ERR_CERT_COMMON_NAME_INVALID openssl x509 -noout -ext subjectAltName
443 不通 连接超时、Connection refused ss -lntp | grep :443 + 外网 telnet

Ubuntu 安装 SSL 证书的完整实操步骤(以 Ubuntu 24.04 + Nginx 为例)

动手前先确认版本,能省掉大量“为什么握手失败”的排查。下面以 Ubuntu 24.04 LTS + Nginx 为主线,22.04 只需替换版本号。

步骤 1:确认系统与组件版本

lsb_release -a          # 期望 Distributor ID: Ubuntu / Release: 24.04(或 22.04)
openssl version         # 需 ≥ 3.0.2;低于 1.1.1 无法启用 TLS 1.3
nginx -v                # 22.04: nginx/1.18.0(Ubuntu);24.04: nginx/1.24.0(Ubuntu)
apache2 -v              # 22.04/24.04 均为 Apache/2.4.58 (Ubuntu)

据 OpenSSL 官方文档,TLS 1.3(RFC 8446)自 OpenSSL 1.1.1 起支持,Ubuntu 22.04 起默认 3.0.x,天然可用;CentOS 7 这类 OpenSSL 1.0.2 平台只能停在 TLS 1.2,若合规要求 TLS 1.3,应先升级系统而非改配置硬撑。

步骤 2:生成私钥与 CSR

# RSA 2048:兼容性最好,密钥约 1.7KB
openssl req -new -newkey rsa:2048 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

# ECDSA P-256:性能更好、密钥约 0.3KB,需 CA 支持
openssl req -new -newkey ec -pkeyopt ec_paramgen_curve:P-256 -nodes 
  -keyout example.com.key -out example.com.csr 
  -subj "/C=CN/ST=Zhejiang/L=Hangzhou/O=Example/CN=example.com" 
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

现代浏览器与 Let’s Encrypt 均已接受 SAN 字段替代 CN(RFC 6125 要求校验 SAN),因此 -addext 不可省。可用 openssl req -in example.com.csr -noout -text | grep -A1 "Subject Alternative Name" 复核。

步骤 3:拼接证书链

# 顺序必须是 服务器证书 → 中间证书,颠倒会导致部分客户端握手失败
cat example.com.crt intermediate.crt > fullchain.pem
openssl verify -CAfile root.crt -untrusted intermediate.crt example.com.crt  # 期望 OK

根证书不要拼入:客户端已内置,拼进去只增大链体积。据 Let’s Encrypt 文档,其中间证书由 ISRG Root X1 签发,需随站点下发。

步骤 4:落盘并收紧权限

sudo install -m 644 fullchain.pem /etc/ssl/certs/example.com.fullchain.pem
sudo install -m 600 example.com.key /etc/ssl/private/example.com.key
sudo chown root:root /etc/ssl/certs/example.com.fullchain.pem /etc/ssl/private/example.com.key
ls -ld /etc/ssl/private   # Ubuntu 默认 drwx--x--- root root(710),非 root 进程读不到

步骤 5–6:写配置、查语法、平滑重载

# /etc/nginx/sites-available/example.com
server {
    listen 443 ssl;
    http2 on;                                   # 1.24.0 用 http2 on; 1.18.0 用 listen 443 ssl http2;
    server_name example.com www.example.com;
    ssl_certificate     /etc/ssl/certs/example.com.fullchain.pem;
    ssl_certificate_key /etc/ssl/private/example.com.key;
    ssl_protocols TLSv1.2 TLSv1.3;
}
sudo nginx -t                # 期望 syntax is ok / test is successful
sudo apachectl configtest    # Apache 场景期望 Syntax OK
sudo systemctl reload nginx  # 平滑重载,不断开既有连接;restart 会
sudo ufw allow 'Nginx Full'  # 或 ufw allow 443/tcp,云安全组需同步放行
对比项 reload restart
既有连接 保持 中断
配置错误时 保留旧进程继续服务 可能直接宕机
适用场景 证书/站点变更(推荐) 模块、二进制升级

至此一轮 ubuntu 安装 ssl 证书流程完成;后续可用 openssl s_client -connect example.com:443 -servername example.com 验证链完整性与协议版本,这正是下一节的验证重点。

Ubuntu 安装 SSL 证书的命令与配置示例:Nginx、Apache、certbot 三套写法

很多人卡在这一步:证书文件已经拿到手,却不确定 Nginx 里那几行 ssl_* 到底该怎么写、Apache 的链文件要不要单独指定、certbot 跑完会不会把配置改坏。下面把 Ubuntu 安装 SSL 证书的三条落地路径一次写全,配置可直接复制,改掉域名和路径即可。

Nginx 1.24(Ubuntu 24.04 apt 源)标准 server 块

# /etc/nginx/sites-available/example.com
server {
    listen 80;
    server_name example.com www.example.com;
    return 301 https://$host$request_uri;   # 80 端口只做跳转,避免明文页面
}

server {
    listen 443 ssl;                        # 1.24.0 及以下要开 HTTP/2 须写成 listen 443 ssl http2;
    server_name example.com www.example.com;

    ssl_certificate         /etc/ssl/certs/example.com.fullchain.pem;  # 站点证书 + 中间证书
    ssl_certificate_key     /etc/ssl/private/example.com.key;          # 私钥,chmod 600
    ssl_trusted_certificate /etc/ssl/certs/example.com.chain.pem;      # 仅供 OCSP stapling 校验

    ssl_protocols           TLSv1.2 TLSv1.3;   # 1.23.4 起默认即为此值,旧版默认含 TLSv1
    ssl_prefer_server_ciphers off;             # 默认 off,TLS1.3 下该指令已不生效
    ssl_session_cache       shared:SSL:10m;    # 默认 none,10m 约存 4 万个会话
    ssl_session_timeout     1d;                # 默认 5m
    ssl_stapling            on;
    ssl_stapling_verify     on;

    add_header Strict-Transport-Security "max-age=31536000" always;

    root  /var/www/example.com;
    index index.html;
}
# 生效:nginx -t && systemctl reload nginx

HTTP/2 的版本坑:Nginx 1.25.1 起引入独立的 http2 on; 指令,而 1.24.0 及以下没有它。在 1.24 上写 http2 on;,nginx -t 会直接报 unknown directive "http2" in /etc/nginx/sites-enabled/example.com:12 并拒绝 reload;反过来在 1.25.1+ 仍写 listen 443 ssl http2; 只产生 deprecation warning,尚可运行。据 Mozilla SSL Configuration Generator 的建议,TLS 1.3 下 ssl_ciphers 可留空,靠 ssl_conf_command Ciphersuites 才生效。

Apache 2.4.58 写法:自 2.4.8 起 SSLCertificateChainFile 已废弃,把中间证书拼进 SSLCertificateFile 指向的 fullchain 文件即可,再单独指定链文件会触发 AH02559: The SSLCertificateChainFile directive is deprecated。

# /etc/apache2/sites-available/example.com.conf
<VirtualHost *:80>
    ServerName example.com
    Redirect permanent / https://example.com/    # 等价于 Nginx 的 return 301
</VirtualHost>

<VirtualHost *:443>
    ServerName example.com
    ServerAlias www.example.com
    SSLEngine             on
    SSLCertificateFile    /etc/ssl/certs/example.com.fullchain.pem   # 含中间证书
    SSLCertificateKeyFile /etc/ssl/private/example.com.key
    # 不要再用 SSLCertificateChainFile
</VirtualHost>
# 生效:a2enmod ssl && apachectl configtest && systemctl reload apache2

用 certbot 一键完成 Ubuntu 安装 SSL 证书:Ubuntu 22.04 源里是 certbot 1.21,够用;Ubuntu 24.04 推荐 snap 装 3.x,续期钩子与 ECDSA 支持更完整。

sudo apt install -y certbot python3-certbot-nginx        # 或 Apache 用 python3-certbot-apache
sudo certbot --nginx -d example.com -d www.example.com 
     --redirect --agree-tos -m ops@example.com --no-eff-email
sudo certbot renew --dry-run                             # 验证续期链路,systemd timer 每天跑两次

内网测试用自签名证书:

sudo openssl req -x509 -newkey rsa:2048 -nodes -days 365 
  -keyout self.key -out self.crt 
  -subj "/CN=intranet.local" 
  -addext "subjectAltName=DNS:intranet.local,IP:10.0.0.10"
# 验证:openssl s_client -connect 10.0.0.10:443 -servername intranet.local </dev/null 2>/dev/null | openssl x509 -noout -dates -subject

有效期别超 825 天:Apple 平台对超过 825 天的 TLS 证书直接拒绝握手(CA/B Forum 已将公有 CA 上限压到 398 天,自签名不受该条约束但受客户端实现约束)。

路径 适用场景 证书来源与续期 关键校验命令
Nginx server 块手写 已有 fullchain/key 文件(商业 CA、内网 CA) 手动上传,到期手动换 nginx -t
Apache VirtualHost 手写 同上,且已 a2enmod ssl 手动上传 apachectl configtest
certbot --nginx 公网可解析域名,走 Let’s Encrypt ACME 自动签发,systemd timer 自动续期 certbot certificates
OpenSSL 自签名 内网、测试、CI 环境 自签,需手动分发信任 openssl x509 -noout -dates

据 Let’s Encrypt 文档,certbot 会在证书到期前 30 天自动续期,但前提是 80/443 端口对 ACME 校验可达;用 --dry-run 预演能提前暴露防火墙与 DNS 问题。协议层面的依据可查 RFC 8446(TLS 1.3)与 RFC 6797(HSTS),前者解释了为何 ssl_prefer_server_ciphers 在 TLS 1.3 下失去意义。

三条路径到底怎么选?先看这张 2025 年价格速查表

选型的分水岭不是”免费还是付费”,而是谁能替你验证身份、谁来保证续期不出错。DV 只验证域名控制权,OV 要核验营业执照,自签名则连”第三方背书”这一层都不存在——这决定了它们在浏览器里的表现和运维工作量完全不同。下表价格为 2025 年常见区间,仅供预算参考。

方案 典型价格 有效期 浏览器信任 安装方式 适用场景
商业 DV 单域名 0–200 元/年 398 天 全平台信任 手动上传 fullchain 或调用 API 个人站、博客
商业 OV 800–3000 元/年 398 天 全平台信任 + 组织信息 人工审核 1–3 个工作日后部署 企业官网、支付页
Let’s Encrypt 免费 90 天 全平台信任 certbot 自动签发与续期 绝大多数公开站点
云厂商免费 DV 免费 90–365 天 全平台信任 控制台一键部署到 SLB/CDN 已上云的业务
自签名 / 私有 CA 0 自定义,≤825 天 不信任,需手动导入 openssl 或 step-ca 签发 内网、开发测试

90 天 vs 398 天:续期成本差在哪?

Let’s Encrypt 证书 90 天到期,一年要续 4 次,靠人记是必出事故的,必须交给 certbot.timer。Ubuntu 22.04 仓库的 certbot 约为 1.21.0,24.04 约为 2.9.0(用 apt policy certbot 确认实际版本),安装后 timer 默认每天触发两次、带最多 12 小时随机延迟,并且只在剩余有效期不足 30 天时真正续签(对应 renewal 配置里的 renew_before_expiry)。上线前务必跑一次演练:

# 安装 nginx 插件(22.04/24.04 通用)
sudo apt update && sudo apt install -y certbot python3-certbot-nginx

# 确认定时器已启用:应看到 certbot.timer 处于 active (waiting)
systemctl list-timers --all | grep certbot

# 用 staging 环境演练续期,不会消耗正式速率限制
sudo certbot renew --dry-run

# 查看每张证书的真实到期时间(-d 后接域名)
sudo certbot certificates -d example.com

商业 DV/OV 是 398 天,一年只需人工更换 1 次,但到期前 30 天就得申请新证书并完成部署——据 CA/Browser Forum 基线要求,公开信任证书有效期上限就是 398 天,这个数字不会回到”买三年省事”的年代。

审核与交付时效差多少?

DV 走 DNS TXT 或 HTTP 文件验证,通常 5–30 分钟签发;OV 要人工核验营业执照,1–3 个工作日;内网私有 CA 用 step-ca 或 Easy-RSA 签发只要几秒,代价是必须先把根证书推进每台客户端的信任库(Linux 放 /usr/local/share/ca-certificates/ 后执行 update-ca-certificates)。自签命令示例,注意 -addext 要求 OpenSSL 1.1.1 以上,Ubuntu 22.04/24.04 自带 3.0.x:

# 生成 397 天有效的自签证书,SAN 必须写,否则 Chrome 直接报错
openssl req -x509 -newkey rsa:4096 -sha256 -days 397 -nodes 
  -keyout /etc/ssl/private/example.key 
  -out /etc/ssl/certs/example.crt 
  -subj "/CN=example.internal" 
  -addext "subjectAltName=DNS:example.internal,IP:10.0.0.10"

有效期别随便写:Apple 平台对 2020-09-01 之后签发的 TLS 服务器证书限制为 398 天(此前为 825 天),用户手动安装的根证书签发的证书可豁免,据 Apple 支持文档《Requirements for trusted certificates》说明。用 825 天在 Safari 上会遇到 NET::ERR_CERT_INVALID 一类的硬拦截。

功能差异真的影响安全吗?

商业 CA 普遍提供 OCSP、证书透明度日志和 1 万至 175 万美元不等的保修赔付(见各家 CPS 与订户协议);Let’s Encrypt 同样记录 CT 日志,但不提供人工客服与任何赔付——它的 CPS 写明服务”按现状”提供。OCSP 这条差异正在消失:Let’s Encrypt 已宣布 2025 年停止 OCSP 服务、转向 CRL,所以 Nginx 里的 ssl_stapling on; 对 LE 证书会逐渐失去意义。自签名证书则根本走不通 OCSP stapling,浏览器会以 NET::ERR_CERT_AUTHORITY_INVALID 红屏告警。

已经上了 CDN 或 SLB,证书还装在 Ubuntu 上吗?

此时浏览器看到的是边缘节点的证书,优先在 CDN 控制台上传;源站改配自签或云厂商回源证书,并强制 443。也就是说,Ubuntu 安装 SSL 证书的工作重心从”公网信任”转成”回源加密 + 跳转”,Nginx 侧最小配置如下(return 301 比 rewrite 更省一次正则匹配):

server {
    listen 80;
    listen [::]:80;
    server_name example.com;
    return 301 https://$host$request_uri;   # 强制跳转,保留原始路径
}

Ubuntu 安装 SSL 证书后常见报错与排查清单(含真实报错原文)

排查顺序固定为:配置语法 → 私钥与证书是否配对 → 证书链是否完整 → 协议与密码套件是否协商 → 客户端信任库。ubuntu 安装ssl证书 之后的报错有九成都落在这五步里。先记住一个前提:Ubuntu 22.04 自带 OpenSSL 3.0.2、24.04 为 3.0.13,两者默认安全级别都是 SECLEVEL=2,后文多条报错都源于此(据 OpenSSL 3.0 官方文档 SSL_CTX_set_security_level)。

报错一:nginx: [emerg] cannot load certificate “/etc/ssl/private/example.com.fullchain.pem”: BIO_new_file() failed (SSL: error:8000000D:system library::Permission denied)

这是路径或权限问题,不是证书问题。/etc/ssl/private 在 Ubuntu 上默认是 710 root:ssl-cert,非 root 进程进不去;反过来把私钥丢在 /var/www 再 chmod 644,等于把私钥公开。正确布局是证书链放 /etc/ssl/certs(644)、私钥放 /etc/ssl/private(600 root:root):

# install 一步完成复制+设权,避免 cp 受 umask 影响
sudo install -m 644 -o root -g root example.com.fullchain.pem /etc/ssl/certs/
sudo install -m 600 -o root -g root example.com.key        /etc/ssl/private/
# 确认每一级目录都可被 nginx master(root)读取
namei -l /etc/ssl/private/example.com.key
sudo nginx -t && sudo systemctl reload nginx

报错二:nginx: [emerg] PEM_read_bio_X509_AUX() failed (SSL: error:0480006C:PEM routines::no start line)

文件根本不是 PEM 文本,最常见于把 IIS 导出的 .pfx 或 .der 直接改后缀。先用 openssl x509 -in cert.pem -text -noout 验证:能打印 Subject/Issuer 才是 PEM,报 unable to load certificate 就按来源转换:

# DER → PEM
openssl x509 -inform DER -in cert.der -out cert.pem
# PFX/P12 → 一次拆出私钥+叶子证书+中间证书(-nodes 表示私钥不加密)
openssl pkcs12 -in cert.pfx -nodes -out all.pem
# 复核
openssl x509 -in cert.pem -noout -subject -issuer -dates

报错三:curl: (60) SSL certificate problem: unable to get local issuer certificate / 浏览器 NET::ERR_CERT_AUTHORITY_INVALID

服务端只发了叶子证书、没发中间证书。RFC 8446 §4.4.2 要求服务器发送完整链(叶子在前、中间证书在后,根证书无需发送)。用 openssl s_client -connect example.com:443 -servername example.com -showcerts 数一下返回几个 -----BEGIN CERTIFICATE-----,只有 1 个就是缺链:

# 顺序不可颠倒:服务器证书在前,中间证书在后
cat example.com.crt intermediate.crt > example.com.fullchain.pem
# 本地验证链能否构建
openssl verify -CAfile /etc/ssl/certs/ca-certificates.crt 
  -untrusted intermediate.crt example.com.crt

Nginx 的 ssl_certificate 指向该链文件即可;ssl_trusted_certificate 仅在启用 OCSP stapling 时才需要,指向同一文件。Mozilla SSL Configuration Generator 的 intermediate 档同样要求 chain 含中间证书。

报错四:SSL_ERROR_NO_CYPHER_OVERLAP

客户端只支持 TLS 1.0/1.1,而 SECLEVEL=2 已禁用 TLS <1.2 与 SHA1 签名。不要全局加 @SECLEVEL=1——那会连带打开弱套件;应升级客户端,或为遗留设备单独开一个受限 server 块。

报错五:certbot 报 Problem binding to port 80: Could not bind to IPv4 or IPv6

standalone 模式要独占 80 端口,而 Nginx/Apache 正占着。改用 --nginx,或走 webroot 文件验证:

sudo certbot certonly --webroot -w /var/www/html -d example.com -d www.example.com
# 若提示 too many failed authorizations recently:已触发 Let's Encrypt 的
# 失败验证上限(每账户每主机名每小时 5 次),等 1 小时再试,别循环重跑

报错六:Nginx SSL_CTX_use_PrivateKey … key values mismatch,或 Apache AH02572: Failed to configure at least one certificate and key for example.com:443

证书与私钥不是一对,通常是续期时只替换了其中一个。比对公钥比比对 modulus 更通用(RSA/ECDSA 皆可):

openssl x509 -noout -pubkey -in /etc/ssl/certs/example.com.fullchain.pem | openssl sha256
openssl pkey -pubout -in /etc/ssl/private/example.com.key | openssl sha256
# 两行哈希一致才配对;不一致需重新生成 CSR 并重签
报错关键字 根因 快速验证
BIO_new_file() failed: Permission denied 目录权限/路径错误 namei -l <私钥路径>
PEM routines::no start line 非 PEM(.pfx/.der 改后缀) openssl x509 -in cert.pem -noout -subject
unable to get local issuer certificate 缺中间证书 openssl s_client -showcerts
NO_CYPHER_OVERLAP 客户端过旧 / SECLEVEL=2 openssl s_client -tls1_1 -connect host:443
key values mismatch / AH02572 证书私钥不配对 比对 -pubkey 的 SHA-256

每次改动后固定跑三步收尾:sudo nginx -t(Apache 为 sudo apachectl configtest)、sudo systemctl reload nginx、openssl s_client -connect example.com:443 -servername example.com </dev/null | grep "Verify return code",输出 0 (ok) 才算真正生效。

如何验证 Ubuntu 上 SSL 证书安装成功并已生效?6 条命令逐个跑

证书装完不等于生效。下面 6 条命令建议按顺序跑,每一条都有明确判据,任何一条不通过就先别动其他配置。命令在 Ubuntu 22.04(OpenSSL 3.0.2)与 24.04(OpenSSL 3.0.13)上均可用,把 example.com 换成你的域名即可。

1. 线上证书的主体、签发者、有效期是否与磁盘一致?注意必须带 -servername 发送 SNI,否则同一 IP 上的多站点会返回默认站点的证书,这是最常见的误判来源。

# 抓取线上叶子证书并解码
openssl s_client -connect example.com:443 -servername example.com -showcerts /dev/null 
  | openssl x509 -noout -subject -issuer -dates

# 与磁盘文件对比:两个 notAfter 必须逐字相同
openssl x509 -noout -enddate -in /etc/letsencrypt/live/example.com/fullchain.pem

2. 证书链是否完整?据 RFC 5280,服务器必须下发中间证书,客户端才能把链接到本地根库。很多“电脑能打开、手机报错”的问题就出在这里。

openssl s_client -connect example.com:443 -servername example.com -verify_return_error &1 
  | grep "Verify return code"

输出必须是 Verify return code: 0 (ok)。常见非 0 值含义如下:

返回码 含义 典型原因
0 (ok) 链验证通过 正常
20 unable to get local issuer certificate 缺中间证书,只配了 cert.pem 而非 fullchain.pem
21 unable to verify the first certificate 同上,或证书顺序写反(应先叶后中间)
10 certificate has expired 证书已过期或系统时间错误

3. 协议版本与加密套件是否符合预期?TLS 1.0/1.1 已于 2021 年被 RFC 8996 正式弃用,Mozilla 服务器端 TLS 指南的“中间兼容”配置也早已只保留 TLS 1.2 与 1.3。下面这条应直接握手失败:

# 期望输出 handshake failure 或 no protocols available
openssl s_client -connect example.com:443 -servername example.com -tls1_1 </dev/null

# 用 nmap 枚举实际启用的套件(需 apt install nmap)
nmap --script ssl-enum-ciphers -p 443 example.com
# 或用 testssl.sh 3.2 一次性给出协议、套件与评级建议
./testssl.sh --protocols --fs example.com

4. 服务端真的加载了新配置吗?改完配置只 reload 未校验,是“证书换了但线上没变”的头号原因。

# 输出 nginx 实际合并后的完整配置文本(需 root)
nginx -T | grep -E "ssl_certificate|ssl_protocols"
# Apache 用:apachectl configtest && apachectl -S
ss -lntp | grep ':443'            # 确认 nginx/apache2 在 443 上监听
tail -f /var/log/nginx/access.log # 观察是否有新请求打进来

5. 浏览器与第三方评级怎么交叉验证?Chrome/Edge 点地址栏锁图标 → 连接安全 → 证书有效,同时 F12 Console 不应出现 Mixed Content 告警。再到 SSL Labs(ssllabs.com/ssltest)跑一次,配置正确通常是 A 或 A+;A+ 的硬性前提是返回 HSTS 头且 max-age ≥ 31536000(一年),依据 RFC 6797:

# nginx 中加入 HSTS,Apache 用 Header always set Strict-Transport-Security
add_header Strict-Transport-Security "max-age=31536000; includeSubDomains" always;

6. 怎么让它以后自动报警?openssl x509 -checkend 在证书将于指定秒数内过期时返回 1,正好可用于巡检脚本。

#!/usr/bin/env bash
# /usr/local/bin/check-cert.sh —— 到期前 14 天告警
HOST=example.com; DAYS=14
if ! openssl s_client -connect "$HOST:443" -servername "$HOST" /dev/null 
     | openssl x509 -noout -checkend $((DAYS*86400)); then
  echo "证书将在 ${DAYS} 天内过期: $HOST" | mail -s "SSL 告警" ops@example.com
fi
# crontab -e 添加:0 3 * * * /usr/local/bin/check-cert.sh

据 Let’s Encrypt 文档,其证书有效期 90 天、建议在剩余 30 天内续期;商业 DV 证书受 CA/Browser Forum 规定限制最长 398 天。因此把巡检阈值设为剩余 30/14/7 天三档,既能覆盖自动续期失败,也能兜住商业证书忘记重签的情况。

Ubuntu 安装 SSL 证书之后:续期、换证与不停机更新的运维要点

证书装好只是开始。真正的运维风险集中在三件事上:忘了续期、续了期但服务没重载、换证过程中握手失败。下面按顺序给出可验证的自检命令与回滚手段。

certbot 自动续期到底准备好了没有?

据 Let’s Encrypt 官方文档,其证书有效期为 90 天,官方建议在剩余 30 天时续期,certbot 的 timer 默认每天跑两次(OnCalendar=*-*-* 00/12:00:00 加随机延迟)。判断”是否真的就绪”要用两条命令,缺一不可:

# 1) 模拟续期:必须看到全绿,任何一处失败都会在真实续期时变成过期事故
sudo certbot renew --dry-run
# 期望输出结尾(真实报错会在此处显示 DNS problem / Connection refused 等):
#   Congratulations, all simulated renewals succeeded:
#     /etc/letsencrypt/live/example.com/fullchain.pem (success)

# 2) 确认定时器已装载并激活(Ubuntu 24.04 用 snap 安装的 certbot 默认自带 certbot.timer)
systemctl list-timers | grep certbot
# 期望看到类似:
#   NEXT                        LEFT     LAST                        PASSED  UNIT          ACTIVATES
#   Tue 2025-06-10 03:14:22 UTC 9h left  Mon 2025-06-09 15:02:11 UTC 3h ago  certbot.timer certbot.service

若 list-timers 无输出,说明你可能是用 apt 装的旧版 certbot,需补一条 sudo systemctl enable --now certbot.timer;Ubuntu 22.04 起官方已推荐改用 snap install certbot --classic(见 certbot 官网 Installation 页),apt 源里的版本更新滞后。

为什么续期成功了浏览器还是旧证书?

因为 Nginx/Apache 只在启动或显式 reload 时读取证书文件,覆盖 PEM 文件本身不会触发重载,进程会继续用内存里的旧证书直到下次重启——而 90 天周期里你很可能几个月不重启。解决办法是 deploy hook,三种写法任选其一:

方式 放置位置 / 命令 适用场景
全局钩子(推荐) /etc/letsencrypt/renewal-hooks/deploy/reload-web.sh,内容 #!/bin/sh + systemctl reload nginx,需 chmod +x 一台机器跑 Nginx + Apache 多站点,一次配置全生效
单证书钩子 certbot renew --deploy-hook "systemctl reload nginx"(仅本次) 临时验证钩子是否有效
写入 renewal 配置 /etc/letsencrypt/renewal/example.com.conf 中加 renew_hook = systemctl reload nginx 只对某张证书定制动作
# 全局 deploy hook 的完整落地命令
sudo tee /etc/letsencrypt/renewal-hooks/deploy/reload-web.sh >/dev/null <<'EOF'
#!/bin/sh
# 证书文件已被覆盖,此处只做重载;nginx -t 失败则中止,避免把坏配置推上线
nginx -t && systemctl reload nginx
EOF
sudo chmod +x /etc/letsencrypt/renewal-hooks/deploy/reload-web.sh

手动更换商业证书,怎么做到 1 分钟内回滚?

先用 OpenSSL 查准到期日,别靠日历记忆:

openssl x509 -enddate -noout -in /etc/nginx/ssl/fullchain.pem
# 输出示例:notAfter=Sep 28 23:59:59 2025 GMT
# 建议提前 30 天向 CA 提交新 CSR;换证顺序必须是:备份旧证书 → 落新文件 → nginx -t → reload
sudo cp -a /etc/nginx/ssl /etc/nginx/ssl.bak.$(date +%F)   # 备份,回滚的唯一凭据
sudo nginx -t && sudo systemctl reload nginx                # 先校验后重载
# 若 reload 后握手异常,回滚只需两步(秒级):
sudo cp -a /etc/nginx/ssl.bak.2025-06-09/. /etc/nginx/ssl/
sudo systemctl reload nginx

OCSP stapling 配了却不生效?

常见原因是只写了 ssl_stapling on; 却没给 ssl_trusted_certificate,Nginx 拿不到中间证书就无法验证并缓存 OCSP 响应。验证命令与典型失败输出如下(依据 Nginx 官方 ngx_http_ssl_module 文档,ssl_stapling 默认 off):

# nginx.conf 中 server 块内
ssl_stapling on;
ssl_stapling_verify on;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;  # 必须是中间证书链,不能是 fullchain

echo | openssl s_client -connect example.com:443 -servername example.com -status 2>/dev/null | grep -A1 "OCSP response"
# 未生效时输出:OCSP response: no response sent
# 生效时输出:OCSP Response Status: successful (0x0)

同一台 Ubuntu 怎么放多张证书?

同一个 443 端口靠 SNI 承载多个 server 块,每块写各自的 ssl_certificate/ssl_certificate_key 即可。要注意的是:不支持 SNI 的老客户端(部分 Java 6/7、Windows XP 上的 IE)会命中 default_server,因此给 default_server 也挂一张有效证书,否则这些请求会直接握手失败而不是拿到错误页面。这也是在 Ubuntu 上安装 SSL 证书后最容易忽略的收尾项——单站点场景无所谓,多域名共存时必须处理。相关细节可对照 RFC 6066(SNI 定义)与 Mozilla SSL Configuration Generator 的推荐套件。

最后一条经验:把 certbot renew --dry-run 加进你的监控或月度巡检脚本,它比任何日历提醒都可靠;据 Let’s Encrypt 统计,过期事故绝大多数不是”没配自动续期”,而是”配了但从未验证过”。

不需要重启,执行 systemctl reload nginx(等价 nginx -s reload)即可平滑加载新证书,已有连接不会中断。restart 会杀掉 worker 进程导致瞬时 502,只在 reload 失败时才用。reload 后用 openssl s_client 查看 notAfter 确认新证书已生效。

安装动作本身不收费,成本在证书。Let's Encrypt 免费但 90 天需自动续期;商业 DV 单域名常见 0–200 元/年,OV 约 800–3000 元/年,有效期均为 398 天;自签名 0 元但浏览器不信任,只适合内网与测试环境。

按概率排查三件事:证书链是否缺中间证书(curl 会报 unable to get local issuer certificate)、SAN 是否覆盖当前访问的域名(www 与裸域要分别列出)、页面是否还有 http:// 的图片或 JS 导致混合内容。Chrome DevTools 的 Console 与 Security 面板会直接给出具体原因。

certbot 会代做 CSR 生成、域名验证、证书落盘与续期定时器,Let's Encrypt 证书 90 天自动续;手动安装适合商业 DV/OV 证书,398 天一次,需要自己生成 CSR、拼接 fullchain、写 ssl_certificate 并 reload。两者最终配置项完全一致,区别只在签发与续期流程。

这是证书文件不是合法 PEM 的典型报错,常见于把 .pfx/.der/.cer 直接改后缀,或 cat 时把私钥和证书混在一个文件里。先用 openssl x509 -in 文件 -text -noout 验证,DER 用 openssl x509 -inform DER 转换,PFX 用 openssl pkcs12 -in cert.pfx -nodes 拆出证书与私钥,再重新 nginx -t。

可以,靠 SNI 在同一个 443 端口上按 server_name 分发,每个 server 块写各自的 ssl_certificate 与 ssl_certificate_key。注意给 default_server 也配一张证书,否则不支持 SNI 的老客户端会握手失败;证书数量增加后建议统一放在 /etc/ssl/certs 并做命名规范。

按 Debian/Ubuntu 惯例,证书与链文件放 /etc/ssl/certs(权限 644),私钥放 /etc/ssl/private(权限 600,属主 root:root)。也可以集中放 /etc/nginx/ssl 或 /etc/apache2/ssl,便于按站点管理。不要把私钥放在 /var/www 等 Web 可访问目录,避免被直接下载。


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

内容审核

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