Entendendo .htaccess no KapsuleHost

Compreendendo .htaccess no KapsuleHost

Kapsule oferece todos os sites com um servidor web de alto desempenho que não lê .htaccess, portanto as regras que você adiciona a esse arquivo não têm efeito: este guia explica o que isso significa para um site WordPress e mostra a configuração do KPanel que realiza cada tarefa em vez disso.

Se você se mudou de um host compartilhado cPanel, .htaccess era provavelmente onde você colocava redirecionamentos, forçamento de HTTPS, páginas de erro personalizadas e bloqueios de bots. Todas essas coisas ainda funcionam no Kapsule. Elas são simplesmente definidas no KPanel em vez de em um arquivo de texto, e porque são aplicadas no nível do servidor, são mais rápidas e não podem danificar seu site com um erro de digitação.

Por que .htaccess não faz nada aqui

.htaccess é um arquivo de configuração por diretório para o servidor web Apache. O Apache o relê a cada requisição, o que o torna conveniente e também o que o torna lento.

Kapsule não executa Apache. Seu site é servido por um servidor web orientado a eventos que carrega sua configuração uma única vez na inicialização, o que é uma grande parte do motivo pelo qual os sites aqui respondem mais rapidamente sob carga. Esse servidor não tem equivalente a um arquivo de substituição por diretório, portanto nunca abre .htaccess.

A boa notícia é o oposto da história usual de .htaccess horror: um erro de sintaxe no arquivo não pode derrubar seu site aqui, porque nada o analisa.

O que ainda funciona sem ele

Permalinks. O motivo mais comum para um site WordPress precisar de .htaccess no Apache é pretty permalinks. No Kapsule a reescrita é integrada à configuração do servidor do seu site, portanto /2026/07/my-post/ é resolvido através do WordPress sem nenhum bloco .htaccess. Se os permalinks estão retornando 404s, a causa é outra: veja Corrigindo problemas de permalink do WordPress.

WordPress gravando no arquivo. WordPress e alguns plugins ainda gravam blocos # BEGIN/# END em .htaccess porque assumem Apache. Isso é inofensivo. O arquivo é real, é gravável, e você o verá no gerenciador de arquivos. Ele simplesmente não tem leitor.

Plugins de segurança que relatam "hardening aplicado". Plugins que afirmam ter bloqueado xmlrpc.php ou wp-config.php editando .htaccess não protegeram nada nesta plataforma. Use a guia Security do site, que aplica as regras equivalentes no servidor.

Equivalentes do KPanel para regras .htaccess comuns

Cada um desses fica no site em si: Websites, depois seu site, depois a guia mostrada.

Dois desses fazem mais do que a versão .htaccess jamais poderia fazer. Redirecionamentos suportam caminhos exatos, prefixos de barra final e wildcards como /blog/*, e KPanel verifica o redirecionamento ao vivo depois que você o salva. Páginas de erro são servidas com seu código de status verdadeiro, portanto uma página 404 personalizada ainda é um 404 real para mecanismos de busca em vez de um 200 com um pedido de desculpas nele.

Encontrando e lendo o arquivo

Você ainda pode querer olhar para .htaccess, geralmente para ver o que um plugin gravou nele ou para copiar regras antes de recriá-las no KPanel.

Na guia WordPress

1. Entre no KPanel e clique em Websites na barra lateral esquerda.
2. Clique no site que deseja.
3. Abra a guia WordPress, depois a seção wp-config.
4. Role até o painel .htaccess. O conteúdo é mostrado somente leitura, com um botão Edit se você precisar alterá-lo.

Do gerenciador de arquivos

1. Abra o site, depois Files, depois File Manager.
2. Clique em Show Hidden na barra de ferramentas. Arquivos começando com um ponto estão ocultos por padrão, portanto .htaccess não aparecerá até que você faça isso.
3. Clique em .htaccess para abri-lo no editor integrado.

O arquivo fica na raiz do seu site, ao lado de wp-config.php e wp-content. Detalhes completos sobre o editor e seus controles de permissões estão em Using the File Manager.

O bloco WordPress padrão

Para referência, este é o bloco que WordPress escreve para si mesmo. Em um host Apache ele aciona permalinks. No Kapsule é inerte, e deletá-lo não quebrará nada:

# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

Deixe-o no lugar se você puder mover o site para um host Apache depois. WordPress o reescreverá de qualquer forma na próxima vez que você salvar suas configurações de permalink.

Se você estiver migrando regras

Quando você traz um site de cPanel, abra o antigo .htaccess antes de cancelar o antigo host e trabalhe através dele linha por linha:

1. Redirects. Recrie cada Redirect ou RewriteRule em Advanced, depois Redirects. Uma linha por regra. Escolha 301 para uma mudança permanente, 302 se a mudança puder ser revertida.
2. HTTPS forcing. Delete-o. Ative Force HTTPS em Settings do site em vez disso.
3. IP blocks. Recrie em WordPress, depois Security, no painel de bloqueio de IP.
4. Caching and compression headers. Delete-os. Eles são tratados para você, e regras mod_expires antigas de um host antigo são uma fonte comum de comportamento de cache confuso.
5. Anything a plugin wrote. Ignore-o. Reinstale o plugin no novo site e deixe-o fazer sua própria coisa.

Sua migração mantém o arquivo em si, portanto nada é perdido enquanto você trabalha na lista. Passo a passo completo da migração: Migrating a Website From cPanel.

Solução de problemas

"Adicionei um redirecionamento a .htaccess e nada aconteceu." Esperado. Adicione-o em Advanced, depois Redirects. A coluna Status lá mostra se o redirecionamento foi verificado ao vivo.

"Um plugin diz que meu site está hardened mas um scanner discorda." O plugin gravou regras .htaccess que não estão sendo lidas. Verifique a guia Security do site para as proteções que são genuinamente aplicadas.

"O .htaccess do meu host antigo tinha regras que não entendo." Não as copie cegas. Abra um ticket com o arquivo anexado e diremos quais têm um equivalente Kapsule e quais estavam apenas compensando um host Apache compartilhado.

"Permalinks estão quebrados." Isso não é um problema .htaccess aqui. Vá para Fixing WordPress Permalink Issues, ou limpe as regras de reescrita na guia WordPress do site, depois Quick Actions, depois Flush Rewrites.