返回文章
速查2026-11-07•8 分鐘閱讀•CSR.plus 團隊

OpenSSL 產生 CSR 命令:RSA、ECDSA、SAN 與常見錯誤

OpenSSL 產生 CSR 命令:RSA、ECDSA、SAN 與常見錯誤

大多數人只需要這一條命令

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"

拆開來讀就是:建立新請求、同時產生新金鑰、不加密金鑰輸出(-nodes)、把金鑰寫到 privkey.pem、請求寫到 request.csr、將 subject 設為 CN=example.com,並追加一條涵蓋根網域與 www 主機的 SAN 擴充。

有兩個參數最容易踩坑:

  • -nodes("no DES" 的縮寫)表示私密金鑰以明文寫出。拿掉它就會要求輸入密碼,而多數伺服器開機時無法互動輸入。
  • -addext 需要 OpenSSL 1.1.1 以上。舊版上這個參數不存在,命令不會報錯,但也沒有 SAN。

RSA 4096

同一條命令,只把位元數換大:

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

4096 位元 RSA 每次交握明顯更耗 CPU,安全性提升卻有限。真想強化,選 ECDSA 更划算。

ECDSA P-256 與 P-384

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"

若 CA 要求 384 位元,把 prime256v1 換成 secp384r1。注意部分舊版 Android 與 Windows 對 ECDSA 憑證鏈相容性不佳,切換前先看流量。

SAN 很多或要帶 IP

SAN 一多,-addext 就很難讀。改用設定檔:

# csr.cnf
[req]
default_bits       = 2048
prompt             = no
default_md         = sha256
distinguished_name = dn
req_extensions     = v3_req

[dn]
CN = example.com

[v3_req]
subjectAltName = @alt_names

[alt_names]
DNS.1 = example.com
DNS.2 = www.example.com
DNS.3 = api.example.com
IP.1  = 192.0.2.10
openssl req -new -newkey rsa:2048 -nodes \
  -keyout privkey.pem -out request.csr -config csr.cnf

關鍵在 req_extensions 這一行。漏掉它,你會得到一份完全合法卻沒有任何 SAN 的 CSR——然後 CA 告訴你名稱不符。

提交前先看內容

openssl req -in request.csr -noout -text

請檢查:

  • Subject Alternative Name 是否包含所有預期的主機名稱
  • Public-Key 行是否顯示 2048 bit(或 id-ecPublicKey 搭配正確曲線)
  • Signature Algorithm,例如 sha256WithRSAEncryption

接著驗證簽章是否自洽:

openssl req -in request.csr -noout -verify

正常的檔案會印出 verify OK。若出現 "unable to load",代表檔案被截斷——通常是從會折行的終端機複製出來的緣故。

錯誤訊息與真實原因對照

錯誤訊息真實原因處理
Error unpacking CSR檔案是 DER 而非 PEM,或混入多餘文字轉換:openssl req -inform DER -in request.der -out request.csr
no start line缺少 PEM 標頭或換行被破壞確認檔案以 -----BEGIN CERTIFICATE REQUEST----- 開頭
error adding extension在 OpenSSL 1.0.2 上用了 -addext改用設定檔
unable to load private key金鑰受密碼保護加上 -passin pass:...,或不要用 -passphrase 重新產生
CSR 通過但名稱被拒沒寫 SAN 或只寫了 CN用 -addext 重新產生

確認 CSR 與金鑰配對

部署前,先確認拿回的憑證屬於伺服器上的那把金鑰:

openssl req -in request.csr -noout -pubkey
openssl pkey -in privkey.pem -pubout

兩段輸出必須逐位元組相同。若不同,就表示你即將裝上一張與金鑰不符的憑證——這正是 nginx 出現 ssl_error_no_cypher_overlap 與 "key values mismatch" 的典型原因。

金鑰比對工具 會在瀏覽器裡完成同樣的比對,私密金鑰資料不會被複製到任何地方。

為什麼還要用命令列

因為可重現。在筆電上點表單產生的 CSR 很難稽核;寫進 runbook 的命令可以被審查、重跑、納入版本管理。把命令放在部署指令稿旁邊,但不要把 privkey.pem 提交進儲存庫——只有 CSR 適合入庫。

常見問題

哪個 OpenSSL 版本支援 -addext?

1.1.1 及以上。CentOS 7 或較舊的 macOS 內建版本可能是 1.0.2,沒有 -addext,需改用帶 [v3_req] 的設定檔。

為什麼傳了 -subj,CSR 裡還是沒有 SAN?

-subj 只設定 subject(CN)。SAN 來自 -addext 或設定檔。只用 -subj 產生的 CSR 會被所有現代 CA 拒絕,因為瀏覽器不再看 CN。

怎麼確認 CSR 與私密金鑰是配對的?

分別匯出公開金鑰比對:openssl req -in request.csr -noout -pubkey 與 openssl pkey -in privkey.pem -pubout,兩塊內容必須完全一致。

CSR 裡能放 IP 位址嗎?

可以,寫成 IP:192.0.2.10。公共 CA 很少為公用 IP 簽發,但內部 CA 與 Let's Encrypt 測試環境支援。

免費 SSL/TLS 工具

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

相關憑證資訊

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

相關文章