不完整的憑證鏈:修復缺少的中間體

不完整的憑證鏈:如何診斷和修復遺失的中間件(Nginx / Apache)
直接回答:大多數「憑證鏈錯誤」都不是無效證書——伺服器只是發送葉子而不發送中間件。一個指令可以解決這個問題:計算 openssl s_client -showcerts 傳回的憑證;單一憑證意味著鏈條斷裂。修復方法是一個串聯文件,先是葉子,然後是中間文件:將 Nginx ssl_certificate 指向它,或在 Apache 2.4.8+ 上將鏈放入 SSLCertificateFile 目標中。不要發送根——客戶端已經有了它。
核心概念
三個組成部分
| 組件 | 角色 | 伺服器應該發送嗎? |
|---|---|---|
| 葉(終端實體) | 綁定您的主機名稱 | 是 |
| 中級 | 將葉子連結到根 | 是的-缺失意味著鏈條斷裂 |
| 根 | 客戶端的信任錨 | 否,已在信任儲存中 |
鏈條如何運作
客戶直接信任根源。您的葉子由不在其信任存儲中的中間體簽名,因此伺服器必須在握手期間發送它,以便客戶端構建葉子→中間體→根。為什麼必須傳送中間體:客戶端只信任本機根;沒有中間體就無法建置路徑。
為什麼有些客戶有效而有些卻失敗
有些用戶端快取中間體或透過 AIA 擴充功能取得遺失的連結;其他的——舊版 Android、Java/OpenJDK、curl、Node、監控代理程式——會立即失敗。伺服器永遠不應該依賴客戶端修復:AIA 獲取不可靠,因為它取決於客戶端實作和網路可達性。
順序很重要
按簽名順序,先是葉子,然後是中間體。錯誤的訂單讓一些客戶徹底崩潰。
讓我們加密目前的層次結構
實務上 ECDSA 葉憑證通常搭配 ECDSA 中繼憑證,但跨演算法簽章在 X.509 中是合法的——真正必須相符的是簽發者與簽章,而非金鑰演算法。
只需 6 個步驟即可修復
步驟 1 — 查看伺服器實際發送的內容
ZXQ代碼0QXZ
計數 BEGIN CERTIFICATE 區塊:1 表示僅葉; 2個或更多是健康的。
步驟 2 — 讀取驗證碼
ZXQ代碼1QXZ
代碼 20 = 未找到發行人(缺少中間體); 21 = 無法驗證第一個憑證; 19 = 自簽章。
第 3 步 — 取得正確的中間體
從 CA 的鏈束或葉的權威資訊存取擴展中獲取正確的中間體。切勿混合世代 - ECDSA 葉子需要 ECDSA 中間體。 證書解碼器 即時顯示頒發者和 AIA。
步驟 4 — 連接(葉在前,無根)
cat leaf.crt intermediate.crt > fullchain.crt不要附加根:客戶端已將其儲存在本機信任儲存中。
第 5 步 — 設定伺服器
Nginx:只有ssl_certificate和ssl_certificate_key;不存在單獨的鏈指令,因此中間體必須位於同一個檔案中,葉在前。
ssl_certificate /etc/ssl/certs/fullchain.crt;
ssl_certificate_key /etc/ssl/private/example.com.key;Apache 2.4.8+:SSLCertificateChainFile 已刪除;將鏈放入 SSLCertificateFile 引用的檔案中。
Certbot 使用者:cert.pem 僅是葉子(使用它是此錯誤的根本原因),chain.pem 僅是中間體,fullchain.pem 是您配置的內容。CDN:CDN用自己的憑證終止TLS;僅上傳葉子會將相同的斷鍊轉發給訪客。
第 6 步 — 驗證
openssl verify -CAfile root.pem -untrusted intermediate.pem leaf.pem # expect "leaf.pem: OK"然後使用 SSL 檢查器 並從乾淨的瀏覽器設定檔進行外部重新測試。
故障排除清單
| 症狀/代碼 | 意義 | 修復 |
|---|---|---|
| 驗證錯誤:num=20 無法取得本地頒發者憑證 | 缺少中間體,或根本不存在 | 檢查伺服器發送了多少個憑證 |
| 驗證錯誤:num=21 無法驗證第一個憑證 | 伺服器不傳送中間體 | 建立全鏈並重新載入 |
| 驗證錯誤:num=19 自簽名憑證 | 自簽名憑證正在使用 | 切換到公共信任的憑證 |
| Chrome NET::ERR_CERT_AUTHORITY_INVALID | 路徑建置失敗 | 相同的修復,然後在清除快取的情況下重新測試 |
| Java PKIX 路徑建置失敗 | TrustStore 缺少 CA 或未傳回中間體 | 傳送完整鏈;不要相信「它在瀏覽器中開啟」 |
| curl / Node 失敗,瀏覽器正常工作 | 瀏覽器掩蓋了問題 | 將curl 視為真實情況 |
| 僅部分 Android 設備故障 | 舊信任存儲,無 AIA 獲取 | 發送完整鏈 |
| 中繼憑證並未簽發該葉憑證 | 鏈檔案放錯中繼憑證 | 換成 subject 與葉憑證 issuer 一致的中繼憑證 |
| 您配置了 cert.pem | 僅葉,無中間體 | 切換到 fullchain.pem |
| CDN/負載平衡器與源端不一致 | 兩側不同鏈 | 兩側更新全鏈 |
進一步閱讀
工具: SSL 檢查器 檢查即時鏈 · 憑證解碼器 顯示頒發者和 AIA · 憑證和金鑰匹配器 也確認憑證和金鑰對
相關:SSL 憑證格式說明 · 檢查憑證是否與其私密金鑰相符 · [ACME HTTP-01 與 DNS-01](/articles/acme-http-01-vs-dns
更深入:SSL 憑證:完整指南 · 憑證類型比較 · SSL 憑證選擇器
常見問題
我應該將根包含在全鏈中嗎?
不,客戶已經有了;發送它只會增加位元組和混亂。
為什麼 Chrome 可以工作,而curl、Java 或 Android 卻失敗?
有些客戶端快取中間體或透過 AIA 取得它們;其他人則不然。透過curl 來判斷,而不是透過瀏覽器來判斷。
CDN 會隱藏這一點嗎?
不會。 CDN 使用自己的憑證終止 TLS,因此僅上傳葉子會將損壞的鏈傳遞給訪客。
cert.pem、chain.pem 和 fullchain.pem 有什麼不同?
在Certbot的目錄中:cert.pem僅是葉子,chain.pem僅是中間體,fullchain.pem是葉子+中間體。在 Nginx/Apache 中使用 fullchain.pem。
我需要對 Let's Encrypt 的新根做什麼?
通常不需要手動操作-客戶端會自動接收新鏈。只需確保沒有配置固定特定的中間體,並且舊客戶端的信任儲存包含 ISRG 根 X1/X2。
免費 SSL/TLS 工具
數秒內驗證並檢查你的憑證。
相關憑證資訊
進一步了解如何選擇和購買 SSL 憑證。