Como buscar um texto dentro de vários arquivos do site usando grep pelo SSH
Oi! Aqui é a Sensei da GeHost 🧘♀️ Hoje vamos aprender um truque que economiza HORAS de trabalho: como encontrar rapidinho onde está escrito um determinado texto (uma palavra, um trecho de código, um telefone antigo, um nome de produto) dentro de dezenas ou centenas de arquivos do seu site, sem precisar abrir um por um. A ferramenta mágica pra isso se chama grep, e ela roda direto no terminal, via SSH.
Este é um recurso mais avançado, pensado para quem já tem familiaridade com terminal/linha de comando ou está sendo orientado por um desenvolvedor. Se você nunca usou terminal antes, tudo bem — vá com calma e siga o passo a passo com carinho, um comando de cada vez. 💛
Antes de começar: seu plano tem acesso SSH?
O acesso SSH é um recurso liberado conforme o plano/serviço contratado, e funciona dentro do ambiente da sua própria hospedagem (não é acesso root nem servidor dedicado). Se você não tiver certeza se o seu tem esse acesso habilitado, ou se ainda não recebeu as credenciais de conexão, fale com o nosso suporte pelo painel.gehost.com.br que a gente confirma e te orienta certinho.
Passo 1 — Conectando via SSH
- Abra o terminal do seu computador (no Windows pode ser o PowerShell, Prompt de Comando ou um app como o PuTTY; no Mac/Linux, o próprio Terminal já serve).
- Use o comando de conexão que o suporte te passou, algo no formato:
ssh seu_usuario@seudominio.com.br -p PORTA - Digite a senha quando for solicitado (ela não aparece na tela enquanto você digita — é normal, é assim mesmo por segurança).
- Pronto! Se aparecer uma linha de comando com o nome do seu usuário, você está conectado. 🎉
Passo 2 — Indo até a pasta do site
Normalmente os arquivos do site ficam dentro da pasta public_html. Entre nela com:
cd public_html
Se o seu site for um addon domain ou subdomínio, a pasta pode ter outro nome — dê uma olhada com o comando ls (que lista o conteúdo da pasta atual) pra se localizar.
Essa é a mesma estrutura de pastas que você vê no Gerenciador de Arquivos do cPanel — o grep vai varrer exatamente esses arquivos, só que de um jeito muito mais rápido que abrir pasta por pasta na tela.
Passo 3 — O comando mágico: grep
Agora vem a parte boa. Pra buscar um texto dentro de todos os arquivos de uma pasta (incluindo subpastas), use:
grep -r "texto que você procura" .
Repare no ponto final (.) — ele diz "procure a partir da pasta onde eu estou agora". O -r significa "recursivo", ou seja, entra em todas as subpastas também.
Exemplo prático: se você quer achar em quais arquivos aparece o texto contato@meusite.com.br, o comando fica:
grep -r "contato@meusite.com.br" .
O resultado mostra o nome do arquivo e a linha inteira onde o texto foi encontrado — assim você já sabe exatamente onde precisa editar.
Passo 4 — Deixando a busca mais esperta (flags úteis)
- Ignorar maiúsculas/minúsculas:
grep -ri "texto" .— encontra "Texto", "TEXTO" e "texto" ao mesmo tempo. - Mostrar o número da linha:
grep -rn "texto" .— ótimo pra passar pro seu desenvolvedor ("está na linha 42 do arquivo tal"). - Buscar só em um tipo de arquivo (ex.: só PHP):
grep -rn "texto" --include=*.php . - Combinar tudo:
grep -rni "texto" --include=*.php .
Passo 5 — Contando quantas vezes aparece
Se você só quer saber quantos arquivos têm aquele texto (sem listar linha por linha), adicione o -l (de "list"):
grep -rl "texto" .
💡 Dica da Sensei: o grep é só de LEITURA — ele encontra, mas não altera nada nos seus arquivos. Pra editar de fato, você vai precisar abrir o arquivo encontrado (pelo Gerenciador de Arquivos do cPanel ou por um editor via SSH) e trocar o trecho manualmente. Isso é proposital: assim você revisa cada alteração antes de aplicar, sem risco de mudar algo em massa por engano.
⚠️ Atenção: evite rodar buscas muito pesadas (pastas com milhares de arquivos, como wp-content/uploads cheia de imagens) sem necessidade — isso consome processamento do seu plano à toa. Sempre que possível, entre direto na pasta específica onde acredita que o texto está antes de rodar o comando.
Resumindo
- Conecte via SSH.
- Entre na pasta do site (
cd public_html). - Rode
grep -rn "seu texto" . - Anote o arquivo e a linha indicados.
- Edite o arquivo pelo Gerenciador de Arquivos ou editor de sua preferência.
Ficou com dúvida em algum comando ou não tem certeza se seu plano inclui SSH? É só chamar a gente pelo painel.gehost.com.br — a Sensei (e o time todo 💛) tá sempre por aqui pra ajudar!