Transférer des fichiers avec SCP

Quand on déploie une configuration sur un serveur, récupère des logs ou transfère un fichier rapidement entre deux machines, scp (Secure Copy Protocol) est l'outil le plus direct. Il utilise SSH pour chiffrer le transfert de bout en bout : une seule commande, pas de serveur FTP à configurer. Pour les transferts ponctuels et rapides, scp reste imbattable en simplicité.

Ce que vous allez apprendre

• Copier un fichier vers ou depuis un serveur distant
• Transférer un répertoire complet avec -r
• Utiliser un port SSH personnalisé avec -P (majuscule)
• Connaître la différence entre -p et -P
• Identifier quand préférer rsync à scp

La commande scp dans l'écosystème Linux

scp fait partie des outils de transfert de fichiers sous Linux. Chaque outil a sa spécialité :

Commande	Spécialité	Quand l'utiliser
scp	Copie distante via SSH	Transfert rapide one-shot
rsync	Synchronisation intelligente (delta)	Sauvegardes, gros fichiers, reprise
sftp	Transfert interactif via SSH	Navigation distante, sessions prolongées
tar + ssh	Archivage + transfert	Arbres de fichiers avec permissions complexes
curl / wget	Téléchargement HTTP/FTP	Récupérer depuis le web

Glissez pour voir

Quand utiliser scp plutôt que les autres :

Situation	Meilleur outil	Pourquoi
Copier un fichier unique vers un serveur	scp	Plus simple que rsync pour un seul fichier
Sauvegarder un dossier régulièrement	rsync	Ne transfère que les différences
Transfert coupé en cours	rsync -P	scp recommence à zéro
Transférer un fichier très volumineux	rsync	Reprise possible, bande passante contrôlée
Récupérer un log rapidement	scp	Une seule commande, rapide
Synchronisation bi-directionnelle	unison	rsync et scp sont unidirectionnels

Glissez pour voir

Comprendre scp en 2 min

🧠 Modèle mental — Comment fonctionne scp

scp = Source → [Tunnel SSH chiffré] → Destination

Points clés

• scp copie des fichiers à travers un tunnel SSH chiffré
• La syntaxe user@host:chemin désigne un emplacement distant
• Sans -r, scp ne copie que des fichiers (pas de dossiers)
• -P (majuscule) pour le port, -p (minuscule) pour préserver les permissions
• Aucune reprise de transfert possible : si ça coupe, on recommence
• Pour des transferts réguliers, préférer rsync à scp

Règles d'or

1

Utiliser des clés SSH plutôt que des mots de passe Plus sécurisé et permet l'automatisation sans interaction.

2

Préférer rsync pour les transferts volumineux ou récurrents rsync reprend les transferts interrompus et ne transfère que les différences.

Vocabulaire essentiel

-r

Récursif : copie les dossiers et leur contenu

-P (majuscule)

Spécifier le port SSH (attention : majuscule !)

-p (minuscule)

Préserver permissions et dates

-C

Activer la compression pendant le transfert

-q

Mode silencieux (pas de barre de progression)

-v

Mode verbeux (détails de connexion SSH)

📚 Pour aller plus loin — 6 options avancées

-l

Limiter la bande passante (en Kbit/s)

-3

Transfert entre 2 serveurs via la machine locale

-i

Spécifier un fichier de clé privée SSH

-o

Passer des options SSH (StrictHostKeyChecking, etc.)

-F

Utiliser un fichier de config SSH alternatif

-c

Choisir l'algorithme de chiffrement

Le principe est simple : scp prend un fichier source (local ou distant), le fait passer à travers un tunnel SSH chiffré, et le dépose à la destination (locale ou distante). C'est exactement comme cp, mais à travers le réseau et de manière sécurisée.

Syntaxe minimale

scp [OPTIONS] SOURCE DESTINATION

Les 3 scénarios d'utilisation

Scénario	Syntaxe	Exemple
Local → Distant	scp fichier user@srv:/dest/	scp config.conf admin@web-01:/etc/nginx/
Distant → Local	scp user@srv:/fichier /local/	scp admin@web-01:/var/log/app.log ~/logs/
Distant → Distant	scp -3 user1@srv1:/f user2@srv2:/dest/	scp -3 admin@web-01:/log admin@backup:/logs/

Glissez pour voir

⚠️ Le piège -p vs -P (CRITIQUE)

C'est la source d'erreur n°1 avec scp :

Option	Signification	Exemple
-p (minuscule)	Préserve les permissions et dates	scp -p script.sh user@srv:/opt/
-P (majuscule)	Port SSH personnalisé	scp -P 2222 fichier user@srv:/tmp/

Glissez pour voir

Astuce mnémotechnique : Port = Pmajuscule, permissions = pminuscule.

# ❌ ERREUR FRÉQUENTE : -p au lieu de -P pour le port
scp -p 2222 fichier.txt user@serveur:/tmp/
# → Ne change pas le port, préserve les permissions et essaie de copier "2222" !

# ✅ CORRECT : -P (majuscule) pour le port
scp -P 2222 fichier.txt user@serveur:/tmp/

Les options essentielles

Option	Signification	Usage
-r	Récursif	Copier un dossier complet
-P <port>	Port SSH	Serveur SSH sur port non standard
-p	Préserver	Conserver permissions et dates
-C	Compression	Accélérer sur connexions lentes
-v	Verbose	Débugger les problèmes SSH
-q	Quiet	Pas de barre de progression
-l <Kbit/s>	Limiter	Contrôler la bande passante
-i <clé>	Identity	Utiliser une clé SSH spécifique

Glissez pour voir

La combo standard :

# Envoi simple vers un serveur
scp config.conf admin@web-01:/etc/nginx/

# Dossier complet avec compression et port personnalisé
scp -r -C -P 2222 ~/projet/ deployer@prod:/var/www/app/

# Récupérer des logs avec préservation des dates
scp -p admin@web-01:/var/log/app.log ~/logs/

Transférer un dossier complet

Par défaut, scp ne copie que les fichiers simples. Pour copier un dossier avec tout son contenu, l'option -r (récursif) est obligatoire :

# ❌ ERREUR : scp refuse de copier un dossier sans -r
scp dossier/ user@serveur:/tmp/
# → "not a regular file"

# ✅ CORRECT : -r pour récursif
scp -r dossier/ user@serveur:/tmp/

Transfert entre deux serveurs distants

L'option -3 permet de copier un fichier d'un serveur à un autre en passant par votre machine locale comme relais :

# Copie logs de web-01 vers backup-01, via votre machine
scp -3 admin@web-01:/var/log/app.log admin@backup-01:/logs/

Sans -3, scp tente une connexion directe entre les deux serveurs (qui doit être autorisée).

Utiliser une clé SSH spécifique

Pour les transferts automatisés (scripts, CI/CD), utilisez une clé dédiée :

# Clé SSH spécifique
scp -i ~/.ssh/deploy_key app.tar.gz deployer@prod:/releases/

# Combiné avec port personnalisé
scp -i ~/.ssh/deploy_key -P 2222 app.tar.gz deployer@prod:/releases/

Compression et bande passante

Sur les connexions lentes ou pour les fichiers texte volumineux, la compression accélère le transfert :

# Compression activée
scp -C database-dump.sql admin@backup:/dumps/

# Limiter la bande passante (en Kbit/s, pas Ko/s !)
scp -l 800 gros-fichier.iso user@serveur:/data/
# 800 Kbit/s ≈ 100 Ko/s

Unité de -l : Kbit/s

L'option -l utilise des Kbit/s (pas des Ko/s). Pour obtenir 100 Ko/s, il faut spécifier 800 (100 × 8). C'est une source d'erreur fréquente.

Bonnes pratiques de sécurité

• Utiliser des clés SSH plutôt que des mots de passe pour l'automatisation
• Vérifier les permissions après transfert : ssh user@srv "ls -la /chemin/"
• Préférer un compte non-root pour les transferts, puis déplacer avec sudo si nécessaire
• Surveiller les connexions : sudo journalctl -u ssh

Quand passer à rsync

scp est idéal pour les transferts ponctuels. Mais pour certains cas, rsync est meilleur :

Critère	scp	rsync
Reprise de transfert	❌ Recommence à zéro	✅ Reprend où il s'est arrêté
Transfert delta	❌ Copie tout	✅ Ne copie que les changements
Exclusion de fichiers	❌ Impossible	✅ --exclude
Dry-run	❌ Impossible	✅ -n pour tester
Simplicité	✅ Plus simple	⚠️ Plus d'options à connaître
Disponibilité	✅ Partout	⚠️ Pas toujours installé

Glissez pour voir

Règle simple : transfert ponctuel → scp. Transfert récurrent ou volumineux → rsync.

Les patterns de transfert courants

Maintenant que vous maîtrisez les bases, voici des recettes prêtes à l'emploi pour les cas fréquents. Chacune associe une formule générique et un exemple concret à adapter.

Fichier local vers serveur distant

Le cas le plus courant : envoyer un fichier vers un serveur.

# Formule
scp <fichier> user@serveur:<destination>/

# Exemple
scp config.conf admin@web-01:/etc/nginx/

• <fichier> : chemin du fichier local à envoyer.
• user@serveur : identifiant et adresse du serveur cible.
• <destination> : chemin de dépôt sur le serveur.

Serveur distant vers machine locale

L'opération inverse : récupérer un fichier depuis un serveur.

# Formule
scp user@serveur:<fichier> <destination>/

# Exemple
scp admin@web-01:/var/log/nginx/error.log ~/logs/

• user@serveur:<fichier> : la source distante.
• <destination> : le dossier local qui reçoit le fichier.

Dossier complet récursif

Copier un répertoire entier avec tout son contenu.

# Formule
scp -r <dossier>/ user@serveur:<destination>/

# Exemple
scp -r ~/projet/ deployer@prod:/var/www/app/

• -r : active la copie récursive, obligatoire pour les dossiers.

Port SSH personnalisé

Transférer quand le serveur SSH n'écoute pas sur le port 22.

# Formule
scp -P <port> <fichier> user@serveur:<destination>/

# Exemple
scp -P 2222 backup.tar.gz admin@srv:/backups/

• -P : port SSH — attention, majuscule.

Transfert entre deux serveurs

Copier un fichier d'un serveur à un autre en passant par la machine locale.

# Formule
scp -3 user1@srv1:<fichier> user2@srv2:<destination>/

# Exemple
scp -3 admin@web-01:/var/log/app.log admin@backup-01:/logs/

• -3 : fait transiter les données par la machine locale comme relais.

Préserver les attributs

Conserver les permissions et dates d'origine du fichier — indispensable pour les scripts exécutables.

# Formule
scp -p <fichier> user@serveur:<destination>/

# Exemple
scp -p deploy.sh admin@prod:/opt/scripts/

• -p : préserve permissions, date de modification et date d'accès.

Transfert compressé

Accélérer le transfert sur les connexions lentes, particulièrement efficace pour le texte.

# Formule
scp -C <fichier> user@serveur:<destination>/

# Exemple
scp -C database-dump.sql admin@backup:/dumps/

• -C : active la compression pendant le transfert.

Clé SSH spécifique

Utiliser une clé SSH dédiée au transfert, typiquement pour l'automatisation.

# Formule
scp -i <clé> <fichier> user@serveur:<destination>/

# Exemple
scp -i ~/.ssh/deploy_key app.tar.gz deployer@prod:/releases/

• -i : chemin vers la clé privée SSH à utiliser.

Les pièges à éviter

Ces erreurs reviennent constamment avec scp. Les connaître évite des transferts ratés et des fichiers écrasés par erreur.

Confusion entre -p et -P

scp -p 2222 fichier.txt user@serveur:/tmp/

Symptôme : le port est ignoré, ou scp tente de copier un fichier nommé 2222.

Cause : -p (minuscule) préserve les permissions ; -P (majuscule) change le port SSH. Moyen mnémotechnique : Port = P majuscule.

scp -P 2222 fichier.txt user@serveur:/tmp/

Oubli du -r pour les dossiers

scp dossier/ user@serveur:/tmp/

Symptôme : erreur not a regular file, rien n'est copié.

Cause : par défaut, scp ne copie que les fichiers simples, jamais les dossiers.

scp -r dossier/ user@serveur:/tmp/

Pas de reprise de transfert

scp gros-fichier.iso user@serveur:/data/   # coupure réseau

Symptôme : après une coupure, le transfert recommence à zéro.

Cause : scp ne supporte pas la reprise de transfert, contrairement à rsync.

rsync -avP gros-fichier.iso user@serveur:/data/

Espaces dans les chemins distants

scp user@serveur:/home/user/Mon Dossier/file.txt .

Symptôme : erreur ou fichier introuvable.

Cause : le shell interprète l'espace comme un séparateur d'arguments.

scp "user@serveur:/home/user/Mon\ Dossier/file.txt" .

Écrasement silencieux sans confirmation

scp user@serveur:/config/new.conf ~/config/important.conf

Symptôme : le fichier local est écrasé sans aucun avertissement.

Cause : scp écrase la destination sans demander confirmation.

cp ~/config/important.conf ~/config/important.conf.bak && scp user@serveur:/config/new.conf ~/config/important.conf

Unité de -l en Kbit/s, pas Ko/s

scp -l 100 fichier user@srv:/tmp/   # en pensant limiter à 100 Ko/s

Symptôme : transfert beaucoup plus lent que prévu, autour de 12,5 Ko/s.

Cause : -l s'exprime en Kbit/s ; 100 Kbit/s valent seulement ~12,5 Ko/s.

scp -l 800 fichier user@srv:/tmp/   # 800 Kbit/s ≈ 100 Ko/s

Travaux pratiques

Ce lab vous fait manipuler scp sur des fichiers réalistes, de l'envoi simple à la limitation de bande passante. Comptez 15 minutes.

Préparer le terrain

Le script suivant crée des fichiers de test représentatifs d'une administration serveur :

# Créer le lab
mkdir -p ~/scp-lab/{local,received}
cd ~/scp-lab/local

# Fichier de configuration typique
cat > config.conf << 'EOF'
# Configuration nginx
server {
    listen 80;
    server_name example.com;
    root /var/www/html;
}
EOF

# Script de déploiement
cat > deploy.sh << 'EOF'
#!/bin/bash
echo "Déploiement en cours..."
systemctl restart nginx
echo "Déploiement terminé."
EOF
chmod +x deploy.sh

# Fichier de logs
for i in $(seq 1 50); do
  echo "$(date -d "$i hours ago" '+%Y-%m-%d %H:%M:%S') INFO  Événement $i" >> app.log
done

# Dossier avec sous-dossiers
mkdir -p projet/{src,docs,tests}
echo "print('hello')" > projet/src/main.py
echo "# Documentation" > projet/docs/README.md
echo "def test(): pass" > projet/tests/test_main.py

echo "Lab créé dans ~/scp-lab"
ls -laR ~/scp-lab/local

Pour tout nettoyer à la fin : rm -rf ~/scp-lab.

Les 8 étapes du lab

1. Copier un fichier vers un serveur — envoyez config.conf dans /tmp/ distant : scp ~/scp-lab/local/config.conf user@serveur:/tmp/. La syntaxe user@serveur:/chemin désigne la destination distante ; tout passe par SSH.

2. Récupérer un fichier depuis un serveur — rapatriez /etc/hostname : scp user@serveur:/etc/hostname ~/scp-lab/received/. On inverse source et destination : le serveur devient la source.

3. Copier un dossier complet — envoyez projet/ avec -r : scp -r ~/scp-lab/local/projet user@serveur:/tmp/. Sans -r, scp refuse de copier un dossier.

4. Utiliser un port SSH personnalisé — pour un serveur sur le port 2222 : scp -P 2222 ~/scp-lab/local/deploy.sh user@serveur:/tmp/. Attention, c'est -P majuscule.

5. Préserver les permissions — copiez deploy.sh en conservant le bit exécutable : scp -p ~/scp-lab/local/deploy.sh user@serveur:/tmp/. -p minuscule préserve permissions et dates.

6. Transfert avec compression — envoyez app.log compressé : scp -C ~/scp-lab/local/app.log user@serveur:/tmp/. -C accélère le transfert des fichiers texte.

7. Mode verbeux pour le debug — observez la négociation SSH : scp -v ~/scp-lab/local/config.conf user@serveur:/tmp/. -v affiche authentification, algorithmes et erreurs détaillées.

8. Limiter la bande passante — plafonnez le débit à 800 Kbit/s : scp -l 800 ~/scp-lab/local/app.log user@serveur:/tmp/. Soit environ 100 Ko/s.

Exercices progressifs

Ces exercices vont du premier transfert au diagnostic d'un échec. Lisez l'énoncé, cherchez la commande, puis dépliez la solution.

Niveau fondations

Exercice 1 — Premier transfert. Envoyez le fichier config.conf vers le serveur web-01 dans /tmp/.

Indice : syntaxe scp fichier user@serveur:/chemin/.

Voir la solution

scp config.conf admin@web-01:/tmp/

La syntaxe de base de scp : fichier local en premier, destination distante en second.

Exercice 2 — Récupération de logs. Récupérez le fichier /var/log/syslog du serveur web-01 vers ~/logs/.

Indice : la source distante vient en premier.

Voir la solution

scp admin@web-01:/var/log/syslog ~/logs/

Pour récupérer un fichier, la source distante est le premier argument, la destination locale le second.

Exercice 3 — Transfert de dossier. Envoyez tout le dossier ~/projet/ vers /var/www/ sur le serveur prod.

Indice : -r est obligatoire pour les dossiers.

Voir la solution

scp -r ~/projet/ deployer@prod:/var/www/

Sans -r, scp refuse de copier un dossier — c'est l'erreur la plus fréquente.

Niveau composition

Exercice 4 — Port SSH non standard. Envoyez backup.tar.gz vers un serveur qui utilise le port SSH 2222.

Indice : -P (majuscule) pour le port SSH.

Voir la solution

scp -P 2222 backup.tar.gz admin@srv:/backups/

Attention à la casse : -P majuscule = port, -p minuscule = permissions.

Exercice 5 — Transfert avec préservation. Envoyez un script en préservant ses permissions d'exécution.

Indice : -p préserve les permissions et dates.

Voir la solution

scp -p deploy.sh admin@prod:/opt/scripts/

-p préserve les dates de modification et les permissions, dont le bit exécutable.

Niveau industrialisation

Exercice 6 — Transfert entre deux serveurs. Copiez /var/log/app.log depuis web-01 vers backup-01 en passant par votre machine.

Indice : -3 utilise votre machine comme relais.

Voir la solution

scp -3 admin@web-01:/var/log/app.log admin@backup-01:/logs/

-3 fait transiter les données par la machine locale. Sans -3, la connexion serait directe entre les deux serveurs.

Exercice 7 — Options combinées. Envoyez un dossier avec compression, port 2222 et préservation des permissions.

Indice : les options scp se combinent librement.

Voir la solution

scp -r -C -P 2222 -p ~/projet/ admin@srv:/var/www/

-r -C -P 2222 -p couvre la plupart des besoins d'un transfert un peu exigeant.

Niveau sécurité

Exercice 8 — Debug d'un transfert échoué. Diagnostiquez un transfert qui échoue en affichant les détails SSH.

Indice : -v affiche les détails de connexion SSH.

Voir la solution

scp -v config.conf admin@srv:/tmp/

-v montre la négociation SSH : authentification, algorithmes et erreurs détaillées.

Dépannage

Quand un transfert échoue, ces méthodes de diagnostic et ces erreurs fréquentes couvrent la grande majorité des cas.

Méthodes de diagnostic

# Mode verbeux : tous les détails SSH et du transfert
scp -v fichier.txt user@serveur:/tmp/

# Tester la connexion SSH avant scp
ssh -v user@serveur "echo OK"

# Vérifier que le port SSH est ouvert
nc -zv serveur 22

# Tester avec un petit fichier pour isoler un problème de taille
echo "test" | ssh user@serveur "cat > /tmp/test.txt"

Erreurs fréquentes

Erreur	Cause probable	Solution
Permission denied	Pas de droits d'écriture, ou dossier destination inexistant	Ajuster les permissions ou copier vers un dossier autorisé (/tmp/)
connect to host ... port 22: Connection refused	sshd arrêté, pare-feu, ou port différent	Démarrer sshd, ouvrir le port, ou utiliser -P <port>
REMOTE HOST IDENTIFICATION HAS CHANGED!	Serveur réinstallé, ou attaque MITM (rare)	Vérifier avec l'admin, puis ssh-keygen -R serveur et reconnexion
not a regular file	Copie d'un dossier sans l'option -r	Ajouter -r pour copier récursivement
No space left on device	Disque destination plein ou quota atteint	Vérifier avec ssh user@serveur "df -h", libérer de l'espace

Glissez pour voir

Aide-mémoire scp

À garder sous la main : la syntaxe générale et les options les plus utilisées au quotidien.

Syntaxe générale

Syntaxe	Signification	Exemple
scp fichier user@host:/chemin/	Envoyer un fichier	scp app.conf admin@srv:/etc/
scp user@host:/chemin/fichier .	Récupérer un fichier	scp admin@srv:/var/log/app.log .
scp -3 user1@srv1:f user2@srv2:/	Transfert inter-serveurs	scp -3 a@s1:/log b@s2:/log/

Glissez pour voir

Options courantes

Syntaxe	Signification	Exemple
-r	Copie récursive (dossiers)	scp -r dossier/ user@srv:/tmp/
-P <port>	Port SSH (majuscule)	scp -P 2222 f.txt user@srv:/
-p	Préserve permissions et dates	scp -p script.sh user@srv:/
-C	Active la compression	scp -C dump.sql user@srv:/
-v	Mode verbeux (debug)	scp -v f.txt user@srv:/
-q	Mode silencieux	scp -q f.txt user@srv:/
-l <Kbit/s>	Limite la bande passante	scp -l 800 f user@srv:/
-i <clé>	Clé SSH privée	scp -i ~/.ssh/key f user@srv:/
-o <option>	Option SSH ponctuelle	scp -o StrictHostKeyChecking=no f srv:/
-c <algo>	Algorithme de chiffrement	scp -c aes256-ctr f user@srv:/

Glissez pour voir

Checklist de maîtrise

Vous maîtrisez scp quand vous pouvez cocher chacun de ces points sans hésiter :

• Je sais envoyer un fichier vers un serveur distant.
• Je sais récupérer un fichier depuis un serveur distant.
• Je sais copier un dossier complet avec -r.
• Je sais utiliser un port SSH personnalisé (-P).
• Je sais préserver permissions et dates avec -p.
• Je sais transférer entre deux serveurs via -3.
• Je connais la différence entre -p et -P.
• Je sais quand utiliser rsync à la place de scp.
• Je sais diagnostiquer un problème de connexion avec -v.

Contrôle de connaissances

Contrôle de connaissances

Validez vos connaissances avec ce quiz interactif

10 questions

5 min.

80% requis

Informations

• Le chronomètre démarre au clic sur Démarrer
• Questions à choix multiples, vrai/faux et réponses courtes
• Vous pouvez naviguer entre les questions
• Les résultats détaillés sont affichés à la fin

Démarrer le quiz

Lance le quiz et démarre le chronomètre

Points clés à retenir :

• -r : obligatoire pour copier un dossier
• -P (majuscule) pour le port, -p (minuscule) pour les permissions
• -v : indispensable pour diagnostiquer les problèmes SSH
• Pas de reprise : si le transfert s'interrompt, il recommence
• Préférer rsync pour les transferts réguliers ou volumineux

Prochaines étapes

Transférer des fichiers avec SFTP Mode interactif du transfert SSH : naviguer, lister, transférer plusieurs fichiers en session.

Synchroniser avec rsync Synchronisation intelligente avec delta et reprise — l'outil complémentaire de scp pour les backups récurrents.

tar avancé : backups et restauration sélective Pipeline tar + SSH pour transférer une arborescence complète en préservant les permissions.

Vérifier l'intégrité d'un fichier sha256sum et GPG pour valider ce qu'on a reçu avant de l'utiliser.

×

📖 Voir la documentation →