返回文章
指南2026-11-07•7 分鐘閱讀•CSR.plus 團隊

Let's Encrypt 需要 CSR 嗎?什麼情況下必須自己產生

Let's Encrypt 需要 CSR 嗎?什麼情況下必須自己產生

簡短回答:不需要,但也有例外

Let's Encrypt 從不要求你透過網頁表單上傳 CSR。ACME 協定裡確實有一個 finalize 步驟需要送出 CSR,但那份 CSR 是客戶端自己產生的——私密金鑰在你本機產生、簽進 CSR 後,只有 CSR 會送給 CA。

所以一般情況下的答案是:你不需要手動產生 CSR。執行 certbot --nginx -d example.com,certbot 會自己建立 privkey.pem 與 CSR、完成驗證、寫回憑證。

不過有四類情況,你確實得自己產出 CSR。

什麼時候必須手動準備 CSR

情境為什麼客戶端做不到
私密金鑰存放在 HSM 或雲端 KMS金鑰無法匯出,只能在邊界內簽好 CSR 再匯出
企業 CA 或代管商代為簽發對方的入口網站只要 CSR 檔案,永遠碰不到你的金鑰
重複使用既有金鑰客戶端會另生新金鑰,把你固定的公開金鑰沖掉
排查 finalize 失敗需要精確查看 CSR 裡到底帶了哪些網域名稱

用 OpenSSL 產生私密金鑰與 CSR

一條命令同時產出兩個檔案。-addext 負責把 SAN 寫進 CSR——這才是 Let's Encrypt 真正讀取的欄位:

openssl req -new -newkey rsa:2048 -nodes \
  -keyout privkey.pem -out request.csr \
  -subj "/CN=example.com" \
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

改用 ECDSA(體積更小、交握更快,Let's Encrypt 同樣接受):

openssl req -new -newkey ec -pkeyopt ec_paramgen_curve:prime256v1 -nodes \
  -keyout privkey.pem -out request.csr \
  -subj "/CN=example.com" \
  -addext "subjectAltName=DNS:example.com,DNS:www.example.com"

兩條命令產生的 privkey.pem 都是未加密的(-nodes)。這是網頁伺服器需要的型態,也正因如此,該檔案必須只有 root 能讀取。

送出去簽署前先檢查 CSR

openssl req -in request.csr -noout -text

輸出裡重點看三項:

  1. Subject Alternative Name 是否列全所有網域名稱。CN 只是裝飾——Let's Encrypt 只驗證 SAN。
  2. Public Key Algorithm 與位元數是否符合預期(2048 位元 RSA 或 P-256)。
  3. Signature Algorithm 是否存在且與金鑰類型相符。沒有簽章區塊的就不是合法 CSR。

如果不想把檔案丟進 shell,本站的 CSR 解碼器 也能在瀏覽器裡解析同樣的欄位。

CA 拿到 CSR 後做了什麼

ACME 流程大概是這樣:

  1. 客戶端下單,宣告一組識別碼(網域名稱)。
  2. CA 下發挑戰(HTTP-01、DNS-01、TLS-ALPN-01)。
  3. 客戶端逐項證明控制權。
  4. 客戶端把 CSR POST 到 finalize 端點。
  5. CA 核對 CSR 裡的名稱與已通過驗證的識別碼完全一致,然後簽發。

第 5 步是手動 CSR 最常出錯的地方。訂單涵蓋 example.com 與 www.example.com,但 CSR 只寫了 example.com,finalize 就會回報識別碼不符。CSR 無法在驗證之後再追加名稱,兩份清單必須事先對齊。

四個常犯錯誤

  • 漏寫 SAN:只有 CN=example.com 的 CSR,在現代用戶端上等於什麼都沒宣告,SAN 擴充是必要的。
  • CN 與 SAN 不一致:有些工具會把 CN 複製進 SAN,有些不會,務必實際查看檔案。
  • 萬用字元配了 HTTP-01:*.example.com 必須用 DNS TXT 驗證,HTTP-01 無法證明萬用字元。
  • 金鑰與 CSR 不是同一次產生的:先產生 CSR 又重新產生金鑰,最終憑證就會和伺服器金鑰對不上。部署前可用 金鑰比對工具 比對模數或公開金鑰點。

續期時重複使用金鑰

CSR 與憑證有效期無關。你可以多年沿用同一把私密金鑰,每次只重新產生 CSR——有些團隊這麼做,是因為金鑰被組態管理系統固定,或者金鑰輪換與憑證續期走兩套節奏。

代價是:金鑰一旦外洩,在輪換之前都持續危險,憑證續多少次都沒用。如果沒有維運上的硬性理由,讓客戶端每次續期都產生新金鑰——預設如此是有原因的。

直接在瀏覽器裡做

如果 CSR 只是為了交給某個面板,CSR 產生器 會在本機產生金鑰與 CSR,全程不上傳。匯出金鑰離線保存,只在需要的地方貼上 CSR。

常見問題

可以把自己的 CSR 直接交給 Let's Encrypt 嗎?

在 ACME 層面可以。用戶端的 finalize 請求提交的就是 DER 編碼的 CSR,允許貼上 CSR 的工具只是跳過了本機產生金鑰這一步。憑證會簽發給 CSR 中的名稱,因此必須與已通過驗證的識別碼完全一致。

certbot 會覆寫我的 CSR 或私鑰嗎?

certbot 會為每個網域名稱在 /etc/letsencrypt/live/<domain>/ 下產生獨立的金鑰組。如果你手動替換了私鑰,續期時會繼續使用該路徑的檔案——所以要在原位置替換,或用 --key-path 指向你自己的金鑰。

萬用字元憑證需要 CSR 嗎?

CSR 中必須包含 DNS:*.example.com,且驗證方式必須是 DNS-01。萬用字元不允許用 HTTP-01,因此 CSR 與驗證類型要一起規劃。

為什麼 CSR 在商業 CA 能用,在 Let's Encrypt 卻失敗?

多數是名稱不符:商業 CA 常接受 CN,而 Let's Encrypt 只讀 SAN;或者 CSR 裡包含無法公開驗證的內網名稱。

免費 SSL/TLS 工具

數秒內驗證並檢查你的憑證。

相關憑證資訊

進一步了解如何選擇和購買 SSL 憑證。

相關文章