Gerenciar plugins pelo painel do WordPress é prático — até não ser. Quando você precisa atualizar dezenas de plugins de uma vez, reverter um plugin que quebrou o site depois de uma atualização, ou agir quando o próprio wp-admin está inacessível, a linha de comando resolve em segundos o que levaria dezenas de cliques. Neste guia, você aprende a atualizar e a fazer downgrade de plugins do WordPress via SSH, usando o WP-CLI — a ferramenta oficial de linha de comando do WordPress. Cobrimos os pré-requisitos, os comandos passo a passo e os cuidados para não quebrar nada.
A linha de comando é poderosa e rápida — o que também significa que um erro afeta o site na hora, sem confirmação. Antes de atualizar ou reverter qualquer plugin, faça um backup completo (arquivos e banco de dados). Assim, se algo der errado, você recupera o site em minutos.
Conteúdo
Por que gerenciar plugins via SSH?
O WordPress deixa você atualizar plugins pelo painel, em Plugins → Plugins Instalados, com um clique. Para o dia a dia, é o suficiente. Mas há situações em que a linha de comando é muito melhor:
- Velocidade e lote: atualizar 30 plugins são 30 cliques no painel — ou um único comando no terminal.
- Reverter uma atualização ruim: o painel não oferece downgrade nativo. Se um plugin quebrou o site após atualizar, pela linha de comando você volta à versão anterior em segundos.
- Quando o wp-admin está inacessível: se um plugin derrubou o painel, você ainda consegue agir via SSH, sem depender da interface.
- Automação: comandos podem ser reunidos em scripts para manter vários sites de uma vez.
A ferramenta que torna isso possível é o WP-CLI (WordPress Command Line Interface), o utilitário oficial que permite fazer pela linha de comando praticamente tudo o que o painel faz.
Pré-requisitos
Antes de começar, você precisa de três coisas:
- Acesso SSH ao seu servidor. Se você não sabe o que é ou como acessar, veja nosso guia sobre o que é SSH e como usar.
- WP-CLI instalado no servidor. Na maioria das hospedagens que oferecem SSH, o WP-CLI já vem pronto. Para confirmar, rode
wp --info— se retornar informações da ferramenta, está instalado. - Um backup recente do site (arquivos e banco), como reforçado acima.
Com isso pronto, conecte-se ao servidor via SSH e navegue até a pasta da sua instalação WordPress (aquela onde ficam o wp-config.php e as pastas wp-content, wp-admin):
cd caminho/para/seu/wordpressListar os plugins e ver o que precisa de atualização
Antes de atualizar, veja o estado atual. Este comando lista todos os plugins instalados, com nome, status (ativo/inativo), versão atual e se há atualização disponível:
wp plugin listPara ver apenas os que têm atualização pendente:
wp plugin list --update=availableAnote o nome (slug) dos plugins que aparecem — é ele que você usa nos comandos seguintes (por exemplo, akismet, woocommerce).
Atenção a este ponto, porque é o erro nº 1 de quem começa: o slug (o nome técnico usado nos comandos) quase sempre é diferente do nome de exibição do plugin. Por exemplo, o plugin “Contact Form 7” tem o slug contact-form-7, e o “Yoast SEO” tem o slug wordpress-seo. Você encontra o slug correto de duas formas: na saída do wp plugin list (primeira coluna), ou na URL do plugin no WordPress.org (a parte final do endereço, em wordpress.org/plugins/nome-do-slug/). Usar o nome de exibição em vez do slug é o que faz o comando falhar.
Como atualizar plugins via SSH
Para atualizar um plugin específico, use o nome dele:
wp plugin update nome-do-pluginPara atualizar todos os plugins de uma vez — o comando que mais economiza tempo:
wp plugin update --allO WP-CLI baixa e instala a versão mais recente de cada plugin, mostrando um resumo do que foi atualizado. É o equivalente a abrir o painel e atualizar cada um manualmente — só que em segundos.
Se você tem receio de atualizar e quebrar algo, existe uma rede de segurança: a flag --dry-run. Ela simula a atualização e mostra exatamente o que aconteceria — quais plugins seriam atualizados e para quais versões — sem executar nada de fato:
wp plugin update --all --dry-runRode isso primeiro para conferir o que será alterado, e só então execute o comando de verdade (sem o --dry-run). É um hábito que evita surpresas.
Outra situação comum: você quer atualizar todos os plugins, menos um — normalmente porque sabe que a versão nova daquele plugin quebra o seu site. Use a flag --exclude com o slug do plugin que deve ficar de fora:
wp plugin update --all --exclude=nome-do-pluginAssim você mantém tudo em dia sem tocar no plugin problemático até que ele seja corrigido.
Se além dos plugins você quer atualizar o core do WordPress, o WP-CLI também faz isso com wp core update seguido de wp core update-db. Se preferir atualizar o WordPress sem linha de comando, veja nosso guia de como atualizar o WordPress manualmente.
Como fazer downgrade de um plugin via SSH
Este é o cenário que o painel não resolve: um plugin foi atualizado, e a nova versão quebrou o site ou entrou em conflito com o tema ou outro plugin. Você precisa voltar à versão anterior — o downgrade. Com o WP-CLI, é direto.
O comando de atualização aceita a flag --version, que permite instalar qualquer versão específica do plugin, inclusive uma anterior à atual:
wp plugin update nome-do-plugin --version=1.2.3Troque 1.2.3 pela versão para a qual você quer voltar. Mas como saber qual era a versão anterior? Duas formas:
- Na página do plugin no WordPress.org: abra a aba “Desenvolvimento” (ou “Advanced View”), onde há um histórico de versões anteriores para download e o changelog.
- Para descobrir o número da versão anterior, veja o histórico de versões e o changelog na aba “Desenvolvimento” (Advanced View) da página do plugin no WordPress.org.
wp plugin update nome-do-plugin --version=1.2.3 --forceA flag --force garante a substituição mesmo “rebaixando” a versão. Depois do downgrade, confirme que o site voltou ao normal e — importante — considere desativar a atualização automática desse plugin até que o desenvolvedor corrija o problema, para ele não voltar a atualizar sozinho.
Uma variante mais confiável para o downgrade. Em alguns casos, o wp plugin update --version não consegue “descer” para uma versão anterior — porque o comando update é pensado para avançar. Nessas situações, use o install com --force, que sobrescreve o plugin com a versão exata que você indicar, seja ela mais nova ou mais antiga:
wp plugin install nome-do-plugin --version=1.2.3 --forceEsta costuma ser a forma mais recomendada de fazer downgrade — o install --force não tem a limitação de “só avançar” do update.
Importante — plugins premium: o downgrade pela flag --version só funciona para plugins hospedados no repositório oficial do WordPress.org. Plugins pagos (premium) não estão lá, então o WP-CLI não consegue baixar versões antigas deles. Para reverter um plugin premium, baixe o arquivo .zip da versão anterior no site do desenvolvedor e instale-o direto do arquivo:
wp plugin install caminho/para/plugin-1.2.3.zip --forceVoltar a uma versão anterior resolve na hora, mas versões antigas podem ter falhas de segurança já corrigidas nas novas. Trate o downgrade como uma medida provisória: reporte o problema ao desenvolvedor do plugin e volte para a versão atualizada assim que o conflito for resolvido.
Depois de qualquer atualização ou downgrade, confirme que o site voltou ao normal: abra o front-end numa janela anônima (incognito) do navegador, para ver a página sem o cache da sua sessão. Se estiver tudo certo ali, a operação funcionou. Se o problema persistir mesmo após reverter o plugin, a causa pode estar em outro lugar (no banco de dados, no cache do servidor ou no tema) — nesse caso, limpe os caches e investigue os outros plugins.
Outros comandos úteis de plugin
O WP-CLI cobre todo o ciclo de vida dos plugins. Alguns comandos que complementam:
# Ativar um plugin
wp plugin activate nome-do-plugin
# Desativar um plugin
wp plugin deactivate nome-do-plugin
# Desativar TODOS os plugins (útil para diagnosticar conflitos)
wp plugin deactivate --all
# Instalar e já ativar um plugin
wp plugin install nome-do-plugin --activate
# Remover um plugin
wp plugin delete nome-do-pluginO comando de desativar todos é especialmente útil para diagnóstico: se um plugin quebrou o site, wp plugin deactivate --all derruba todos de uma vez, devolvendo o acesso, e aí você reativa um a um para achar o culpado — a mesma lógica do troubleshooting clássico, só que pela linha de comando.
Há um caso extremo que vale conhecer: às vezes um plugin quebra o site de forma tão grave que o próprio WP-CLI trava ao tentar carregar o WordPress. Quando isso acontece, adicione as flags --skip-plugins --skip-themes ao comando — elas fazem o WP-CLI ignorar o carregamento de plugins e temas na inicialização, permitindo que ele rode mesmo com um plugin defeituoso presente:
wp plugin install nome-do-plugin --version=1.2.3 --force --skip-plugins --skip-themesCom isso, você consegue reverter o plugin problemático mesmo quando o site está totalmente fora do ar.
Para usar a linha de comando do WordPress, você precisa de uma hospedagem com acesso SSH e WP-CLI. A Homehost oferece hospedagem WordPress com esses recursos, além de backups, SSL grátis e suporte em português.
Ver hospedagem WordPressPerguntas frequentes
Como atualizar todos os plugins do WordPress via SSH?
Conecte-se ao servidor via SSH, navegue até a pasta do WordPress e rode o comando wp plugin update --all. O WP-CLI atualiza todos os plugins com atualização disponível de uma só vez. Faça backup antes.
Como fazer downgrade de um plugin do WordPress?
Use o WP-CLI com a flag de versão: wp plugin update nome-do-plugin --version=1.2.3 --force, trocando pelo número da versão anterior desejada. É a forma mais rápida de reverter um plugin que quebrou o site após uma atualização, já que o painel não oferece downgrade nativo.
Preciso de acesso SSH para usar o WP-CLI?
Sim. O WP-CLI roda no servidor, então você precisa de acesso SSH à sua hospedagem e do WP-CLI instalado (na maioria das hospedagens com SSH ele já vem pronto). Verifique com o comando wp --info.
O downgrade de um plugin apaga minhas configurações?
Geralmente não. As configurações dos plugins ficam no banco de dados, não nos arquivos, então mudar a versão do plugin normalmente preserva os ajustes. Ainda assim, faça backup antes, porque algumas versões alteram a estrutura de dados.
É seguro atualizar plugins pela linha de comando?
Sim, é tão seguro quanto pelo painel — o WP-CLI usa o mesmo mecanismo do WordPress. O cuidado principal é o de sempre: fazer backup antes, já que a linha de comando executa a ação imediatamente, sem tela de confirmação.
Veja também
Conclusão
Gerenciar plugins pela linha de comando parece coisa de especialista, mas os comandos são poucos e diretos: wp plugin list para ver o que precisa de atenção, wp plugin update --all para atualizar tudo de uma vez, e wp plugin update nome --version=X --force para reverter uma versão problemática. O WP-CLI economiza tempo, funciona mesmo quando o painel não abre, e dá um controle que a interface não oferece — como o downgrade. O único hábito inegociável é o backup antes de agir. Com isso, você gerencia seus plugins de forma mais rápida, segura e profissional.
