ssh-copy-id
將公鑰安裝至遠端帳號的 authorized_keys。
執行前須知
需要已有的登入方式（通常為帳號密碼）、可寫入的遠端家目錄及相容的 shell。部分 macOS／Windows 安裝不包含此工具，請先確認是否可用。僅複製 .pub 公鑰。此操作只新增授權公鑰，不會自動停用密碼登入，亦不會設定 OTP。
使用範例
透過預設 SSH 連接埠安裝指定公鑰。
ssh-copy-id -i ~/.ssh/id_ed25519.pub alice@server.example.com透過 2222 連接埠安裝公鑰，再以 ssh -p 2222 驗證登入。
ssh-copy-id -p 2222 -i ~/.ssh/id_ed25519.pub alice@server.example.com參數與範例
-i identity_file常用選擇要安裝在伺服器上的公鑰。不要複製私鑰。
範例
ssh-copy-id -i ~/.ssh/id_ed25519.pub alice@server.example.com-p port常用透過指定的 SSH 連接埠連接到伺服器。
範例
ssh-copy-id -p 2222 -i ~/.ssh/id_ed25519.pub alice@server.example.com-n在不安裝金鑰的情況下執行空運行；可用性因版本而異。
範例
ssh-copy-id -n -i ~/.ssh/id_ed25519.pub alice@server.example.com-f強制安裝而不檢查密鑰是否已經存在；可能會導致重複。
範例
ssh-copy-id -f -i ~/.ssh/id_ed25519.pub alice@server.example.com-o option將 SSH 用戶端設定選項傳遞給連線。
範例
ssh-copy-id -o ConnectTimeout=10 -i ~/.ssh/id_ed25519.pub alice@server.example.com-F configfile使用備用 SSH 用戶端設定檔。
範例
ssh-copy-id -F ~/.ssh/lab_config alice@server.example.com權威參考
核對日期：2026 年 10 月 27 日