Compartir a través de

Hospedar e implementar ASP.NET Core Blazor WebAssembly con Nginx

Nota:

Esta no es la versión más reciente de este artículo. Para la versión actual, consulte la versión de .NET 10 de este artículo.

Advertencia

Esta versión de ASP.NET Core ya no se admite. Para obtener más información, consulte la política de soporte de .NET y .NET Core. Para la versión actual, consulte la versión de .NET 9 de este artículo.

En este artículo se explica cómo hospedar e implementar Blazor WebAssembly mediante Nginx.

El siguiente nginx.conf archivo se simplifica para mostrar cómo configurar Nginx para enviar el index.html archivo siempre que no pueda encontrar un archivo correspondiente en el disco.

events { }
http {
    server {
        listen 80;

        location / {
            root      /usr/share/nginx/html;
            try_files $uri $uri/ /index.html =404;
        }
    }
}

Al establecer el límite de velocidad de ráfaga NGINX con limit_req y limit_req_zone, Blazor WebAssembly las aplicaciones pueden requerir valores de parámetros grandes burst/rate para dar cabida al número relativamente grande de solicitudes realizadas por una aplicación. Inicialmente, establezca el valor en al menos 60:

http {
    limit_req_zone $binary_remote_addr zone=one:10m rate=60r/s;
    server {
        ...

        location / {
            ...

            limit_req zone=one burst=60 nodelay;
        }
    }
}

Aumente el valor si las herramientas de desarrollo del explorador o una herramienta de tráfico de red indican que las solicitudes reciben un código de estado 503- Servicio no disponible .

Para obtener más información sobre la configuración del servidor web nginx de producción, consulte Creación de archivos de configuración ngINX Plus y NGINX.

Implementación hospedada en Linux (Nginx)

Configure la aplicación con ForwardedHeadersOptions para reenviar los X-Forwarded-For encabezados y X-Forwarded-Proto siguiendo las instrucciones de Configuración de ASP.NET Core para trabajar con servidores proxy y equilibradores de carga.

Para obtener más información sobre cómo establecer la ruta de acceso base de la aplicación, incluida la configuración de la ruta de acceso de la aplicación secundaria, consulte ASP.NET ruta de acceso base de la aplicación principalBlazor.

Siga las instrucciones para obtener una aplicación SignalR de ASP.NET Core con los siguientes cambios:

  • Quite la configuración de almacenamiento en búfer de proxy (proxy_buffering off;) porque la configuración solo se aplica a los eventos enviados por el servidor (SSE), que no son relevantes para las interacciones cliente-servidor de la aplicación Blazor.

  • Cambie la ruta de location de /hubroute (location /hubroute { ... }) a la ruta de la aplicación secundaria /{PATH} (location /{PATH} { ... }), donde el marcador de posición {PATH} es la ruta de la aplicación secundaria.

    En el ejemplo siguiente se configura el servidor para una aplicación que responde a las solicitudes en la ruta de acceso raíz /:

    http {
    server {
        ...
        location / {
            ...
        }
    }
}

    En el ejemplo siguiente se configura la ruta de acceso de la aplicación secundaria de /blazor:

    http {
    server {
        ...
        location /blazor {
            ...
        }
    }
}

Recursos adicionales

  • Last updated on