Comandos FTP: referência do cliente e do protocolo
Todos os comandos de FTP em um lugar só – os comandos do cliente de linha de comando que você digita no ftp.exe do Windows, no macOS ou no Linux (get, put, mget, bye), e os comandos crus do protocolo, da RFC 959, nos quais eles se traduzem na rede.
Atualizado em julho de 2026
Comandos do cliente FTP de linha de comando
Estes comandos funcionam nos clientes FTP interativos embutidos no Windows (ftp.exe), no macOS e no Linux. Comece uma sessão com ftp servidor (ou open servidor a partir do prompt ftp>) e então use os comandos abaixo. Para um passo a passo completo no Windows, com automação, veja o guia FTP pela linha de comando no Windows.
Sessão e conexão
| Comando | O que ele faz | Exemplo |
|---|---|---|
open | Conecta a um servidor FTP (pede usuário e senha). | open ftp.example.com |
user | Entra de novo, ou como outro usuário, na conexão aberta. | user alice |
close / disconnect | Encerra a conexão com o servidor, mas continua no programa de FTP. | close |
bye / quit | Fecha a conexão e sai do programa de FTP. | bye |
status | Mostra as configurações atuais da sessão (modo, tipo, opções). | status |
! | Cai no terminal local; digite exit para voltar ao ftp>. | !dir |
Baixando e enviando
| Comando | O que ele faz | Exemplo |
|---|---|---|
get / recv | Baixa um arquivo do servidor. | get report.pdf |
put / send | Envia um arquivo para o servidor. | put backup.zip |
mget | Baixa vários arquivos (curingas permitidos). | mget *.log |
mput | Envia vários arquivos (curingas permitidos). | mput *.html |
append | Acrescenta um arquivo local ao fim de um arquivo no servidor. | append part2.txt log.txt |
delete | Apaga um arquivo no servidor. | delete old.bak |
mdelete | Apaga vários arquivos no servidor (curingas permitidos). | mdelete *.tmp |
rename | Renomeia um arquivo no servidor. | rename a.txt b.txt |
Navegando pelos diretórios
| Comando | O que ele faz | Exemplo |
|---|---|---|
dir / ls | Lista os arquivos do diretório remoto atual. | dir |
cd | Muda o diretório remoto. | cd /public_html |
lcd | Muda o diretório local usado nas transferências. | lcd C:\Downloads |
pwd | Mostra o diretório remoto atual. | pwd |
mkdir | Cria um diretório no servidor. | mkdir images |
rmdir | Remove um diretório vazio no servidor. | rmdir old-site |
Configurações e opções de transferência
| Comando | O que ele faz | Exemplo |
|---|---|---|
binary | Muda para o modo binário (imagem) – use para zip, imagens, executáveis e mídia. Defina sempre este modo antes de baixar arquivos que não sejam texto. | binary |
ascii | Muda para o modo de texto ASCII (com conversão de fim de linha). É o padrão em muitos clientes. | ascii |
prompt | Liga e desliga a confirmação por arquivo em mget/mput/mdelete. | prompt |
hash | Mostra um # a cada bloco transferido – uma barra de progresso improvisada. | hash |
verbose | Liga e desliga a exibição das respostas do servidor. | verbose |
literal / quote | Envia um comando cru do protocolo (veja a tabela abaixo) direto para o servidor. | literal SYST |
remotehelp | Pergunta ao servidor quais comandos de protocolo ele suporta. | remotehelp |
help / ? | Lista os comandos do cliente, ou explica um deles. | help mget |
Uma sessão típica
C:\> ftp ftp.example.com Connected to ftp.example.com. User: alice Password: ******** ftp> binary 200 Type set to I. ftp> cd /backups 250 CWD command successful. ftp> hash Hash mark printing On. ftp> get site-backup.zip 226 Transfer complete. ftp> mput *.log mput access.log? y 226 Transfer complete. ftp> bye 221 Goodbye.
Trabalhando por SSH? O cliente sftp do OpenSSH usa um conjunto de comandos parecido, mas distinto – veja a referência de comandos SFTP. E se o servidor se recusa a conectar, descarte antes os problemas de rede com o testador de conexão FTP.
Comandos crus do protocolo FTP (RFC 959)
Estes são os comandos que os clientes FTP realmente enviam pela conexão de controle – úteis para ler registros do servidor, depurar com literal/quote ou implementar FTP você mesmo. Busque ou filtre por categoria.
Sobre os comandos de FTP
Os comandos do protocolo FTP são enviados pelo cliente ao servidor pela conexão de controle (a porta 21, por padrão). O servidor responde com um código de status de 3 dígitos. O protocolo principal é definido na RFC 959, com extensões definidas nas RFCs 2228, 2389, 2640, 3659 e 4217.
Procurando o que significam os códigos de resposta do servidor? Use a ferramenta de consulta de códigos de resposta FTP.
Perguntas frequentes
Vem. O clássico cliente FTP de linha de comando acompanha o Windows 11 e o Windows 10 – abra o Prompt de Comando ou o PowerShell e digite ftp para iniciá-lo. Ele suporta apenas FTP puro, então não consegue se conectar a servidores SFTP ou FTPS.
O ftp.exe do Windows só suporta o modo ativo, em que o servidor se conecta de volta ao seu PC a cada transferência de dados. A maioria dos roteadores domésticos e dos firewalls corporativos bloqueia essas conexões de entrada, então as listagens de diretório e as transferências travam depois do login. Clientes que suportam o modo passivo (PASV) – ou seja, praticamente todo cliente FTP com interface gráfica – não têm esse problema.
Comandos de cliente como get, put, mget e bye são o que você digita em um programa de FTP de linha de comando. O programa os traduz em comandos crus de protocolo (RETR, STOR, PASV, QUIT), definidos pela RFC 959, que são os que realmente viajam pela rede até o servidor. Por exemplo, digitar get report.pdf envia TYPE I, PASV ou PORT, e RETR report.pdf nos bastidores.
Não. O ftp.exe do Windows fala apenas FTP puro, sem criptografia. Para SFTP você precisa do comando sftp do OpenSSH (também embutido no Windows 10 e 11) ou de um cliente que o suporte. Para FTPS (FTP sobre TLS) você precisa de um cliente com suporte a TLS explícito ou implícito – o ftp.exe não tem nenhum dos dois.
Coloque um comando por linha em um arquivo de texto e rode ftp -s:comandos.txt servidor. O arquivo normalmente começa com o usuário e a senha em linhas separadas, seguidos de comandos de transferência como binary, get ou put, e bye. Note que a senha fica guardada em texto puro e a conexão não é criptografada, então tarefas agendadas ou sem supervisão são mais bem atendidas por uma ferramenta com suporte a SFTP/FTPS e um agendador de verdade.
Prefere não decorar comandos?
O FTPie é um cliente FTP e FTPS moderno para Windows, com transferências por arrastar e soltar, modo passivo que simplesmente funciona através de firewalls, e SFTP, WebDAV e mais de 10 serviços de nuvem no mesmo programa – gratuito para até 3 conexões com servidores.
Download FTPie Free