تثبيت Nginx Proxy Manager - دليل الإعداد في دقيقتين

ما تحتاجه قبل البدء

يجب أن تتوفر ثلاثة أشياء قبل أن يتمكن Nginx Proxy Manager (NPM) من العمل. أولاً، خادم Linux أو جهاز كمبيوتر مثبت عليه Docker وDocker Compose مثبت ويعمل بالفعل - يعمل NPM كحاوية، وليس كبرنامج عادي. ثانيًا، اسم النطاق الذي يمكنك تعديل DNS الخاص به، لأن كل خدمة تحصل على نطاق فرعي خاص بها. ثالثًا، يجب أن يكون جهاز التوجيه أو جدار الحماية السحابي لديك قادرًا على إعادة توجيه المنفذين 80 و443 إلى هذا الجهاز.

قم بتوجيه DNS الخاص بالمجال الخاص بك إلى الخادم أولاً

يقوم NPM بتوجيه حركة المرور حسب الاسم، ويقوم Lets Encrypt بإصدار شهادات فقط للأسماء التي تشير بشكل مؤكد إلى جهازك - لذلك يجب حل الاسم قبل إنشاء أي شيء عليه. في المسجل أو مضيف DNS الخاص بك، أضف سجل A: الاسم هو كلمة النطاق الفرعي فقط (على سبيل المثال app) والقيمة هي عنوان IP العام لخادمك. تحصل كل خدمة على سجلها الخاص، ويمكن أن تشير جميعها إلى نفس عنوان IP - ويفصل NPM الخدمات لاحقًا بالاسم. قم بتعيين مدة زمنية قصيرة مثل 300 ثانية أثناء الاختبار، بحيث تتلاشى الأخطاء في دقائق بدلاً من ساعات.

أثبت ذلك قبل المتابعة: تأكد من أن الاسم يتحول إلى عنوان IP العام الخاص بك من شبكة خارجية (على سبيل المثال من هاتفك مع إيقاف تشغيل Wi-Fi). يتيح لك طلب شهادة ضد نفايات نظام أسماء النطاقات المعطوبة تشفير المحاولات، ويمكن أن تؤدي حالات الفشل المتكررة إلى تقييد معدلك لساعات. الترتيب مهم: DNS أولاً، المضيف الوكيل ثانياً، الشهادة ثالثاً.

قم بإنشاء المجلد وملف الإنشاء

أنشئ مجلدًا لـ NPM على الخادم واحفظ الملف أدناه بداخله باسم docker-compose.yml. هذا الملف الفردي هو التثبيت الكامل. اسم الصورة هو صورة المجتمع الرسمية. المنفذان 80 و443 هما الأبواب العامة، والمنفذ 81 هو لوحة الإدارة، والمجلدان هما المكان الذي يوجد فيه الإعداد بالكامل: ./data يحتفظ بقاعدة البيانات مع جميع مضيفي الوكيل، ويحتفظ ./letsencrypt بشهاداتك. تفقد هذين المجلدين وتفقد الإعداد بالكامل - قم بعمل نسخة احتياطية لهما بمجرد تشغيل الأشياء.

services:
  app:
    image: 'jc21/nginx-proxy-manager:latest'
    restart: unless-stopped
    ports:
      - '80:80'
      - '443:443'
      - '81:81'
    volumes:
      - ./data:/data
      - ./letsencrypt:/etc/letsencrypt

يقوم سطر إعادة التشغيل: ما لم يتم إيقافه بإعادة تشغيل NPM تلقائيًا بعد إعادة التشغيل.

ابدأ تشغيل مدير وكيل Nginx

من داخل هذا المجلد، قم بتشغيل أمر البدء. يقوم Docker بتنزيل الصورة وبدء تشغيل الحاوية في الخلفية.

docker compose up -d

التحقق من أنه قيد التشغيل:

docker ps

من المفترض أن تشاهد الحاوية مدرجة بالمنافذ 80 و443 و81. على خادم صغير، تستغرق البداية الأولى دقيقة أو دقيقتين أثناء إنشاء قاعدة البيانات. إذا استمرت الحاوية في إعادة التشغيل، فسوف تعرض السجلات السبب بلغة واضحة:

docker compose logs

تسع مرات من أصل عشرة، تكون حلقة إعادة التشغيل عبارة عن منفذ يستخدمه بالفعل شيء آخر على المضيف - عادةً ما يكون خادم الويب القديم لا يزال قيد التشغيل.

تسجيل الدخول الأول - تأمين حساب المسؤول على الفور

افتح لوحة الإدارة في متصفح على شبكتك الخاصة:

http://your-server-ip:81

افعل هذا في الدقيقة الأولى. اعتمادًا على الإصدار، يطلب منك NPM إما استبدال تفاصيل مسؤول تسجيل الدخول الأول المعروفة بالبريد الإلكتروني الخاص بك وكلمة مرور قوية، أو - في الإصدارات الأحدث بدون حساب افتراضي - يقوم أول شخص يفتح صفحة المسؤول بإنشاء المسؤول. في كلتا الحالتين، القاعدة هي نفسها: قم بإعداد حساب المسؤول الخاص بك في اللحظة التي تبدأ فيها الحاوية، قبل إنشاء أي شيء آخر، واستخدم صندوق بريد حقيقي - رسائل البريد الإلكتروني NPM التي تتناول مشكلات الشهادات.

قم بإنشاء مضيف الوكيل الأول الخاص بك

في NPM، افتح المضيفون ← مضيفو الوكيل ← إضافة مضيف وكيل واملأ النموذج كجملة واحدة - "ينتقل هذا الاسم إلى تلك الخدمة الداخلية":

أسماء النطاقات: app.yourdomain.com - الاسم العام الدقيق من الخطوة 2، والذي يجب أن يتم حله بالفعل على الخادم الخاص بك.
المخطط: http لمعظم تطبيقات المنزل والمكتب. يصف المخطط العلاقة بين NPM والخدمة الداخلية، وليس ما يستخدمه الزوار - NPM يتولى التشفير العام عند الباب. اختر https هنا فقط عندما يخدم التطبيق الداخلي نفسه HTTPS.
إعادة توجيه اسم المضيف / IP: العنوان الداخلي للخدمة، على سبيل المثال 192.168.1.50.
منفذ إعادة التوجيه: المنفذ الذي تستمع إليه الخدمة فعليًا، على سبيل المثال 8080 - وليس 80 أو 443؛ تلك هي أبواب NPM، وليست أبواب الخدمة.

قم بتشغيل حظر برامج الاستغلال الشائعة، ثم حفظ. اختبر على الفور عن طريق فتح الاسم في المتصفح - من هاتفك بشكل مثالي مع إيقاف تشغيل Wi-Fi، حتى تتمكن من اختبار المسار العام الحقيقي.

احصل على شهادة Let's Encrypt HTTPS المجانية

لا تفعل ذلك إلا بعد أن يعمل المضيف العادي من الخطوة 6 بالفعل - يمنحك HTTPS على مضيف معطل مضيفًا معطلاً بشهادة، وضعف الأماكن للبحث عن الخطأ. افتح نفس مضيف الوكيل، وانتقل إلى علامة التبويب SSL، وقم بتعيين شهادة SSL على طلب شهادة SSL جديدة، وقم بتمكين فرض SSL ودعم HTTP/2، ووافق على شروط خدمة Lets Encrypt، ثم احفظ. أعد تحميل الموقع - يجب أن يعرض المتصفح الآن القفل على https.

كيف يعمل: يثبت Lets Encrypt أنك تتحكم في الاسم من خلال مطالبة الخادم الخاص بك، عبر الإنترنت العام على المنفذ 80، بإظهار رمز مميز لمرة واحدة (تحدي HTTP-01). ولهذا السبب فإن توجيه DNS إليك والمنفذ 80 الذي يمكن الوصول إليه غير قابلين للتفاوض - ففشل أي منهما وفشل الطلب، والخطأ موجود في الإعداد، وليس في Lets Encrypt أبدًا. يقوم فرض SSL بإعادة توجيه كل زائر http إلى https تلقائيًا؛ وبدونها يبقى الباب غير المشفر مفتوحا بجانب الباب المشفر.