شغّل n8n على سيرفرك: دليل الـ Self-host

Cloud ولا Self-host؟

نفس البرنامج. الفرق مين اللي شايل السيرفر.

الرخصة في سطر: مجاني لاستخدامك الشخصي أو الشغل الداخلي في شركتك. تبيعه كخدمة لعملاء؟ محتاج اتفاق مع n8n.

Cloud

n8n بيدير السيرفر وتبدأ في دقايق، بس فيه اشتراك شهري بعد 14 يوم.

Self-host

البرنامج مجاني (Community edition) وبتدفع تمن السيرفر بس، بس الـ backups والتحديثات والأمان عليك.

n8n نفسها بتنصح بالـ self-host للي عنده خبرة في السيرفرات. غلطة في الإعداد ممكن تضيّع داتا أو تفتح ثغرة.

هتحتاج إيه

سيرفر

VPS على أي منصة. Linux.

دومين

subdomain زي n8n.yoursite.com.

Docker

n8n بيشتغل جواه.

SSH

terminal توصل بيه للسيرفر.

اختار المنصة

منصات تانية ليها أدلة رسمية من n8n: Google Cloud Run و AWS و Azure و Heroku و GKE. Railway و Render فيهم templates من المجتمع، مش رسمية، فراجع مين عاملها وأي إصدار بتنزّل.

Hostinger (المسار A)

Template فيه n8n متسطّب. من غير terminal. الأسهل.

DigitalOcean (المسار B)

Droplet بصورة Docker من الـ Marketplace، ودليل n8n الرسمي.

Hetzner (المسار B)

سيرفر بـ Docker CE، ونفس دليل n8n الرسمي. CPX11 كفاية لمعظم الاستخدام.

اللابتوب بتاعك (المسار C)

Docker Desktop وأمر واحد. ببلاش، بس شغال طول ما الجهاز شغال. للتعلم والتجربة.

مش متأكد؟ ابدأ على اللابتوب بتاعك (المسار C) ببلاش، وانقل لسيرفر لما تحتاج.

المسار A: Hostinger، template جاهز من غير terminal

n8n بيجي متسطّب جوه Docker على Ubuntu.

عايز دومينك؟ اعمل A record لـ n8n على IP السيرفر، عدّل ملف .env وحط دومينك، وأعد التشغيل بـ docker compose down وبعدين up -d. أسماء القوايم من hPanel وقت كتابة الدليل، وممكن تتغير.

1. 1

   افتح الـ VPS من hPanel

   hPanel، بعدين VPS، بعدين Manage جنب السيرفر.

2. 2

   غيّر الـ OS لـ template الـ n8n

   OS & Panel، بعدين Operating System، وابحث عن n8n واختار الـ template. لو لسه بتشتري الـ VPS، تقدر تختاره وقت الشراء على طول. تغيير الـ OS بيمسح كل حاجة على السيرفر، فاعمله على سيرفر جديد أو بعد backup.

3. 3

   حط باسورد الـ root واستنى التسطيب

   احفظه في password manager. هتحتاجه لو دخلت بالـ SSH بعدين.

4. 4

   افتح n8n واعمل حساب الـ owner

   العنوان بتاعك مكتوب في صفحة الـ Overview، أو دوس Manage App. أول مرة تفتح بيطلب منك تعمل حساب الأدمن.

المسار B: DigitalOcean أو Hetzner بالدليل الرسمي (Docker + Caddy)

نفس الخطوات على المنصتين. Caddy بيعمل HTTPS لوحده على بورت 443 و 80، و n8n شغال على 5678، والداتا كلها في Docker volume اسمه n8n_data.

1. 1

   اعمل السيرفر بصورة فيها Docker

   DigitalOcean: Droplets، بعدين Create، تاب Marketplace، واختار Docker. خطة basic shared CPU كفاية. Hetzner: CREATE SERVER، بعدين Image، تاب APPS، واختار Docker CE بنوع CPX11. اختار SSH key بدل الباسورد، أأمن.

2. 2

   ادخل على السيرفر بالـ SSH

   ssh root@SERVER_IP

3. 3

   Hetzner بس: سطّب Docker Compose

   apt update && apt -y upgrade
   apt install docker-compose-plugin

4. 4

   اشتغل بـ user غير الـ root

   ضيف الـ SSH key للـ user الجديد، اخرج، وادخل بيه. ده من دليل DigitalOcean وينفع على أي سيرفر.

   adduser mina
   usermod -aG sudo mina

5. 5

   نزّل ملفات الإعداد الرسمية

   git clone https://github.com/n8n-io/n8n-docker-caddy.git
   cd n8n-docker-caddy
   sudo docker volume create caddy_data
   sudo docker volume create n8n_data

6. 6

   وجّه الـ subdomain للسيرفر

   من لوحة الدومين بتاعك (أي مزوّد): A record اسمه n8n وقيمته IP السيرفر.

7. 7

   افتح بورت 80 و 443

   sudo ufw allow 80
   sudo ufw allow 443

8. 8

   املا ملف .env

   DATA_FOLDER=/home/mina/n8n-docker-caddy # = output of pwd
   DOMAIN_NAME=yoursite.com
   SUBDOMAIN=n8n
   GENERIC_TIMEZONE=Africa/Cairo
   SSL_EMAIL=you@yoursite.com

9. 9

   اكتب دومينك في الـ Caddyfile

   n8n.yoursite.com {
       reverse_proxy n8n:5678 {
           flush_interval -1
       }
   }

10. 10

    شغّل وافتح

    افتح https://n8n.yoursite.com واعمل حساب الـ owner. أول تشغيل ممكن ياخد كام دقيقة.

    sudo docker compose up -d

المسار C: n8n على اللابتوب بتاعك

مجاني، والداتا على جهازك. أحسن مكان تتعلم وتبني فيه.

1. 1

   سطّب Docker Desktop

   Windows: سطّب WSL الأول من PowerShell كـ Administrator بأمر wsl --install، وبعدين Docker Desktop. Mac: نزّل النسخة الصح لجهازك، Apple silicon أو Intel، وتعرف نوع الـ chip من Apple ثم About This Mac. Linux: Docker Desktop، أو Docker Engine مع الـ Compose plugin. التحميل من docs.docker.com/get-docker.

2. 2

   اتأكد إن Docker شغال

   الاتنين لازم يطبعوا رقم إصدار. لو طلع error، Docker Desktop لسه مقفول.

   docker --version
   docker compose version

3. 3

   شغّل أمر التسطيب

   على Windows من الـ terminal بتاع Ubuntu (WSL)، مش PowerShell. على Mac و Linux من الـ Terminal.

   curl -fsSL https://get.n8n.io | sh

4. 4

   افتح المتصفح واعمل حساب الـ owner

   افتح http://localhost:5678. أول تشغيل بياخد كام دقيقة، ولو الصفحة مفتحتش استنى شوية واعمل refresh.

اللابتوب: أوامر كل يوم، وحدوده

من نفس الفولدر اللي شغّلت فيه أمر التسطيب. هو عامل جواه فولدر اسمه n8n.

ينفع لـ

تتعلم n8n من غير ما تدفع، تبني وتجرب workflows، وتشتغل على ملفات وداتا على جهازك.

مينفعش لـ

Schedule لازم يشتغل 24 ساعة، webhooks من برّه زي Telegram و GitHub، أو فريق محتاج يدخل من أجهزته. اللابتوب نايم أو مقفول يعني n8n واقف، وأي trigger في الوقت ده بيفوت.

رخصة Docker Desktop

مجاني للاستخدام الشخصي والتعليم والشركات الأقل من 250 موظف و 10 مليون دولار إيراد. الشركات الأكبر محتاجة اشتراك مدفوع.

جاهز تنقل لسيرفر؟

من اللابتوب: القايمة ⋯ ثم Download. وعلى السيرفر: القايمة ⋯ ثم Import from File.

# stop
docker compose -f ./n8n/compose.yml down

# start again (after a restart, open Docker Desktop first)
docker compose -f ./n8n/compose.yml up -d

# upgrade to the latest version
curl -fsSL https://get.n8n.io | sh -s -- --upgrade

جهازك مش متاح من الإنترنت، فالـ webhooks من برّه مش هتوصله. أداة الـ tunnel بتاعة n8n معمولة للتطوير بس، و n8n بتقول إنها مش آمنة للـ production.

بعد التسطيب

السيرفر بقى مسؤوليتك. دي الحاجات اللي متتأجلش.

• اعمل حساب الـ owner أول ما يفتح. متسيبش الصفحة دي مفتوحة لحد تاني.
• سجّل الـ Community edition بإيميلك. مجاني، ويفتح Folders و Debug in editor.
• احفظ نسخة من ملف .env والـ volume بتاع n8n_data. فيهم كل الـ workflows والـ credentials.
• حدّث n8n بانتظام. متسيبش سيرفر مفتوح على الإنترنت بإصدار قديم.
• فريق أو production؟ انقل من SQLite لـ Postgres.

التحديث على المسار B

الداتا في الـ volume، فمش بتتمسح مع down. السيرفر الرخيص مش مجاني: ساعة من وقتك كل شهر للتحديث والـ backup جزء من التكلفة.

cd ~/n8n-docker-caddy
sudo docker compose pull
sudo docker compose down
sudo docker compose up -d

خد بالك من -v. الأمر docker compose down -v بيمسح الداتا كلها.