پرش به محتوای اصلی

راهنمای سازنده‌ی پیکربندی Nginx و Caddy

زمان مطالعه: ۳ دقیقه

این ابزار چیست؟

وقتی یک برنامه‌ی Node، Python یا هر سرویس دیگری را روی سرور بالا می‌آورید، معمولاً یک وب‌سرور جلوی آن می‌نشیند تا HTTPS، فشرده‌سازی، هدرهای امنیتی و محدودیت حجم درخواست را مدیریت کند. نوشتن این پیکربندی از صفر پر از جزئیات است و یک خط جاافتاده می‌تواند سایت را ناامن یا کند کند. این ابزار پیکربندی آماده‌ی Nginx یا Caddy را با چند انتخاب ساده می‌سازد.

سه نوع سایت پشتیبانی می‌شود: پروکسی معکوس به یک پورت داخلی، سایت ایستا و برنامه‌ی تک‌صفحه‌ای (SPA). گزینه‌های HTTPS با Let’s Encrypt، هدایت http به https، HSTS، هدرهای امنیتی، gzip، brotli و WebSocket هم در دسترس‌اند. پیکربندی در مرورگر شما ساخته می‌شود.

گام‌به‌گام

  1. دامنه و نوع سایت را بدهید

    نام دامنه را بنویسید و «پروکسی معکوس»، «سایت ایستا» یا «برنامه‌ی تک‌صفحه‌ای (SPA)» را بردارید؛ برای پروکسی پورت برنامه و برای سایت ایستا مسیر پوشه را تعیین کنید.

  2. گزینه‌های امنیتی را تنظیم کنید

    HTTPS، هدایت http به https، HSTS و هدرهای امنیتی به‌طور پیش‌فرض روشن‌اند. HSTS را فقط وقتی نگه دارید که مطمئنید سایت همیشه روی HTTPS است.

  3. قالب خروجی را انتخاب کنید

    Nginx یا Caddy را بردارید. پیکربندی تولیدشده همان لحظه بررسی ساختاری می‌شود.

  4. روی سرور بگذارید و بیازمایید

    پیکربندی Nginx را در پوشه‌ی sites-available بگذارید و پیش از بارگذاری دوباره با nginx -t بیازمایید؛ برای Caddy آن را در Caddyfile بگذارید.

نمونه‌های کاربردی

  • پروکسی معکوس با Caddy

    برنامه روی پورت ۳۰۰۰ اجرا می‌شود؛ Caddy گواهی HTTPS را خودش می‌گیرد، پس پیکربندی کوتاه‌تر از Nginx است.

    نتیجه: example.ir { … reverse_proxy 127.0.0.1:3000 } با فشرده‌سازی zstd و gzip و هدرهای امنیتی

  • دامنه‌ی نامعتبر

    دامنه نباید پیشوند http یا فاصله داشته باشد.

    نتیجه: نام دامنه معتبر نیست؛ فقط حروف لاتین، رقم، نقطه و خط تیره (مثل example.com).

اشتباه‌های رایج

  • روشن کردن HSTS پیش از آماده بودن HTTPS: مرورگرها تا دو سال فقط با HTTPS به سایت سر می‌زنند و اگر گواهی مشکل داشته باشد، سایت باز نمی‌شود.
  • add_header در یک location دیگر: در Nginx اگر بلوک location خودش add_header داشته باشد، هدرهای بلوک server را به ارث نمی‌برد. هدرها را در یک جا نگه دارید.
  • روشن کردن brotli بدون ماژول: Nginx به‌طور پیش‌فرض brotli ندارد و به ماژول ngx_brotli نیاز دارد؛ بدون آن پیکربندی بارگذاری نمی‌شود.
  • فراموش کردن WebSocket برای برنامه‌هایی که به آن نیاز دارند: بدون سرآیندهای Upgrade، اتصال‌های بلادرنگ پشت پروکسی قطع می‌شوند.
  • CSP پیش‌فرض برای سایتی که منابع بیرونی دارد: هدر Content-Security-Policy ساخته‌شده فقط منابع همان سایت را مجاز می‌کند. اگر فونت یا اسکریپتی از جای دیگر می‌آید، آن را با سازنده‌ی CSP تنظیم کنید.

Nginx یا Caddy؟

Nginx پرکاربردترین وب‌سرور است، سریع است و تقریباً هر سناریویی را پوشش می‌دهد، اما گواهی HTTPS را باید جدا با ابزاری مثل certbot بگیرید و تمدید کنید. Caddy گواهی را خودکار می‌گیرد و تمدید می‌کند و پیکربندی کوتاه‌تری دارد.

برای یک سرور ساده با چند سایت، Caddy راه‌اندازی سریع‌تری دارد؛ برای سرورهایی که از قبل Nginx دارند یا تنظیم‌های پیچیده لازم دارند، Nginx انتخاب معمول است.

پرسش‌های متداول

هدرهای امنیتی چه نمره‌ای می‌گیرند؟
مجموعه‌ی تولیدشده همان است که ابزار بررسی هدرهای سایت در این وب‌سایت نمره‌ی A می‌دهد؛ در آزمون‌های خودکار هم همین بررسی می‌شود.
چرا add_header فقط در سطح server است؟
در Nginx اگر یک بلوک location خودش add_header داشته باشد، هدرهای سطح بالاتر را کاملاً نادیده می‌گیرد؛ به همین دلیل هدرها یک‌جا و در سطح server نوشته شده‌اند.
گواهی HTTPS را چگونه بگیرم؟
مسیر گواهی در خروجی بر پایه‌ی Let’s Encrypt است. گواهی را با certbot یا مشابه آن بگیرید، پیکربندی را با nginx -t بیازمایید و بعد بارگذاری مجدد کنید. در Caddy گواهی خودکار است.

ابزارهای مرتبط