Conectar-se ao SSH no WordPress.com

O SSH, ou Secure Shell, é um protocolo que permite que você se conecte a serviços como servidores da Web. Isso permite que você se conecte aos nossos servidores e gerencie seu site do WordPress.com com ferramentas de linha de comando, como WP-CLI.

Essa funcionalidade está disponível nos sites com o plano WordPress.com Negócios ou eCommerce.

Neste guia

1. Obtenha as credenciais do SSH do WordPress.com e ative o SSH
   1. Redefinir uma senha do SSH
2. Conectar-se ao SSH
   1. Como se conectar ao SSH em sistemas MacOS e Linux
   2. Como se conectar ao SSH em sistemas Windows
3. Chave SSH
   1. Como adicionar uma chave SSH à sua conta
   2. Como anexar uma chave SSH existente a um site
   3. Como desanexar uma chave de um site
   4. Como atualizar uma chave SSH existente
   5. Como remover uma chave SSH existente
4. Como usar os comandos do Shell
5. Como usar o WP-CLI
   1. Gerenciar temas e plugins com o WP-CLI
   2. Pular temas e plugins com o WP-CLI
   3. Recursos adicionais do WP-CLI
6. E se algo der errado?
7. Perguntas frequentes
   1. Posso obter suporte para usar as ferramentas de linha de comando?
   2. Todos os comandos estão disponíveis?
   3. Posso definir minha própria senha do SSH?

Obtenha as credenciais do SSH do WordPress.com e ative o SSH

Se estiver acessando o SSH pela primeira vez, será necessário criar suas credenciais e ativar o acesso ao SSH:

1. No painel do WordPress.com do seu site, vá até Configurações → Configuração de hospedagem para acessar as opções de SSH do site.
2. Se solicitado, clique em Criar credenciais. Você só precisará fazer isso uma vez, e serão gerados um nome de usuário e uma senha de SSH para o site selecionado. As credenciais serão usadas para as conexões SFTP e SSH.
3. Anote a senha em um lugar seguro. Caso você perca ou se esqueça, pode usar o botão Redefinir senha para gerar uma nova.
4. Encontre a opção Acesso SSH e habilite a opção Ativar o acesso SSH para este site.

Por padrão, o acesso SSH fica desativado.

5. Depois que o acesso SSH é ativado, um comando de conexão é exibido. Você pode copiar e colar essas informações em um aplicativo de terminal. Leia nossas instruções em Conectar-se ao SSH para mais informações sobre como acessar seu site via SSH.

Redefinir uma senha do SSH

Se você esquecer ou perder sua senha SFTP/SSH, poderá redefini-la acessando Configurações → Configuração de hospedagem.

Na seção de credenciais do SFTP/SSH, clique em Redefinir senha.

Conectar-se ao SSH

Para acessar seu site usando SSH, você precisará do seu nome de usuário e senha do SSH e de um programa de terminal. Veja abaixo as instruções para se conectar usando alguns dos programas mais comuns.

Como se conectar ao SSH em sistemas MacOS e Linux

1. Abra o aplicativo de terminal do seu computador.
   • No MacOS, acesse Aplicativos → Utilitários no seu computador e abra o aplicativo Terminal.
   • No Linux, consulte o documento de distribuição para mais informações sobre como abrir a janela de terminal. Algumas versões podem se referir ao programa de terminal como um shell, console ou prompt de comando.
2. No painel do WordPress.com do seu site, vá até Configurações → Configuração de hospedagem para acessar as opções de SSH do site.
3. Na página Configuração de hospedagem confirme se o acesso SSH está ativado e copie o comando ssh command fornecido para seu site. Por exemplo, ssh example.wordpress.com@sftp.wp.com.

4. Cole ou digite o comando ssh no aplicativo de terminal e pressione Enter/Return.
   • Se esta for a sua primeira conexão, o terminal pode indicar que não é possível estabelecer a autenticidade do host. Digite yes e pressione Enter/Return para continuar.
5. O terminal agora deve solicitar que você insira uma senha. Cole ou digite a senha SSH que você usou para criar suas credenciais do SSH e pressione Enter.
   • Ao inserir sua senha no aplicativo de terminal, os caracteres não serão exibidos enquanto você digita. Isso é normal.
   • Se você esqueceu ou perdeu sua senha SSH, é possível redefinir.
6. Se a operação for bem-sucedida, você se conectará ao SSH e poderá executar comandos do shell ou do WP-CLI.

Como se conectar ao SSH em sistemas Windows

Desde o Windows 10, as versões mais recentes do sistema operacional oferecem suporte para SSH usando o subsistema do Windows para Linux e o cliente OpenSSH. Consulte a documentação oficial da Microsoft para saber como usar esses métodos.

O PuTTY também é uma opção disponível para versões mais antigas e atuais do Windows.

1. Faça o download e instale gratuitamente o cliente do PuTTY.
2. Inicie o PuTTY, defina as configurações de Host Name (Nome de host) e Port (Porta) e clique em Open (Abrir)
   • Defina o nome do host como sftp.wp.com
   • Defina a porta como 22

Cliente SSH do PuTTY para Windows

3. Se esta for a sua primeira conexão, você pode receber uma solicitação para definir o host e a opção de impressão digital rsa2 como confiáveis. Clique em Yes (Sim).
4. O PuTTY abrirá uma tela de terminal. Insira seu nome de usuário do SSH e pressione Enter/Return.
5. Quando solicitado, insira sua chave SSH.
6. Se a operação for bem-sucedida, você se conectará ao SSH e poderá executar comandos do shell ou do WP-CLI.

Chave SSH

As instruções abaixo explicam o processo para adicionar uma chave SSH à sua conta do WordPress.com. Você precisa primeiro adicionar a chave SSH à sua conta e, então, anexá-la ao site no qual você quer usar essa chave. Se não tiver uma chave SSH em seu computador, você pode se conectar ao SSH usando autenticação por senha.

Como adicionar uma chave SSH à sua conta

Antes de adicionar sua chave SSH à sua conta do WordPress.com, você precisa copiá-la para sua área de transferência. Há duas maneiras de fazer isso usando seu terminal de computador:

Mac

pbcopy < ~/.ssh/id_rsa.pub

Windows

clip < ~/.ssh/id_rsa.pub

Linux

cat ~/.ssh/id_rsa.pub

Se o seu arquivo de chave SSH pública usar um nome diferente do mencionado acima, edite o código para que ele fique igual ao nome do arquivo em seu computador.

Depois de copiar sua chave SSH pública para a área de transferência, siga as etapas abaixo para adicioná-la à sua conta:

1. No painel do WordPress.com, acesse Meu perfil.
2. Na página Meu perfil, clique em Segurança.
3. Clique na opção Chave SSH disponível na lista de verificação de segurança.

4. Cole sua chave SSH no campo Chave SSH pública.

5. Clique no botão Salvar chave SSH.

Depois que você adicionar sua chave SSH à sua conta do WordPress.com, será necessário anexá-la a cada site em que você quer essa chave.

Como anexar uma chave SSH existente a um site

Depois de adicionar a chave SSH à sua conta, será necessário anexá-la ao site ao qual você quer se conectar via SSH. Para anexar sua chave SSH a um site, siga estas etapas:

1. No painel do WordPress.com, vá até Configurações → Configuração de hospedagem.
2. Na seção Acesso SSH, use o campo Chaves SSH para selecionar a chave desejada.

3. Clique no botão Anexar chave SSH ao site.

Depois de anexar a chave SSH ao seu site, você poderá usá-la ao fazer a autenticação sobre SSH.

Como desanexar uma chave de um site

Se não quiser mais se conectar a um site usando a chave SSH, você pode desanexá-la do site. Para isso, siga estas etapas:

1. No painel do WordPress.com, vá até Configurações → Configuração de hospedagem.
2. Na seção Acesso SSH, localize a chave SSH que você quer remover.

3. Clique no botão Desanexar para remover a chave do site.

A chave SSH permanecerá associada à sua conta do WordPress.com até que ela seja removida.

Como atualizar uma chave SSH existente

Siga as etapas abaixo para atualizar sua chave SSH pública:

1. No painel do WordPress.com, acesse Meu perfil.
2. Na página Meu perfil, clique em Segurança.
3. Clique na opção Chave SSH disponível na lista de verificação de segurança.
4. Clique no botão Atualizar chave SSH ao lado da chave que você quer atualizar.

5. Cole sua chave SSH atualizada no campo Nova chave SSH pública.

6. Clique no botão Atualizar chave SSH para salvar as alterações.

Como remover uma chave SSH existente

Ao remover uma chave SSH da sua conta do WordPress.com, ela também será desanexada de todos os sites aos quais está associada. Para remover uma chave SSH existente da sua conta do WordPress.com, siga estas etapas:

1. No painel do WordPress.com, acesse Meu perfil.
2. Na página Meu perfil, clique em Segurança.
3. Clique na opção Chave SSH disponível na lista de verificação de segurança.
4. Clique no botão Remover chave SSH exibido ao lado da chave existente.

5. Uma mensagem de confirmação será exibida. Clique no botão OK para confirmar que você quer remover a chave.

Como usar os comandos do Shell

⚠️

Tenha cuidado ao executar comandos para evitar perda de dados ou danos ao seu site. Execute comandos apenas quando souber exatamente o que eles farão.

Há muitos recursos disponíveis sobre como usar a linha de comando do Linux. Alguns exemplos conhecidos incluem as seguintes fontes de terceiros:

• Tutorial: linha de comando do Ubuntu para iniciantes
• Manual de comandos para Linux do freeCodeCamp
• LinuxCommand.org
• Curso sobre o Shell da Microsoft

Veja abaixo alguns comandos comuns.

Comando	Descrição
ls	Mostra uma lista dos conteúdos atuais do diretório.
cd	Altera o diretório.
mkdir	Cria uma nova pasta/um novo diretório.
touch	Cria um arquivo.
rm	Remove um arquivo.
cat	Mostra o conteúdo de um arquivo.
cp	Copia.
mv	Move.
pwd	Mostra o diretório atual.
grep	Pesquisa uma frase específica em um arquivo/linhas.
find	Pesquisa arquivos e diretórios.
nano	Editor de texto.
history	Mostra os últimos 50 comandos usados.
clear	Limpa a tela do terminal.
du	Mostra o tamanho do arquivo.
rsync	Copia os arquivos do servidor e para ele.

Como usar o WP-CLI

O WP-CLI vem pré-instalado no WordPress.com e estende o shell para fornecer ferramentas de linha de comando específicas do WordPress. Você pode começar a executar os comandos do WP-CLI assim que se conectar ao SSH.

Existem vários comando e subcomandos que podem ajudar você a gerenciar e solucionar problemas do seu site. Para mais informações sobre os comandos disponíveis e como usá-los, acesse o guia do WP-CLI ou a documentação do WordPress.org para WP-CLI.

Gerenciar temas e plugins com o WP-CLI

É possível usar o WP-CLI para gerenciar e solucionar problemas de plugins e temas.

Comando do WP-CLI	Descrição
wp plugin list	Lista os plugins instalados, incluindo o status e a versão deles.
wp theme list	Lista os temas instalados.
wp plugin deactivate plugin-name	Desativa um plugin. Substitua plugin-name por um valor de name encontrado com o comando wp plugin list. É possível inserir mais de um nome de plugin para desativar vários de uma vez.
wp plugin activate plugin-name	Ativa o plugin Substitua plugin-name por um valor de name encontrado com o comando wp plugin list. É possível inserir mais de um nome de plugin para ativar vários de uma vez.
wp theme activate theme-name	Ativa um tema. Substitua theme-name por um valor de name encontrado com o comando wp theme list.
wp php-errors	Lista os erros recentes do PHP registrados. Isso é útil para identificar plugins e temas com problema e que precisam ser atualizados ou desativados.

Pular temas e plugins com o WP-CLI

Se o seu site apresentar erros e não puder executar comandos, talvez seja necessário pular o tema do site e o código do plugin. Para fazer isso, adicione --skip-themes and --skip-plugins a qualquer comando do WP-CLI.

Comando do WP-CLI	Descrição
wp --skip-plugins --skip-themes plugin deactivate plugin-name	Pula o tema e o código do plugin e, em seguida, desativa um plugin. Substitua plugin-name por um valor de name encontrado com o comando wp plugin list.
wp --skip-plugins --skip-themes theme activate theme-name	Pula o tema e o código do plugin e, em seguida, ativa um tema. Substitua theme-name por um valor de name encontrado com o comando wp theme list.
wp --skip-plugins --skip-themes php-errors	Pula o tema e o código do plugin e, em seguida, lista os erros recentes do PHP registrados. Isso é útil para identificar plugins e temas com problema e que precisam ser atualizados ou desativados.

Recursos adicionais do WP-CLI

• Como usar o WP-CLI
• Documentação do WP-CLI do WordPress.org
• Documentação do WP-CLI do WooCommerce
• WP-CLI.org

E se algo der errado?

Se algo acontecer com seu site depois que você implementar as alterações pelo SSH, será possível restaurar seu site usando o Jetpack Backup.

Se você executar um comando e acontecer algo inesperado, podemos ajudar você a restaurar seu site para um ponto anterior, antes de você ter executado o comando. No entanto, não poderemos ajudar você a depurar o comando para fazê-lo funcionar conforme o esperado.

Perguntas frequentes

Posso obter suporte para usar as ferramentas de linha de comando?

Devido à complexidade do SSH e do WP-CLI, não oferecemos suporte adicional para o uso dessas ferramentas. A equipe de suporte está disponível para ajudar com problemas de conexão pelo SSH, mas não pode orientar você sobre como usar comandos.

Todos os comandos estão disponíveis?

Para fornecer um ambiente seguro e eficiente, o WordPress.com pode restringir ou desativar determinados comandos do shell e do WP-CLI.

Posso definir minha própria senha do SSH?

O nome de usuário e a senha são gerados automaticamente pelo sistema. Essas credenciais são exclusivas para cada site. Se você tiver diversos sites, precisará usar vários nomes de usuário e senhas, um par para cada site.