⚡ تثبيت Huginn — عملاء أتمتة ذاتية الاستضافة
انشر Huginn على Ubuntu باستخدام Docker — عملاء مستقلون يراقبون المواقع وموجزات RSS وواجهات API، ثم يُنبّهونك أو يسلسلون الأحداث في أتمتة كاملة، بدون اشتراكات أو ارتباط بسحابة أي شركة.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/automation/huginn/huginn-ubuntu.sh
chmod +x huginn-ubuntu.sh
sudo bash huginn-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/automation/huginn/huginn-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x huginn-ubuntu.sh
3 تشغيل المثبت
يثبّت السكريبت Docker إن لزم، يسحب صورة Huginn، ويُشغّل الحاوية مع قاعدة بيانات MySQL الخاصة بها على تخزين دائم.
sudo bash huginn-ubuntu.sh
4 الدخول إلى واجهة الويب
افتح المتصفح وسجّل الدخول ببيانات الاعتماد الافتراضية، ثم غيّر كلمة المرور فوراً:
http://:3000
# Default login: admin / password
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3000 | Huginn Web UI + webhook endpoints |
نظرة عامة
Huginn نظام مجاني ومفتوح المصدر لبناء عملاء يراقبون المواقع وموجزات RSS وواجهات API ومصادر بيانات أخرى، ثم يتصرفون تلقائياً عند حدوث تغيير. مستوحى من أدوات مثل IFTTT وYahoo Pipes، يتيح لك ربط لبنات بناء صغيرة تُسمى العملاء (Agents) — كل منها يراقب حدثاً أو يحوّل بيانات أو يُطلق إجراءً — في تدفقات أتمتة كاملة. كل شيء يعمل على سيرفرك الخاص، لذا لا اشتراكات ولا حدود معدل يفرضها طرف ثالث ولا شركة تقرأ منطق أتمتتك.
لماذا تستخدمه
وُجد Huginn لأن منصات الأتمتة التجارية مثل IFTTT وZapier تفرض رسوماً شهرية، وتحدّ عدد الأتمتة التي يمكنك تشغيلها، وتتطلب مرور بياناتك وبيانات اعتمادك عبر سحابتها. Huginn ذاتي الاستضافة، مجاني، ومفتوح المصدر برخصة MIT، بحيث يمكنك بناء تدفقات غير محدودة، وكشط أي موقع أو API لديك حق وصول شرعي إليه، والاحتفاظ بالبيانات الحساسة ورموز تسجيل الدخول بالكامل على بنيتك التحتية الخاصة. نموذج العملاء والأحداث لديه أيضاً أكثر مرونة بكثير من معظم أدوات الأتمتة بدون كود — يمكن ربط العملاء في مخططات معقدة، ويمكن توسيع إطار العمل المبني على Ruby بكود مخصص أو حزم خارجية لأتمتة لا تستطيع أي أداة بصرية التعبير عنها.
متى تحتاجه
- تريد مراقبة المواقع أو موجزات RSS أو واجهات API لرصد التغييرات والحصول على تنبيهات دون دفع اشتراك لمنصة أتمتة سحابية
- تحتاج ربط عدة خطوات أتمتة معاً — كشط، تصفية، تحويل، ثم إشعار أو نشر — في تدفق واحد
- تصطدم بحدود عدد الأتمتة أو تكرار التشغيل في الخطط المجانية لـ IFTTT أو Zapier أو خدمات سحابية مشابهة
- تريد أتمتة تلمس بيانات اعتماد حساسة أو بيانات شخصية ولا تريد مرور تلك البيانات عبر سحابة طرف ثالث
- أنت مرتاح لتطبيق Ruby on Rails ذاتي الاستضافة وتريد تحكماً كاملاً في محرك الأتمتة الخاص بك
- تحتاج تكاملات مخصصة أو غير اعتيادية لا تدعمها منصات الأتمتة الجاهزة افتراضياً
من يحتاجه
- عشاق الاستضافة الذاتية الذين يريدون بديلاً خاصاً لـ IFTTT أو Zapier بدون حدود تشغيل أو رسوم اشتراك
- المطورون المرتاحون لتوسيع الأتمتة بكود Ruby مخصص أو حزم عملاء للحالات التي لا تستطيع الأدوات البصرية التعامل معها
- الباحثون والمحللون الذين يحتاجون كشط ومراقبة مستمرة للمواقع أو الموجزات أو واجهات API للبيانات المتغيرة
- المستخدمون المهتمون بالخصوصية الذين لا يريدون تخزين منطق أتمتتهم أو بيانات اعتمادهم أو بياناتهم المكشوطة على سيرفرات طرف ثالث
- الفرق الصغيرة التي تريد تدفقات تنبيه ومراقبة داخلية دون تبني منصة أتمتة تجارية
- الهواة الذين يبنون لوحات معلومات شخصية أو متتبعات أسعار أو أنظمة إشعارات من مصادر بيانات عامة مجمّعة
حالات الاستخدام الشائعة
- تتبع تغيرات الأسعار على مواقع التسوق وإرسال تنبيه عند انخفاض سلعة تحت سعر مستهدف
- مراقبة موجزات RSS وإعادة توجيه المقالات الجديدة المطابقة لكلمات مفتاحية إلى البريد أو Slack أو webhook للدردشة
- مراقبة موقع لرصد تغيرات المحتوى وإشعارك لحظة حدوث تحديث
- تجميع بيانات من عدة واجهات API وموجزات في ملخص واحد يُرسل حسب جدول زمني
- إطلاق أتمتة لاحقة في أدوات أخرى عبر webhooks عند حدوث حدث في Huginn
- بناء لوحات معلومات شخصية بسيطة تجمع الطقس والأخبار ومصادر بيانات مخصصة في موجز واحد
الميزات الرئيسية
- محرك تدفق عمل قائم على العملاء — كل عميل يؤدي مهمة واحدة ويمرر الأحداث للعميل التالي في السلسلة
- مجموعة واسعة من العملاء المدمجين لكشط الويب وتحليل RSS واستطلاع API والبريد الإلكتروني وwebhooks والمشغّلات المجدولة
- بنية قائمة على الأحداث بحيث لا تعمل العملاء وتمرر البيانات إلا عند حدوث تغيير فعلي
- مخطط بصري لسلاسل العملاء يُظهر كيفية تدفق الأحداث عبر أتمتتك
- قابل للتوسيع بعملاء مخصصين مكتوبين بـ Ruby أو مضافين كحزم خارجية عبر متغير البيئة ADDITIONAL_GEMS
- تجميع السيناريوهات لتنظيم العملاء المرتبطين في حزمة أتمتة واحدة قابلة للتصدير والمشاركة
- تنفيذ مجدول أو مُطلق بـ webhook بحيث يمكن للعملاء العمل بمؤقت أو الاستجابة فوراً لأحداث خارجية
كيفية الاستخدام بعد التثبيت
- سجّل الدخول ببيانات admin / password الافتراضية وغيّر كلمة المرور فوراً من إعدادات حسابك
- أنشئ أول عميل لك — Website Agent أو RSS Agent نقطة بداية جيدة لمراقبة مصدر بيانات
- اربط عميلاً ثانياً بالأول، مثل Email Agent أو Webhook Agent، للتصرف عندما ينتج العميل المصدر حدثاً
- جمّع العملاء المرتبطين في سيناريو حتى تتمكن من تنظيم وتصدير ومشاركة أتمتة كاملة كوحدة واحدة
- اضبط الجدول الزمني لكل عميل استطلاع في إعداداته — يُشغّل Huginn العملاء عبر مهمة rake مرتبطة بفترة جدولة
- استكشف عرض مخطط العملاء لتصور كيفية تدفق الأحداث بين عملائك واستكشاف أخطاء السلاسل المعطلة
- تصفّح ويكي المجتمع ومكتبة العملاء العامة لأمثلة سيناريوهات يمكنك استيرادها بدلاً من البناء من الصفر
أفضل ممارسات الأمان
- غيّر بيانات الدخول الافتراضية admin / password فوراً بعد أول تسجيل دخول — هذه البيانات معروفة للعامة
- ضع Huginn خلف وكيل عكسي مع HTTPS قبل كشفه خارج شبكتك المحلية، لأن نموذج تسجيل الدخول يُرسل بيانات الاعتماد
- لا تكشف المنفذ 3000 مباشرة للإنترنت بدون TLS — ملفات تعريف ارتباط الجلسة وبيانات الاعتماد ستنتقل بدون تشفير
- راجع إعدادات أي عميل بعناية قبل تفعيله، خاصة عملاء Shell Command الذين يستطيعون تنفيذ أوامر عشوائية على المضيف
- خزّن مفاتيح API وأسرار webhook التي تستخدمها عملاؤك كبيانات اعتماد Huginn بدلاً من ترميزها مباشرة في إعدادات العميل
- قيّد التسجيل إذا كشفت النسخة لغيرك — يسمح Huginn بالتسجيل المفتوح افتراضياً في بعض الإعدادات
- حافظ على تحديث صورة Docker، لأن Huginn يعتمد على مكدس Rails وRuby يتلقى تصحيحات أمنية دورية
المنافذ وإعدادات جدار الحماية
تُقدَّم واجهة Huginn ونقاط webhook على المنفذ 3000 افتراضياً، مدعومة بحاوية قاعدة بيانات MySQL (أو PostgreSQL) تبقى داخلية لشبكة Docker ولا تُنشر إلى المضيف. يجب عدم كشف المنفذ 3000 مباشرة للإنترنت العام بدون وكيل عكسي يضيف TLS، وإلا فإن بيانات تسجيل الدخول وحمولات webhook ستنتقل بنص عادي HTTP. إذا احتجت أن يستقبل العملاء webhooks خارجية — مثلاً من خدمة طرف ثالث تنشر أحداثاً إلى Huginn — ضع النسخة خلف Nginx Proxy Manager أو وكيل عكسي مماثل على المنفذ 443 مع شهادة صالحة، وقيّد الوصول المباشر للمنفذ 3000 على شبكتك المحلية أو VPN.
النسخ الاحتياطي والصيانة
- احفظ نسخة احتياطية من حجم قاعدة بيانات MySQL/PostgreSQL، الذي يخزن كل إعدادات العملاء والسيناريوهات وتاريخ الأحداث
- صدّر السيناريوهات الفردية من الواجهة كملفات JSON لنسخة احتياطية خفيفة وقابلة للنقل من منطق أتمتتك
- احفظ نسخة من docker-compose.yml وأي متغيرات بيئة (مثل ADDITIONAL_GEMS أو إعدادات SMTP) حتى يمكن إعادة إنشاء المكدس بشكل مطابق
- جدول تفريغات قاعدة بيانات تلقائية بدلاً من الاعتماد على نسخ احتياطية يدوية، خاصة إذا كانت العملاء تجمع بيانات بنشاط
- خزّن النسخ الاحتياطية خارج سيرفر المضيف حتى لا يستطيع فشل قرص واحد تدمير أتمتتك الحية ونسختها الاحتياطية معاً
- اختبر استعادة تصدير سيناريو على نسخة Huginn منفصلة دورياً للتأكد أن نسخك الاحتياطية قابلة للاستخدام فعلياً
الأخطاء الشائعة
- ترك بيانات الدخول الافتراضية admin / password دون تغيير، وهي معروفة للعامة وهدف شائع للفحوصات الآلية
- كشف المنفذ 3000 للإنترنت بدون وكيل عكسي وTLS، مما يرسل بيانات الاعتماد وبيانات webhook بدون تشفير
- استطلاع مواقع أو واجهات API خارجية بتكرار مفرط، مما قد يُفعّل تحديد المعدل أو يؤدي لحظر عنوان IP الخاص بسيرفرك
- استخدام عملاء Shell Command لتشغيل سكريبتات عشوائية دون فهم أنها تُنفَّذ بصلاحيات عملية Huginn
- نسيان تجميع العملاء المرتبطين في سيناريوهات، مما يجعل مخطط الأتمتة صعب الإدارة مع نموه
- عدم ضبط جدول زمني لعملاء الاستطلاع، فإما لا تعمل أبداً أو تعمل أكثر بكثير مما هو مقصود
استكشاف الأخطاء وإصلاحها
- تعذر الوصول لواجهة الويب — تأكد أن الحاوية تعمل بأمر docker ps وتحقق أن المنفذ 3000 غير محظور بجدار حماية المضيف
- العملاء لا تُفعَّل حسب الجدول — تحقق من ضبط الجدول بشكل صحيح في إعدادات العميل وأن عملية المُجدول الخلفية تعمل
- عميل كشط الويب لا يُعيد بيانات — قد يكون هيكل HTML للموقع المستهدف قد تغيّر؛ حدّث محددات CSS/XPath للعميل وفقاً لذلك
- رسائل البريد من Email Agents لا تصل — تحقق أن متغيرات بيئة SMTP مضبوطة بشكل صحيح واختبر بعميل بسيط أولاً
- أخطاء اتصال بقاعدة البيانات عند التشغيل — تأكد أن حاوية MySQL/PostgreSQL سليمة وأن متغيرات البيئة متطابقة بين الحاويات
- استخدام مرتفع للذاكرة أو المعالج — راجع أي العملاء تستطلع بتكرار مفرط ووزّع جداولها لتخفيف الحمل
البدائل
n8n وNode-RED أدوات أتمتة بصرية قائمة على التدفق أسهل لبناء منطق معقد بها بيانياً، وكلاهما أيضاً ذاتي الاستضافة ومجاني، مما يجعلهما بديلين قريبين إذا فضّلت واجهة السحب والإفلات على نموذج قائمة العملاء في Huginn. IFTTT وZapier منصتا أتمتة سحابيتان تجاريتان متطورتان بمكتبات تكامل ضخمة، لكنهما تفرضان اشتراكات، وتحدّان عدد الأتمتة في الخطط المجانية، وتوجّهان بياناتك عبر سيرفراتهما. changedetection.io يركز تحديداً على مراقبة تغيرات المواقع وهو أبسط بكثير للإعداد إذا كانت هذه حاجتك الوحيدة. لكشط ويب قابل للبرمجة وسلسلة أحداث تتحكم فيها بالكامل على بنيتك التحتية الخاصة، يبقى Huginn من أنضج الخيارات ذاتية الاستضافة، رغم أن واجهته القائمة على Rails تبدو قديمة مقارنة بمحرر n8n الحديث.
متى لا تستخدمه
واجهة Huginn ونموذج إعداد العملاء أقل صقلاً بكثير من البدائل الحديثة مثل n8n أو Node-RED، لذا إذا كان بناء تدفق العمل البصري وواجهة حديثة مهمين لك، فمن المرجح أن تكون تلك الأدوات أكثر متعة للاستخدام. ليس الأداة المناسبة إذا احتجت تكاملات مبنية على الذكاء الاصطناعي أو سوقاً كبيراً من الموصلات الجاهزة — المنصات التجارية وأدوات الأتمتة الأحدث لديها تكاملات جاهزة أكثر بكثير. يعتمد Huginn أيضاً على مكدس Ruby on Rails، لذا قد يتطلب استكشاف الأخطاء العميقة إلماماً بـ Ruby لا تتطلبه البدائل المبنية على Node.js. إذا كنت تحتاج فقط مراقبة موقع واحد للتغييرات، فأداة مخصصة مثل changedetection.io أبسط بكثير للنشر والصيانة من تشغيل نسخة Huginn كاملة.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
هل Huginn مجاني للاستخدام؟
نعم. Huginn مجاني تماماً ومفتوح المصدر برخصة MIT. لا يوجد حد لعدد العملاء أو السيناريوهات أو عمليات التشغيل، ولا يُطلب اشتراك لأي ميزة.
ما بيانات الدخول الافتراضية لـ Huginn؟
الحساب الافتراضي هو اسم المستخدم admin وكلمة المرور password. سجّل الدخول مرة وغيّر كلمة المرور فوراً من إعدادات حسابك — هذه البيانات معروفة للعامة ويجب ألا تُترك كما هي أبداً.
كيف يختلف Huginn عن IFTTT أو Zapier؟
يؤدي Huginn نفس المهمة — ربط المشغّلات بالإجراءات — لكنه يعمل بالكامل على سيرفرك الخاص. لا توجد حدود أتمتة ولا رسوم شهرية، وبيانات اعتمادك وبياناتك المكشوطة لا تغادر بنيتك التحتية أبداً. المقايضة هي أنك تدير الاستضافة والتحديثات بنفسك.
هل يمكن لـ Huginn كشط أي موقع؟
يستطيع Website Agent في Huginn كشط معظم الصفحات العامة باستخدام محددات CSS أو XPath، لكن المواقع ذات العرض الثقيل بـ JavaScript أو حماية مكافحة الكشط قد لا تعمل بشكل موثوق. تأكد دائماً من أن لديك الحق القانوني في كشط موقع معين قبل أتمتته.
هل يدعم Huginn الإشعارات إلى Slack أو البريد أو الرسائل النصية؟
نعم. يتضمن Huginn عملاء مدمجين لإرسال البريد الإلكتروني وwebhooks يمكنها النشر إلى Slack أو Discord أو أي خدمة لديها رابط webhook وارد. الرسائل النصية SMS تتطلب التوجيه عبر خدمة بوابة SMS متوافقة مع webhook لأنه لا يوجد عميل SMS أصلي.
