參考 已更正 已針對 1.1.11 審閱

使用 SSH 金鑰的 SFTP

以密碼、私密金鑰檔案(有或沒有通行密語)或 SSH 代理中的金鑰登入 SFTP 伺服器。

本頁內容 4 個章節

SFTP 伺服器接受三種登入方式。在「連接伺服器」面板中,或編輯已儲存的伺服器時,於選項 › 身分驗證下選擇一種。

身分驗證DockDuck 使用什麼儲存什麼
密碼帳號的密碼。密碼,存放在鑰匙圈。
SSH 金鑰你 Mac 上的私密金鑰檔案,以及它的通行密語(如果有的話)。金鑰的路徑連同伺服器一起儲存,通行密語則存放在鑰匙圈。
代理人載入你 SSH 代理中的金鑰。什麼都不儲存。不會儲存密碼。

新的 SFTP 伺服器一開始會採用設定 › 伺服器 › 預設 SFTP 認證中設定的方式。

SFTP 的「連接伺服器」面板,已打開「選項」、選取「SSH 金鑰」,並有「密鑰」和「通行密語」欄位SFTP 的「連接伺服器」面板,已打開「選項」、選取「SSH 金鑰」,並有「密鑰」和「通行密語」欄位

以金鑰檔案登入

  1. 在「連接伺服器」面板中,選擇 SFTP,然後打開選項。
  2. 把身分驗證設為 SSH 金鑰。
  3. 在密鑰中,輸入你的私密金鑰的路徑(例如 ~/.ssh/id_ed25519),或點按 … 按鈕來選擇它。選擇器會在 ~/.ssh 中打開,並顯示隱藏檔案。
  4. 如果金鑰有通行密語,請在通行密語中輸入。如果沒有,請留空。

支援的金鑰檔案

金鑰類型格式
Ed25519OpenSSH(BEGIN OPENSSH PRIVATE KEY),有或沒有通行密語
RSAOpenSSH,有或沒有通行密語
ECDSA(P-256、P-384、P-521)OpenSSH,有或沒有通行密語;也支援較舊的 BEGIN EC PRIVATE KEY 格式(不含通行密語)

RSA 金鑰會先以 SHA-512 簽署,所以它們在拒絕較舊 SHA-1 RSA 簽章的伺服器上也能運作。

終端機 · 建立 Ed25519 金鑰
ssh-keygen -t ed25519 -C "you@example.com"

以你的 SSH 代理登入

把身分驗證設為代理人。DockDuck 會向代理索取它的金鑰,並一次一個提供給伺服器,最多嘗試六次。這裡沒有密碼或通行密語欄位:由代理負責簽署。

DockDuck 尋找代理的方式與 ssh 相同:

  • 如果 ~/.ssh/config 設定了 IdentityAgent,DockDuck 會使用該 socket。密碼管理工具的代理通常是這樣設定的。
  • 否則它會使用 SSH_AUTH_SOCK 中的代理。
  • IdentityAgent none 會關閉代理。

代理可以保存 Ed25519、ECDSA(P-256、P-384、P-521)和 RSA 金鑰。

終端機 · 把你的金鑰加入代理
ssh-add ~/.ssh/id_ed25519

伺服器只以互動方式要求的密碼

有些伺服器只透過互動式提示接受密碼,而不是一般的密碼。DockDuck 無法回答該提示,而伺服器會把它回報成與密碼錯誤相同的拒絕。如果你確定使用者名稱和密碼正確,請改用 SSH 金鑰登入。

你可能看到的錯誤

訊息該怎麼做
無法讀取位於該路徑的 SSH 密鑰檢查路徑,或重新選擇金鑰檔案。
無法讀取該 SSH 密鑰。通行密語錯誤,或金鑰類型不受支援。支援 OpenSSH 格式的 Ed25519、ECDSA 和 RSA 金鑰。
伺服器拒絕了憑證。檢查使用者名稱,以及這把金鑰是否已在伺服器上獲得授權。
SSH 代理沒有可提供的密鑰。以 ssh-add 加入你的金鑰,或使用密碼或金鑰檔案。點按使用密碼即可切換。

更多資訊請見疑難排解伺服器連線。

還是沒解決? 請告訴我們你試過什麼。我們會閱讀每一則訊息。