Base de Conhecimento

Cache do navegador: o que é e como configurar no site

  • cache do navegador, cache-control, velocidade do site, pagespeed insights, apache, nginx
  • Usuários acharam útil: 0

Entenda a validade com max-age, a validação com ETag e Last-Modified, a auditoria do Lighthouse sobre política de cache e como resolver quando o visitante ainda vê a versão antiga.

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: Cache do navegador: o que é e como configurar no site

Capa da Redação Eleven Host para o guia: Cache do navegador: o que é e como configurar no site Arte: Eleven Host

Cache do navegador é a cópia que o navegador guarda dos arquivos de um site, como imagens, CSS e JavaScript, para usar de novo na próxima visita sem baixar tudo outra vez. O prazo dessa cópia é controlado por cabeçalhos HTTP, principalmente os da resposta do servidor.

Pela MDN, uma prática comum é trocar o endereço do arquivo a cada mudança de conteúdo, com versão ou hash no nome, para poder guardá-lo por muito tempo. Para o HTML, que não muda de nome, a MDN indica no-cache, que faz o navegador conferir com o servidor antes de cada uso.

O que é cache do navegador

A MDN explica que o cache HTTP guarda a resposta ligada a uma requisição e a reaproveita nas requisições seguintes. O cache do navegador é o tipo chamado de privado: fica no aparelho de um visitante e serve só a ele.

O web.dev descreve o caminho de uma requisição: o navegador olha primeiro o próprio cache e, se encontra uma resposta válida, lê o arquivo dali e não usa a rede.

Pelo web.dev, o comportamento do cache é controlado por cabeçalhos HTTP, e a configuração do servidor é o que mais pesa nos de resposta. Alguns servidores já mandam esses cabeçalhos por padrão, outros só se forem configurados. Sem o cabeçalho Cache-Control, o cache não fica desligado: o navegador tenta adivinhar por quanto tempo guardar. A MDN chama isso de cache heurístico e diz que, basicamente, as respostas deveriam declarar o Cache-Control de forma explícita.

Cada site publicado responde por um nome registrado, e a Eleven Host faz registro de domínio em centenas de extensões. Buscar domínio

Como o cache funciona: validade e validação

A MDN divide a vida de uma cópia em duas fases. Enquanto está fresca, o navegador pode reaproveitá-la. Depois que vence, a cópia não é jogada fora: o navegador pergunta ao servidor se ela ainda serve.

Validade com max-age

A diretiva max-age do Cache-Control diz por quantos segundos a resposta fica fresca. No exemplo da MDN, Cache-Control: max-age=604800 vale uma semana. Com Expires e max-age juntos, a MDN informa que vale o max-age.

Validação com ETag e Last-Modified

Para conferir uma cópia vencida, o navegador manda uma requisição condicional. Com o ETag, um valor que o servidor gera para aquela versão do arquivo, o navegador envia If-None-Match. Com o Last-Modified, a data da última mudança, envia If-Modified-Since. Se o arquivo não mudou, o servidor responde 304 Not Modified.

Pela MDN, a resposta 304 não tem corpo e só confirma que a cópia guardada continua válida. O web.dev acrescenta que uma resposta 304 carrega pouquíssimos dados e por isso é bem mais rápida do que reenviar o arquivo. Se o arquivo mudou, o servidor manda um 200 OK com a versão nova.

Diretivas do Cache-Control citadas pela MDN e pelo web.dev

  • max-age=N: a resposta fica fresca por N segundos.
  • no-cache: pode guardar, mas precisa confirmar com o servidor antes de cada uso. Não quer dizer "não guardar".
  • no-store: nenhum cache guarda a resposta.
  • private: só o cache do navegador guarda; caches compartilhados não.
  • public: caches compartilhados também podem guardar.
  • immutable: avisa que o arquivo não muda enquanto estiver fresco, o que evita a revalidação ao recarregar. O web.dev observa que alguns navegadores ignoram essa diretiva.

A auditoria do Lighthouse sobre política de cache

A documentação do Lighthouse, no developer.chrome.com, descreve uma auditoria sobre a política de cache dos recursos estáticos. Segundo a página, ela olha fontes, imagens, mídia, scripts e folhas de estilo que respondem com código 200, 203 ou 206 e não têm uma política explícita de no-cache.

A recomendação da documentação é guardar por muito tempo os arquivos estáticos que não mudam, como um ano ou mais, com o exemplo max-age=31536000. A mesma página avisa que um prazo longo pode fazer o visitante não ver uma atualização e que mais longo nem sempre é melhor. Para entender as métricas de experiência da página, veja Core Web Vitals: o que são e como melhorar no site.

Quanto tempo guardar cada tipo de arquivo

Não existe um prazo único que sirva para todo site. A MDN chega a dizer que, entre os valores longos mais comuns, na prática faz pouca diferença qual se escolhe. Uma forma de organizar é separar os arquivos em dois grupos.

Arquivos com versão no nome, como CSS, JavaScript e imagens. Para eles, a MDN sugere max-age longo com immutable, no exemplo Cache-Control: public, max-age=31536000, immutable, que corresponde a um ano.

HTML e arquivos que não mudam de nome, como a página principal, o favicon.ico e o manifest.json. A MDN indica Cache-Control: no-cache com ETag ou Last-Modified, para o navegador conferir com o servidor a cada uso. Em páginas personalizadas, como as de área logada, entra também o private.

A MDN não recomenda usar no-store à vontade, porque o site perde vantagens como o cache de voltar e avançar do navegador. Recomendamos guardar o no-store para respostas que não devem ficar em cache nenhum e usar prazos longos só onde o arquivo tem versão no nome.

Como configurar no Apache

No Apache, o módulo mod_expires controla o cabeçalho Expires e o max-age do Cache-Control. Pela documentação do Apache, as diretivas ExpiresActive, ExpiresByType e ExpiresDefault podem ir na configuração do servidor ou num arquivo .htaccess, desde que o servidor permita sobrescrever opções do grupo Indexes. Sobre esse arquivo, veja Arquivo htaccess: o que é e como editar no site.

O prazo é escrito como base mais intervalo: access conta a partir do acesso do visitante e modification, a partir da última mudança do arquivo. Os prazos do exemplo abaixo são só ilustrativos: enquanto a cópia estiver fresca, o visitante pode continuar vendo a versão antiga do arquivo, como explica a seção sobre a versão velha, mais adiante. Um exemplo:

ExpiresActive On

ExpiresByType image/png "access plus 1 month"

ExpiresByType image/jpeg "access plus 1 month"

ExpiresByType text/css "access plus 1 week"

ExpiresByType application/javascript "access plus 1 week"

O ExpiresByType só vale com ExpiresActive On. Confira no seu servidor se o módulo está ativo e qual tipo de arquivo ele informa para cada extensão antes de copiar as linhas.

Para diretivas como immutable, o Apache indica a diretiva Header do mod_headers, que também aceita .htaccess quando o servidor libera o grupo FileInfo. Com o mod_headers ativo, num .htaccess de pasta que só tenha arquivos com versão no nome, um exemplo:

Header set Cache-Control "max-age=31536000, immutable"

Como configurar no Nginx

No Nginx, a diretiva expires acrescenta os cabeçalhos Expires e Cache-Control. Pelo nginx.org, um tempo positivo gera max-age em segundos e um negativo gera no-cache; ela pode ir nos blocos http, server e location. Para uma pasta de arquivos estáticos, um exemplo:

location /assets/ {

expires 30d;

}

Ajuste o caminho para a pasta do seu site; os 30 dias do exemplo são só ilustrativos. Teste a configuração antes de recarregar o Nginx. Quem administra o próprio servidor encontra o que é uma VPS no guia de servidor VPS.

Como conferir no Chrome DevTools

A documentação do Lighthouse descreve o caminho: abra o DevTools com Ctrl+Shift+J (Cmd+Option+J no Mac) e vá à aba Network. Recarregue a página, clique no arquivo na coluna Name e abra a aba Headers. Em Response Headers, procure o Cache-Control e veja se o valor é o que você configurou. A coluna Size pode indicar se o arquivo veio do cache. Pela MDN, o recarregamento comum faz o navegador revalidar as respostas; por isso, para ver o cache em uso, recomendamos abrir o endereço de novo em vez de recarregar.

Pela referência do painel Network, a caixa Disable cache simula a primeira visita de alguém. Recomendamos conferir com a caixa desmarcada, já que com ela marcada o navegador não usa o cache.

Mudei o site e o visitante ainda vê a versão velha

Esse é o efeito colateral de um prazo longo: a cópia guardada continua fresca e o navegador pode seguir reaproveitando-a. A saída que a MDN, o web.dev e o Lighthouse apontam é mudar o endereço do arquivo quando o conteúdo muda. Os exemplos da MDN são bundle.v123.js e bundle.js?v=123; o do web.dev é style.x234dff.css. Com nome novo, o navegador trata o arquivo como outro e baixa a versão atual, e o HTML, conferido a cada uso, já aponta para ele.

Para ver a mudança no seu próprio computador, a ajuda do Chrome orienta abrir Mais, depois Excluir dados de navegação, escolher o período e marcar a opção de imagens e arquivos armazenados em cache; cookies ficam em outra caixa. Isso limpa só o seu navegador, não o dos visitantes.

Cache do navegador, cache de página e cache do servidor

O cache do navegador fica no aparelho do visitante. Já o cache compartilhado, segundo a MDN, fica entre o visitante e o servidor, como um proxy reverso ou uma CDN, e o s-maxage define o prazo só para ele. A MDN observa que guardar HTML por muito tempo exige um cache gerenciado que possa ser limpo de propósito, como uma CDN ou um service worker.

Em resumo

Prazo longo para arquivos com versão no nome, conferência a cada uso para o HTML e uma olhada nos cabeçalhos depois de cada mudança.

Assinatura mensal de servidor virtual (VPS) também é oferecida pela Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver VPS

Perguntas frequentes

O que é cache do navegador?

É a cópia que o navegador guarda das respostas de um site para reaproveitar nas visitas seguintes. O tempo de validade é indicado pelos cabeçalhos Cache-Control ou Expires, quando o servidor os envia.

Qual a diferença entre no-cache e no-store?

Pela MDN, no-cache deixa guardar, mas exige confirmar com o servidor antes de cada uso. Com no-store, nenhum cache guarda a resposta.

Por quanto tempo devo guardar os arquivos?

Depende do arquivo. O Lighthouse sugere um ano ou mais para arquivos estáticos que não mudam e lembra que mais longo nem sempre é melhor. Nos exemplos da MDN, o HTML fica com no-cache.

Como faço o visitante ver a versão nova de um arquivo?

Mude o nome do arquivo quando o conteúdo mudar, com uma versão ou um hash, e atualize o HTML para apontar para o nome novo.

Esta resposta lhe foi útil?

Artigos Relacionados