O Google Search Console pode verificar uma propriedade de prefixo de URL por um arquivo HTML acessível na raiz do site. Com acesso à configuração do Nginx, você pode responder a essa URL diretamente, sem criar o arquivo no diretório do site.

O endereço e o conteúdo da resposta precisam corresponder ao arquivo fornecido pelo Google. Este tutorial mostra como configurar a resposta, testá-la e resolver erros comuns.

Antes de começar

Você precisa de acesso à configuração do Nginx e de permissão para testá-la e recarregá-la. No Search Console, adicione uma propriedade do tipo Prefixo do URL, selecione a verificação por arquivo HTML e baixe o arquivo indicado.

O método de arquivo HTML não verifica uma propriedade do tipo Domínio. Nesse caso, use o registro DNS solicitado pelo Search Console. Consulte a documentação oficial de verificação de propriedade para conhecer os requisitos e os métodos disponíveis.

Configure a resposta no Nginx

Abra o arquivo baixado e anote o nome e o conteúdo exatamente como foram fornecidos. O código abaixo usa um identificador fictício: substitua o nome nas duas ocorrências e confira o corpo com o arquivo real.

Dentro do bloco server responsável pela propriedade, adicione:

location = /googleabcdef0123456789.html {
    default_type text/html;
    return 200 'google-site-verification: googleabcdef0123456789.html';
}

O sinal = faz a regra corresponder exatamente ao caminho indicado. A diretiva return entrega a resposta sem encaminhá-la ao WordPress ou ao PHP. O manual do Nginx explica a correspondência exata de location.

Por exemplo, para uma propriedade https://www.exemplo.com.br/, coloque a regra no bloco que atende esse endereço HTTPS. A localização do arquivo de configuração varia conforme a instalação; em sistemas Debian ou Ubuntu, ele costuma estar em /etc/nginx/sites-available/ e ser habilitado em sites-enabled/.

Teste e recarregue a configuração

Antes de aplicar a mudança, verifique a sintaxe:

sudo nginx -t

Se o comando apontar um erro, corrija-o e execute o teste novamente. Quando estiver correto, recarregue o serviço no sistema que usa systemd:

sudo systemctl reload nginx

Em outras instalações, inclusive em contêineres, o comando pode ser diferente. Consulte o guia de reload e restart do Nginx para identificar o procedimento do seu ambiente.

Confirme a resposta pública

Acesse no navegador anônimo a URL exata indicada pelo Search Console. Ela deve estar disponível sem login e mostrar somente o conteúdo do arquivo de verificação. Para conferir pelo terminal, substitua o domínio e o nome pelo valor real:

curl -i https://www.exemplo.com.br/googleabcdef0123456789.html

Confira o status 200 e compare o corpo da resposta com o arquivo baixado. Depois volte ao Search Console e clique em Verificar. Mantenha a resposta acessível após a confirmação: o Google pode verificar a propriedade novamente, e remover o recurso pode fazer você perder a verificação.

Se houver cache ou proteção na frente do servidor, teste o endereço público que o Google acessará. Um proxy, CDN ou regra de segurança pode responder antes do Nginx. Para entender outra parte dessa configuração, veja também o guia de FastCGI Cache no WordPress.

O que fazer se a verificação falhar?

  • Erro 404: confirme o nome completo, o caminho e o bloco server que atende ao domínio e ao HTTPS da propriedade.
  • Erro 403 ou pedido de login: verifique regras de acesso, autenticação e proteção no servidor ou na CDN. A URL precisa ser pública.
  • Resposta diferente: compare o conteúdo com o arquivo baixado para a conta que está verificando a propriedade. Não altere o identificador.
  • Redirecionamento: confira se a URL final corresponde ao endereço esperado. Se o site redireciona para outro domínio e a verificação não funciona, use outro método, como a tag HTML, conforme as instruções do Google.
  • Mudança não aparece: confirme que nginx -t passou, que o serviço correto foi recarregado e que não há resposta antiga em cache.

Preciso manter o arquivo no servidor?

Não neste exemplo: o Nginx devolve o conteúdo diretamente pela regra return. A URL e a resposta precisam continuar disponíveis enquanto você usa esse método de verificação. Se preferir, você também pode enviar o arquivo fornecido pelo Google à raiz do site, sem alterar seu nome ou conteúdo.

Isso melhora a velocidade do site?

A resposta é tratada diretamente pelo Nginx, mas a verificação de propriedade é uma solicitação específica. Não há motivo para esperar uma melhora perceptível na velocidade das páginas. Use a técnica pela praticidade de configurar essa resposta, não como otimização de desempenho.