Ubuntu Manpage: sftp — Transfert de fichier sécurisé par OpenSSH

NOM

       sftp — Transfert de fichier sécurisé par OpenSSH

SYNOPSIS

       sftp     [-46AaCfNpqrv]     [-B     taille_tampon]     [-b     fichier_batch]    [-c    algo_chiffrement]
            [-D commande_serveur_sftp] [-F configuration_ssh] [-i fichier_identité] [-J destination] [-l limite]
            [-o option_ssh] [-P port] [-R nombre_requêtes]  [-S  programme]  [-s  sous_système  |  serveur_sftp]
            [-X option_sftp] destination

DESCRIPTION

sftp est un programme de transfert de fichier similaire à ftp(1) qui effectue toutes ses opérations sur
un transport chiffré ssh(1). Il peut aussi utiliser de nombreuses fonctionnalités de ssh comme
l’authentification par clé publique et la compression.

La destination peut être spécifiée sous la forme [utilisateur@]hôte[:chemin] ou à l’aide de l’URI
sftp://[utilisateur@]hôte[:port][/chemin].

Si la destination comporte un chemin et s’il ne s’agit pas d’un répertoire, sftp retrouvera
automatiquement les fichiers si une méthode d’authentification non interactive est utilisée ; dans le cas
contraire, il le fera après une authentification interactive réussie.

Si aucun chemin n’est spécifié ou si chemin est un répertoire, sftp se connectera à l’ hôte spécifié et
entrera en mode commande interactif, en se plaçant dans le répertoire distant s’il est indiqué. Il est
possible d’ajouter un barre oblique en fin de chemin pour forcer l’interprétation de chemin comme
répertoire.

Comme les formats de la destination utilisent des caractères deux-points (« : ») pour séparer les noms
d’hôte des noms de chemin ou des numéros de port, les adresses IPv6 doivent être entourées de crochets
(« [] ») pour éviter toute ambiguïté.

Les options sont les suivantes :

-4 Forcer sftp à n’utiliser que des adresses IPv4.

-6 Forcer sftp à n’utiliser que des adresses IPv6.

-A Autoriser la redirection de ssh-agent(1) vers le système distant. Par défaut, la redirection d’un
agent d’authentification n’est pas autorisée.

-a Essayer de reprendre les transferts interrompus au lieu d’écraser les copies de fichiers
existantes partielles ou complètes. Si le contenu partiel diffère de celui qui est en cours de
transfert, le fichier résultant sera probablement corrompu.

-B taille_tampon
Cette option permet de spécifier la taille du tampon utilisé par sftp lors d’un transfert de
fichiers. Une taille de tampon plus grande nécessitera moins d’allers-retours au prix d’une
consommation de mémoire plus importante. La valeur par défaut est 32768 octets.

-b fichier_batch
Le mode de traitement par lot lit une suite de commandes depuis un fichier d’entrée fichier_batch
au lieu de stdin. Comme il n'y a pas d'interaction avec l'utilisateur, ce mode doit être utilisé
avec une authentification non interactive pour éviter d’avoir à fournir un mot de passe lors de
la connexion (voir sshd(8) et ssh-keygen(1) pour les détails).

Utiliser « - » comme fichier_batch permet d’indiquer l'entrée standard. sftp s'interrompra si
l'une des commandes suivantes échoue : get, put, reget, reput, rename, ln, rm, mkdir, chdir, ls,
lchdir, copy, cp, chmod, chown, chgrp, lpwd, df, symlink et lmkdir.

La sortie sur erreur peut être supprimée commande par commande en préfixant la commande par un
caractère « - » (par exemple, -rm /tmp/blah*). L’écho de la commande peut être supprimé en
préfixant la commande par un caractère « @ ». Ces deux préfixes peuvent être combinés entre eux
dans n’importe quel ordre (par exemple -@ls /bsd).

-C Activer la compression (à l’aide de l'option -C de ssh).

-c algorithme_chiffrement
Cette option permet de sélectionner l’algorithme de chiffrement à utiliser pour le chiffrement
des transferts de données. Cette option est passée directement à ssh(1).

-D commande_serveur_sftp
Cette option permet d’indiquer un serveur sftp local auquel se connecter directement (plutôt que
par ssh(1)). Il est possible de spécifier une commande et ses arguments (par exemple
« /chemin/serveur_sftp -el debug3 »). Cette option peut s’avérer utile pour le débogage du client
et du serveur.

-F configuration_ssh
Cette option permet de spécifier un fichier de configuration par utilisateur de remplacement pour
ssh(1). Elle est passée directement à ssh(1).

-f Forcer l’écriture des fichiers sur disque immédiatement après leur transfert. Lors d’un
téléversement de fichier, cette fonctionnalité n’est activée que si le serveur prend en charge
l’extension « fsync@openssh.com ».

-i fichier_identité
Cette option permet de sélectionner le fichier à partir duquel l’identité (la clé privée) sera
lue pour l'authentification par clé publique. Elle est passée directement à ssh(1).

-J destination
Se connecter à l’hôte cible en établissant tout d’abord une connexion sftp vers la machine de
saut indiquée par destination, puis en effectuant une redirection TCP vers la destination finale
depuis la machine de saut. Il est possible de spécifier plusieurs sauts successifs en les
séparant par des virgules. Cette option est un raccourci pour définir une directive de
configuration ProxyJump. Cette option est passée directement à ssh(1).

-l limite
Cette option permet de limiter la bande passante utilisée en spécifiant sa valeur maximale en
kbit/s.

-N Désactiver le mode silencieux, par exemple pour outrepasser le mode silencieux implicite défini
par l’option -b.

-o option_ssh
Cette option permet de passer des options à ssh au format utilisé dans ssh_config(5). Elle
s’avère utile pour spécifier des options pour lesquelles il n'y a pas d'option dédiée pour la
ligne de commande de sftp. Par exemple, pour spécifier un port de remplacement : sftp -oPort=24.
Pour plus de détails sur les options énumérées ci-après et leurs valeurs possibles, voir
ssh_config(5).

AddKeysToAgent
AddressFamily
BatchMode
BindAddress
BindInterface
CASignatureAlgorithms
CanonicalDomains
CanonicalizeFallbackLocal
CanonicalizeHostname
CanonicalizeMaxDots
CanonicalizePermittedCNAMEs
CertificateFile
ChannelTimeout
CheckHostIP
Ciphers
ClearAllForwardings
Compression
ConnectTimeout
ConnectionAttempts
ControlMaster
ControlPath
ControlPersist
DynamicForward
EnableEscapeCommandline
EnableSSHKeysign
EscapeChar
ExitOnForwardFailure
FingerprintHash
ForkAfterAuthentication
ForwardAgent
ForwardX11
ForwardX11Timeout
ForwardX11Trusted
GSSAPIAuthentication
GSSAPIDelegateCredentials
GatewayPorts
GlobalKnownHostsFile
HashKnownHosts
Host
HostKeyAlgorithms
HostKeyAlias
HostbasedAcceptedAlgorithms
HostbasedAuthentication
Hostname
IPQoS
IdentitiesOnly
IdentityAgent
IdentityFile
IgnoreUnknown
Include
KbdInteractiveAuthentication
KbdInteractiveDevices
KexAlgorithms
KnownHostsCommand
LocalCommand
LocalForward
LogLevel
LogVerbose
MACs
NoHostAuthenticationForLocalhost
NumberOfPasswordPrompts
ObscureKeystrokeTiming
PKCS11Provider
PasswordAuthentication
PermitLocalCommand
PermitRemoteOpen
Port
PreferredAuthentications
ProxyCommand
ProxyJump
ProxyUseFdpass
PubkeyAcceptedAlgorithms
PubkeyAuthentication
RekeyLimit
RemoteCommand
RemoteForward
RequestTTY
RequiredRSASize
RevokedHostKeys
SecurityKeyProvider
SendEnv
ServerAliveCountMax
ServerAliveInterval
SessionType
SetEnv
StdinNull
StreamLocalBindMask
StreamLocalBindUnlink
StrictHostKeyChecking
SyslogFacility
TCPKeepAlive
Tag
Tunnel
TunnelDevice
UpdateHostKeys
User
UserKnownHostsFile
VerifyHostKeyDNS
VisualHostKey
XAuthLocation

-P port
Cette option permet de spécifier le port auquel se connecter sur l'hôte distant.

-p Préserver les dates de modifications, d'accès et les modes des fichiers transférés.

-q Mode silencieux : la barre de progression ainsi que les messages d’avertissement et de diagnostic
en provenance de ssh(1) sont désactivés.

-R nombre_requêtes
Cette option permet de spécifier le nombre de requêtes pouvant être en attente à un instant
donné. Augmenter ce nombre améliorera légèrement la vitesse de transfert des fichiers, mais
augmentera la consommation de mémoire. La valeur par défaut est de 64 requêtes en attente.

-r Copier récursivement les répertoires complets lors d’un téléversement ou d’un téléchargement.
Notez que sftp ne suit pas les liens symboliques rencontrés lors du parcours de l'arborescence.

-S programme
Cette option permet de spécifier le nom du programme à utiliser pour la connexion chiffrée. Ce
programme doit prendre en charge les options de ssh(1).

-s sous_système | serveur_sftp
Cette option permet de spécifier le sous-sytème SSH2 ou le chemin d'un serveur sftp sur l'hôte
distant. Un tel chemin s’avère utile lorsque que le démon sshd(8) distant n'a pas de sous-système
sftp configuré.

-v Augmenter le niveau de journalisation. Cette option est aussi passée à ssh(1).

-X option_sftp
Cette option permet de spécifier une option qui contrôle certains aspects du comportement du
protocole SFTP. Les options disponibles sont :

nrequests=valeur
Cette option permet de définir le nombre de requêtes SFTP de lecture ou d’écriture qui
peuvent être traitées simultanément au cours d’un téléchargement ou d’un téléversement.
Par défaut, 64 requêtes peuvent être traitées simultanément.

buffer=valeur
Cette option permet de définir la taille maximale du tampon utilisé lors d’un
téléchargement ou d’un téléversement pour une seule opération SFTP de lecture/écriture.
La valeur par défaut est de 32 ko.

COMMANDES INTERACTIVES

En mode interactif, sftp prend en charge un jeu de commandes similaires à celles de ftp(1). Les commandes
sont insensibles à la casse. Les noms des chemins contenant des espaces doivent être entourés de
guillemets droits simples (« ' »). Tout caractère spécial contenu dans un nom de chemin et reconnu par
glob(3) doit être protégé par une barre oblique inverse (« \~»).

bye Quitter sftp.

cd [chemin]
Changer le répertoire distant pour chemin. Si chemin n’est pas spécifié, changer le répertoire
pour celui sous lequel la session a démarré.

chgrp [-h] grp chemin
Changer le groupe du fichier chemin à grp. chemin peut contenir des caractères glob(7) et peut
correspondre à plusieurs fichiers. grp doit être un GID numérique.

Si l’option -h est spécifiée, les liens symboliques ne seront pas suivis. Notez que cette
fonctionnalité n’est prise en charge que par les serveurs qui implémentent l’extension
« lsetstat@openssh.com ».

chmod [-h] mode chemin
Changer les permissions du fichier path à mode. chemin peut contenir des caractères glob(7) et
peut correspondre à plusieurs fichiers.

chown [-h] propriétaire chemin
Changer le propriétaire du fichier chemin à propriétaire. chemin peut contenir des caractères
glob(7) et peut correspondre à plusieurs fichiers. propriétaire doit être un UID numérique.

copy ancien_chemin nouveau_chemin
Copier le fichier distant de ancien_chemin vers nouveau_chemin.

Notez que cette fonctionnalité n’est prise en charge que par les serveurs qui implémentent
l’extension « copy-data ».

cp ancien_chemin nouveau_chemin
Alias de la commande copy.

df [-hi] [chemin]
Afficher les informations d’utilisation du système de fichiers contenant le répertoire actuel (ou
chemin si spécifié). Si l’option -h est spécifiée, les informations d’utilisation seront
affichées avec des suffixes « lisibles par les humains ». Le drapeau -i demande l'affichage des
numéros d'inodes en plus des informations d’utilisation. Cette commande n’est prise en charge que
par les serveurs qui implémentent l'extension « statvfs@openssh.com ».

exit Quitter sftp.

get [-afpR] chemin_distant [chemin_local]
Récupérer l'emplacement chemin_distant et le stocker sur la machine locale. Si le nom
d'emplacement local n'est pas spécifié, il adoptera le même nom que sur l’hôte distant.
chemin_distant peut contenir des caractères glob(7) et peut correspondre à plusieurs fichiers. Si
c'est le cas et si un chemin_local est spécifié, chemin_local doit correspondre à un répertoire.

Si l’option -a est spécifiée, tenter de reprendre les transferts partiels des fichiers existants.
Notez que la reprise suppose que toute copie partielle du fichier local correspond à la copie
distante. Si le contenu du fichier distant diffère de celui de la copie partielle locale, le
fichier résultant sera probablement corrompu.

Si l’option -f est spécifiée, fsync(2) sera appelé après le transfert complet du fichier pour
enregistrer ce dernier sur disque.

Si l’option -p est spécifiée, les permissions complètes du fichier et les heures d'accès seront
aussi conservées.

Si l’option -R est spécifiée, les répertoires seront copiés récursivement. Notez que sftp ne suit
pas les liens symboliques lors de transferts récursifs.

help Afficher le texte de l'aide.

lcd [chemin]
Changer le répertoire local en chemin. Si chemin n’est pas spécifié, changer le répertoire pour
le répertoire personnel de l’utilisateur local.

lls [options_ls [chemin]]
Afficher la liste des fichiers du répertoire local chemin ou du répertoire local actuel si chemin
n'est pas spécifié. options_ls peut contenir n'importe quelle option prise en charge par la
commande ls(1) du système local. chemin peut contenir des caractères glob(7) et peut correspondre
à plusieurs fichiers.

lmkdir chemin
Créer le répertoire local spécifié par chemin.

ln [-s] ancien_chemin nouveau_chemin
Créer un lien de ancien_chemin à nouveau_chemin. Si l’option -s est spécifiée, le lien créé sera
un lien symbolique, sinon ce sera un lien physique.

lpwd Afficher le répertoire de travail local.

ls [-1afhlnrSt] [chemin]
Afficher la liste des fichiers du répertoire distant chemin ou du répertoire actuel si chemin
n'est pas spécifié. chemin peut contenir des caractères glob(7) et peut correspondre à plusieurs
fichiers.

Les options suivantes sont reconnues et modifient le comportement de ls en conséquence :

-1 Produire une sortie sur une seule colonne.

-a Lister les fichiers dont le nom commence par un point « . ».

-f Ne pas trier la liste. L’ordre de tri par défaut est lexicographique.

-h Avec l'option de format long, utiliser les suffixes d'unité : Octet, Kilooctet,
Megaoctet, Gigaoctet, Teraoctet, Petaoctet et Exaoctet pour réduire le nombre de chiffres
à quatre ou moins à l'aide de puissances de 2 pour les tailles (K=1024, M=1048576, etc.).

-l Afficher des informations supplémentaires dont les permissions et le propriétaire.

-n Produire une longue liste avec les informations sur le propriétaire et le groupe
présentées de manière numérique.

-r Inverser l'ordre de tri de la liste.

-S Trier la liste par taille de fichier.

-t Trier la liste par date de dernière modification.

lumask umask
Définir l'umask (mode de création de fichier) local à umask.

mkdir chemin
Créer le répertoire distant spécifié par chemin.

progress
Activer l'affichage de la barre de progression.

put [-afpR] chemin_local [chemin_distant]
Téléverser l'emplacement chemin_local et le stocker sur l’hôte distant. Si le chemin distant
n'est pas spécifié, il adoptera le même nom que sur la machine locale. chemin_local peut contenir
des caractères glob(7) et peut correspondre à plusieurs fichiers. Si c'est le cas et si un
chemin_distant est spécifié, ce dernier doit correspondre à un répertoire.

Si l’option -a est spécifiée, tenter de reprendre les transferts partiels des fichiers existants.
Notez que la reprise suppose que toute copie partielle du fichier distant correspond à la copie
locale. Si le contenu du fichier local diffère de celui de la copie partielle distante, le
fichier résultant sera probablement corrompu.

Si l’option -f est spécifiée, il sera demandé au serveur d’appeler fsync(2) une fois le transfert
du fichier terminé. Notez que cette fonctionnalité n’est prise en charge que par les serveurs qui
implémentent l’extension « fsync@openssh.com ».

Si l’option -p est spécifiée, les permissions complètes du fichier et les heures d'accès seront
aussi conservées.

Si l’option -R est spécifiée, les répertoires seront copiés récursivement. Notez que sftp ne suit
pas les liens symboliques lors de transferts récursifs.

pwd Affiche le répertoire de travail distant.

quit Quitter sftp.

reget [-fpR] chemin_distant [chemin_local]
Reprendre le téléchargement de chemin_distant. Équivalent à get avec le drapeau -a défini.

reput [-fpR] chemin_local [chemin_distant]
Reprendre le téléversement de chemin_local. Équivalent à put avec le drapeau -a défini.

rename ancien_chemin nouveau_chemin
Renommer le fichier distant ancien_chemin en nouveau_chemin.

rm chemin
Supprimer le fichier distant spécifié par l'emplacement chemin.

rmdir chemin
Supprimer le répertoire distant spécifié par l'emplacement chemin.

symlink ancien_chemin nouveau_chemin
Créer un lien symbolique de ancien_chemin vers nouveau_chemin.

version
Afficher la version du protocole de .

!commande
Exécuter la commande dans l’interpréteur de commande local.

! Basculer dans l’interpréteur de commande local.

? Synonyme pour aide.

VOIR AUSSI

       ftp(1), ls(1), scp(1), ssh(1), ssh-add(1), ssh-keygen(1), ssh_config(5), glob(7), sftp-server(8), sshd(8)
       T. Ylonen and S. Lehtinen, « SSH  File  Transfer  Protocol »,  draft-ietf-secsh-filexfer-00.txt,  janvier
       2001, travail en cours.

TRADUCTION

       La  traduction  française  de  cette  page  de  manuel a été créée par Lucien Gentis <lucien.gentis@univ-
       lorraine.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter à la  GNU  General  Public  License
       version   3:   https://www.gnu.org/licenses/gpl-3.0.html   concernant  les  conditions  de  copie  et  de
       distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si vous découvrez un bogue dans la traduction de cette page de manuel,  veuillez  envoyer  un  message  à
       debian-l10n-french@lists.debian.org .

Debian                                          6 décembre, 2024                                         SFTP(1)