.\" -*- coding: UTF-8 -*- .\" $OpenBSD: sftp.1,v 1.144 2024/12/06 15:12:56 djm Exp $ .\" .\" Copyright (c) 2001 Damien Miller. All rights reserved. .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .Dd $Mdocdate: 6 de Diciembre 2024 $ .Dt SFTP 1 .Os .Sh NOMBRE .Nm sftp .Nd OpenSSH Transferencia segura de archivos .Sh SINOPSIS .Nm sftp .Op Fl 46AaCfNpqrv .Op Fl B Ar tamaño de búfer .Op Fl b Ar archivo_por_lotes .Op Fl c Ar cifrado .Op Fl D Ar orden_de_servidor_sftp .Op Fl F Ar configuración_ssh .Op Fl i Ar archivo_de_identidad .Op Fl J Ar destino .Op Fl l Ar límite .Op Fl o Ar opción_de_ssh .Op Fl P Ar puerto .Op Fl R Ar número_solicitudes .Op Fl S Ar programa .Op Fl s Ar subsistema | servidor_sftp .Op Fl X Ar opción_sftp .Ar destino .Sh DESCRIPCIÓN .Nm sftp es un programa de transferencia de archivos, similar a .Xr ftp 1 , que realiza todas sus operaciones mediante un transporte cifrado .Xr ssh 1 . También puede utilizar muchas funciones de ssh, como la autenticación de clave pública y la compresión. .Pp El .Ar destino puede definirse como .Sm off .Oo usuario @ Oc equipo Op : ruta .Sm on o como una URI con el formato .Sm off .No sftp:// Oo usuario @ Oc equipo Oo : puerto Oc Op / ruta . .Sm on .Pp Si el .Ar destino incluye una .Ar ruta y no es un directorio, .Nm sftp recuperará automáticamente los achivos si se utiliza un método de autenticación no interactivo, sino lo hará tras una autenticación interactiva exitosa. .Pp Si no se especifica ninguna .Ar ruta , o si ésta es un directorio, .Nm sftp iniciará sesión en el equipo .Ar especificado y entrará en el modo de ordenes interactivas, cambiando al directorio remoto si se indicó uno. Se puede usar una barra diagonal final opcional para que .Ar se interprete como un directorio. .Pp Dado que los formatos de destino utilizan dos puntos para separar los nombres de eqipo de las rutas o los números de puerto, las direcciones IPv6 deberán ir entre corchetes para evitar ambigüedades. .Pp Las opciones son las siguientes: .Bl -tag -width Ds .It Fl 4 Fuerza a .Nm sftp a usar solo direcciones IPv4. .It Fl 6 Fuerza a .Nm sftp a usar solo direcciones IPv6. .It Fl A Permite el reenvío de .Xr ssh-agent 1 al sistema remoto. El valor predeterminado es no reenviar un agente de autenticación. .It Fl a Intenta continuar las transferencias interrumpidas en lugar de sobrescribir copias parciales o completas de los archivos. Si el contenido parcial difiere del que se transfiere, es probable que el archivo resultante esté dañado. .It Fl B Ar buffer_size Define el tamaño del búfer que utiliza .Nm sftp al transferir archivos. Los búferes más grandes requieren menos recorridos de ida y vuelta, pero consumen más memoria. El valor predeterminado es de 32768 bytes. .It Fl b Ar archivo_por_lotes El modo por lotes lee una serie de órdenes desde un archivo de entrada .Ar archivo_por_lotes en lugar de por la .Em entrada estándar . Dado que no requiere interacción del usuario, debe usarse junto con la autenticación no interactiva para evitar la necesidad de introducir una contraseña al conectarse (consulte .Xr sshd 8 y .Xr ssh-keygen 1 ) . .Pp Se puede usar un archivo de entrada .Ar archivo_por_lotes de .Sq \- para indicar la entrada estándar. .Nm sftp se cancelará si falla alguna de las siguientes órdenes: .Ic get, put, reget, reput, rename, ln , .Ic rm, mkdir, chdir, ls , .Ic lchdir, copy, cp, chmod, chown , .Ic chgrp, lpwd, df, symlink y .Ic lmkdir . .Pp La terminación por error se puede suprimir orden a orden prefijándolas con un carácter .Sq \- (por ejemplo, .Ic -rm /tmp/blah* ) . El eco de la orden se puede suprimir prefijándola con un carácter .Sq @ . Estos dos prefijos pueden combinarse en cualquier orden, por ejemplo, .Ic -@ls /bsd . .It Fl C Habilita la compresión (mediante el indicador .Fl C de ssh). .It Fl c Ar cipher Selecciona el cifrado para las transferencias de datos. Esta opción se pasa directamente a .Xr ssh 1 . .It Fl D Ar orden_servidor_sftp Conecta directamente a un servidor SFTP local (en lugar de hacerlo a través de .Xr ssh 1 ) . Se puede definir una orden y argumentos, por ejemplo, .Qq /ruta/servidor-sftp -el debug3 . Esta opción puede ser útil para depurar el cliente y el servidor. .It Fl F Ar configuración_ssh Define un archivo de configuración alternativo por usuario para .Xr ssh 1 . Esta opción se pasa directamente a .Xr ssh 1 . .It Fl f Solicita que los archivos se vuelquen inmediatamente en el disco después de la transferencia. Al subir archivos, esta función solo se habilita si el servidor implementa la extensión «fsync@openssh.com». .It Fl i Ar archivo_de_identidad Selecciona el archivo desde el que se lee la identidad (clave privada) para la autenticación de clave pública. Esta opción se pasa directamente a .Xr ssh 1 . .It Fl J Ar destino Se conecta al equipo de destino estableciendo primero una conexión .Nm sftp con el equipo de intermedio descrito por .Ar destino y, a continuación, se establece un reenvío TCP al destino final desde allí. Se pueden especificar varios intermedios separados por comas. Este es un atajo para especificar una directiva de configuración .Cm ProxyJump . Esta opción se pasa directamente a .Xr ssh 1 . .It Fl l Ar limite Limita el ancho de banda utilizado, especificado en kbit/s. .It Fl N Desactiva el modo silencioso, por ejemplo, para anular el modo silencioso implícito establecido por el indicador .Fl b . .It Fl o Ar ssh_option Se puede usar para pasar opciones a .Nm ssh en el formato utilizado en .Xr ssh_config 5 . Suele usarse para especificar opciones que no tienen una línea de órdenes .Nm sftp independiente. Por ejemplo, para especificar un puerto alternativo, utilice: .Ic sftp -oPort=24 . Para obtener más información sobre las opciones que se enumeran a continuación y sus posibles valores, consulte .Xr ssh_config 5 . .Pp .Bl -tag -width Ds -offset indent -compact .It AddKeysToAgent .It AddressFamily .It BatchMode .It BindAddress .It BindInterface .It CASignatureAlgorithms .It CanonicalDomains .It CanonicalizeFallbackLocal .It CanonicalizeHostname .It CanonicalizeMaxDots .It CanonicalizePermittedCNAMEs .It CertificateFile .It ChannelTimeout .It CheckHostIP .It Ciphers .It ClearAllForwardings .It Compresión .It ConnectTimeout .It ConnectionAttempts .It ControlMaster .It ControlPath .It ControlPersist .It DynamicForward .It EnableEscapeCommandline .It EnableSSHKeysign .It EscapeChar .It ExitOnForwardFailure .It FingerprintHash .It ForkAfterAuthentication .It ForwardAgent .It ForwardX11 .It ForwardX11Timeout .It ForwardX11Trusted .It GSSAPIAuthentication .It GSSAPIDelegateCredentials .It GatewayPorts .It GlobalKnownHostsFile .It HashKnownHosts .It Host .It HostKeyAlgorithms .It HostKeyAlias .It HostbasedAcceptedAlgorithms .It HostbasedAuthentication .It Hostname .It IPQoS .It IdentitiesOnly .It IdentityAgent .It IdentityFile .It IgnoreUnknown .It Include .It KbdInteractiveAuthentication .It KbdInteractiveDevices .It KexAlgorithms .It KnownHostsCommand .It LocalCommand .It LocalForward .It LogLevel .It LogVerbose .It MACs .It NoHostAuthenticationForLocalhost .It NumberOfPasswordPrompts .It ObscureKeystrokeTiming .It PKCS11Provider .It PasswordAuthentication .It PermitLocalCommand .It PermitRemoteOpen .It Port .It PreferredAuthentications .It ProxyCommand .It ProxyJump .It ProxyUseFdpass .It PubkeyAcceptedAlgorithms .It PubkeyAuthentication .It RekeyLimit .It RemoteCommand .It RemoteForward .It RequestTTY .It RequiredRSASize .It RevokedHostKeys .It SecurityKeyProvider .It SendEnv .It ServerAliveCountMax .It ServerAliveInterval .It SessionType .It SetEnv .It StdinNull .It StreamLocalBindMask .It StreamLocalBindUnlink .It StrictHostKeyChecking .It SyslogFacility .It TCPKeepAlive .It Tag .It Tunnel .It TunnelDevice .It UpdateHostKeys .It User .It UserKnownHostsFile .It VerifyHostKeyDNS .It VisualHostKey .It XAuthLocation .El .It Fl P Ar puerto Define el puerto al que conectarse en el equipo remoto. .It Fl p Conserva las horas de modificación, las horas de acceso y los modos de los archivos originales antes de ser transferidos. .It Fl q Modo silencioso: desactiva el indicador de progreso, los mensajes de advertencia y de diagnóstico de .Xr ssh 1 . .It Fl R Ar num_solicitudes Define cuántas solicitudes pueden estar pendientes simultáneamente. Incrementar este valor puede mejorar ligeramente la velocidad de transferencia de archivos, pero también el uso de memoria. El valor predeterminado es de 64 solicitudes pendientes. .It Fl r Copia recursivamente directorios completos al cargar y descargar. Tenga en cuenta que .Nm sftp no seguirá los enlaces simbólicos encontrados al recorrer los directorios. .It Fl S Ar programa Nombre del programa .Ar que se utilizará para la conexión cifrada. El programa debe tener soporte para las opciones de .Xr ssh 1 . .It Fl s Ar subsistema | servidor_sftp Define el subsistema SSH2 o la ruta de un servidor SFTP en el equipo remoto. Una ruta será útil si el .Xr sshd 8 remoto no tiene un subsistema SFTP configurado. .It Fl v Aumentar el nivel de registro. Esta opción también se pasa a ssh. .It Fl X Ar opción_sftp Define una opción para controlar aspectos del comportamiento del protocolo SFTP. Las opciones válidas son: .Bl -tag -width Ds .It Cm nrequests Ns = Ns Ar value Define cuántas solicitudes de lectura o escritura SFTP simultáneas pueden estar en curso en cualquier momento durante una subida o bajada. De forma predeterminada, se pueden activar 64 solicitudes simultáneamente. .It Cm buffer Ns = Ns Ar value Define el tamaño máximo del búfer para una sola operación de lectura/escritura SFTP utilizada durante la subida o bajada. De forma predeterminada, se utiliza un búfer de 32 KB. .El .El .Sh ÓRDENES INTERACTIVAS En modo interactivo, .Nm sftp puede interpretar un conjunto similar de órdenes a .Xr ftp 1 . Las órdenes no distinguen entre mayúsculas y minúsculas. Las rutas de acceso que contienen espacios deben ir entre comillas. Cualquier carácter especial contenido en las rutas de acceso reconocidas por .Xr glob 3 debe escaparse con barras invertidas .Pq Sq \e . .Bl -tag -width Ds .It Ic bye Sale de .Nm sftp . .It Ic cd Op Ar path Cambia el directorio remoto a .Ar ruta . Si no se especifica nada, se cambia al directorio donde se inició la sesión. .It Xo Ic chgrp .Op Fl h .Ar grupo .Ar ruta .Xc Cambia el grupo del archivo .Ar ruta a .Ar grupo . .Ar ruta puede contener caracteres .Xr glob 7 y puede concordar con varios archivos. .Ar grupo debe ser un GID numérico. .Pp Si se especifica el indicador .Fl h , no se seguirán los enlaces simbólicos. Tenga en cuenta que esto solo es compatible con servidores que implementan la extensión «lsetstat@openssh.com». .It Xo Ic chmod .Op Fl h .Ar modo .Ar ruta .Xc Cambia los permisos del archivo .Ar ruta a .Ar modo . .Ar ruta puede contener caracteres .Xr glob 7 y puede concordar con varios archivos. .Pp Si se especifica el indicador .Fl h , no se seguirán los enlaces simbólicos. Tenga en cuenta que esto solo es compatible con servidores que implementan la extensión «lsetstat@openssh.com». .It Xo Ic chown .Op Fl h .Ar dueño .Ar ruta .Xc Cambia el propietario del archivo .Ar ruta a .Ar dueño . .Ar ruta puede contener caracteres .Xr glob 7 y puede coincidir con varios archivos. .Ar dueño debe ser un UID numérico. .Pp Si se especifica el indicador .Fl h , no se seguirán los enlaces simbólicos. Tenga en cuenta que esto solo es compatible con servidores que implementan la extensión «lsetstat@openssh.com». .It Ic copy Ar antigua_ruta Ar nueva_ruta Copia el archivo remoto de .Ar antigua_ruta a .Ar nueva_ruta . .Pp Esto solo es compatible con servidores que implementan la extensión «copy-data». .It Ic cp Ar antigua_ruta Ar nueva_ruta Alias de la orden .Ic copy . .It Xo Ic df .Op Fl hi .Op Ar ruta .Xc Muestra información de uso del sistema de archivos que contiene el directorio actual (o .Ar ruta si se definió). Si se especifica el indicador .Fl h , la información de capacidad se mostrará mediante sufijos «humanamente legibles». El indicador .Fl i solicita que se muestre información del inodo además de la información de capacidad. Esta orden solo es compatible con servidores que implementan la extensión .Dq statvfs@openssh.com . .It Ic exit Sale de .Nm sftp . .It Xo Ic get .Op Fl afpR .Ar ruta-remota .Op Ar ruta-local .Xc Recupera la .Ar ruta-remota y la guarda en el equipo local. Si no se especifica el nombre de la ruta local, se le asignará el mismo nombre que en el equipo remoto. .Ar ruta-remota puede contener caracteres .Xr glob 7 y puede concordar con varios archivos. Si los contiene y se especifica .Ar ruta-local , ésta última deberá definir un directorio. .Pp Si se define el indicador .Fl a , se intentará reanudar las transferencias parciales de los archivos existentes. La reanudación asume que cualquier copia parcial del archivo local coincide con la copia remota. Si el contenido del archivo remoto difiere del de la copia local parcial, es probable que el archivo resultante esté corrupto. .Pp Si se especifica el indicador .Fl f , se llamará a .Xr fsync 2 una vez completada la transferencia del archivo para volcarlo al disco. .Pp .\" undocumented redundant alias .\" or .\" .Fl P Si se define el indicador .Fl p , también se copiarán todos los permisos del archivo y los tiempos de acceso. .Pp .\" undocumented redundant alias .\" or .\" .Fl r Si se especifica el indicador .Fl R , los directorios se copiarán recursivamente. .Nm sftp no sigue enlaces simbólicos cuando realiza transferencias recursivas. .It Ic help Muestra un texto de ayuda. .It Ic lcd Op Ar ruta Cambiar el directorio local a .Ar ruta . Si no se especifica .Ar ruta , cambiar al directorio personal del usuario local. .It Ic lls Op Ar opciones-ls Op Ar ruta Muestra la lista de directorios locales de .Ar ruta o del directorio actual si no se especifica .Ar ruta . .Ar opciones-ls puede contener cualquier indicador compatible con la orden .Xr ls 1 del sistema local. .Ar ruta puede contener caracteres .Xr glob 7 y concordar con varios archivos. .It Ic lmkdir Ar ruta Crea el directorio local definido por .Ar ruta . .It Xo Ic ln .Op Fl s .Ar antigua_ruta .Ar nueva_ruta .Xc Crea un enlace de .Ar antigua_ruta a .Ar nueva_ruta . Si se define el indicador .Fl s , el enlace creado es simbólico, sino será físico. .It Ic lpwd Muestra el directorio de trabajo local. .It Xo Ic ls .Op Fl 1afhlnrSt .Op Ar ruta .Xc Muestra un listado de directorios remotos de .Ar ruta o del directorio actual si no se especifica. .Ar ruta puede contener caracteres .Xr glob 7 y concordar con varios archivos. .Pp Se reconocen los siguientes indicadores para modificar el comportamiento de .Ic ls : .Bl -tag -width Ds .It Fl 1 Produce una salida de una sola columna. .It Fl a Lista los archivos que empiezan por un punto .Pq Sq \&. . .It Fl f No ordena el listado. El orden de clasificación predeterminado es lexicográfico. .It Fl h Al usar una opción de formato largo, emplea sufijos de unidad: byte, kilobyte, megabyte, gigabyte, terabyte, petabyte y exabyte para reducir el número de dígitos a cuatro o menos mediante potencias de 2 para los tamaños (K=1024, M=1048576, etc.). .It Fl l Muestra detalles adicionales, incluyendo permisos e información de propiedad. .It Fl n Genera un listado amplio con información de usuarios y grupos presentada numéricamente. .It Fl r Invierte el orden de clasificación de la lista. .It Fl S Ordena la lista en base al tamaño de archivo. .It Fl t Ordena la lista por fecha en base a la última modificación. .El .It Ic lumask Ar umask Define la umask local en .Ar umask . .It Ic mkdir Ar path Crea el directorio remoto definido por .Ar ruta . .It Ic progress Activa o desactiva la visualización del indicador de progreso. .It Xo Ic put .Op Fl afpR .Ar ruta-local .Op Ar ruta-remota .Xc Carga .Ar ruta-local y lo guarda en el equipo remoto. Si no se especifica el nombre de la ruta remota, se le asigna el mismo nombre que tiene en el equipo local. .Ar ruta-local puede contener caracteres .Xr glob 7 y puede concordar con varios archivos. Si los contiene y se define .Ar ruta-remota , entonces .Ar ruta-remota debe ser un directorio. .Pp Si se define el indicador .Fl a , se intentarán reanudar las transferencias parciales de los archivos existentes. Tenga en cuenta que la reanudación asume que cualquier copia parcial del archivo remoto coincide con la copia local. Si el contenido del archivo local difiere del de la copia local remota, es probable que el archivo resultante esté corrupto. .Pp Si se indica el indicador .Fl f , se enviará una solicitud al servidor para llamar a .Xr fsync 2 después de la transferencia del archivo. Tenga en cuenta que esto solo es compatible con servidores que implementan la extensión «fsync@openssh.com». .Pp .\" undocumented redundant alias .\" or .\" .Fl P Si se define el indicador .Fl p , también se copiarán todos los permisos del archivo y los tiempos de acceso. .Pp .\" undocumented redundant alias .\" or .\" .Fl r Si se especifica el indicador .Fl R , los directorios se copiarán recursivamente. .Nm sftp no sigue enlaces simbólicos cuando realiza transferencias recursivas. .It Ic pwd Muestra el directorio de trabajo remoto. .It Ic quit Sale de .Nm sftp . .It Xo Ic reget .Op Fl fpR .Ar ruta-remota .Op Ar ruta-local .Xc Reanudar la descarga de .Ar ruta-remota . Equivalente a .Ic get con el indicador .Fl a activado. .It Xo Ic reput .Op Fl fpR .Ar ruta-local .Op Ar ruta-remota .Xc Reanudar la carga de .Ar ruta-local . Equivalente a .Ic put con el indicador .Fl a activado. .It Ic rename Ar ruta-antigua ruta-nueva Cambiar el nombre del archivo remoto de .Ar ruta-antigua a .Ar ruta-nueva . .It Ic rm Ar path Eliminar el archivo remoto definido en .Ar ruta . .It Ic rmdir Ar path Eliminar el directorio remoto especificado por .Ar ruta . .It Ic symlink Ar oldpath newpath Crear un enlace simbólico de .Ar antigua_ruta a .Ar nueva_ruta . .It Ic version Muestra la versión del protocolo .Nm . .It Orden Ic \&! Ns Ar Ejecuta .Ar orden en la shell local. .It Ic \&! Escapar a la shell local. .It Ic \&? Sinónimo de ayuda. .El .Sh VÉASE TAMBIÉN .Xr ftp 1 , .Xr ls 1 , .Xr scp 1 , .Xr ssh 1 , .Xr ssh-add 1 , .Xr ssh-keygen 1 , .Xr ssh_config 5 , .Xr glob 7 , .Xr sftp-server 8 , .Xr sshd 8 .Rs .%A T. Ylonen .%A S. Lehtinen .%T "SSH File Transfer Protocol" .%N draft-ietf-secsh-filexfer-00.txt .%D January 2001 .%O work in progress material .Re .Pp .Sh TRADUCCIÓN La traducción al español de esta página del manual fue creada por Marcos Fouces . .Pp Esta traducción es documentación libre; lea la .Lk https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 o posterior con respecto a las condiciones de copyright. No existe NINGUNA RESPONSABILIDAD. .Pp Si encuentra algún error en la traducción de esta página del manual, envíe un correo electrónico a .Mt debian-l10n-spanish@lists.debian.org .Me .