Voltar para o suporte Conta Hospedagem Usar SFTP no WordPress.com

Usar SFTP no WordPress.com

SFTP é um método FTP seguro para transferir arquivos do seu site ou para ele. Neste guia, você aprenderá a usar SFTP no WordPress.com.

Essa funcionalidade está disponível nos sites com o plano WordPress.com Creator ou Entrepreneur. Essa funcionalidade também está disponível para sites no antigo plano Pro.

Precauções

SFTP é uma função avançada para quem tem experiência em editar arquivos de sites.

A maioria das ações que você pode realizar no SFTP pode ser feita sem ele, incluindo:

Não edite nenhum arquivo se não souber exatamente o que a alteração acarretará. Fazer upload de arquivos desconhecidos ou editar arquivos sem saber com certeza para que servem pode fazer com que seu site pare de funcionar ou provocar a perda de dados. Teste as alterações de código e arquivo primeiro em um site de teste.

Sobre SFTP

O SFTP é um método para acessar arquivos e pastas de um site usando um programa cliente, como o FileZilla, em um computador local. SFTP é a sigla em inglês para protocolo de transferência segura de arquivos (ou protocolo de transferência de arquivos SSH). Ele foi criado como uma extensão do protocolo SSH (shell seguro). A transferência é considerada segura porque ocorre em um canal seguro: o SSH.

Não confunda SFTP com o FTP (protocolo de transferência de arquivos), que é parecido, mas não é seguro.

Vários plugins e temas personalizados podem solicitar a criação de pastas específicas ou adicionar arquivos via SFTP. No entanto, em termos gerais, não é necessário usar SFTP para o site funcionar.

Encontrar suas credenciais SFTP

Para acessar as opções de SFTP do seu site e obter suas credenciais, siga estas etapas:

  1. Acesse o painel do seu site.
  2. Vá até Configurações → Configuração de hospedagem.
  3. Em Credenciais SFTP/SSH, clique no botão Criar credenciais:
Uma seta apontando para o botão de credenciais.

Em alguns instantes, as credenciais serão exibidas:

  • Endereço URL
  • Número da porta
  • Nome de usuário
  • Senha

Clique no botão Copiar ao lado de qualquer valor para copiá-lo para a área de transferência do seu dispositivo.

O nome de usuário e a senha são gerados automaticamente pelo sistema. Essas duas credenciais são exclusivas de cada site. Então, se você tiver diversos sites, precisará usar um par diferente de nome de usuário e senha para cada um deles no cliente SFTP.

Credenciais SFTP

Por motivos de segurança, não armazenamos sua senha de SFTP. Se você esqueceu sua senha, pode redefini-la clicando no botão Redefinir senha, que é exibido quando você sai da tela Configuração de hospedagem e retorna.

Configurar um cliente

Um cliente SFTP é uma ferramenta que aceita suas credenciais e permite acessar os arquivos do seu site. Há muitos clientes disponíveis. Se você não tiver preferência, recomendamos o FileZilla. Veja as instruções de configuração abaixo.

FileZilla

Para acessar o SFTP com o FileZilla, siga estas etapas:

  1. Acesse o site do FileZilla para fazer download do FileZilla para Windows, MacOS ou Linux.
  2. Abra o programa e acesse Arquivo → Gerenciador de Sites.
  3. Clique no botão Novo site.
  4. Defina o campo “Protocolo” como SFTP (SSH File Transfer Protocol), não como FTP.
  5. Adicione as credenciais obtidas anteriormente.
  6. Clique no botão Conectar:
Captura da tela de credenciais do FileZilla com "Protocolo" definido como "SFTP - SSH File Transfer Protocol", o campo "Usuário" com o texto "NOME DO USUÁRIO AQUI" e o campo "Senha" preenchido

No layout padrão do FileZilla, você verá seus arquivos locais à esquerda e os arquivos do site à direita.

Transmit

Clique para expandir as instruções do cliente SFTP Transmit, disponível no macOS.

Se seu sistema operacional é o macOS, você pode usar o aplicativo Transmit no computador. Faça download diretamente do site do desenvolvedor aqui: Transmit 5.

Depois de fazer download e instalar corretamente o aplicativo no computador, aparecerá um módulo de início.

Uma amostra de captura de tela do módulo de login do Transmit

Confirme se o campo “Protocol” (Protocolo) está definido como “SFTP”.

Uma amostra de captura de tela do Transmit. Uma seta laranja apontando para a opção "SFTP"

Depois, preencha as credenciais do SFTP (endereço, nome de usuário, porta e senha) nos respectivos campos:

Uma amostra de captura de tela do módulo de login do Transmit

Por fim, clique em “Connect” (Conectar).

Cyberduck

Clique para expandir as instruções do cliente SFTP Cyberduck no macOS e Windows.

O Cyberduck está disponível para macOS e Windows. Faça download no próprio site do software/aplicativo: cyberduck.io.

Depois da instalação, aparecerá um módulo de início.

Uma amostra de captura de tela do Cyberduck. Botão "Nova Conexão" à esquerda

Clique no botão “Nova Conexão” no canto superior esquerdo.

Uma amostra de captura de tela do Cyberduck com uma seta laranja apontando para o botão "Nova Conexão"

Você verá uma janela pop-up de login para preencher com suas credenciais de SFTP. Confira se está definido como SFTP.

Uma amostra de captura de tela do módulo de login do Cyberduck.

Clique na seta do menu suspenso ao lado da opção “FTP (File Transfer Protocol)”.

Uma amostra de captura de tela do Cyberduck com uma seta laranja apontando para a seta do menu suspenso ao lado da opção "(File Transfer Protocol)"

Escolha a opção “SFTP (SSH File Transfer Protocol)”.

Uma amostra de captura de tela do Cyberduck com o menu suspenso e uma seta laranja apontando para a opção "SFTP (SSH File Transfer Protocol)"

Depois que você fizer isso, o campo “Port” (Porta) mudará para 22. Preencha os campos com as credenciais disponíveis em Configurações → Configuração de hospedagem no seu painel do WordPess.com.

Uma amostra de captura de tela do Cyberduck com os campos "Server", "Port", "Username" e "Password"

Clique em “Connect” (Conectar) e pronto.

Problemas e perguntas frequentes

Fiz upload de um plugin/tema e ele não aparece no meu painel.

Verifique se os arquivos foram enviados para a pasta correta. Se os plugins não estiverem em /wp-content/plugins/ e os temas não estiverem em /wp-content/themes/, eles não funcionarão.

Modifiquei os arquivos do meu tema, mas minhas alterações desapareceram depois que o tema foi atualizado.

Esse é um problema comum quando as modificações não são feitas em um tema secundário, pois elas são substituídas sempre que o tema é atualizado para uma nova versão. Para manter seus temas personalizados, siga estas instruções.

Adicionei meu site ao cliente SFTP e ele não está funcionando!

Verifique se você especificou a conexão como SFTP nas configurações do cliente. Se você estiver usando a conexão rápida, inicie o endereço SFTP com sftp://.

Fiz upload de imagens/vídeos via SFTP, mas eles não são exibidos na minha biblioteca de mídia.

Isso é esperado porque o WordPress não reconhece arquivos de mídia enviados via SFTP. Embora sejam acessíveis por meio da URL direta, eles não serão exibidos na área de administração. Use plugins como o Media Sync para resolver esse problema. Dessa forma, as imagens e os vídeos enviados para o site via SFTP aparecerão normalmente na biblioteca de mídia.

Quais permissões de arquivo devo definir?

Por padrão, suas permissões de pastas e arquivos devem ser definidas como 755. Alterar essas configurações pode travar seu site. Alguns arquivos com symlink podem ter permissões diferentes. Isso é normal e não pode ser alterado.

Posso editar o arquivo wp-config.php do meu site?

Sim, você pode modificar o arquivo wp-config.php do seu site. No entanto, recomendamos não mexer nesse arquivo, a menos que seja realmente necessário. Se você estiver em dúvida, entre em contato conosco antes de fazer qualquer alteração.

Posso editar o functions.php?

Na maioria dos temas oferecidos pelo WordPress.com, o arquivo functions.php tem symlink e é protegido. Isso significa que não é possível editá-lo. No entanto, é possível alterar o arquivo functions.php de temas de terceiros e instalados manualmente.

Lembre-se de que editar ou adicionar códigos não testados ao arquivo functions.php pode fazer com que seu site pare de funcionar. Além disso, essas alterações geralmente são perdidas quando o tema é atualizado. Recomendamos usar plugins, como o Code Snippets, para aplicar modificações no arquivo functions.php do seu site. Além de dar mais controle e granularidade à execução do código, esse plugin também permite desativar trechos com facilidade se algo der errado.

O conteúdo enviado via SFTP é contabilizado nos limites de armazenamento do meu site?

Sim, o conteúdo enviado via SFTP é contabilizado no limite de armazenamento do site, assim como qualquer conteúdo enviado usando a biblioteca de mídia.

Posso editar os arquivos básicos do WordPress?

Não, você não pode editar os arquivos básicos do WordPress nem os temas e plugins padrão do WordPress.com. Tais arquivos são essenciais para que seu site funcione. Por isso, não é possível editá-los via SFTP.

Fiz upload de um plugin usando SFTP, mas não consigo ativá-lo. O que devo fazer?

Fazemos o possível para que você consiga usar inúmeros plugins no seu site do WordPress.com. No entanto, alguns plugins não são adequados para nossa plataforma ou são simplesmente incompatíveis. Confira se o plugin que você enviou é incompatível.

Estou tentando fazer upload de um tema para o meu site, mas aparece uma mensagem dizendo que ele é muito grande. Posso fazer upload desse arquivo via SFTP?

Sim. É possível fazer upload de um tema em Aparência > Temas > Adicionar novo. No entanto, há um limite de 50 MB por motivos de segurança, já que alguns temas podem incluir outros arquivos que não fazem parte deles.

Nesse caso, o primeiro passo é verificar se os arquivos do tema estão corretos. Os temas de terceiros podem incluir conteúdo de demonstração ou informações de licença dentro do arquivo zip, por exemplo. Faça upload apenas dos arquivos do tema que podem ser instalados no seu site do WordPress.

Se você removeu os arquivos extras, mas continua recebendo uma mensagem de erro, use o SFTP para adicionar o tema ao site. Para fazer isso, descompacte os arquivos e coloque os corretos no diretório /wp-content/themes/.

Posso adicionar módulos PHP personalizados, como o ioncube?

Não. Embora alguns plugins precisem que módulos PHP personalizados sejam instalados para funcionar, isso é configurado no servidor e não pode ser alterado. Consulte os detalhes do ambiente do nosso servidor aqui.

Por que não consigo acessar determinadas pastas via SFTP?

Alguns diretórios da estrutura do sistema de arquivos permanecem bloqueados e não podem ser acessados via SFTP. Isso é vital para preservar a segurança e uma garantia de que seu site continuará funcionando.

A captura de tela abaixo mostra alguns diretórios básicos com um ponto de interrogação (?). Isso significa que o diretório faz parte da instalação básica do site no WordPress. Não permitimos a alteração de arquivos básicos porque eles são necessários para manter o site em funcionamento.

Como posso conceder ao desenvolvedor do meu plugin ou tema acesso ao meu site via SFTP?

Se o desenvolvedor do seu plugin ou tema solicitar acesso via SFTP, compartilhe suas credenciais com ele. O acesso é limitado a um usuário SFTP por site. Portanto, não se esqueça de redefinir a senha do SFTP assim que o desenvolvedor não precisar mais do acesso.

E se algo der errado?

Se algo indesejado acontecer com seu site como resultado de ações no SFTP, você poderá restaurar um backup anterior do seu site.

Copied to clipboard!