Como configurar cabeçalhos de cache (cache-control) personalizados por tipo de arquivo

Cache-Control por tipo de arquivo: fazendo seu site voar ⚡

Olá! Aqui é a Sensei da GeHost. Hoje vamos falar de um ajuste simples, mas que faz uma diferença enorme na velocidade do seu site: o cache-control personalizado por tipo de arquivo. Pode parecer "coisa de programador", mas prometo te guiar com calma, passo a passo, sem termos técnicos assustadores.

O que é isso, afinal?

Todo arquivo do seu site (imagem, CSS, JavaScript, fonte, HTML) precisa ser baixado pelo navegador de quem visita seu site. O cache-control é uma instrução que diz ao navegador: "pode guardar esse arquivo aí na memória do visitante por um tempo, assim ele não precisa baixar de novo toda vez".

O pulo do gato é que nem todo arquivo deve ser guardado pelo mesmo tempo. Por exemplo:

• Uma logo ou imagem de fundo raramente muda — pode ficar em cache por muito tempo.
• Um arquivo CSS ou JavaScript pode ser atualizado quando você faz alterações no site — cache moderado.
• O HTML das páginas costuma mudar com mais frequência (textos, promoções, novidades) — cache curto ou nenhum.

💡 Dica da Sensei: pense no cache como a validade de um produto na prateleira. Uma lata de conserva pode ficar meses guardada; um pão fresco, só alguns dias. Cada tipo de "arquivo" do seu site tem sua própria validade ideal.

Por que isso importa para desempenho e CDN?

Quando o cache está bem configurado, seu site carrega mais rápido para visitantes que já passaram por ali antes, você economiza tráfego do servidor, e ferramentas de análise de performance (como as que avaliam a "nota" de velocidade do site) tendem a apontar menos alertas sobre "aproveitar cache do navegador".

Passo a passo: configurando o cache-control

No plano de hospedagem cPanel da GeHost, a forma mais comum de personalizar isso é através de um arquivo chamado .htaccess, que fica na pasta principal do seu site (geralmente a public_html).

1. Acesse o Gerenciador de Arquivos

1. Entre no seu cPanel (o acesso fica disponível no seu painel de cliente).
2. Procure e clique em "Gerenciador de Arquivos" (File Manager).
3. Navegue até a pasta public_html (ou a subpasta do seu domínio, se for o caso).

2. Localize (ou crie) o arquivo .htaccess

O arquivo .htaccess começa com ponto, então ele pode estar "escondido". Se não aparecer:

1. Clique em Configurações (canto superior direito do Gerenciador de Arquivos).
2. Marque a opção "Mostrar Arquivos Ocultos (dotfiles)".
3. Se o arquivo não existir, você pode criar um novo arquivo com esse nome exato: .htaccess

⚠️ Atenção: antes de editar o .htaccess, faça uma cópia dele (clique com o botão direito → "Copiar" e salve com outro nome, tipo .htaccess-backup). Assim, se algo der errado, você volta atrás rapidinho.

3. Adicione as regras de cache por tipo de arquivo

Clique com o botão direito sobre o .htaccess e escolha "Editar". Adicione (no final do arquivo) um bloco parecido com este:

<IfModule mod_expires.c>
  ExpiresActive On

  # Imagens: cache longo, elas mudam pouco
  ExpiresByType image/jpeg "access plus 1 year"
  ExpiresByType image/png "access plus 1 year"
  ExpiresByType image/webp "access plus 1 year"
  ExpiresByType image/svg+xml "access plus 1 year"

  # CSS e JavaScript: cache moderado
  ExpiresByType text/css "access plus 1 month"
  ExpiresByType application/javascript "access plus 1 month"

  # Fontes: cache longo
  ExpiresByType font/woff2 "access plus 1 year"

  # HTML: cache curto, para refletir atualizações rápido
  ExpiresByType text/html "access plus 1 hour"
</IfModule>

Você pode ajustar os tempos ("1 year", "1 month", "1 hour") conforme a frequência de atualização do seu conteúdo. O importante é entender a lógica: arquivos estáticos e raramente alterados = cache mais longo; conteúdo dinâmico = cache mais curto.

4. Salve e teste

1. Clique em "Salvar Alterações" no editor.
2. Abra seu site em uma aba anônima do navegador para simular uma visita "nova".
3. Use as ferramentas de desenvolvedor do navegador (aba "Network"/"Rede") para conferir se os arquivos estão mostrando o cabeçalho Cache-Control ou Expires esperado.

💡 Dica da Sensei: se você usa WordPress ou outro CMS com plugin de cache/CDN, verifique se o plugin já cuida disso automaticamente — nesse caso, configurar via .htaccess ao mesmo tempo pode gerar regras conflitantes. Prefira ajustar em um lugar só.

Cuidados importantes

• Se o seu site muda o design ou os arquivos CSS/JS com frequência, cache muito longo pode fazer visitantes recorrentes verem uma versão "antiga" do site até o cache expirar. Uma prática comum nesses casos é versionar o nome do arquivo (ex: estilo.css?v=2) quando fizer uma atualização importante.
• Sempre teste o site depois de qualquer alteração no .htaccess — um erro de sintaxe nesse arquivo pode até deixar o site fora do ar.
• Se algo não funcionar como esperado ou você não se sentir confortável mexendo em arquivos do servidor, nosso suporte está à disposição para ajudar dentro do período de suporte gratuito após a entrega do seu plano.

Precisa de ajuda?

Se tiver qualquer dúvida durante o processo, você pode acessar seu painel do cliente (painel.gehost.com.br) para consultar detalhes do seu plano ou abrir um chamado com nosso suporte. Estamos aqui para ajudar! 🌱