Delen via

ASP.NET Core Blazor WebAssembly hosten en implementeren met Nginx

Notitie

Dit is niet de nieuwste versie van dit artikel. Zie de .NET 9-versie van dit artikelvoor de huidige release.

Waarschuwing

Deze versie van ASP.NET Core wordt niet meer ondersteund. Zie de .NET- en .NET Core-ondersteuningsbeleidvoor meer informatie. Zie de .NET 9-versie van dit artikelvoor de huidige release.

Belangrijk

Deze informatie heeft betrekking op een pre-releaseproduct dat aanzienlijk kan worden gewijzigd voordat het commercieel wordt uitgebracht. Microsoft geeft geen garanties, uitdrukkelijk of impliciet, met betrekking tot de informatie die hier wordt verstrekt.

Zie de .NET 9-versie van dit artikelvoor de huidige release.

In dit artikel wordt uitgelegd hoe u Nginx host en implementeertBlazor WebAssembly.

Het volgende nginx.conf bestand is vereenvoudigd om te laten zien hoe u Nginx configureert om het index.html-bestand te verzenden wanneer er geen bijbehorend bestand op schijf kan worden gevonden.

events { }
http {
    server {
        listen 80;

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

Bij het instellen van de limiet voor NGINX-burstfrequentie met limit_req enlimit_req_zoneBlazor WebAssembly, is voor apps mogelijk een grote burst/rate parameterwaarde vereist voor het relatief grote aantal aanvragen dat door een app wordt gedaan. Stel in eerste instantie de waarde in op ten minste 60:

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

        location / {
            ...

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

Verhoog de waarde als hulpprogramma's voor browserontwikkelaars of een hulpprogramma voor netwerkverkeer aangeeft dat aanvragen een 503 - Service niet beschikbaar statuscode ontvangen.

Zie NGINX Plus- en NGINX-configuratiebestanden makenvoor meer informatie over de configuratie van Nginx-webservers.

Gehoste implementatie op Linux (Nginx)

Configureer de app met ForwardedHeadersOptions om de X-Forwarded-For- en X-Forwarded-Proto-headers door te sturen, door de richtlijnen in te volgen en ASP.NET Core te configureren om met proxyservers en load balancers te werken.

Zie voor meer informatie over het instellen van het basispad van de app, inclusief configuratie van het pad voor sub-apps, basispad van de ASP.NET Core-appBlazor.

Volg de richtlijnen voor een ASP.NET Core SignalR-app met de volgende wijzigingen:

  • Verwijder de configuratie voor proxybuffering (proxy_buffering off;) omdat de instelling alleen van toepassing is op Server-Sent Gebeurtenissen (SSE), die niet relevant zijn voor Blazor client-serverinteracties van de app.

  • Wijzig het location pad van /hubroute (location /hubroute { ... }) in het sub-app-pad /{PATH} (location /{PATH} { ... }), waarbij de plaatsaanduiding {PATH} het sub-app-pad is.

    In het volgende voorbeeld wordt de server geconfigureerd voor een app die reageert op aanvragen op het hoofdpad /:

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

    In het volgende voorbeeld wordt het sub-app-pad van /blazorgeconfigureerd:

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

Aanvullende bronnen