n8n على Cloudesta: أول تسجيل دخول والإعداد الأولي

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

المتطلبات المسبقة

• خدمة استضافة n8n من Cloudesta مفعّلة.
• رسالة الترحيب، وتحتوي على عنوان IP الخاص بالسيرفر وبيانات دخول SSH ورابط n8n ومجلد Docker Compose.
• عميل SSH (تطبيق Terminal على macOS/Linux، أو Windows Terminal/PowerShell على Windows).
• كلمة مرور قوية وفريدة جاهزة لحساب مالك n8n.

1. ماذا تتضمن باقة n8n من Cloudesta؟

الباقة عبارة عن VPS سحابي كامل يعمل بنظام Ubuntu، مع صلاحية دخول root عبر SSH وعنوان IPv4 مخصص. Docker وDocker Compose مثبّتان، وn8n يعمل داخل حاوية. تتضمن رسالة الترحيب البيانات التي تحتاجها:

• عنوان IP الخاص بالسيرفر (مثلًا 203.0.113.10) واسم مستخدم SSH وكلمة المرور.
• رابط n8n (مثلًا https://n8n.example.com).
• المجلد الذي يحتوي على ملف Docker Compose. يكون عادةً /opt/n8n، لكن استخدم دائمًا المسار المذكور في رسالتك.

2. كيف أسجّل الدخول إلى سيرفر n8n عبر SSH؟

اتصل بالمستخدم root، وغيّر كلمة المرور التي استلمتها، ثم انتقل إلى مجلد Compose:

ssh root@203.0.113.10
passwd
cd /opt/n8n
ls -la

يُفترض أن يحتوي المجلد على docker-compose.yml أو compose.yaml، وربما ملف .env. تفترض الأوامر في هذا الشرح أن اسم خدمة n8n هو n8n. يمكنك التأكد من أسماء الخدمات باستخدام docker compose ps --services.

3. كيف أنشئ حساب مالك n8n؟

افتح رابط n8n الموجود في رسالتك في المتصفح. عند الزيارة الأولى يعرض n8n نموذج Set up owner account. أدخل بريدك الإلكتروني والاسم الأول واسم العائلة وكلمة مرور، ثم اضغط Next. يشترط n8n أن تتكون كلمة المرور من 8 أحرف على الأقل وتحتوي على رقم واحد وحرف كبير واحد، لكن يُنصح باستخدام كلمة مرور أطول بكثير.

4. كيف أضبط المنطقة الزمنية لـ n8n ومدة الاحتفاظ ببيانات التنفيذ؟

يقرأ n8n كلا الإعدادين من متغيرات البيئة. تتحكم المنطقة الزمنية في توقيت تشغيل عُقد Schedule Trigger. أما مدة الاحتفاظ فتتحكم في المدة التي يُحفظ فيها سجل التنفيذات، مما يمنع قاعدة البيانات من التضخم بلا حدود. أولًا خذ نسخة احتياطية من ملف Compose:

cd /opt/n8n
cp docker-compose.yml docker-compose.yml.bak
nano docker-compose.yml

تحت قسم environment: الخاص بخدمة n8n، أضف هذه الأسطر أو عدّلها. غيّر المنطقة الزمنية إلى منطقتك. قيمة EXECUTIONS_DATA_MAX_AGE بالساعات، أي أن 168 تساوي 7 أيام.

    environment:
      - GENERIC_TIMEZONE=Africa/Cairo
      - TZ=Africa/Cairo
      - EXECUTIONS_DATA_PRUNE=true
      - EXECUTIONS_DATA_MAX_AGE=168
      - EXECUTIONS_DATA_PRUNE_MAX_COUNT=10000

إذا كان إعدادك يحفظ المتغيرات في .env، فأضفها هناك بدلًا من ذلك كأسطر عادية بصيغة KEY=value. طبّق التغييرات باستخدام:

docker compose up -d

استخدم up -d هنا وليس restart، لأن إعادة التشغيل لا تقرأ متغيرات البيئة المعدّلة. يمكنك أيضًا تجاوز المنطقة الزمنية لسير عمل واحد من خلال Settings الخاصة بسير العمل.

5. أين يخزّن n8n بياناته؟

داخل الحاوية، يحفظ n8n بياناته في /home/node/.n8n. ويُربط هذا المجلد بالسيرفر المضيف بإحدى طريقتين: Docker volume (مثلًا n8n_data) أو bind mount (مثلًا ./n8n_data). راجع قسم volumes: في ملف Compose لمعرفة الطريقة المستخدمة على سيرفرك. يمكنك عرض الـ volumes ومعرفة مكانها على القرص باستخدام:

docker volume ls
docker volume inspect n8n_data

يعتمد مكان قاعدة البيانات على نوعها:

• إذا لم يكن DB_TYPE مضبوطًا، يستخدم n8n قاعدة SQLite المخزّنة في database.sqlite داخل مجلد .n8n.
• إذا كان DB_TYPE=postgresdb مضبوطًا، فإن سير العمل والتنفيذات تُحفظ في حاوية Postgres، ولهذه الحاوية volume خاص بها.

6. كيف أشغّل n8n وأوقفه وأعرض سجلاته باستخدام Docker Compose؟

نفّذ هذه الأوامر من داخل مجلد Compose:

docker compose ps                    # status of all containers
docker compose up -d                 # start (or apply changes)
docker compose stop                  # stop without removing containers
docker compose restart n8n           # restart n8n only
docker compose logs -f --tail=100 n8n   # follow the last 100 log lines (Ctrl+C to exit)

الأمر docker compose down يحذف الحاويات لكنه يُبقي على الـ volumes المسمّاة، لذا تظل بياناتك آمنة. لا تُضف أبدًا -v إلى هذا الأمر، لأن -v يحذف الـ volumes ومعها بياناتك.

7. كيف أعرف إصدار n8n الذي يعمل؟

من واجهة الويب، افتح Help > About n8n في الشريط الجانبي الأيسر. ومن SSH، نفّذ:

docker compose exec n8n n8n --version

8. كيف أشغّل أول سير عمل تجريبي؟

يؤكد هذا الاختبار أن سير العمل يعمل وأن المنطقة الزمنية صحيحة:

• أنشئ سير عمل جديدًا وأضف عقدة Manual Trigger ("Trigger manually").
• أضف عقدة Edit Fields (Set)، وأنشئ حقلًا باسم now بالتعبير {{ $now.toISO() }}.
• اضغط Test workflow. في الإصدارات الأحدث يحمل هذا الزر اسم Execute workflow.

يُفترض أن تعرض النتيجة الوقت الحالي مع فرق التوقيت الخاص بمنطقتك الزمنية، مثلًا +03:00.

9. كيف أحافظ على أمان n8n؟

• استخدم كلمة مرور طويلة وفريدة لحساب المالك، واستخدم مفاتيح SSH بدلًا من كلمات المرور للمستخدم root.
• ادخل إلى n8n دائمًا عبر HTTPS من خلال النطاق الخاص به، ولا تستخدم أبدًا http://203.0.113.10:5678.
• لا تفتح منافذ إضافية. المنافذ التي ينشرها Docker تتجاوز ufw، لذا تأكد من أن docker compose ps لا يعرض 0.0.0.0:5678->5678. إذا ظهر ذلك وكان الـ reverse proxy يعمل على السيرفر المضيف، فغيّر الربط إلى "127.0.0.1:5678:5678".
• حافظ على تحديث Ubuntu باستخدام apt update && apt upgrade.

لتعزيز الحماية بما يتجاوز هذه الأساسيات، اطّلع على خدمات الأمن السيبراني من Cloudesta.

التحقق من أن كل شيء يعمل

docker compose ps
curl -s https://n8n.example.com/healthz

كل شيء يعمل بشكل سليم إذا تحققت جميع النقاط التالية:

• تظهر الحاويات بحالة running (أو Up).
• يُرجع فحص السلامة {"status":"ok"}.
• يمكنك تسجيل الدخول كمالك، ويعمل سير العمل التجريبي بنجاح.

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

صفحة n8n لا تفتح

نفّذ هذه الفحوصات بالترتيب:

• نفّذ docker compose ps. إذا كانت حاوية n8n أو حاوية الـ proxy متوقفة، فشغّلها باستخدام docker compose up -d وراجع docker compose logs n8n بحثًا عن أخطاء.
• افحص الجدار الناري باستخدام ufw status. إذا كان مفعّلًا، فاسمح بمنافذ الويب باستخدام ufw allow 80/tcp وufw allow 443/tcp. لا تفعّل ufw قبل السماح بـ OpenSSH، وإلا ستفقد إمكانية الدخول عبر SSH.
• تأكد من أن سجل DNS من نوع A الخاص بنطاقك يشير إلى عنوان IP الخاص بالسيرفر.

تحذير "Your n8n server is configured to use a secure cookie"

أنت تفتح n8n عبر HTTP غير المشفّر. استخدم بدلًا من ذلك رابط النطاق https:// الموجود في رسالتك. ضبط N8N_SECURE_COOKIE=false يُخفي التحذير، لكنه يترك جلسة تسجيل الدخول دون حماية، لذا لا تستخدمه إلا لاختبار محلي قصير.

نسيت كلمة مرور المالك

إذا كان SMTP مُعدًّا، فاستخدم Forgot my password في صفحة تسجيل الدخول. وبدون SMTP، أعد ضبط إدارة المستخدمين بالأوامر التالية، ثم أنشئ حساب المالك من جديد. يؤدي ذلك إلى حذف جميع حسابات المستخدمين، لكن سير العمل وبيانات الاعتماد تبقى كما هي.

docker compose exec n8n n8n user-management:reset
docker compose restart n8n

المهام المجدولة تعمل في وقت خاطئ

اضبط GENERIC_TIMEZONE كما هو موضح في القسم 4، ونفّذ docker compose up -d، وتحقق من إعداد المنطقة الزمنية الخاص بكل سير عمل.

الأسئلة الشائعة

هل يمكنني تثبيت برامج أخرى على سيرفر n8n؟

نعم. فهو VPS سحابي عادي بصلاحيات root، لكن تجنّب أي برنامج يستخدم المنفذين 80/443 أو ينافس n8n على الذاكرة.

كيف أحصل على معالج أو ذاكرة RAM أو مساحة أكبر لـ n8n؟

تتولى Cloudesta ترقية الباقات، لذا افتح تذكرة دعم تطلب فيها الترقية. كما يتم طلب وضع الإنقاذ (Rescue mode) وإعادة تثبيت نظام التشغيل وتغيير عنوان IP عبر تذكرة أيضًا.

ما الذي يجب أن آخذ منه نسخة احتياطية؟

خذ نسخة احتياطية من مجلد .n8n (بما في ذلك ملف config الذي يحتوي على مفتاح التشفير)، ومن volume الخاص بـ Postgres إذا كنت تستخدم Postgres، ومن ملفات Compose و.env. تتوفر شروحات أخرى في مكتبة شروحات Cloudesta.

تحتاج إلى مساعدة؟ افتح تذكرة دعم من خلال https://cloudesta.com/submitticket.php وأرفق عنوان IP الخاص بسيرفرك ونتيجة الأمر docker compose ps.