Configuración del Servidor

Servir archivos estáticos es una parte fundamental del desarrollo web. Necesitas entregar HTML, CSS, JS e imágenes a tus usuarios.

En el framework Hyperlane, esto se hace mediante middleware. El middleware intercepta las solicitudes y lee los archivos de tu disco.

El proceso consta de cuatro pasos:

  • Resolución de rutas: Mapear las URLs a tu sistema de archivos.
  • Detección del tipo de contenido: Encontrar el tipo MIME correcto.
  • Lectura de archivos: Extraer datos del disco.
  • Entrega de la respuesta: Enviar el archivo al cliente.

Hyperlane facilita esto con la utilidad FileExtension. Detecta automáticamente tipos como: • .html a text/html • .css a text/css • .js a application/javascript • .png a image/png

Mejores prácticas para servir archivos estáticos:

  1. Usar E/S asíncrona Usa siempre tokio::fs para leer archivos. Esto evita que tu servidor se bloquee.

  2. Gestionar solicitudes de directorios Si una ruta termina en una barra (/), busca un archivo index.html. Esto ayuda a servir sitios web correctamente.

  3. Establecer los encabezados correctos Asegúrate de enviar el Content-Type adecuado. Si sirves archivos a otros dominios, añade encabezados CORS.

  4. Seguridad y errores

  • Comprueba la existencia del archivo para devolver errores 404.
  • Sanea las rutas para prevenir ataques de salto de directorio (directory traversal).
  • Usa middleware de autenticación si tus recursos son privados.

Hyperlane te brinda las herramientas para construir servidores de archivos eficientes y seguros. Puedes combinar estas herramientas con filtros de ruta para controlar exactamente quién ve tus archivos.

Código del proyecto: https://github.com/hyperlane-dev/hyperlane

Fuente: https://dev.to/tengxgfyrz67s/server-configuration-8i7