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