使用說明

SSH key 產生:在瀏覽器建立 Ed25519 或 RSA 金鑰組

不用開啟終端機或 ssh-keygen,就能完成 SSH key 產生。選擇演算法,按下產生金鑰組,下載私密金鑰,再複製公開金鑰那一行,給 GitHub、GitLab 或伺服器使用。金鑰是在你的瀏覽器裡建立的,不會離開瀏覽器。這個頁面無法儲存或傳送金鑰。


SSH key 產生步驟

  1. 演算法保持在 Ed25519(建議)。如果是舊伺服器,就選 RSA 4096 位元或 RSA 2048 位元。
  2. 需要的話,在註解(選填)輸入標籤,例如 you@example.com。最多可輸入 100 個字元。
  3. 按下產生金鑰組。Ed25519 馬上完成,RSA 4096 位元可能要幾秒鐘。
  4. 在紅色的私密金鑰卡片中按下載私密金鑰。Ed25519 的檔案名稱是 id_ed25519,兩種 RSA 大小都是 id_rsa。
  5. 在公開金鑰卡片中按複製到剪貼簿。按鈕會短暫顯示「已複製」。
  6. 按重新開始會回到第一個畫面。金鑰組不會保留,所以請先下載。

私密金鑰與公開金鑰:各自的用途

私密金鑰是未加密的 OpenSSH 檔案,開頭是 -----BEGIN OPENSSH PRIVATE KEY-----。它只該放在你的 ~/.ssh 資料夾,不要放在其他地方。拿到這個檔案的人可以用你的身分登入,所以頁面把它標成紅色。

公開金鑰只有一行,像是 ssh-ed25519 AAAA... you@example.com,RSA 則以 ssh-rsa AAAA... 開頭。它可以放心分享:貼到 GitHub 或 GitLab 的 SSH 設定,或伺服器上的 authorized_keys 檔案。註解留空時,這一行會緊接在金鑰之後結束,結尾沒有空格。

Ed25519 或 RSA:該選哪一種演算法

Ed25519 金鑰組幾乎都可以用預設值。它短、快,目前的 GitHub、GitLab 和 OpenSSH 都支援。公開金鑰以 ssh-ed25519 開頭。

只有舊伺服器拒絕 Ed25519 時才需要 RSA。RSA 4096 位元的餘裕較大,RSA 2048 位元則產生得比較快。兩者下載後都叫 id_rsa,公開金鑰都以 ssh-rsa 開頭。如果你已經有同名的金鑰,請先替新檔案改名,再移到定位。

Windows SSH key 產生後的檔案權限

下載的檔案是一般權限,ssh 會拒絕其他使用者讀得到的私密金鑰,並顯示像 UNPROTECTED PRIVATE KEY FILE 或 permissions are too open 的訊息。在 macOS 和 Linux 上,把檔案放進 .ssh 資料夾,並設成只有你能讀取:

RSA 金鑰請改用 id_rsa。在 Windows 上,基於同樣的原因,檔案只能由你自己的帳號讀取。頁面在下載之後的說明裡也重複了 chmod 指令。

把公開金鑰加到 GitHub、GitLab 或伺服器

要用在 GitHub 或 GitLab,請把複製的那一行貼到設定頁中新增 SSH 金鑰的欄位。要用在伺服器,就把這一行附加到 ~/.ssh/authorized_keys,再用金鑰連線:

頁面沒有下載公開金鑰的按鈕。如果想在私密金鑰旁邊放一個 .pub 檔案,請把複製的那一行貼到名為 id_ed25519.pub 的新文字檔。

密語(passphrase)與註解

產生出來的私密金鑰沒有加密,頁面也沒有輸入密語的欄位。檔案一旦遺失或被複製,拿到的人都能使用這把金鑰。要保護它,請在現在存放檔案的電腦上加上密語:ssh-keygen -p -f ~/.ssh/id_ed25519。公開金鑰不會改變,所以已經放在 GitHub 或伺服器上的不必更換。

註解只是加在公開金鑰結尾的標籤,例如你的電子郵件或筆電名稱。它能幫你在清單中分辨金鑰,不影響金鑰的運作。如果你需要的是密碼而不是金鑰,可以用密碼產生器。


常見問題

如何產生 SSH key?

把演算法保持在「Ed25519(建議)」,需要的話輸入電子郵件之類的註解,然後按「產生金鑰組」。用「下載私密金鑰」儲存檔案,再用「複製到剪貼簿」複製公開金鑰那一行。Ed25519 會馬上出現,RSA 4096 位元可能要幾秒鐘。

在網頁上產生 SSH key 安全嗎?

在這個頁面,金鑰組是在你的瀏覽器裡用瀏覽器的安全亂數建立的,下載之前只存在頁面的記憶體中。頁面無法儲存或傳送你的金鑰,離開頁面後私密金鑰就消失了。如果金鑰要保護正式環境的伺服器,請在你信任的電腦上建立,之後再加上密語。

該選 Ed25519 還是 RSA?

除非伺服器拒絕,否則請選 Ed25519。Ed25519 金鑰短、建立得快,目前的 GitHub、GitLab 和 OpenSSH 都支援。RSA 是給不接受 Ed25519 的舊伺服器用的。

RSA 4096 位元還是 RSA 2048 位元?

RSA 4096 位元餘裕較大,建立要幾秒鐘。RSA 2048 位元比較快,現在仍被廣泛接受。兩者都會下載成名為 id_rsa 的檔案,公開金鑰都以 ssh-rsa 開頭。

Windows SSH 金鑰檔案權限太開放,ssh 說檔案沒有受到保護怎麼辦?

下載的檔案是一般權限,同一台電腦的其他使用者讀得到,ssh 會拒絕這樣的私密金鑰。在 macOS 和 Linux 上,把檔案移到 ~/.ssh,再執行 chmod 600 ~/.ssh/id_ed25519(RSA 則是 id_rsa)。在 Windows 上,檔案同樣只能由你自己的帳號讀取。

下載的私密金鑰要存在哪裡?

存在家目錄的 .ssh 資料夾:macOS 和 Linux 是 ~/.ssh,Windows 是 C:\Users\使用者名稱\.ssh。保留頁面給的檔名 id_ed25519 或 id_rsa,ssh 就不用額外選項也找得到。兩種 RSA 大小都會下載成 id_rsa,所以如果已有同名金鑰,請先替檔案改名。

怎麼把公開金鑰加到 GitHub 或 GitLab?

按「複製到剪貼簿」,打開帳號設定中的 SSH 頁面,選擇新增金鑰,把整行貼到金鑰欄位。只貼公開金鑰,也就是以 ssh-ed25519 或 ssh-rsa 開頭的那一行,絕對不要貼私密金鑰的檔案。

怎麼把公開金鑰加到伺服器的 authorized_keys?

把複製的那一行,維持單獨一行,附加到伺服器上的 ~/.ssh/authorized_keys,例如用 echo "ssh-ed25519 AAAA... you@example.com" >> ~/.ssh/authorized_keys。接著用 ssh -i ~/.ssh/id_ed25519 user@host 連線。

金鑰有密語嗎?之後能再加嗎?

金鑰沒有密語,頁面也沒有可以輸入密語的欄位。之後要加的話,對下載的檔案執行 ssh-keygen -p -f ~/.ssh/id_ed25519,並在系統詢問時輸入新的密語。在那之前,任何拿到檔案的人都能使用這把金鑰。

關掉頁面後還能拿回同一把金鑰嗎?

不能。金鑰組不會儲存在任何地方,所以如果你沒有下載私密金鑰就離開頁面或按「重新開始」,它就消失了,你得重新產生一組。離開之前請先下載私密金鑰。