blog
Painéis

O que é o .htaccess e como editar sem derrubar o site

O arquivo oculto que manda no seu site antes de qualquer página carregar, e o caminho de volta: apagar um arquivo e renomear outro.

JR · · 8 min de leitura · 1 tabela

Resposta curta: sim, você pode editar o .htaccess sozinho. Ele é um arquivo de instruções oculto dentro de public_html que o servidor lê antes de abrir a página. No Gerenciador de Arquivos do cPanel: ligue "Show Hidden Files", baixe uma cópia do arquivo com Download e só então edite.

Neste artigo
  1. O que é o .htaccess e por que ele fica oculto
  2. Pode editar, desde que a cópia exista antes
  3. O que ter em mãos antes de abrir o arquivo
  4. O caminho completo no Gerenciador de Arquivos do cPanel
  5. Como voltar atrás quando o site cai com erro 500
  6. Erros comuns no .htaccess e o que cada um significa
  7. Três situações em que é melhor não mexer

O que é o .htaccess e por que ele fica oculto

Imagine que o seu site mora em uma sala dentro de um prédio. O prédio é o servidor: um computador ligado 24 horas por dia que entrega as páginas para quem digita o endereço do seu site. A sala é a pasta onde ficam os arquivos do seu site.

O .htaccess é um bilhete colado na porta dessa sala. Antes de entregar qualquer página para o visitante, o servidor lê o bilhete e obedece ao que está escrito nele. Por isso ele consegue fazer coisas que a página sozinha não faria:

O nome começa com ponto por um motivo prático: em servidores Linux, arquivo cujo nome começa com ponto é um arquivo oculto. Ele existe, mas não aparece na listagem normal. É por isso que muita gente abre a pasta do site, não vê o .htaccess e conclui que ele não existe.

Duas coisas que convém saber antes de continuar. Primeiro: o .htaccess vale para a pasta onde está e para as pastas abaixo dela. Segundo: ele é um arquivo de texto puro, sem formatação, e um erro de digitação em uma única linha pode tirar o site inteiro do ar com um erro 500, a mensagem que o servidor mostra quando não consegue entregar a página. Não é motivo para medo, é motivo para fazer cópia antes.

Pode editar, desde que a cópia exista antes

Pode editar. É um arquivo seu, dentro da sua hospedagem, e o Gerenciador de Arquivos do cPanel existe exatamente para isso.

A condição é uma só: tenha a cópia de segurança pronta antes de alterar a primeira letra. Não é uma recomendação de cautela genérica. É a diferença entre um susto de dois minutos e um site fora do ar por horas enquanto você procura alguém para ajudar.

O que este guia entrega é o caminho de ida e o caminho de volta. A regra que você vai colar lá dentro depende do que você quer fazer, e cada tutorial de redirecionamento ou de página de erro traz a sua. O que ninguém costuma ensinar é como desfazer.

O que ter em mãos antes de abrir o arquivo

Se você não sabe onde fica o seu cPanel, procure no e-mail de boas-vindas da hospedagem. O endereço costuma ser o seu domínio seguido de /cpanel.

O caminho completo no Gerenciador de Arquivos do cPanel

Todo o caminho abaixo é feito com o mouse, dentro do navegador. Não existe terminal nem comando para decorar.

Abrir o Gerenciador de Arquivos no cPanel

Entre no cPanel e procure a seção Files (Arquivos). Clique em File Manager (Gerenciador de Arquivos). Abre uma tela dividida: à esquerda a árvore de pastas, à direita a lista de arquivos da pasta selecionada.

Resultado esperado: você vê uma lista de pastas com nomes como etc, logs, mail, public_html.

Exibir arquivos ocultos para o .htaccess aparecer

No canto superior direito, clique em Settings (Configurações). Marque a opção Show Hidden Files (dotfiles) e confirme em Save. A documentação oficial do cPanel descreve essa opção como a que exibe os arquivos cujo nome começa com ponto.

Resultado esperado: a listagem recarrega e passam a aparecer itens que antes estavam escondidos, entre eles o .htaccess.

Entrar na public_html e achar a pasta certa do site

Clique duas vezes em public_html. Essa é a pasta pública: tudo o que está aqui é o que o visitante consegue ver. Se você tem mais de um domínio na mesma conta, o site adicional costuma ficar em uma subpasta dentro de public_html, com o nome do domínio.

Resultado esperado: você vê os arquivos do site e, agora, o .htaccess na lista.

Se o .htaccess não aparecer mesmo com os ocultos ligados, é porque ele ainda não existe nessa pasta. É normal em sites recém-criados. Veja o que fazer na seção de erros comuns.

Baixar a cópia de segurança antes de alterar uma letra

Jeito mais simples e à prova de erro: clique uma vez sobre o .htaccess para selecionar e clique em Download na barra superior. O arquivo é salvo no seu computador. Guarde em uma pasta que você ache depois.

Se quiser também uma cópia dentro do servidor, são duas etapas, porque a janela de Copy pede o caminho da pasta de destino e não um nome de arquivo novo:

  1. Selecione o .htaccess e clique em Copy. Abre uma janela pequena, com uma frase dizendo para onde o arquivo será copiado, um campo de texto já preenchido com o caminho atual (algo como /public_html) e o botão de confirmação Copy File(s).
  2. No campo, troque o caminho pelo da pasta que fica um nível acima de public_html, que é a pasta inicial da conta, a primeira da árvore à esquerda. Confirme. A cópia vai para lá com o mesmo nome.
  3. Clique nessa pasta na árvore à esquerda, selecione o .htaccess que acabou de chegar e clique em Rename (Renomear). Troque o nome para .htaccess-backup e confirme.

Resultado esperado: o .htaccess original continua em public_html, intocado, e existe um .htaccess-backup guardado na pasta de cima. Esse é o seu caminho de volta.

Editar e salvar o arquivo

Selecione o .htaccess e clique em Edit na barra superior. O cPanel pode exibir um aviso sobre codificação de caracteres; siga adiante. Abre um editor de texto simples.

Cole ou altere o que você precisa, sempre em uma linha nova, e clique em Save Changes no canto superior direito.

Resultado esperado: mensagem de sucesso. A alteração passa a valer na hora, sem reiniciar nada.

Testar o site em aba anônima logo depois de salvar

Abra o site em uma aba anônima do navegador. Teste a página inicial e uma página interna. Se tudo carrega, pronto.

Caminho até o .htaccess no cPanelAbrir GerenciadorcPanel, seção FilesMostrar ocultosSettings, Show Hidden FilesEntrar em public_htmlPasta pública do siteBaixar cópiaDownload antes de editarEditar e testarSave Changes, aba anônima
Todo o caminho é feito com o mouse, sem terminal.

Como voltar atrás quando o site cai com erro 500

Tela branca, erro 500 ou "Internal Server Error" logo depois de salvar significa quase sempre que o conteúdo do .htaccess tem algo que o servidor não entende. A correção, no caso mais comum, é apagar um arquivo e renomear outro.

Situação O que fazer no Gerenciador de Arquivos
Você baixou a cópia para o computador Apague o .htaccess do servidor com Delete e envie o arquivo salvo com Upload, dentro de public_html
Você guardou a cópia .htaccess-backup na pasta acima de public_html Apague o .htaccess de public_html com Delete, selecione o .htaccess-backup, use Copy para o caminho /public_html e lá renomeie a cópia para .htaccess com Rename
Você não fez cópia e só acrescentou linhas Abra o .htaccess em Edit, apague as linhas que você colou e salve
O arquivo não existia antes e você criou Apague o .htaccess com Delete

Depois de restaurar, recarregue o site em uma aba anônima. O navegador guarda páginas antigas, e isso engana muita gente na hora do teste.

Como desfazer uma edição que derrubou o siteSite caiu com erro 500Logo após salvar o arquivoTem cópia no computador?Delete e Upload da cópiaTem .htaccess-backup?Copy para public_html e RenameSó acrescentou linhas?Edit, apague as linhas, salveCriou o arquivo do zero?Delete o .htaccessRecarregue em aba anônimaCache engana no teste
Caminho de volta conforme a cópia que você tem em mãos.

Erros comuns no .htaccess e o que cada um significa

O .htaccess não aparece mesmo com os ocultos ligados. O arquivo não existe nessa pasta. Você pode criar um com + File na barra superior, digitando o nome exato .htaccess, com o ponto na frente e sem extensão. Só crie se o tutorial que você está seguindo pedir.

Existe mais de um .htaccess. É possível e é normal: um em public_html e outro dentro de uma subpasta, por exemplo. O da subpasta vale para aquela subpasta. Mexa no que está na pasta indicada pelo tutorial.

O editor avisa sobre codificação de caracteres. É só um aviso sobre acentuação. Pode prosseguir.

Salvei e nada mudou. Teste em aba anônima. Se o site usa um serviço de cache (uma cópia pronta da página, guardada para ser entregue mais rápido) ou uma CDN (rede de entrega de conteúdo, um serviço que guarda cópias do seu site em vários lugares do mundo para entregar mais rápido), a página antiga pode continuar sendo entregue por alguns minutos.

Aparece erro de permissão ao salvar. O arquivo pode estar marcado como somente leitura. Clique com o botão direito sobre ele, escolha Change Permissions e verifique se o dono tem permissão de escrita. Se não tiver certeza do que está fazendo aqui, pare e peça ajuda ao suporte da sua hospedagem: permissão errada em arquivo público é risco de segurança.

Três situações em que é melhor não mexer

Três situações em que a melhor decisão é fechar o Gerenciador de Arquivos.

  1. Você não sabe o que a linha faz. Copiar uma regra de um fórum sem entender é a origem mais comum de site fora do ar. Procure a fonte oficial da regra antes.
  2. Seu site é WordPress e o plugin oferece fazer o mesmo. Plugins de redirecionamento e de cache escrevem no .htaccess de forma controlada. Se existe o botão, use o botão.
  3. É o único arquivo entre você e um site que está faturando agora. Agende para um horário de baixo movimento, com a cópia feita e a aba do Gerenciador de Arquivos já aberta no caminho de volta.

O .htaccess deixa de ser assustador no momento em que você sabe desfazer. A regra você acha em qualquer tutorial. A cópia feita antes de editar é o que separa um ajuste de dois minutos de um fim de semana perdido.

Referências

  1. Documentação oficial do cPanel — File Manager. Consultado em 2026-09-16.
Leia também