دليل شامل: تثبيت n8n على Ubuntu باستخدام Docker Compose في 2026

ما هو n8n ولماذا يجب عليك استخدامه؟

instal n8n on ubuntu يمثل خطوة أساسية للمطورين الذين يبحثون عن منصة أتمتة مفتوحة المصدر. يمنح n8n المستخدمين التحكم الكامل في التكاملات وتدفقات البيانات، على عكس الحلول السحابية مثل Zapier، حيث يمكن استضافته على بنيتك التحتية الخاصة لضمان المرونة والخصوصية وقابلية التوسع. يوفر هذا الدليل الفني دليلاً مبسطًا للمبتدئين لتثبيت وتكوين n8n على خادم Ubuntu ذاتي الاستضافة باستخدام Docker Compose. ستتعلم أيضًا كيفية حل الأخطاء الشائعة، وتأمين النظام باستخدام HTTPS، وتجنب المخاطر أثناء النشر في الإنتاج.

الميزات الرئيسية لـ n8n

يتميز n8n بكونه منصة أتمتة مرنة وصديقة للمطورين. يتضمن محرر تدفقات بصري يعتمد على السحب والإفلات، وأكثر من 300 تكامل جاهز، ودعم الاستضافة الذاتية، وإمكانية كتابة كود JavaScript الأصلي داخل العقد. بالإضافة إلى ذلك، يدعم n8n التنفيذ المبني على الأحداث مثل Webhooks وCron Jobs. يتيح الهيكل المعياري إضافة عقد مخصصة وتكاملات متقدمة مع أنظمة مثل AWS وJira وأطر عمل Agentic AI.

مقارنة بين الخيارات المتاحة

يُفضل استخدام Docker على Ubuntu لمعظم المطورين لأنه يجمع بين التحكم الكامل والسهولة. فيما يلي جدول مقارنة فني:

الخيار	المميزات	العيوب	الجمهور المستهدف
n8n Cloud	لا يتطلب إعداد، إدارة تلقائية	مدفوع، تحكم محدود	مستخدمون غير فنيون
Self-hosted Docker	تحكم كامل، رخيص، آمن	يتطلب صيانة	مطورون وفرق فنية
Bare-metal	مرونة قصوى	إعداد يدوي معقد	مستخدمون متقدمون

المتطلبات الأساسية قبل تثبيت n8n على Ubuntu

قبل البدء في عملية instal n8n on ubuntu، تأكد من توفر الآتي: خادم Ubuntu 22.04 أو أحدث، نطاق مسجل موجه للخادم، صلاحيات root، وتثبيت Docker وDocker Compose. يمكنك تثبيت Docker باستخدام الأوامر التالية:

sudo apt update
sudo apt install docker.io docker-compose -y

خطوة 1: إعداد ملف Docker Compose

أنشئ مجلدًا خاصًا بالمشروع ثم أنشئ ملف التكوين:

mkdir ~/n8n && cd ~/n8n
nano docker-compose.yml

الصق التكوين التالي الذي يستخدم PostgreSQL للتخزين الدائم:

version: '3.7'

services:
  db:
    image: postgres:14
    environment:
      - POSTGRES_USER=n8n
      - POSTGRES_PASSWORD=n8npass
      - POSTGRES_DB=n8n
    volumes:
      - postgres_data:/var/lib/postgresql/data

  n8n:
    image: n8nio/n8n
    ports:
      - "5678:5678"
    environment:
      - DB_TYPE=postgresdb
      - DB_POSTGRESDB_HOST=db
      - DB_POSTGRESDB_DATABASE=n8n
      - DB_POSTGRESDB_USER=n8n
      - DB_POSTGRESDB_PASSWORD=n8npass
      - N8N_BASIC_AUTH_ACTIVE=true
      - N8N_BASIC_AUTH_USER=admin
      - N8N_BASIC_AUTH_PASSWORD=strongpass
      - N8N_HOST=n8n.yourdomain.com
      - WEBHOOK_TUNNEL_URL=https://n8n.yourdomain.com
    depends_on:
      - db
    volumes:
      - n8n_data:/home/node/.n8n

volumes:
  postgres_data:
  n8n_data:

خطوة 2: تشغيل n8n والتحقق من التثبيت

شغل الحاويات باستخدام الأمر التالي:

docker-compose up -d

يمكنك الوصول إلى n8n عبر http://your_server_ip:5678. في حالة الوصول عبر IP فقط، قد تواجه تحذير الأمان بسبب استخدام n8n للكوكيز الآمنة التي تتطلب HTTPS.

خطوة 3: تأمين n8n باستخدام HTTPS مع Nginx وLet’s Encrypt

ثبت Nginx وCertbot أولاً:

sudo apt install nginx certbot python3-certbot-nginx -y

أنشئ ملف تكوين Nginx للـ HTTPS:

server {
  listen 443 ssl;
  server_name n8n.yourdomain.com;

  ssl_certificate /etc/letsencrypt/live/n8n.yourdomain.com/fullchain.pem;
  ssl_certificate_key /etc/letsencrypt/live/n8n.yourdomain.com/privkey.pem;

  location / {
    proxy_pass http://localhost:5678;
    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;
  }
}

فعل الموقع ثم أصدر الشهادة:

sudo certbot --nginx -d n8n.yourdomain.com

إعداد الحساب الأولي في واجهة n8n

بعد الوصول إلى https://n8n.yourdomain.com، قم بإنشاء حساب المالك باستخدام بريد إلكتروني وقوة مرور قوية. بعد ذلك، قم بتسجيل النسخة المجانية لفتح الميزات المتقدمة مثل سجل التنفيذ وهيكلة المجلدات.

خطوة 4: إنشاء أول Workflow في n8n

ابدأ بإنشاء Workflow جديد، أضف عقدة Webhook، ثم عقدة Set لإرجاع رسالة نصية. شغل الـ Workflow واختبره باستخدام curl:

curl -X POST https://n8n.yourdomain.com/webhook/test-webhook

مثال عملي: مراقبة الخادم واستعادة الخدمات تلقائيًا

يمكن استخدام n8n مع UptimeRobot للكشف عن توقف الخادم. عند حدوث مشكلة، ينفذ أمر shell لإعادة تشغيل Nginx، يحدث إعدادات Cloudflare، ويرسل إشعارات عبر Slack وWhatsApp.

استكشاف الأخطاء الشائعة أثناء تثبيت n8n على Ubuntu

من أبرز الأخطاء:

• 401 Unauthorized: تحقق من إعدادات N8N_BASIC_AUTH.
• Webhook لا يعمل: تأكد من صحة WEBHOOK_TUNNEL_URL.
• خطأ الذاكرة: أضف NODE_OPTIONS=–max-old-space-size=2048.
• مشاكل الصلاحيات: استخدم chown -R 1000:1000 على مجلدات البيانات.

للحصول على أحدث النصائح حول استضافة n8n، يمكنك زيارة muslim-host.com. كما يُنصح بالرجوع إلى الوثائق الرسمية لـ n8n لمزيد من التفاصيل الفنية.

الأسئلة الشائعة حول تثبيت n8n

هل يتطلب تثبيت n8n على Ubuntu خبرة سابقة؟

لا، يمكن للمبتدئين اتباع الخطوات بسهولة خاصة مع Docker Compose.

ما هي أفضل قاعدة بيانات لـ n8n في الإنتاج؟

PostgreSQL هو الخيار الموصى به للتخزين الدائم والأداء العالي.

كيف يمكنني تفعيل الميزات المجانية المتقدمة؟

سجل بريدك الإلكتروني للحصول على مفتاح ترخيص مجاني مدى الحياة.

هل يدعم n8n التكامل مع أطر الذكاء الاصطناعي؟

نعم، يمكن دمجه مع Agentic AI Frameworks لإنشاء أتمتة ذكية.