ssh-copy-id

Installer une clé publique dans authorized_keys du compte distant.

Avant de commencer

Nécessite une méthode d’authentification existante, souvent un mot de passe, un dossier personnel distant accessible en écriture et un shell compatible. Cet outil n’est pas inclus dans toutes les installations macOS ou Windows. Copiez uniquement le fichier .pub. L’ajout d’une clé ne désactive pas les mots de passe et ne configure pas OTP.

Exemples

Installer la clé publique choisie sur le port SSH par défaut.

ssh-copy-id -i ~/.ssh/id_ed25519.pub alice@server.example.com

Installer via le port 2222, puis tester avec ssh -p 2222.

ssh-copy-id -p 2222 -i ~/.ssh/id_ed25519.pub alice@server.example.com

Options et exemples

-i identity_fileCourant

Sélectionnez la clé publique à installer sur le serveur. Ne copiez pas la clé privée.

Exemple

ssh-copy-id -i ~/.ssh/id_ed25519.pub alice@server.example.com

-p portCourant

Connectez-vous au serveur sur le port SSH spécifié.

Exemple

ssh-copy-id -p 2222 -i ~/.ssh/id_ed25519.pub alice@server.example.com

-n

Effectuez un essai à sec sans installer de clés ; la disponibilité varie selon la version.

Exemple

ssh-copy-id -n -i ~/.ssh/id_ed25519.pub alice@server.example.com

-f

Forcer l'installation sans vérifier si la clé est déjà présente ; des doublons peuvent en résulter.

Exemple

ssh-copy-id -f -i ~/.ssh/id_ed25519.pub alice@server.example.com

-o option

Transmettez une option de configuration du client SSH à la connexion.

Exemple

ssh-copy-id -o ConnectTimeout=10 -i ~/.ssh/id_ed25519.pub alice@server.example.com

-F configfile

Utilisez un autre fichier de configuration client SSH.

Exemple

ssh-copy-id -F ~/.ssh/lab_config alice@server.example.com

Références officielles

Vérifié le 27 octobre 2026