انتقل إلى المحتوى
دليل الويب

وكلاء الذكاء الاصطناعي والأتمتة

تثبيت n8n على VPS باستخدام Docker مع شهادة SSL مجانية

شغّل n8n على سيرفرك الخاص باستخدام Docker Compose وشهادة Let's Encrypt مجانية وروابط Webhook صحيحة. إعداد مُختبَر وأرقام حقيقية لاستهلاك الذاكرة وطريقة النسخ الاحتياطي.

بقلم فريق تحرير دليل الويبنُشر في قراءة في 4 دقائق
خطوات Workflow مترابطة ترمز إلى أتمتة n8n

أصبح n8n الأداة الأولى لمن يريد وكلاء ذكاء اصطناعي ينجزون أعمالًا فعلية: يردّون على الرسائل، ويحدّثون بيانات العملاء، ويلخّصون البريد، ويتصلون بأي واجهة برمجية. وتشغيله على سيرفرك الخاص يعني أنك لا تدفع مقابل كل تنفيذ، وأن بياناتك تبقى عندك، وأنك تستطيع ربطه بأي خدمة يصل إليها السيرفر.

في هذا الدليل نثبّت n8n باستخدام Docker Compose خلف Traefik، مع شهادة Let's Encrypt مجانية وروابط Webhook صحيحة. تحقّقنا من صحة كل الملفات أدناه بالأمر docker compose config، وشغّلنا صورة n8n وقِسنا استهلاكها قبل النشر.

ما الذي تحتاجه

  • سيرفر VPS برامات 2 جيجابايت على الأقل. في اختبارنا استهلك n8n 2.47.7 نحو 740 ميجابايت من الرامات وهو يعمل من دون أي Workflow. ووكلاء الذكاء الاصطناعي وأكواد الـ Code node والتشغيل المتزامن تزيد هذا الرقم، لذلك تكون 4 جيجابايت هي الحجم المريح إن كان السيرفر يشغّل أشياء أخرى.
  • دومين أو ساب دومين (Subdomain) توجّهه إلى السيرفر، مثل n8n.example.com.
  • وصول SSH بحساب root أو مستخدم لديه صلاحية sudo.

إن لم يكن لديك سيرفر بعد، فدليلنا عن السيرفر الافتراضي VPS يشرح ما الذي تبحث عنه. خطط KVM من Hostinger خيار شائع لهذا الغرض؛ فخطة KVM 2 التي نشغّل عليها مشاريعنا فيها معالجان افتراضيان و8 جيجابايت ذاكرة و100 جيجابايت تخزين، وهي مساحة مريحة لـ n8n مع حاويات أخرى.

الخطوة 1: وجّه ساب دومين (Subdomain) إلى السيرفر

من إعدادات DNS أنشئ سجل A:

الاسمالنوعالقيمة
n8nAعنوان IPv4 الخاص بالسيرفر

انتظر حتى يعمل السجل قبل أن تكمل، وإلا سيفشل طلب الشهادة في الخطوة 5:

dig +short n8n.example.com

الخطوة 2: ثبّت Docker

كثير من شركات VPS توفّر نظامًا مثبّتًا عليه Docker مسبقًا، ولدى Hostinger قالب باسم "Ubuntu 24.04 with Docker and Traefik". وعلى سيرفر Ubuntu جديد استخدم سكربت Docker الرسمي:

curl -fsSL https://get.docker.com | sudo sh
docker compose version

الخطوة 3: أنشئ مجلد المشروع والإعدادات

mkdir -p ~/n8n && cd ~/n8n
openssl rand -hex 32

انسخ النص العشوائي الناتج عن الأمر الأخير، فهو مفتاح التشفير الذي يستخدمه n8n لتشفير بيانات الدخول التي تحفظها (مفاتيح API وكلمات المرور). إن فقدته فلن يمكن فك تشفير هذه البيانات، فاحفظه في مكان آمن.

أنشئ ملفًا باسم .env:

DOMAIN_NAME=example.com
SUBDOMAIN=n8n
GENERIC_TIMEZONE=Asia/Riyadh
SSL_EMAIL=you@example.com
N8N_ENCRYPTION_KEY=paste-the-random-string-here

اكتب منطقتك الزمنية (مثل Africa/Cairo أو Asia/Dubai) حتى تعمل المهام المجدولة في المواعيد التي تتوقعها.

الخطوة 4: أنشئ ملف Compose

أنشئ الملف compose.yaml في المجلد نفسه:

services:
  traefik:
    image: traefik:v3
    restart: unless-stopped
    command:
      - --providers.docker=true
      - --providers.docker.exposedbydefault=false
      - --entrypoints.web.address=:80
      - --entrypoints.web.http.redirections.entrypoint.to=websecure
      - --entrypoints.web.http.redirections.entrypoint.scheme=https
      - --entrypoints.websecure.address=:443
      - --certificatesresolvers.le.acme.tlschallenge=true
      - --certificatesresolvers.le.acme.email=${SSL_EMAIL}
      - --certificatesresolvers.le.acme.storage=/letsencrypt/acme.json
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - traefik_data:/letsencrypt
      - /var/run/docker.sock:/var/run/docker.sock:ro

  n8n:
    image: n8nio/n8n:2.47.7
    restart: unless-stopped
    ports:
      - "127.0.0.1:5678:5678"
    environment:
      - N8N_HOST=${SUBDOMAIN}.${DOMAIN_NAME}
      - N8N_PORT=5678
      - N8N_PROTOCOL=https
      - N8N_PROXY_HOPS=1
      - N8N_WEBHOOK_URL=https://${SUBDOMAIN}.${DOMAIN_NAME}/
      - N8N_ENCRYPTION_KEY=${N8N_ENCRYPTION_KEY}
      - NODE_ENV=production
      - GENERIC_TIMEZONE=${GENERIC_TIMEZONE}
      - TZ=${GENERIC_TIMEZONE}
    volumes:
      - n8n_data:/home/node/.n8n
    labels:
      - traefik.enable=true
      - traefik.http.routers.n8n.rule=Host(`${SUBDOMAIN}.${DOMAIN_NAME}`)
      - traefik.http.routers.n8n.entrypoints=websecure
      - traefik.http.routers.n8n.tls.certresolver=le
      - traefik.http.services.n8n.loadbalancer.server.port=5678

volumes:
  n8n_data:
  traefik_data:

بعض الاختيارات التي تستحق الفهم:

  • ثبّتنا إصدار n8n على 2.47.7 بدلًا من latest، فلا يحدث أي تحديث إلا بقرار منك.
  • البورت 5678 (Port) مربوط بـ 127.0.0.1، فلا يصل أحد إلى n8n من الإنترنت إلا عبر Traefik وHTTPS، وليس مباشرة.
  • N8N_WEBHOOK_URL يجعل روابط الـ Webhook في المحرر تستخدم دومينك الحقيقي. في الإصدارات الأقدم من 2.30 يسمّى المتغير WEBHOOK_URL.
  • N8N_PROXY_HOPS=1 يخبر n8n بأن أمامه Reverse Proxy واحدًا (هنا Traefik)، فيرى عناوين IP الحقيقية للزوار.

الخطوة 5: شغّل n8n

docker compose up -d
docker compose logs -f n8n

عندما يظهر في السجل Editor is now accessible via افتح https://n8n.example.com. أول طلب يطلق إصدار شهادة Let's Encrypt، ويستغرق ذلك ثواني. أنشئ حساب المالك فورًا، لأن أي شخص يصل إلى الرابط قبلك يستطيع إنشاءه.

وللتأكد من الخدمة من داخل السيرفر نفسه:

curl -s http://127.0.0.1:5678/healthz
# {"status":"ok"}

الخطوة 6: انسخ احتياطيًا ما يهم فعلًا

شيئان فقط مهمان: الـ Volume المسمّى n8n_data (فيه الـ Workflows وبيانات الدخول وسجل التشغيل)، ومفتاح التشفير في ملف .env.

cd ~/n8n
docker compose stop n8n
docker run --rm -v n8n_n8n_data:/data -v "$PWD":/backup alpine \
  tar czf /backup/n8n-data-$(date +%F).tgz -C /data .
docker compose start n8n

يضيف Docker اسم المجلد قبل اسم الـ Volume، لذلك يكون الاسم n8n_n8n_data إن كان مجلدك ~/n8n. تحقّق من اسمه بالأمر docker volume ls. وانقل النسخة وملف .env خارج السيرفر؛ فالنسخة الاحتياطية على القرص نفسه ليست نسخة احتياطية.

تحديث n8n

اقرأ ملاحظات الإصدار، وغيّر رقم الإصدار في compose.yaml، ثم:

docker compose pull n8n
docker compose up -d n8n

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

قائمة الأمان

  • أنشئ حساب المالك فورًا وفعّل التحقق بخطوتين من إعدادات حسابك.
  • أبقِ البورت 5678 مربوطًا بـ 127.0.0.1 كما في الملف؛ البورتان 80 و443 فقط يجب أن يكونا مفتوحين للإنترنت.
  • تعامل مع مفتاح التشفير ككلمة مرور، فهو يفتح كل بيانات الدخول المحفوظة في n8n.
  • حدّث بانتظام؛ فـ n8n متصل بخدمات كثيرة، وتحديثات الأمان مهمة.
  • احفظ مفاتيح API في قسم بيانات الدخول (Credentials) في n8n، لا مكتوبة داخل النودز (Nodes) مباشرة.

حل المشكلات الشائعة

العَرَضالسبب المحتملالحل
روابط الـ Webhook تظهر بـ localhost:5678رابط الـ Webhook غير مضبوطاضبط N8N_WEBHOOK_URL (أو WEBHOOK_URL قبل 2.30) وأعد إنشاء الحاوية
المتصفح يحذّر من الشهادةDNS لم يُوجَّه إلى السيرفر بعد، أو البورت 443 مغلقتحقّق بالأمر dig، وافتح البورتين 80 و443 في الـ Firewall لدى الشركة، ثم أعد تشغيل Traefik
تسجيل الدخول يفشل عبر HTTPn8n يستخدم ملفات تعريف ارتباط آمنةاستخدم الرابط الذي يبدأ بـ https:// دائمًا
الكونتينر (Container) يعيد التشغيل باستمرارالرامات غير كافيةراقب الاستهلاك بالأمر docker stats، وانتقل إلى خطة برامات أكبر

الخطوة التالية

بعد تشغيل n8n يمكنك بناء وكلاء ذكاء اصطناعي يستدعون نموذجًا لغويًا، ويستخدمون أدوات، ويتذكرون السياق. وإن لم تكن متأكدًا من الفرق بين الوكيل والشات بوت والأتمتة العادية، فابدأ بمقالنا ما هي وكلاء الذكاء الاصطناعي.

Hostinger

متاح في معظم الدول

استضافة مواقع وووردبريس وخوادم VPS بأسعار مناسبة، مع لوحة تحكم hPanel الخاصة بها ومراكز بيانات في عدة قارات.

الكود1AZMI19

أسئلة شائعة

كم يحتاج n8n من الذاكرة RAM؟

في اختبارنا استهلك n8n 2.47.7 نحو 740 ميجابايت من الذاكرة وهو في وضع الخمول ومن دون أي سير عمل. خطّط لـ 2 جيجابايت كحد أدنى، و4 جيجابايت أو أكثر إن كنت ستشغّل وكلاء ذكاء اصطناعي أو تنفيذات كثيرة متزامنة أو حاويات أخرى على السيرفر نفسه.

هل يمكن تثبيت n8n على استضافة مشتركة؟

غالبًا لا. فـ n8n خدمة Node.js تعمل باستمرار، ومعظم خطط الاستضافة المشتركة لا تسمح بـ Docker ولا بالعمليات الدائمة في الخلفية. سيرفر VPS صغير هو الحد الأدنى العملي.

هل n8n مجاني عند تشغيله على سيرفري؟

نسخة المجتمع التي تستضيفها بنفسك لا تحاسبك على عدد سير العمل أو مرات التنفيذ، وأنت تدفع تكلفة السيرفر فقط. وهي موزّعة برخصة Sustainable Use الخاصة بـ n8n، فاقرأها قبل أن تقدّم n8n لعملائك كخدمة مستضافة.

المصادر والمراجع

  1. توثيق n8n: الإعداد باستخدام Docker Compose (بالإنجليزية)
  2. توثيق n8n: متغيرات بيئة النشر (بالإنجليزية)
  3. توثيق Traefik: شهادات Let's Encrypt (بالإنجليزية)

الخوادم الافتراضية والسحابة

ما هو الخادم الافتراضي VPS، ومتى تحتاج إليه فعلًا؟

يمنحك الخادم الافتراضي الخاص موارد مضمونة وتحكمًا كاملًا، ومعهما مسؤولية كاملة أيضًا. إليك طريقة عمله والعلامات التي تدل على أنك مستعد له.

قراءة في دقيقتين