Host dan sebarkan ASP.NET Core Blazor WebAssembly dengan Nginx

Nota

Ini bukan versi terbaru dari artikel ini. Untuk rilis saat ini, lihat versi .NET 10 dari artikel ini.

Peringatan

Versi ASP.NET Core ini tidak lagi didukung. Untuk informasi selengkapnya, lihat Kebijakan Dukungan .NET dan .NET Core. Untuk rilis saat ini, lihat versi .NET 9 dari artikel ini.

Artikel ini menjelaskan cara menghosting dan menyebarkan Blazor WebAssembly menggunakan Nginx.

File berikut disederhanakan nginx.conf untuk menunjukkan cara mengonfigurasi Nginx untuk mengirim index.html file setiap kali tidak dapat menemukan file yang sesuai pada disk.

events { }
http {
    server {
        listen 80;

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

Saat mengatur batas laju ledakan NGINX dengan limit_req dan limit_req_zone, Blazor WebAssembly aplikasi mungkin memerlukan nilai parameter besar burst/rate untuk mengakomodasi jumlah permintaan yang relatif besar yang dibuat oleh aplikasi. Awalnya, atur nilai ke setidaknya 60:

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

        location / {
            ...

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

Tingkatkan nilai jika alat pengembang browser atau alat lalu lintas jaringan menunjukkan bahwa permintaan menerima kode status 503 - Layanan Tidak Tersedia .

Untuk informasi lebih lanjut tentang konfigurasi server web NGINX produksi, lihat Membuat File Konfigurasi NGINX Plus dan NGINX.

Penyebaran yang dihosting di Linux (Nginx)

Konfigurasikan aplikasi dengan ForwardedHeadersOptions untuk meneruskan header X-Forwarded-For dan X-Forwarded-Proto dengan mengikuti panduan di Mengonfigurasi ASP.NET Core untuk bekerja dengan server proksi dan load balancer.

Untuk informasi selengkapnya tentang mengatur jalur dasar aplikasi, termasuk konfigurasi jalur sub-aplikasi, lihat jalur dasar aplikasi ASP.NET CoreBlazor.

Ikuti panduan untuk aplikasi ASP.NET Core dengan perubahan berikut:

• Hapuslah konfigurasi untuk buffering proksi (proxy_buffering off;) karena pengaturan ini hanya berlaku untuk Peristiwa Terkirim Server (SSE), yang tidak ada relevansinya dengan interaksi server klien aplikasi Blazor.

• Ubah jalur location dari /hubroute (location /hubroute { ... }) ke sub-aplikasi jalur /{PATH} (location /{PATH} { ... }), di mana {PATH} adalah placeholder sub-aplikasi.

  Contoh berikut mengonfigurasi server untuk aplikasi yang merespons permintaan di jalur /akar :

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

  Contoh berikut mengonfigurasi jalur sub-aplikasi dari /blazor:

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

Sumber daya tambahan

• Menghosting ASP.NET Core di Linux dengan Nginx
• Dokumentasi Nginx:
  • NGINX sebagai Proksi WebSocket
  • Proksi WebSocket
• Pengembang di forum dukungan non-Microsoft:
  • Stack Overflow (tag: blazor)
  • Tim ASP.NET Core di Slack
  • Blazor Gitter