منشئ إعدادات Nginx

منشئ إعدادات Nginx

أدخل نطاقك واختر نوع الموقع وحدّد الميزات التي تريدها لتحصل على إعدادات خادم nginx جاهزة للاستخدام. يغطي الأداة الوكلاء العكسيين (تطبيقات Node.js و Python و Java) والمواقع الثابتة والتطبيقات أحادية الصفحة (React و Vue) و PHP، مع إعادة التوجيه من HTTP إلى HTTPS وإعادة التوجيه لنطاق www و WebSocket و gzip والتخزين المؤقت للملفات الثابتة.

يعمل في متصفحك — لا يُرفع أي شيء تُدخله

النطاق

نوع الموقع

عنوان الخادم الخلفي

دعم WebSocket

HTTPSHTTPS (مسارات شهادة Let's Encrypt)HTTP/2HSTS (Strict-Transport-Security)الاستجابة أيضًا لـ www. وإعادة توجيهه

إضافاتضغط Gzipترويسات الأمان

أقصى حجم رفع (MB)

تُبقي القيمة 0 الإعداد الافتراضي لـ nginx وهو 1 MB.

server {
    listen 80;
    listen [::]:80;
    server_name example.com www.example.com;

    # certbot needs plain HTTP access here when renewing with the webroot method
    location /.well-known/acme-challenge/ {
        root /var/www/letsencrypt;
    }

    location / {
        return 301 https://example.com$request_uri;
    }
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name www.example.com;

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;

    return 301 https://example.com$request_uri;
}

server {
    listen 443 ssl http2;
    listen [::]:443 ssl http2;
    server_name example.com;

    ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_session_cache shared:SSL:10m;
    ssl_session_timeout 1d;

    # Common security headers
    add_header X-Content-Type-Options "nosniff" always;
    add_header X-Frame-Options "SAMEORIGIN" always;
    add_header Referrer-Policy "strict-origin-when-cross-origin" always;

    gzip on;
    gzip_vary on;
    gzip_comp_level 5;
    gzip_min_length 1024;
    gzip_types text/plain text/css application/javascript application/json application/xml image/svg+xml;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

احصل على الشهادة أولًا، مثلًا: certbot certonly --webroot -w /var/www/letsencrypt -d example.com -d www.example.com. ثم شغّل nginx -t وأعد تحميل nginx.

طريقة الاستخدام

أدخل النطاق واختر نوع الموقع — عنوان upstream للوكيل العكسي، أو جذر الويب للآخرين.
حدّد HTTPS و HTTP/2 و HSTS وإعادة التوجيه لنطاق www و gzip والتخزين المؤقت ورؤوس الأمان حسب الحاجة.
انسخ أو نزّل الإعدادات إلى /etc/nginx/conf.d/ وشغّل nginx -t وأعد تحميل nginx.

شرح الخيارات

الوكيل العكسي: يُعيد التوجيه إلى عنوان upstream ويمرّر Host و X-Real-IP و X-Forwarded-For و X-Forwarded-Proto، بحيث يرى الخادم الخلفي عنوان IP الفعلي للزائر والبروتوكول.
التطبيق أحادي الصفحة: تُعاد الطلبات للمسارات غير المعروفة إلى index.html، بحيث لا تصدر موجهات history-mode (React Router و Vue Router) أخطاء 404 عند إعادة التحميل.
HTTPS: تتبع مسارات الشهادات افتراضيات certbot (Let's Encrypt) وتُعاد طلبات HTTP بحالة 301 إلى HTTPS. يستخدم HTTP/2 نموذج listen 443 ssl http2 الذي يعمل على كل إصدارات nginx.
HSTS: يخبر المتصفحات باستخدام HTTPS فقط للنطاق وكل نطاقاته الفرعية لمدة سنة. تأكد من دعم HTTPS على كل نطاق فرعي أولًا، وإلا أصبحت غير قابلة للوصول.

مثال: تطبيق صفحة واحدة مع HTTPS وwww

مع النطاق example.com، وتفعيل «تطبيق صفحة واحدة» و«HTTPS» وHTTP/2 و«الاستجابة أيضًا لـ www. وإعادة توجيهه» (وتعطيل «ضغط Gzip» و«ترويسات الأمان» و«تخزين طويل للملفات الثابتة» للاختصار)، يكتب المنشئ ثلاث كتل server:

المنفذ 80 يجيب عن الاسمين، ويُبقي /.well-known/acme-challenge/ متاحًا لتجديد الشهادة، ويرسل كل ما عداه إلى https://example.com$request_uri بحالة 301.
المنفذ 443 لـ www.example.com يستخدم الشهادة نفسها ويعيد 301 إلى النطاق الأساسي.
المنفذ 443 لـ example.com يقدّم الموقع:

    root /var/www/example.com;
    index index.html;

    location / {
        try_files $uri $uri/ /index.html;
    }

تشير كتلتا HTTPS كلتاهما إلى /etc/letsencrypt/live/example.com/fullchain.pem وprivkey.pem، وتسمحان بـ TLS 1.2 و1.3، وتستخدمان ذاكرة مؤقتة مشتركة للجلسات بحجم 10 MB ومهلة جلسة يوم واحد. والسطر try_files هو ما يجعل إعادة التحميل على مسار من جهة العميل مثل /settings تعيد التطبيق بدلًا من خطأ 404.

الأسئلة الشائعة

لماذا يحذّر nginx -t من أن معامل http2 تم إهمالوه؟

منذ nginx 1.25.1 التوجيه المنفصل http2 on؛ مفضَّل، لكن النسخة 1.24 — التي تأتي مع Ubuntu 24.04 وغيره — لا تفهمها. نموذج listen ... http2 يعمل في كل مكان؛ والإصدارات الأحدث تطبع فقط تحذيرًا.

هل يجب أن تتضمن الشهادة نطاق www؟

نعم، عند تفعيل إعادة التوجيه لنطاق www. اطلب كلا الاسمين، مثلًا certbot -d example.com -d www.example.com.

تفشل الرفعات مع 413 Request Entity Too Large؟

nginx يسمح بحد أقصى 1 MB لجسم الطلب افتراضيًا. عيّن حد الرفع الأقصى حسب احتياجك، مثلًا 100.

تفشل اتصالات WebSocket عبر الوكيل؟

يجب على الوكيل إعادة توجيه رؤوس Upgrade و Connection. تفعيل دعم WebSocket يضيفها ويرفع مهلة القراءة إلى ساعة واحدة.

الخصوصية

تعمل هذه الأداة بالكامل داخل متصفحك. تُعالَج ملفاتك ونصوصك على جهازك ولا تُرفع أبدًا إلى خوادمنا.