ملخص سريع: يتطلب تشغيل n8n محليًا إما npm (Node.js 20.19-24.x) أو Docker. تستخدم الطريقة الأسرع npx n8n للاختبار الفوري دون تثبيت، بينما يوفر Docker عزلاً أفضل وجاهزية للإنتاج. تمنحك كلتا الطريقتين وصولاً كاملاً إلى إمكانيات أتمتة سير العمل في n8n دون تكاليف سحابية متكررة.
يؤدي إعداد n8n على جهاز محلي إلى التخلص من رسوم الاشتراك المتكررة مع توفير تحكم كامل في أتمتة سير العمل. وفقًا لوثائق n8n الرسمية، تتطلب المنصة إصدار Node.js بين 20.19 و 24.x لتثبيتات npm، أو Docker للنشر المعبأ في حاويات.
يؤثر القرار بين الاستضافة المحلية والخدمات السحابية على كل من الميزانية والمرونة. وفقًا لمناقشات المجتمع، تتعامل التثبيتات المحلية مع عدد لا نهائي من سير العمل، بينما تتضمن الخطط السحابية تسعيرًا يعتمد على التنفيذ (بدءًا من 24 دولارًا شهريًا مقابل 2500 تنفيذ وفقًا لبعض تقارير المستخدمين).
المتطلبات المسبقة للتثبيت المحلي
قبل تثبيت n8n محليًا، يحتاج النظام إلى برامج محددة اعتمادًا على الطريقة المختارة.
يعتمد إصدار Node.js المطلوب لتثبيت npm بالكامل على المتطلبات المحددة لإصدار n8n الذي تقوم بنشره، حيث أن npm نفسها متوافقة مع جميع إصدارات LTS المدعومة حاليًا من Node.js. تحدد الوثائق الرسمية هذا النطاق الدقيق للإصدار للتوافق. تحقق من الإصدار الحالي عن طريق تشغيل node --version في الطرفية.
تتطلب تثبيتات Docker محرك Docker أو Docker Desktop. يوصي فريق n8n بـ Docker لمعظم احتياجات الاستضافة الذاتية لأنه يوفر عزلاً نظيفًا ويتجنب عدم توافق نظام التشغيل.
متطلبات النظام
تعمل مثيلات n8n المحلية على أنظمة Windows و macOS و Linux. لا يظهر أي حد أدنى لمواصفات ذاكرة الوصول العشوائي (RAM) في الوثائق الرسمية، ولكن تعقيد سير العمل يحدد احتياجات الموارد الفعلية.
يستهلك التثبيت مساحة قرص ضئيلة مبدئيًا. تنمو متطلبات التخزين بناءً على بيانات سير العمل وسجل التنفيذ وحزم العقد المخصصة.
الطريقة 1: تشغيل n8n باستخدام npm
يوفر تثبيت npm أسرع مسار لتشغيل n8n محليًا. تعمل هذه الطريقة مباشرة على النظام المضيف دون الحاجة إلى تعبئة في حاويات.
ابدأ بسرعة مع npx
النهج الأبسط يستخدم npx بدون تثبيت دائم. افتح الطرفية ونفذ:
| npx n8n |
يقوم هذا الأمر بتنزيل كل ما هو مطلوب ويبدأ n8n تلقائيًا. تصبح الواجهة متاحة على localhost:5678 في غضون ثوانٍ.
تعمل طريقة npx بشكل مثالي للاختبار والتقييم. إنها لا تتطلب حزم npm عامة أو تغييرات نظام دائمة.
تثبيت npm العام
للتثبيت الدائم، توفر حزمة npm العامة وصولاً ثابتًا:
| npm install n8n -g |
بعد اكتمال التثبيت، ابدأ n8n في أي وقت عن طريق التشغيل:
| n8n |
الإصدار المستقر الرئيسي الحالي من n8n هو 2.x (على سبيل المثال، 2.10.4). قد تحتوي إصدارات البيتا على ميزات غير مستقرة ويجب تجنبها لسير العمل الإنتاجي.
التكوين وتخزين البيانات
تقوم تثبيتات npm بتخزين بيانات سير العمل في دليل ~/.n8n افتراضيًا. يحتوي هذا الموقع على بيانات الاعتماد وتعريفات سير العمل وسجل التنفيذ.
تتحكم متغيرات البيئة في سلوك n8n. قم بتعيين متغير N8N_PORT لتغيير المنفذ الافتراضي 5678. تقوم متغيرات أخرى بتكوين اتصالات قاعدة البيانات وعناوين URL لاستدعاء الويب وإعدادات المصادقة.
الطريقة 2: تشغيل n8n باستخدام Docker
يمثل تثبيت Docker النهج الموصى به لاستضافة n8n المحلية. تؤكد الوثائق الرسمية على Docker لاحتياجات الاستضافة الذاتية الإنتاجية.
أمر تشغيل Docker الأساسي
ابدأ n8n بأمر Docker واحد:
| docker run -it --rm --name n8n -p 5678:5678 -v ~/.n8n:/home/node/.n8n n8nio/n8n |
ينشئ هذا الأمر حاوية باسم n8n، ويربط المنفذ 5678 بالنظام المضيف، ويحتفظ بالبيانات في دليل ~/.n8n.
تعمل الحاوية بشكل تفاعلي مع العلم -it. قم بإزالة --rm للاحتفاظ بالحاوية بعد إيقافها.
Docker Compose لإعداد الإنتاج
توفر تكوينات Docker Compose تحكمًا أفضل لبيئات الإنتاج. يحتوي مستودع n8n-hosting على GitHub على ملفات Docker Compose جاهزة للاستخدام لمختلف البنى.
يبدو تكوين docker-compose.yml الأساسي كما يلي:
| version: '3.8' services: n8n: image: n8nio/n8n restart: always ports: - "5678:5678" environment: - N8N_BASIC_AUTH_ACTIVE=true - N8N_BASIC_AUTH_USER=admin - N8N_BASIC_AUTH_PASSWORD=password volumes: - ~/.n8n:/home/node/.n8n |
ابدأ المكدس بـ:
| docker-compose up -d |
يقوم العلم -d بتشغيل الحاويات في وضع منفصل، مما يسمح باستخدام الطرفية لمهام أخرى.
التكوين الأولي والوصول
بعد تشغيل n8n عبر أي من الطريقتين، انتقل إلى localhost:5678 في متصفح ويب. تطلب شاشة الإعداد الأولية عنوان بريد إلكتروني وكلمة مرور للحساب الإداري.
يصبح هذا المستخدم الأول مالك المثيل مع صلاحيات إدارية كاملة. يمكن إضافة مستخدمين إضافيين لاحقًا عبر واجهة إدارة المستخدمين.
إعداد المصادقة
للأمان، قم بتمكين المصادقة حتى على التثبيتات المحلية. تقبل تكوينات Docker Compose متغيرات البيئة للمصادقة مباشرة:
| N8N_BASIC_AUTH_ACTIVE=true N8N_BASIC_AUTH_USER=admin N8N_BASIC_AUTH_PASSWORD=strongpassword |
تقوم هذه المتغيرات بتنشيط مصادقة HTTP الأساسية، مما يتطلب بيانات اعتماد لجميع محاولات الوصول.
اختبار العقد المخصصة محليًا
تشرح الوثائق الرسمية كيفية اختبار العقد المخصصة أثناء التطوير. قم بتثبيت n8n عالميًا أولاً، ثم قم بإنشاء وربط حزمة العقدة المخصصة.
في دليل العقدة المخصصة، قم بالتشغيل:
| npm run build npm link |
ثم انتقل إلى دليل عقد n8n (عادةً ~/.n8n/custom/) واربط الحزمة:
| npm link <node-package-name> |
تظهر العقدة المخصصة في واجهة n8n بعد إعادة تشغيل المثيل.
مصادر أتمتة مفيدة للاستخدام مع n8n
إذا كنت تتعلم كيفية تشغيل n8n محليًا واختبار سير العمل على جهازك، فقد تستفيد أيضًا من أدوات مساعدة وقوالب خارجية تجعل من السهل أتمتة المهام الشائعة. يقدم Get AI Perks مكتبة من قوالب سير العمل وأدوات بمساعدة الذكاء الاصطناعي التي يمكنك استخدامها جنبًا إلى جنب مع n8n أو لنمذجة أفكار الأتمتة قبل بنائها بنفسك.
مع Get AI Perks، يمكنك:
- البدء من قوالب سير العمل المعدة مسبقًا
- الحصول على مساعدة الذكاء الاصطناعي للمنطق والمحتوى الروتيني
- استكشاف أنماط الأتمتة الشائعة قبل تنفيذها في n8n
- الجمع بين القوالب وإعداد n8n المحلي الخاص بك
اكتشف Get AI Perks للعثور على مساعدات الأتمتة التي تدعم سير عمل n8n الخاص بك.
استكشاف الأخطاء الشائعة وإصلاحها
تعتبر تعارضات المنافذ المشكلة الأكثر شيوعًا في التثبيت. إذا كان المنفذ 5678 قيد الاستخدام بالفعل، فقم بإيقاف الخدمة المتعارضة أو تغيير منفذ n8n باستخدام متغير البيئة N8N_PORT.
عدم توافق إصدار Node
يؤدي استخدام إصدارات Node.js خارج النطاق 20.19-24.x إلى فشل التثبيت. يوثق مستودع GitHub الخاص بـ n8n المشكلات عندما يحاول المطورون بيئات تطوير محلية، مما يسلط الضوء على أهمية توافق إصدار Node.
تحقق من توافق إصدار Node قبل استكشاف الأخطاء وإصلاحها الأخرى. قم بتبديل إصدارات Node باستخدام nvm (Node Version Manager) إذا لزم الأمر.
أخطاء إذن مجلد Docker
تمنع مشكلات الأذونات مع تحميل مجلد ~/.n8n استمرار البيانات. تعمل حاويات Docker كمستخدم node، والذي قد يفتقر إلى حق الكتابة في الدليل المضيف.
قم بإنشاء الدليل بأذونات مناسبة قبل بدء الحاوية:
| mkdir ~/.n8n chmod 777 ~/.n8n |
أسئلة متكررة
هل يمكن تشغيل n8n بدون اتصال بالإنترنت؟
نعم، يعمل n8n بشكل غير متصل تمامًا لسير العمل المحلي. يصبح الاتصال بالإنترنت ضروريًا فقط عندما تتفاعل سير العمل مع واجهات برمجة التطبيقات الخارجية أو الخدمات السحابية.
كم تكلفة تشغيل n8n محليًا؟
التثبيتات المحلية مجانية. توفر النسخة المجتمعية جميع الميزات الأساسية بدون رسوم ترخيص. تبدأ الاستضافة السحابية بحدود تنفيذ وتكاليف شهرية، ولكن الاستضافة المحلية تزيل هذه القيود تمامًا وفقًا لمناقشات المجتمع.
هل يجب على المبتدئين استخدام npm أم Docker؟
يجب على المبتدئين الذين يختبرون n8n البدء بـ npx للوصول الفوري. يصبح Docker منطقيًا للاستخدام المستمر لأنه يوفر عزلًا أفضل وترقيات أسهل.
أين يقوم n8n بتخزين بيانات سير العمل محليًا؟
دليل البيانات الافتراضي هو ~/.n8n في المجلد الرئيسي للمستخدم. يحتوي هذا الموقع على ملفات قاعدة بيانات SQLite وبيانات الاعتماد وسجلات التنفيذ ما لم يتم تكوينه بخلاف ذلك.
هل يمكن تشغيل مثيلات n8n متعددة على جهاز واحد؟
نعم، ولكن كل مثيل يحتاج إلى منفذ فريد. قم بتعيين منافذ مختلفة باستخدام متغير البيئة N8N_PORT لكل مثيل. يجعل Docker هذا أسهل من خلال تعيين المنافذ في حاويات منفصلة.
كيف تعمل التحديثات للتثبيتات المحلية؟
يتم تحديث تثبيتات npm عبر npm update -g n8n أو npm install -g n8n@latest. يسحب مستخدمو Docker أحدث صورة باستخدام docker pull n8nio/n8n، ثم يعيدون إنشاء الحاويات. قم دائمًا بعمل نسخة احتياطية من دليل ~/.n8n قبل التحديث.
اعتبارات الإنتاج
تؤكد وثائق n8n الرسمية على أن الاستضافة الذاتية تتطلب معرفة تقنية. يتطلب إعداد الخوادم وإدارة الموارد وتأمين التطبيقات خبرة في إدارة النظام.
لعمليات النشر الإنتاجي، يوفر Docker Compose الأساس. أضف وكيلًا عكسيًا مثل nginx أو Caddy لدعم HTTPS. يتضمن مستودع n8n-hosting تكوينات Caddy جاهزة للنشر.
يؤثر اختيار قاعدة البيانات على أعباء العمل الثقيلة. تعمل قاعدة بيانات SQLite الافتراضية للاستخدام المعتدل، ولكن PostgreSQL توفر أداءً أفضل للأتمتة ذات الحجم الكبير وفقًا للإرشادات الرسمية.
اتخاذ القرار: محلي مقابل سحابي
تستوعب استضافة n8n المحلية الفرق التي لديها قدرات تقنية ومتطلبات أمان محددة. تبقى البيانات على بنية تحتية خاضعة للرقابة، وتختفي حدود التنفيذ.
ومع ذلك، تتطلب الاستضافة المحلية الصيانة والنسخ الاحتياطي والمراقبة. تقوم الاستضافة السحابية بنقل هذه المسؤوليات إلى فريق البنية التحتية الخاص بـ n8n. تحقق من الموقع الرسمي للحصول على مقارنات التسعير والميزات السحابية الحالية.
يوفر تشغيل n8n محليًا تحكمًا كاملاً في بنية أتمتة سير العمل. سواء باستخدام npm للاختبار السريع أو Docker لنشر الإنتاج، فإن كلا الطريقتين تقدمان المنصة الكاملة دون تكاليف متكررة. ابدأ بـ npx للاستكشاف الفوري، ثم انتقل إلى Docker عندما تتجه سير العمل نحو الاستخدام الإنتاجي.
