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

محتويات المقال
أصبح 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:
| الاسم | النوع | القيمة |
|---|---|---|
n8n | A | عنوان 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 |
| تسجيل الدخول يفشل عبر HTTP | n8n يستخدم ملفات تعريف ارتباط آمنة | استخدم الرابط الذي يبدأ بـ 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 لعملائك كخدمة مستضافة.
المصادر والمراجع
مقالات ذات صلة
وكلاء الذكاء الاصطناعي والأتمتة
ما هي وكلاء الذكاء الاصطناعي (AI Agents)؟ شرح مبسّط بالأمثلة
الفرق بين وكيل الذكاء الاصطناعي والشات بوت والأتمتة العادية، وكيف يعمل الوكيل، وأمثلة عملية للأعمال العربية، وكيف تبدأ بتشغيل وكيلك الأول على سيرفرك.
قراءة في 3 دقائق
الخوادم الافتراضية والسحابة
ما هو الخادم الافتراضي VPS، ومتى تحتاج إليه فعلًا؟
يمنحك الخادم الافتراضي الخاص موارد مضمونة وتحكمًا كاملًا، ومعهما مسؤولية كاملة أيضًا. إليك طريقة عمله والعلامات التي تدل على أنك مستعد له.
قراءة في دقيقتين
وكلاء الذكاء الاصطناعي والأتمتة
أفضل سيرفر VPS لتشغيل n8n ووكلاء الذكاء الاصطناعي: كم تحتاج فعلًا؟
كم رامات ومعالج يحتاج n8n وOpenClaw وHermes Agent وOllama فعلًا، وأي حجم سيرفر VPS يناسب كل أداة، وما الذي تراجعه قبل أن تختار الشركة.
قراءة في دقيقتين