Ecrã branco. O painel de administração não carrega. O plugin que acabou de ativar deitou o site abaixo. E o suporte de alojamento responde a cada três horas. Parece-lhe familiar?

O FTP em momentos como estes é o único canal através do qual pode aceder aos ficheiros do seu site e trazê-lo de volta à vida. O problema é que os proprietários de sites WordPress raramente acedem ao servidor via FTP em tempos de paz. Quando o desastre acontece, é tudo em pânico e a pesquisar «como ligar por FTP» em três separadores.

Na realidade, ligar é mais fácil do que configurar o email no telemóvel. Cinco minutos e está dentro do sistema de ficheiros do servidor com controlo total sobre cada pasta e cada ficheiro php. Nada de pânico: aqui está o algoritmo desde a instalação do cliente até ao envio de ficheiros e recuperação de emergência.

💡 Visão geral rápida:

• Instale o FileZilla (um cliente FTP gratuito para Windows, macOS e Linux) ou abra o Gestor de Ficheiros integrado no painel de alojamento se precisar de uma operação pontual.
• Crie uma conta FTP no cPanel (ou equivalente): utilizador, palavra-passe, associação de diretório. Os detalhes de ligação aparecem imediatamente após a criação.
• Ligue-se ao servidor: anfitrião (domínio ou IP), porta 22 para SFTP. Encontre a pasta public_html (a raiz do WordPress) e arraste os ficheiros entre o seu computador e o servidor.
• Se um ficheiro multimédia enviado via FTP não aparecer na biblioteca do WordPress, registe-o através do plugin Media Sync ou Add From Server Reloaded. O simples envio de um ficheiro para a pasta de uploads não o adiciona à base de dados.

Porque é que os proprietários de sites WordPress precisam de FTP

FTP (File Transfer Protocol) é um protocolo de rede para transferir ficheiros entre um computador e um servidor. Surgiu muito antes do WordPress: a RFC 959, que descreve a especificação FTP, foi lançada em 1985. Hoje o protocolo tem mais de 40 anos, mas ainda está integrado em todos os serviços de alojamento e painéis de controlo como um transporte básico.

Quatro cenários onde o FTP é indispensável:

• Ecrã branco da morte (WSOD). Ativou um plugin ou tema e o site deixou de abrir, juntamente com o painel de administração. Ligue-se via FTP a /wp-content/plugins/, renomeie a pasta da extensão problemática e o site volta à vida em segundos.
• Edição de wp-config.php e.htaccess. Um erro nestes ficheiros faz o site cair sem acesso ao painel de administração. O FTP é a única forma de os corrigir diretamente.
• Envio de ficheiros grandes. O carregador web do WordPress atinge um limite de 2 a 8 MB (dependendo do alojamento). O FTP permite transferir ficheiros de qualquer tamanho.
• Instalação manual do core, temas e plugins. Carregue o WordPress, um tema ou plugin diretamente, contornando o painel de administração (por exemplo, quando o instalador integrado não consegue lidar com o tamanho do arquivo zip).

Nota importante: antes de qualquer operação via FTP, faça uma cópia de segurança do seu site. Se algo correr mal, pode reverter as alterações em poucos cliques.

Como escolher um cliente FTP

Para se ligar a um servidor, precisa de um programa chamado cliente FTP. Para Windows, macOS e Linux, existem opções, e a maioria é gratuita.

Para 99% das tarefas, o FileZilla é suficiente. É gratuito, funciona em todos os sistemas e tem uma curva de aprendizagem mínima. Descarregue apenas do site oficial; os reempacotadores de terceiros incluem frequentemente adware.

Uma alternativa sem instalação é o Gestor de Ficheiros no cPanel (ou o seu equivalente no seu painel de alojamento: hPanel, ISPmanager, DirectAdmin). Já está no servidor, abre no navegador e é suficiente para envios pontuais de ficheiros.

Passo 1. Criar uma conta FTP

Aceda ao painel de controlo do seu alojamento. Encontre a secção «Contas FTP». Clique em «Criar» e o sistema pedirá três coisas:

• Nome de utilizador. Invente um nome, por exemplo mysite_admin. Passará a fazer parte do endereço: [email protected].
• Palavra-passe. Gere uma forte (mais de 20 caracteres) e guarde-a num gestor de palavras-passe. Não use admin123; as contas FTP são alvo regular de ataques de força bruta.
• Diretório. Normalmente /public_html (a raiz do site). Se deixar o campo vazio, a conta terá acesso a todo o sistema de ficheiros da conta; por segurança, é melhor limitá-la a uma pasta específica.

Após a criação, verá os detalhes de ligação: anfitrião, utilizador, porta. Copie-os.

O anfitrião é geralmente o seu domínio (por exemplo, ftp.yoursite.com) ou o endereço IP do servidor. Se o seu alojamento enviou um e-mail de boas-vindas, os detalhes FTP costumam estar listados lá.

Passo 2. Ligar via FileZilla

Abra o FileZilla e preencha os campos no painel superior:

• Anfitrião: ftp.yoursite.com (ou o endereço IP do servidor)
• Nome de utilizador: utilizador do passo 1
• Palavra-passe: palavra-passe do passo 1
• Porta: 21 para FTP, 22 para SFTP (fortemente recomendado)

Clique em «Ligação rápida». Os registos começarão a aparecer na janela de estado, na parte inferior; a última linha deverá ser Status: Directory listing of "/" successful. Está ligado.

A interface do FileZilla está dividida em duas metades: o lado esquerdo mostra os ficheiros do seu computador, o lado direito mostra o sistema de ficheiros do servidor. À direita, encontre a pasta public_html (em alguns alojamentos chama-se www ou htdocs); esta é a raiz do site WordPress. Aqui encontrará o wp-config.php e três pastas principais: wp-content, wp-admin e wp-includes.

Passo 3. Enviar ficheiros e permissões de acesso

Para enviar um ficheiro do seu computador para o servidor, arraste-o do painel esquerdo do FileZilla para o direito. Ou clique com o botão direito no ficheiro e selecione «Enviar». O FileZilla mostra o progresso e retoma automaticamente a transferência se a ligação cair.

Onde colocar cada coisa:

• Plugins → wp-content/plugins/plugin-name/
• Temas → wp-content/themes/theme-name/
• Ficheiros multimédia (imagens, PDFs) → wp-content/uploads/year/month/, mas o WordPress não os verá na biblioteca multimédia sem um passo adicional (ver secção seguinte)
• Ficheiros na raiz → wp-config.php, .htaccess e robots.txt vão em public_html/

Após o envio, verifique as permissões de acesso (chmod): defina 755 para pastas, 644 para ficheiros. No FileZilla, isto faz-se clicando com o botão direito no ficheiro → «Permissões do ficheiro». Permissões incorretas são a causa mais comum de imagens «partidas» e erros 403 nos sites.

O que fazer se um ficheiro enviado não estiver visível no WordPress

Enviou uma imagem via FTP para a pasta uploads, mas ela não aparece na biblioteca multimédia do WordPress. Isto não é um bug: o WordPress regista os ficheiros na base de dados apenas quando são enviados através do painel de administração. Simplesmente colocar um ficheiro na pasta não é suficiente; precisa de um registo nas tabelas wp_posts e wp_postmeta.

Três soluções, da mais simples à mais avançada:

Primeiro, o plugin Media Sync. O Media Sync analisa a pasta uploads e adiciona os ficheiros não registados à biblioteca multimédia. É gratuito, com mais de 40.000 instalações ativas e uma classificação de 4,7 no WordPress.org. Após a instalação, vá a «Multimédia → Media Sync», clique em «Scan» e selecione os ficheiros para importar. Adequado quando precisa de importar dezenas ou centenas de ficheiros de uma só vez.

Segundo, Add From Server Reloaded. O Add From Server Reloaded adiciona um botão «Importar do servidor» à biblioteca multimédia. Ao contrário do clássico Add From Server (não atualizado há 6 anos), esta versão é mantida ativamente e é compatível com o WordPress 6.7+. Vá à biblioteca multimédia, especifique o caminho para o ficheiro no servidor e ele é registado. Conveniente quando tem poucos ficheiros e precisa de uma importação precisa.

Terceiro, WP-CLI. Se estiver à vontade com o terminal, o comando wp media import <path-to-file> regista um ficheiro na biblioteca multimédia numa única linha. Adequado para automação e processamento em lote.

Se tiver o problema oposto (imagens enviadas através do painel de administração não são exibidas no site), verifique três coisas:

• Permissões de acesso. A pasta uploads e todas as subpastas devem ter chmod 755, os ficheiros devem ter 644. Permissões incorretas são a causa mais comum de imagens invisíveis.
• Conflito com plugin de otimização. Desative temporariamente o Smush, ShortPixel, Imagify ou Jetpack Boost e verifique se as imagens aparecem. Por vezes, a otimização agressiva quebra os caminhos dos ficheiros.
• Cache da CDN. Se usar Cloudflare, BunnyCDN ou StackPath, limpe a cache e verifique se as configurações não estão a bloquear pedidos diretos a wp-content/uploads/.

Recuperação de emergência do site via FTP

O caso de uso mais comum do FTP é a recuperação de emergência. Aqui está um algoritmo passo a passo para quando o seu site deixa de abrir:

• Ligue-se via FTP e, primeiro, renomeie a pasta /wp-content/plugins/ para /wp-content/plugins_disabled/. Isto irá desativar todos os plugins de uma só vez.
• Se o site funcionar, o problema está nos plugins. Restaure as pastas dos plugins uma a uma e verifique o site após cada uma até encontrar o culpado.
• Não resultou? Mude para um tema padrão. Renomeie a pasta do tema ativo em /wp-content/themes/. O WordPress mudará automaticamente para o tema padrão (Twenty Twenty-Six).
• Ainda nada? Verifique o .htaccess. Descarregue o ficheiro via FTP, apague todo o seu conteúdo e envie o ficheiro vazio de volta. Depois vá a Administração → Definições → Links permanentes → «Guardar alterações» (o WordPress irá recriar o .htaccess).
• O site continua sem abrir depois de tudo isto? Ative o WP_DEBUG. Adicione estas linhas ao wp-config.php:

1
define('WP_DEBUG', true);
2
define('WP_DEBUG_LOG', true);
3
define('WP_DEBUG_DISPLAY', false);

Os erros serão escritos em /wp-content/debug.log. Verifique os registos e procure a causa raiz.

Este algoritmo resolve a maioria das emergências do WordPress sem contactar o suporte de alojamento e sem pânico.

⁉️🤔 Perguntas frequentes

O que é mais seguro, FTP ou SFTP?

O SFTP (SSH File Transfer Protocol) encripta tanto o início de sessão com palavra-passe como os ficheiros transferidos. O FTP normal transmite tudo em texto simples, incluindo a palavra-passe. Se o seu alojamento suportar SFTP, use apenas esse. No FileZilla, a mudança é tão simples como alterar a porta de 21 para 22.

Posso enviar ficheiros sem um cliente FTP?

Sim. Quase todos os alojamentos fornecem um Gestor de Ficheiros no próprio painel de controlo: envios baseados no navegador, zero instalações. Para tarefas pontuais é suficiente; o Gestor de Ficheiros não requer configuração e já está autorizado na sua conta. Uma opção mais hardcore é o WP-CLI: o comando wp media import envia e regista um ficheiro na biblioteca multimédia numa única linha.

Porque é que o FileZilla não se liga, mostrando o erro «Connection timed out»?

Duas causas prováveis. Primeira: porta errada. O FTP usa a porta 21, o SFTP usa a porta 22. Experimente ambas. Segunda: o alojamento está a bloquear a ligação por IP. Verifique no seu painel de alojamento se as ligações FTP de entrada estão bloqueadas e adicione o seu IP à lista de permissões.

Posso enviar um tema ou plugin via FTP se o arquivo exceder o limite do alojamento?

Sim, essa é precisamente a vantagem do FTP. O limite de envio através do painel de administração do WordPress (geralmente 2 a 8 MB) não se aplica ao FTP. Descomprima o arquivo no seu computador e envie a pasta do tema ou plugin para wp-content/themes/ ou wp-content/plugins/, respetivamente. Depois disso, o tema ou plugin aparecerá no painel de administração.

Preciso de desativar os plugins antes de enviar ficheiros via FTP?

Não. O FTP funciona ao nível do sistema de ficheiros e não interage diretamente com o WordPress. Pode enviar, apagar e editar ficheiros independentemente de os plugins estarem ativados ou até mesmo se o site não abrir de todo; essa é a principal vantagem do FTP como canal de emergência.

Como encontro as minhas credenciais FTP se as esqueci?

Aceda ao painel de controlo do seu alojamento (cPanel, ISPmanager, DirectAdmin) e abra a secção «Contas FTP». Todas as contas criadas estão listadas lá. Se a palavra-passe foi perdida, pode definir uma nova ali mesmo. Em último recurso: os detalhes FTP costumam estar incluídos no e-mail de boas-vindas do seu alojamento quando a conta foi criada.

Aprender FTP em meia hora: vale a pena ou não?

O FTP não ficou mais bonito em 40 anos. A interface do FileZilla parece o Windows XP, e a confusão com portas e chmod ainda frustra os principiantes. Mas quando o seu site está em baixo e o suporte de alojamento está em silêncio, esta ferramenta desajeitada torna-se o único canal funcional.

Se possui um site WordPress, domine três coisas: criar uma conta FTP no seu painel de alojamento, ligar-se via FileZilla e renomear uma pasta de plugin. Levará meia hora. E um dia poupar-lhe-á horas de pânico e espera.

Comece agora mesmo: crie uma conta FTP de teste, ligue-se ao servidor através do cliente FTP FileZilla e certifique-se de que consegue ver a pasta public_html. Só para saber que o canal funciona.