‫چالش‌های متداول توسعه‌دهندگان ASP.NET Core هنگام استفاده از Nginx - قسمت اول - راه‌اندازی اولیه و مشکلات پیکربندی

• وب سرور اپلیکیشن شماست.
• کد #C شما را اجرا کرده و صفحات داینامیک را تولید می‌کند.
• به صورت پیش‌فرض روی یک پورت غیر استاندارد (مانند 5000) و فقط روی localhost اجرا می‌شود تا از بیرون سرور مستقیماً قابل دسترسی نباشد.

• در خط مقدم قرار دارد و درخواست‌های کاربران را از اینترنت دریافت می‌کند.
• مانند یک نگهبان و توزیع‌کننده عمل می‌کند.
• وظایف اصلی آن عبارتند از:
• Reverse Proxy: درخواست‌های معتبر را به سمت Kestrel هدایت (Forward) می‌کند.
• SSL Termination: مسئولیت مدیریت HTTPS و رمزنگاری را بر عهده می‌گیرد.
• Serving Static Files: فایل‌های ثابت (CSS, JS, تصاویر) را مستقیماً و با سرعت بالا سرو می‌کند.
• Caching: می‌تواند پاسخ‌ها را کش کند تا بار روی Kestrel کاهش یابد.
• Load Balancing: در معماری‌های بزرگ‌تر، می‌تواند ترافیک را بین چند نمونه از برنامه شما تقسیم کند.

• برنامه ASP.NET Core شما اصلاً در حال اجرا نیست: این شایع‌ترین دلیل است.
• برنامه ASP.NET Core در حین اجرا Crash کرده است: به دلیل یک خطا در کد، برنامه متوقف شده است.
• فایروال سرور لینوکس پورت را مسدود کرده است: Nginx نمی‌تواند با Kestrel روی پورت مورد نظر (مثلاً 5000) ارتباط برقرار کند.
• آدرس یا پورت در فایل کانفیگ Nginx اشتباه است:proxy_pass به آدرس یا پورت اشتباهی اشاره می‌کند.
• مشکلات SELinux یا AppArmor: سیستم‌های امنیتی لینوکس ممکن است جلوی ارتباط شبکه بین Nginx و Kestrel را بگیرند (موردی پیشرفته‌تر).

• وارد سرور خود شوید و دستور زیر را برای چک کردن اینکه آیا پروسه‌ای روی پورت 5000 در حال اجراست، وارد کنید (پورت برنامه خود را جایگزین 5000 کنید):

sudo lsof -i:5000

• اگر خروجی این دستور خالی بود، یعنی برنامه شما اجرا نشده است.

• به پوشه پروژه خود بروید و آن را دستی اجرا کنید تا خطاها را ببینید:

cd /path/to/your/app
dotnet YourApp.dll

• به خروجی ترمینال دقت کنید. هر خطایی در Startup.cs یا Program.cs اینجا نمایش داده می‌شود.

• این لاگ اطلاعات بسیار مفیدی در مورد دلیل عدم اتصال می‌دهد.

sudo tail -f /var/log/nginx/error.log

• در خروجی به دنبال عباراتی مانند (111: Connection refused) بگردید که مستقیماً به عدم اجرای Kestrel اشاره دارد.

location / {
    proxy_pass http://127.0.0.1:5001; # پورت برنامه 5000 است نه 5001
}

server {
    listen 80;
    server_name your-domain.com; # دامنه خود را وارد کنید

    location / {
        # این بخش درخواست را به Kestrel ارسال می‌کند
        proxy_pass         http://localhost:5000;
        proxy_http_version 1.1;
        proxy_set_header   Upgrade $http_upgrade;
        proxy_set_header   Connection keep-alive;
        proxy_set_header   Host $host;
        proxy_cache_bypass $http_upgrade;
        proxy_set_header   X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header   X-Forwarded-Proto $scheme;
    }
}

A fatal error occurred. The required library libhostfxr.so could not be found.

# نصب ASP.NET Core Runtime 8.0
sudo apt-get update && \
  sudo apt-get install -y aspnetcore-runtime-8.0

# وضعیت فایروال را بررسی کنید
sudo ufw status

# اگر فایروال فعال است، به Nginx اجازه دهید
sudo ufw allow 'Nginx Full'

# یا پورت‌ها را دستی باز کنید
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp

# تغییرات را اعمال کنید
sudo ufw reload

• برنامه پس از ریبوت شدن سرور به طور خودکار اجرا شود.
• در صورت Crash کردن، به طور خودکار دوباره راه‌اندازی شود.