‫پیشنیازهای ضروری برای استفاده از HTTP/3 در دات‌نت

• ویندوز: نسخه‌های ویندوز 11 و ویندوز سرور 2022 به‌صورت بومی از MsQuic پشتیبانی می‌کنند. نسخه‌های قدیمی‌تر ویندوز (مانند ویندوز 10 یا ویندوز سرور 2019) ممکن است به‌روزرسانی‌های خاصی نیاز داشته باشند یا به‌طور کامل پشتیبانی نشوند.
• لینوکس: توزیع‌های خاصی مانند اوبونتو 20.04 و جدیدتر، فدورا 33 و جدیدتر، و سایر توزیع‌های سازگار با کتابخانه‌های موردنیاز MsQuic پشتیبانی می‌شوند. این توزیع‌ها باید وابستگی‌هایی مانند OpenSSL یا Libmsquic را نصب کرده باشند.
• macOS: پشتیبانی از macOS در حال توسعه است، اما در نسخه‌های NET 8. و قبل‌تر، ممکن است محدودیت‌هایی وجود داشته باشد یا نیاز به پیکربندی دستی باشد.

• OpenSSL: در سیستم‌های لینوکس و macOS، MsQuic به نسخه خاصی از OpenSSL (معمولاً 1.1.1 یا جدیدتر) نیاز دارد تا قابلیت‌های رمزنگاری (Cryptography) موردنیاز QUIC و TLS را فراهم کند.
• Libmsquic: در برخی موارد، ممکن است نیاز باشد که کتابخانه Libmsquic به‌صورت جداگانه نصب شود. این کتابخانه برای مدیریت پروتکل QUIC استفاده می‌شود و باید با نسخه دات‌نت سازگار باشد.

• HTTP/3 به TLS 1.3 وابسته است، زیرا QUIC رمزنگاری را به‌صورت داخلی مدیریت می‌کند. بنابراین، سیستم باید TLS 1.3 را پشتیبانی کند و کتابخانه‌های رمزنگاری مرتبط به‌درستی پیکربندی شده باشند.

• MsQuic از معماری‌های x64 و ARM64 پشتیبانی می‌کند. معماری‌های قدیمی‌تر (مانند x86) ممکن است پشتیبانی کامل نداشته باشند.

sudo apt-get install libmsquic

• بررسی نسخه سیستم‌عامل: مطمئن شوید که از نسخه‌ای از سیستم‌عامل استفاده می‌کنید که در مستندات مایکروسافت به‌عنوان پلتفرم پشتیبانی‌شده ذکر شده است.
• بررسی نصب MsQuic: در لینوکس، می‌توانید بررسی کنید که Libmsquic نصب شده است یا خیر. به‌عنوان مثال:

dpkg -l | grep libmsquic

• آزمایش با کد: می‌توانید یک برنامه آزمایشی ساده بنویسید که تلاش کند از HTTP/3 استفاده کند. اگر پلتفرم الزامات را برآورده نکند، معمولاً خطایی مانند «HTTP/3 is not supported on this platform» دریافت خواهید کرد.

• اطمینان حاصل کنید که OpenSSL نصب است:

sudo apt-get install openssl

• نصب Libmsquic (در صورت نیاز):

sudo apt-get install libmsquic

• فعال‌سازی HTTP/3 در کد یا فایل پروژه (همان‌طور که در مقاله اصلی توضیح داده شد):

System.AppContext.SetSwitch("System.Net.SocketsHttpHandler.Http3Support", true);

• آزمایش درخواست HTTP/3 به یک سرور عمومی مانند https://cloudflare-quic.com:

using var client = new HttpClient
{
    DefaultRequestVersion = HttpVersion.Version30,
    DefaultVersionPolicy = HttpVersionPolicy.RequestVersionExact
};
var response = await client.GetAsync("https://cloudflare-quic.com");
Console.WriteLine($"Version: {response.Version}");

• بازگشت به پروتکل‌های قدیمی‌تر: HttpClient به‌صورت خودکار به HTTP/2 یا HTTP/1.1 بازمی‌گردد، مشروط بر اینکه سرور از این پروتکل‌ها پشتیبانی کند.
• به‌روزرسانی سیستم‌عامل: ارتقا به نسخه‌ای از سیستم‌عامل که MsQuic را پشتیبانی می‌کند (مانند ویندوز 11 یا اوبونتو 22.04).
• استفاده از کانتینرها: می‌توانید از Docker یا کانتینرهایی استفاده کنید که محیطی سازگار با MsQuic فراهم می‌کنند.