Base de Conhecimento

Arquivo htaccess: o que é e como editar no site

  • htaccess, apache, redirecionamento, wordpress, erro 500, servidor web
  • Usuários acharam útil: 0

Entenda como o .htaccess funciona no Apache, quando a documentação recomenda evitá-lo, como achar e editar o arquivo com segurança e o que fazer diante de um erro 500.

Por Redação Eleven Host · @robson.direitodigital · 18 de novembro de 2026 · 9 min de leitura

Arte da Eleven Host: janela de terminal com o título: Arquivo htaccess: o que é e como editar no site

Capa da Redação Eleven Host para a notícia: Arquivo htaccess: o que é e como editar no site Arte: Eleven Host

O arquivo htaccess é um arquivo de configuração do Apache que fica dentro de uma pasta do site e muda o comportamento do servidor só para aquela pasta e as que estão abaixo dela: redirecionamentos, páginas de erro, bloqueios de acesso e cabeçalhos.

O Apache só lê o .htaccess quando a diretiva AllowOverride permite, e o padrão dela é None. Com acesso à configuração principal do servidor, a documentação do Apache recomenda colocar as regras lá.

O que é o arquivo htaccess e onde ele fica

A documentação do Apache chama os arquivos .htaccess de arquivos de configuração distribuída. Cada um traz uma ou mais diretivas, escritas com a mesma sintaxe da configuração principal do servidor, e fica numa pasta de documentos do site. As regras valem para essa pasta e para todas as subpastas.

Um lugar possível é a pasta raiz do site, onde está a página inicial. Nada impede que existam outros .htaccess em subpastas. Segundo o Apache, as diretivas são aplicadas na ordem em que aparecem, e o arquivo de uma subpasta pode sobrepor o da pasta de cima, que por sua vez pode sobrepor a configuração principal.

A documentação dá um exemplo: se uma pasta libera a execução de CGI com Options +ExecCGI e uma subpasta tem só Options Includes, na subpasta vale apenas a segunda linha. Colocar uma diretiva no .htaccess de uma pasta equivale, para o Apache, a colocá-la numa seção Directory daquela pasta.

O WordPress também usa o arquivo. A documentação do WordPress explica que ele controla como o Apache entrega os arquivos da pasta raiz e das subpastas, e que o WordPress mexe no arquivo para ter os links permanentes amigáveis, aqueles endereços com o nome do post em vez de números.

Quando a documentação do Apache recomenda evitar

Segundo o Apache, o uso adequado do .htaccess é quando quem cuida do conteúdo precisa mudar a configuração por pasta, mas não tem acesso de administrador ao servidor. A documentação cita como exemplos a hospedagem gerenciada, a hospedagem com painel e os sistemas de gerenciamento de conteúdo que já trazem um .htaccess.

Para quem tem acesso ao arquivo de configuração principal, a mesma documentação recomenda colocar toda a configuração lá, inclusive autenticação e regras de reescrita de endereços. Esse pode ser o caso de quem administra um servidor próprio; para entender esse tipo de servidor, veja o guia completo de servidor VPS.

Um dos motivos é desempenho. Com o .htaccess liberado, o Apache procura o arquivo em cada pasta do caminho a cada pedido, mesmo que ele não exista. Um arquivo pedido em /www/htdocs/example, por exemplo, gera quatro acessos extras ao disco. Já a configuração principal é carregada uma vez, quando o servidor inicia. As regras de reescrita também pesam: no .htaccess, as expressões são recompiladas a cada pedido.

Há ainda a questão de controle. Segundo o Apache, liberar o .htaccess permite que usuários mudem a configuração do servidor, com mudanças fora do controle de quem administra.

Quando o Apache lê o .htaccess: AllowOverride

Quem decide se o arquivo vale é a diretiva AllowOverride, definida na configuração principal, dentro de uma seção Directory. O padrão é AllowOverride None: nesse caso, segundo a documentação, os .htaccess são ignorados por completo e o servidor nem tenta lê-los.

Com AllowOverride All, qualquer diretiva que aceite o contexto .htaccess passa a valer. Também é possível liberar só categorias, como FileInfo ou AuthConfig. Cada diretiva tem, na documentação do Apache, uma linha que diz qual categoria precisa estar liberada. Se o arquivo trouxer uma diretiva que não foi liberada, o Apache responde com erro interno do servidor, o erro 500.

Do lado da Eleven Host, a VPS é um dos produtos à venda. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS

Como achar e editar o arquivo htaccess

O nome começa com um ponto, e muitos programas de arquivos não mostram esse tipo de arquivo de início. Se ele não aparecer na pasta do site, procure a opção de mostrar arquivos ocultos no programa que você usa.

Há três caminhos comuns para chegar até ele:

  • FTP ou SFTP. Um programa de transferência baixa o arquivo, você edita num editor de texto simples e envia de volta.
  • Gerenciador de arquivos. Se a sua hospedagem tem um painel com gerenciador de arquivos, ele pode abrir arquivos de texto no navegador; confira no painel que você usa.
  • Terminal. Num servidor com acesso por SSH, você entra na pasta do site e abre o arquivo num editor de texto do terminal.

No terminal, um exemplo de comando que lista também os arquivos que começam com ponto, dentro da pasta do site:

ls -a

Antes de salvar uma mudança

  • Recomendamos guardar uma cópia do .htaccess atual, com outro nome ou no seu computador, antes de editar.
  • Recomendamos mudar uma coisa de cada vez e recarregar o site depois de cada mudança.
  • Recomendamos usar um editor de texto simples, sem formatação.
  • Se o site mostrar erro, recomendamos voltar a cópia antes de tentar de novo.

Usos comuns, com exemplos da documentação

Os exemplos abaixo vêm da documentação oficial do Apache e do WordPress. Troque os nomes e caminhos pelos do seu site e confira no seu servidor quais módulos estão ativos antes de usar cada um.

Redirecionar uma página

A diretiva Redirect, do módulo mod_alias, aceita o contexto .htaccess. Sem status, o redirecionamento é temporário (302); com permanent, é 301. Um exemplo, da documentação do Apache:

Redirect permanent "/one" "http://example.com/two"

A diferença entre os códigos e o que o Google diz sobre eles estão no artigo Redirecionamento 301: o que é e como fazer no site.

Levar o visitante de http para https

A forma preferida pelo Apache é um Redirect na configuração principal, num virtual host da porta 80. Sem acesso a ela, a documentação indica o mod_rewrite no .htaccess. Um exemplo, da documentação do Apache:

RewriteEngine On

RewriteCond "%{HTTPS}" !=on

RewriteRule "^(.*)" "https://%{SERVER_NAME}$1" [R=301,L]

O Apache alerta que, atrás de um balanceador ou proxy que cuida do certificado, a variável HTTPS aparece sempre como desligada; nesse cenário, a regra pode entrar em loop. Recomendamos conferir se o certificado do site está funcionando antes de forçar o https; se o navegador mostrar aviso, veja Sua conexão não é particular: o que é e como resolver.

Página de erro personalizada

A diretiva ErrorDocument aceita o contexto .htaccess e pede a categoria FileInfo liberada. Um exemplo, da documentação do Apache:

ErrorDocument 404 /errors/bad_urls.php

O Apache avisa que, se o destino for um endereço completo em outro site, o visitante é redirecionado e não recebe o código de erro original.

Bloquear acesso a arquivos

A diretiva Require, do módulo mod_authz_core, aceita o contexto .htaccess e pede a categoria AuthConfig. Require all denied nega o acesso sem condição. Um exemplo, da documentação do WordPress, que bloqueia o acesso pela web a arquivos sensíveis:

<FilesMatch "^(wp-config\.php|\.htaccess|\.htpasswd|debug\.log)$">

Require all denied

</FilesMatch>

Acrescentar cabeçalhos

A diretiva Header, do módulo mod_headers, também aceita o contexto .htaccess, com a categoria FileInfo. Um exemplo, da documentação do Apache, que acrescenta à resposta um cabeçalho com dados de tempo do pedido:

Header set MyHeader "%D %t"

O .htaccess padrão do WordPress

A documentação do WordPress traz o bloco básico, que pode servir para restaurar o arquivo quando ele se corrompe, por exemplo depois de um plugin com defeito. Ele liga a reescrita de endereços, deixa passar arquivos e pastas que existem e manda o resto para o index.php. Um exemplo, da documentação do WordPress, para conferir no seu site antes de usar:

# BEGIN WordPress

RewriteEngine On

RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

RewriteBase /

RewriteRule ^index\.php$ - [L]

RewriteCond %{REQUEST_FILENAME} !-f

RewriteCond %{REQUEST_FILENAME} !-d

RewriteRule . /index.php [L]

# END WordPress

Instalações multisite têm blocos próprios, também na documentação do WordPress.

Erro 500 depois de editar

Segundo o Apache, o problema mais comum com .htaccess é o AllowOverride não permitir as diretivas usadas. Quando isso acontece, o servidor responde com erro 500.

Se o site parou logo depois da edição, recomendamos voltar a cópia que você guardou e recarregar a página. A documentação orienta olhar o log de erros do Apache, onde mostra duas causas possíveis: uma diretiva que não é permitida naquele ponto ou um erro de sintaxe.

Há também o caso contrário: nada do que você escreve faz efeito. A documentação sugere um teste simples, que é colocar uma palavra sem sentido no arquivo e recarregar a página. Se não aparecer o erro 500, quase certamente o AllowOverride está em None e o arquivo está sendo ignorado. Depois do teste, tire a palavra.

E no Nginx?

O .htaccess é um recurso do Apache. A documentação do Nginx tem uma página sobre como converter regras que antes ficavam no .htaccess em configuração do próprio Nginx. Para mandar o domínio sem www para a versão com www, por exemplo, ela indica um bloco server separado. Um exemplo, da documentação do Nginx:

server {

listen 80;

server_name example.org;

return 301 http://www.example.org$request_uri;

}

Se o seu site roda em Nginx, confira com quem administra o servidor onde fica essa configuração.

Nome do site

O .htaccess cuida de regras do servidor; o nome que o visitante digita para chegar ao site vem do domínio.

Junto com as VPS, a Eleven Host registra domínios em centenas de extensões. Buscar domínio

Perguntas frequentes

Onde fica o arquivo htaccess?

Numa pasta de documentos do site, como a raiz. As regras valem para essa pasta e as subpastas, e pode haver outros .htaccess em subpastas.

Por que o .htaccess não aparece na pasta?

O nome começa com ponto, e muitos programas escondem esse tipo de arquivo. Ative a opção de mostrar arquivos ocultos. Se ele não existir, o site pode estar sem um.

Quando o Apache lê o .htaccess depois de uma edição?

Segundo a documentação, o Apache carrega o .htaccess a cada pedido, ao contrário da configuração principal, lida quando o servidor inicia. Depois de editar, recarregue a página e confira o resultado.

O arquivo htaccess funciona no Nginx?

O .htaccess é do Apache. Para o Nginx, a documentação dele mostra como converter as regras para a configuração do servidor.

Esta resposta lhe foi útil?

Artigos Relacionados