🎫 تثبيت FreeScout — مكتب مساعدة ذاتي الاستضافة وصندوق وارد مشترك

انشر FreeScout على Ubuntu بـ Docker — بديل مجاني وذاتي الاستضافة لـ Help Scout بصندوق وارد مشترك وتذاكر دعم عبر البريد ودعم متعدد الوكلاء دون رسوم لكل وكيل.

⚠️ راجع أي سكريبت دائمًا قبل تشغيله على سيرفرك، واختبره في بيئة تجريبية أولاً.

📦 الملفات والأكواد المطلوبة

قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.

سكريبت تثبيت آلي — مكتب مساعدة FreeScout جاهز بأمر واحد.
عرض على GitHub

التثبيت السريع:

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Support/freescout/freescout-ubuntu.sh
chmod +x freescout-ubuntu.sh
sudo bash freescout-ubuntu.sh

خطوات التنفيذ

1 تحميل السكريبت

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Support/freescout/freescout-ubuntu.sh

2 منح صلاحية التنفيذ

chmod +x freescout-ubuntu.sh

3 تشغيل المثبّت

يثبّت السكريبت Docker إن لزم، يسحب صورتي FreeScout وMySQL، ويشغّل الحاويتين مع تخزين دائم لقاعدة البيانات والمرفقات. يشغّل المثبّت إعداد FreeScout بلغة PHP تلقائياً عند أول إقلاع.

sudo bash freescout-ubuntu.sh

4 الدخول إلى واجهة الويب

افتح المتصفح وأكمل معالج إعداد FreeScout لربط صندوق بريدك وإنشاء أول حساب مشرف:

http://<your-server-ip>:80

المنافذ المستخدمة

المنفذالغرض
80FreeScout Web UI (HTTP)
3306MySQL database (internal)

نظرة عامة

FreeScout هو تطبيق مكتب مساعدة وصندوق وارد مشترك مجاني ومفتوح المصدر، بُني كبديل ذاتي الاستضافة لـ Help Scout — والاسم إشارة مباشرة لهذا الأصل. مكتوب بلغة PHP على إطار عمل Laravel، يحوّل عنواناً بريدياً واحداً أو أكثر للدعم إلى صندوق وارد جماعي مشترك مع تعيين التذاكر والملاحظات الداخلية والردود المحفوظة وقواعد الأتمتة، دون رسوم ترخيص لكل وكيل. التطبيق الأساسي، بصناديق بريد ووكلاء وتذاكر غير محدودة، مجاني بالكامل؛ وتوفر سوق إضافات رسمية إضافات مدفوعة اختيارية (سير عمل، قاعدة معرفة للعملاء، بوابة عملاء، والمزيد) للفرق التي تحتاج وظائف إضافية تتجاوز النواة المجانية.

لماذا تستخدمه

تفرض مكاتب المساعدة التجارية مثل Help Scout وZendesk وFreshdesk رسوماً متكررة شهرياً لكل وكيل، وهو ما يتراكم بسرعة لفرق الدعم النامية. يمنحك FreeScout نفس سير عمل صندوق الوارد المشترك الأساسي — صندوق واحد، وكلاء متعددون، ملكية تذاكر، ردود جاهزة، وأتمتة — بالكامل ذاتي الاستضافة دون تكلفة لكل مقعد ودون حدود للتذاكر. ولأنه PHP وMySQL بسيطان، يعمل بارتياح على استضافة متواضعة وغير مكلفة، ولأن الكود والإضافات الاختيارية مفتوحة، يمكنك توسيع أو تخصيص المنصة لتطابق سير عمل الدعم الخاص بك بدقة.

متى تحتاجه

  • فريق دعمك تجاوز صندوق بريد مشترك بسيط ويحتاج ملكية تذاكر وملاحظات داخلية وأتمتة
  • تريد تجربة صندوق وارد مشترك بأسلوب Help Scout دون دفع اشتراك متكرر لكل وكيل
  • تحتاج وكلاء وصناديق بريد غير محدودة دون الاصطدام بحدود مقاعد اصطناعية في خطة SaaS مجانية
  • تتطلب مؤسستك بقاء بيانات دعم العملاء ضمن بنية تحتية تتحكم بها لأسباب امتثال
  • تريد توسيع مكتب المساعدة بإضافات PHP مخصصة تناسب سير عمل الدعم الخاص بك تحديداً

حالات الاستخدام الشائعة

  • توجيه رسائل support@ وsales@ إلى صناديق بريد مشتركة منفصلة تتعامل معها فرق وكلاء مختلفة
  • تعيين التذاكر الواردة تلقائياً لوكلاء محددين بناءً على قواعد كلمات مفتاحية أو المرسل
  • استخدام الردود المحفوظة والجاهزة للإجابة على الأسئلة الشائعة بشكل متسق وسريع
  • إضافة ملاحظات داخلية على تذكرة مرئية للوكلاء فقط، دون أن يرى العميل النقاش الداخلي
  • تتبع أوقات استجابة اتفاقيات مستوى الخدمة وإنشاء تقارير عن حجم التذاكر وأداء الوكلاء
  • دمج الدردشة المباشرة أو WhatsApp أو Telegram كقنوات إضافية تغذّي نفس صندوق الوارد المشترك

الميزات الرئيسية

  • صناديق بريد ووكلاء وتذاكر غير محدودة في التطبيق الأساسي المجاني، دون تسعير لكل مقعد
  • تعيين التذاكر وتتبع الحالة والوسوم والملاحظات الداخلية للتعاون الجماعي على كل محادثة
  • ردود محفوظة وقوالب رد للإجابة على الأسئلة المتكررة بشكل متسق
  • سير عمل وقواعد آلية لتعيين أو وسم أو الرد على التذاكر بناءً على شروط (متاحة كإضافة مدفوعة للأتمتة المتقدمة)
  • REST API وwebhooks لدمج FreeScout مع أدوات خارجية وسير عمل مخصص
  • تطبيقات موبايل أصلية لـ iOS وAndroid لإدارة التذاكر أثناء التنقل
  • واجهة متعددة اللغات تدعم أكثر من 25 لغة جاهزة
  • إضافات اختيارية لقاعدة معرفة للعملاء وأداة دردشة مباشرة وبوابة خدمة ذاتية للعملاء

كيفية الاستخدام بعد التثبيت

  • أكمل معالج الإعداد وأنشئ حساب المشرف بكلمة مرور قوية
  • اربط حساب بريد الدعم الخاص بك (IMAP/SMTP) أو عنوان صندوق بريد مخصص لاستقبال وإرسال التذاكر
  • ادعُ وكلاء الدعم وعيّنهم لصناديق البريد ومستويات الصلاحيات المناسبة
  • أنشئ ردوداً محفوظة لأسئلة الدعم الأكثر شيوعاً لتسريع وقت استجابة الوكلاء
  • أعدّ قواعد أتمتة أساسية لتعيين أو وسم التذاكر الواردة تلقائياً بناءً على المرسل أو كلمات مفتاحية
  • اضبط إعدادات SMTP الصادرة لضمان وصول الردود بشكل موثوق دون الوقوع في مجلد البريد المزعج
  • ثبّت أي إضافات لازمة من سوق إضافات FreeScout الرسمية لتوسيع الوظائف
  • أعدّ مهمة cron لمهام FreeScout المجدولة، وهي ضرورية لجلب البريد والأتمتة لتعمل بشكل صحيح

أفضل ممارسات الأمان

  • ضع FreeScout خلف وكيل عكسي مع HTTPS — يجب ألا تنتقل محتويات التذاكر وبيانات العملاء عبر HTTP عادي أبداً
  • لا تكشف منفذ MySQL (3306) للعامة أبداً — أبقِ قاعدة البيانات متاحة فقط لحاوية FreeScout
  • استخدم كلمات مرور مخصصة للتطبيقات أو OAuth لربط صناديق Gmail أو Microsoft 365 بدلاً من كلمة مرور حسابك الرئيسي
  • فرض كلمات مرور قوية وفريدة لجميع حسابات الوكلاء، خاصة تلك بصلاحيات المشرف
  • قيّد إجراءات مستوى المشرف (إدارة المستخدمين، تثبيت الإضافات) على عدد قليل من الحسابات الموثوقة
  • حافظ على تحديث FreeScout واعتمادياته بلغة PHP — تصدر تصحيحات أمنية لتطبيقات Laravel بانتظام
  • ثبّت الإضافات فقط من سوق FreeScout الرسمية أو مصادر موثوقة، لأن الإضافات تعمل كود PHP بوصول كامل للتطبيق
  • راجع صناديق البريد ومفاتيح API المتصلة دورياً وألغِ أي منها لم يعد قيد الاستخدام الفعلي

المنافذ وإعدادات جدار الحماية

يُقدَّم FreeScout عبر HTTP على المنفذ 80 بواسطة سيرفر الويب المدمج، مع استماع MySQL داخلياً على المنفذ 3306 لحاوية التطبيق فقط. يجب أن يكون المنفذ 80 خلف وكيل عكسي مثل Nginx Proxy Manager ينهي HTTPS على المنفذ 443 ويحوّل الحركة داخلياً — يجب ألا تُرسَل بيانات دعم العملاء وبيانات تسجيل الدخول عبر HTTP غير مشفر أبداً. يجب ألا يُكشف المنفذ 3306 للإنترنت العام أبداً؛ أبقه متاحاً فقط ضمن شبكة Docker بين حاويتي FreeScout وMySQL. إذا كان FreeScout يستطلع أيضاً صناديق بريد خارجية عبر IMAP، تأكد أن الاتصالات الصادرة على منافذ IMAP/SMTP الخاصة بمزود البريد مسموح بها عبر الجدار الناري.

النسخ الاحتياطي والصيانة

  • انسخ قاعدة بيانات MySQL احتياطياً بانتظام — تخزّن كل تذكرة ومحادثة وسجل عميل وحساب وكيل
  • انسخ دليل storage/attachments احتياطياً، الذي يحتفظ بالمرفقات المرفوعة على التذاكر
  • انسخ ملف الإعداد .env احتياطياً الذي يحتوي مفتاح التطبيق وبيانات اعتماد البريد وقاعدة البيانات
  • جدول نسخاً احتياطية يومية آلية لقاعدة البيانات بـ mysqldump وخزّنها خارج سيرفر التطبيق
  • خذ لقطة لكل من قاعدة البيانات وتخزين الملفات معاً قبل ترقيات إصدار FreeScout الرئيسية
  • اختبر عملية استعادة النسخ الاحتياطي دورياً للتأكد من عودة التذاكر والمرفقات سليمة

الأخطاء الشائعة

  • كشف منفذ MySQL مباشرة للإنترنت بدلاً من إبقائه على شبكة Docker الداخلية
  • تشغيل FreeScout دون HTTPS، ما يعرّض محادثات دعم العملاء وبيانات تسجيل الدخول كنص عادي
  • نسيان إعداد مهمة cron المطلوبة، ما يوقف جلب البريد والأتمتة المجدولة بصمت
  • استخدام كلمة مرور حساب بريدك الشخصي مباشرة بدلاً من كلمة مرور مخصصة للتطبيق أو اتصال OAuth
  • تثبيت إضافات طرف ثالث غير موثوقة تحصل على وصول كامل بمستوى PHP للتطبيق وقاعدة البيانات
  • عدم نسخ دليل storage/attachments احتياطياً مع قاعدة البيانات، ما يفقد المرفقات بعد الاستعادة
  • تخطي اختبار إعداد SMTP، ما ينتج عنه فشل صامت في تسليم الردود الصادرة أو وقوعها في البريد المزعج
  • منح صلاحية المشرف لكل وكيل بدلاً من استخدام مستويات الصلاحيات القائمة على الأدوار في FreeScout

استكشاف الأخطاء وإصلاحها

  • البريد لا يُجلب كتذاكر — تحقق أن مهمة cron تعمل وراجع إعدادات اتصال IMAP لصندوق البريد لأخطاء
  • الردود الصادرة لا تُسلَّم — اختبر إعداد SMTP وتحقق ما إذا كان نطاق الإرسال يملك سجلات SPF/DKIM صحيحة
  • صفحة تسجيل الدخول غير متاحة بعد إعداد الوكيل العكسي — تأكد أن APP_URL في ملف .env يطابق نطاق HTTPS الخارجي
  • المرفقات مفقودة بعد الاستعادة — تحقق أن دليل storage استُعيد مع قاعدة البيانات، وليس قاعدة البيانات وحدها
  • قائمة تذاكر بطيئة مع حجوم كبيرة — راجع فهرسة MySQL وفكّر في أرشفة التذاكر المغلقة القديمة جداً
  • فشل تثبيت الإضافة — تأكد أن حدود ذاكرة PHP وصلاحيات الملفات في دليل الإضافات تطابق متطلبات الإضافة
  • تذاكر مكررة تُنشأ من نفس مسار البريد — تحقق أن معالجة reply-to وmessage-ID لصندوق البريد مضبوطة بشكل صحيح
  • شاشة بيضاء أو خطأ 500 بعد تحديث — راجع سجلات Laravel في storage/logs وامسح ذاكرة التخزين المؤقت للتطبيق

البدائل

Help Scout هي الخدمة المستضافة والمصقولة التي استوحى منها FreeScout مباشرة — تقدم واجهة أكثر رونقاً وبنية تحتية مُدارة لكنها تفرض رسوماً متكررة لكل مستخدم دون خيار استضافة ذاتية. Zendesk وFreshdesk منصتان مؤسساتيتان أكبر بأتمتة وتقارير مدمجة أكثر بكثير، بتكلفة أعلى ومتكررة بالمقابل. Chatwoot بديل حديث ذاتي الاستضافة يميل أكثر نحو الدردشة المباشرة والمراسلة متعددة القنوات (WhatsApp، Instagram، أدوات الموقع) بجانب البريد. Zammad نظام تذاكر ذاتي الاستضافة وغني بالميزات بأتمتة مدمجة أكثر من نواة FreeScout المجانية، لكن باستهلاك موارد أثقل وإعداد أصعب. كمكتب مساعدة بريدي خفيف ومجاني فعلياً بوكلاء غير محدودين يعكس سير عمل صندوق الوارد المشترك الكلاسيكي لـ Help Scout، FreeScout هو الخيار الواضح.

متى لا تستخدمه

إذا كان سير عمل دعمك يعتمد بشكل كبير على الدردشة المباشرة والمراسلة متعددة القنوات (WhatsApp، رسائل Instagram المباشرة، أدوات دردشة الموقع) كقناة أساسية بدلاً من البريد، فإن أداة مثل Chatwoot أنسب فوراً. إذا كنت تحتاج أتمتة مدمجة متقدمة وتقارير اتفاقيات مستوى خدمة وتكاملات مؤسساتية دون تثبيت إضافات مدفوعة، فقد توفر منصة أثقل مثل Zammad أو خدمة مستضافة مثل Zendesk وقت الإعداد رغم التكلفة الأعلى. تجنّب الاستضافة الذاتية لـ FreeScout إذا لم يكن لدى فريقك من يرتاح لصيانة تطبيق PHP/MySQL على المدى الطويل، لأنك مسؤول بنفسك عن التحديثات والنسخ الاحتياطي وأمان السيرفر.

هل تحتاج مساعدة احترافية؟

توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.

  • التثبيت وتجهيز السيرفر
  • الإعداد المتقدم وإعداد التوجيه
  • تصليب الأمان وتحسين جدار الحماية
  • إعداد شهادات SSL/TLS مع Let's Encrypt
  • ربط النطاق المخصص والوكيل العكسي
  • جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
  • المراقبة الفورية وتنبيهات الجاهزية
  • الترحيل من المنصات القائمة
  • استكشاف مشكلات الاتصال والأداء وإصلاحها
  • سكريبتات أتمتة مخصصة وعقود دعم مستمر
تواصل مع PrismaTechWork

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

هل FreeScout مجاني فعلاً؟

نعم. تطبيق FreeScout الأساسي مجاني بالكامل ومفتوح المصدر، بصناديق بريد ووكلاء وتذاكر غير محدودة ودون رسوم لكل مقعد. يولّد FreeScout إيرادات عبر سوق رسمية لإضافات مدفوعة اختيارية (سير عمل، قاعدة معرفة، بوابة عملاء، والمزيد) للفرق التي تريد وظائف إضافية، لكن لا شيء من هذه مطلوب لتشغيل مكتب مساعدة يعمل بالكامل.

كيف يتصل FreeScout ببريد الدعم الخاص بي؟

تربط صندوق بريد باستخدام IMAP القياسي للاستقبال وSMTP للإرسال، إما مباشرة ببيانات اعتماد حساب البريد أو عبر كلمات مرور مخصصة للتطبيقات أو OAuth لمزودين مثل Gmail وMicrosoft 365. يستطلع FreeScout بعدها صندوق البريد وفق جدول عبر مهمة cron مطلوبة ويحوّل الرسائل الواردة إلى تذاكر تلقائياً.

هل يمكن لوكلاء متعددين العمل في نفس صندوق الوارد المشترك في آنٍ واحد؟

نعم، هذا هو الغرض الأساسي من FreeScout. يمكن لوكلاء متعددين مشاهدة التذاكر وتعيينها والرد عليها في نفس صندوق البريد المشترك، مع ملكية التذاكر وملاحظات داخلية مرئية للوكلاء فقط وتتبع الحالة لتجنب رد وكيلين على نفس العميل.

ما قاعدة البيانات التي يتطلبها FreeScout؟

يتطلب FreeScout MySQL (أو قاعدة بيانات متوافقة مع MySQL مثل MariaDB). يشغّل إعداد Docker هذا حاوية MySQL مخصصة بجانب حاوية تطبيق FreeScout لتخزين دائم وبمستوى إنتاجي للتذاكر والإعدادات.

هل إضافات FreeScout المدفوعة ضرورية لاستخدام مكتب المساعدة؟

لا. يتضمن التطبيق الأساسي المجاني بالفعل صناديق بريد ووكلاء وتذاكر غير محدودة، وتعيين تذاكر، وردود محفوظة، وأتمتة أساسية. الإضافات المدفوعة مثل سير العمل المتقدم أو قاعدة المعرفة أو بوابة العملاء هي إضافات اختيارية للفرق التي تريد قدرات إضافية تتجاوز ما توفره النواة المجانية.