Resolviendo errores 404 en .well-known/traffic-advice

Sí ves en tus logs de Nginx errores similares a los siguientes:

[14/Sep/2025:09:30:30 +0200] "GET /.well-known/traffic-advice HTTP/2.0" 404 27772 "-" "Chrome Privacy Preserving Prefetch Proxy"

¿Qué es .well-known/traffic-advice?

El archivo traffic-advice, ubicado en el directorio /.well-known/, es un fichero de configuración en formato JSON (aunque sin extensión .json). Esta decisión se tomó para mantener flexibilidad en futuras adaptaciones.

Actualmente, solo Chrome lo utiliza, y sirve para comunicarse con los proxies de prefetch que visitan tu sitio, indicando si deben realizar precarga de tus páginas y en qué medida.
La extensión de precarga se representa con un valor decimal entre 0.0 (0%) y 1.0 (100%).

Chrome Privacy Preserving Prefetch Proxy bot

Este bot de Chrome busca acelerar la carga de páginas. Básicamente descarga en segundo plano contenido de sitios que el usuario podría visitar, de manera que estén listos cuando haga clic.
Al mismo tiempo, protege la privacidad evitando filtrar información sensible hacia esos sitios.

Según Google, este mecanismo permite reducir hasta un 30% los tiempos de carga.

Más detalles:

Especificación técnica en GitHub

Documentación oficial de Chrome

Resolución

Para eliminar los errores 404 y procesar correctamente estas solicitudes, hay que seguir los siguientes pasos.

En Nginx

1. Crear el directorio .well-known en la raíz de tu sitio:
   sudo mkdir -p /sites/domain.com/.well-known
2. Crear el archivo traffic-advice:
   vim /sites/domain.com/.well-known/traffic-advice
3. Añadir este contenido JSON al archivo:
   [{
"user_agent": "prefetch-proxy",
"google_prefetch_proxy_eap": {
"fraction": 1.0
}
}]
4. Asignar la propiedad correcta del archivo:
   sudo chown www-data:www-data /sites/domain.com/.well-known/traffic-advice
5. Configurar Nginx para devolver el archivo con el tipo MIME correcto (application/trafficadvice+json):
   Edita /etc/nginx/nginx.conf y añade:
   location ^~ /.well-known/traffic-advice {
allow all;
types { } default_type "application/trafficadvice+json; charset=utf-8";
alias /sites/domain.com/.well-known/traffic-advice;
}
6. Recargar Nginx:
   systemctl reload nginx.service

Prueba de funcionamiento

Ejecuta el siguiente comando desde una terminal Linux:

curl --head https://domain.com/.well-known/traffic-advice

Si todo está correcto, deberías recibir una respuesta HTTP/2 200 con el encabezado:

content-type: application/trafficadvice+json; charset=utf-8

Esto confirmará que el archivo está siendo servido correctamente.

Acerca del autor

Juan José Fernández Durán

Administrator

Arquitecto IT & Consultor IT

Ver todas las entradas