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
Se estiver acessando o SSH pela primeira vez, será necessário criar suas credenciais e ativar o acesso ao SSH:
- 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.
- 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.
- 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.
- Encontre a opção Acesso SSH e habilite a opção Ativar o acesso SSH para este site.
- 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.
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.
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.
- 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.
- 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.
- 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
.
- 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.
- 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.
- Se a operação for bem-sucedida, você se conectará ao SSH e poderá executar comandos do shell ou do WP-CLI.
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.
- Faça o download e instale gratuitamente o cliente do PuTTY.
- 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
- Defina o nome do host como
- 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).
- O PuTTY abrirá uma tela de terminal. Insira seu nome de usuário do SSH e pressione Enter/Return.
- Quando solicitado, insira sua chave SSH.
- Se a operação for bem-sucedida, você se conectará ao SSH e poderá executar comandos do shell ou do WP-CLI.
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.
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:
- No painel do WordPress.com, acesse Meu perfil.
- Na página Meu perfil, clique em Segurança.
- Clique na opção Chave SSH disponível na lista de verificação de segurança.
- Cole sua chave SSH no campo Chave SSH pública.
- 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.
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:
- No painel do WordPress.com, vá até Configurações → Configuração de hospedagem.
- Na seção Acesso SSH, use o campo Chaves SSH para selecionar a chave desejada.
- 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.
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:
- No painel do WordPress.com, vá até Configurações → Configuração de hospedagem.
- Na seção Acesso SSH, localize a chave SSH que você quer remover.
- 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.
Siga as etapas abaixo para atualizar sua chave SSH pública:
- No painel do WordPress.com, acesse Meu perfil.
- Na página Meu perfil, clique em Segurança.
- Clique na opção Chave SSH disponível na lista de verificação de segurança.
- Clique no botão Atualizar chave SSH ao lado da chave que você quer atualizar.
- Cole sua chave SSH atualizada no campo Nova chave SSH pública.
- Clique no botão Atualizar chave SSH para salvar as alterações.
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:
- No painel do WordPress.com, acesse Meu perfil.
- Na página Meu perfil, clique em Segurança.
- Clique na opção Chave SSH disponível na lista de verificação de segurança.
- Clique no botão Remover chave SSH exibido ao lado da chave existente.
- Uma mensagem de confirmação será exibida. Clique no botão OK para confirmar que você quer remover a chave.
⚠️
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. |
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.
É 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. |
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. |
- Como usar o WP-CLI
- Documentação do WP-CLI do WordPress.org
- Documentação do WP-CLI do WooCommerce
- WP-CLI.org
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.
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.
Para fornecer um ambiente seguro e eficiente, o WordPress.com pode restringir ou desativar determinados comandos do shell e do WP-CLI.
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.