🍃 تثبيت Peppermint — نظام إدارة تذاكر الدعم الفني العصري على Docker
نشر منصة Peppermint على Ubuntu باستخدام Docker — نظام تذاكر وخدمة عملاء مفتوح المصدر أنيق وعصري مبني بـ Node.js وReact مع دعم تنسيقات Markdown وقاعدة بيانات PostgreSQL.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Support/peppermint/peppermint-ubuntu.sh
chmod +x peppermint-ubuntu.sh
sudo bash peppermint-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/Support/peppermint/peppermint-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x peppermint-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلدات التخزين لقاعدة البيانات والملفات (`./postgres` و`./data`) وتشغيل حاوية تطبيق Peppermint وقاعدة بيانات PostgreSQL على المنفذ 3000.
sudo bash peppermint-ubuntu.sh
4 إتمام معالج الإعداد
افتح متصفحك وانتقل إلى الرابط http://ip-سيرفرك:3000/signup. اتبع معالج الإعداد لإنشاء حساب المشرف الأول وضبط إعدادات مكتب الدعم الفني.
http://<your-server-ip>:3000
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3000 | Peppermint Web UI (HTTP) |
| 5432 | PostgreSQL database (internal) |
نظرة عامة
تعد Peppermint منصة إدارة تذاكر وخدمة عملاء عصرية ومفتوحة المصدر مبنية بتقنيات Node.js وReact وقاعدة بيانات PostgreSQL. تعمل المنصة على المنفذ 3000، وتقدم واجهة عمل أنيقة وسريعة لإدارة طلبات الدعم الفني الداخلي (IT Support) واستفسارات العملاء الخارجية. وتوفر المنصة عرض التذاكر بأسلوب كانبان (Kanban) أو القوائم، وتنسيقات Markdown الغنية، والوسوم، وتحديد الأولويات، وتوزيع المهام على فريق الدعم، ومتابعة التواصل مع العملاء.
لماذا تستخدمه
تفرض حلول الدعم الفني التجارية (مثل Zendesk أو Jira Service Management أو Freshdesk) اشتراكات شهرية باهظة لكل موظف دعم، وتتسم بتعقيد الواجهات، وتخزن بيانات واستفسارات عملائك على خوادم خارجية. تمنحك الاستضافة الذاتية لـ Peppermint تجربة دعم فني حديثة وسريعة مع عدد غير محدود من موظفي الدعم بدون أي تكاليف تراخيص، مع السيادة الكاملة على قاعدة بياناتك وواجهة تفاعلية أحادية الصفحة (SPA).
متى تحتاجه
- تحتاج أنت وفريقك إلى نظام تذاكر ودعم فني حديث ونظيف دون دفع اشتراكات شهرية لكل موظف
- تبحث عن بديل عصري مفتوح المصدر لأنظمة التذاكر القديمة المبنية بـ PHP (مثل osTicket) يعتمد على React
- تدير طلبات الدعم الفني لتقنية المعلومات الداخلية (صيانة الأجهزة، طلبات البرامج، مشاكل الشبكة) لموظفي الشركة
- تريد تنظيم تذاكر الدعم باستخدام أعمدة كانبان المرئية والوسوم المخصصة ومستويات الأولوية
- تلتزم بحفظ سرية وخصوصية استفسارات العملاء الحساسة وتخزينها محلياً على سيرفرك الخاص
حالات الاستخدام الشائعة
- إدارة تذاكر تهيئة الموظفين الجدد (تجهيز اللابتوب، حسابات البريد، ومفاتيح VPN)
- تنظيم بلاغات أخطاء المشاريع البرمجية مع أكواد البرمجة وصور الشاشة ومستويات الأهمية
- توزيع تذاكر الدعم الواردة على المتخصصين في الفريق مع إرسال إشعارات بريد تلقائية
- التشاور الداخلي بين الموظفين داخل التذكرة عبر الملاحظات الخاصة دون أن يراها العميل
- مراجعة إحصائيات الدعم الأسبوعية: سرعة إغلاق التذاكر، عدد التذاكر المفتوحة، وتوزيع أعباء العمل
الميزات الرئيسية
- واجهة مستخدم عصرية وسريعة مبنية بـ React وTailwind CSS تدعم الوضعين الداكن والفاتح
- طرق عرض مرنة: التبديل السلس بين لوحة كانبان (Kanban) المرئية وجداول القوائم القابلة للبحث
- دعم كامل لتنسيقات Markdown في وصف التذاكر والردود مع تلوين الأكواد وإرفاق الصور
- نظام صلاحيات متكامل (RBAC): فصل صلاحيات المشرفين وموظفي الدعم والعملاء/المشاهدين
- وسوم مخصصة للتذاكر، ومستويات أولوية واضحة (منخفض، متوسط، مرتفع، حرج)، ومراحل معالجة مخصصة
- تكامل مع خوادم البريد الإلكتروني (SMTP) لتنبيه الموظفين والعملاء فور إنشاء أو تحديث التذاكر
- قاعدة بيانات PostgreSQL عالية الأداء لضمان حفظ سجلات وتاريخ التذاكر بشكل موثوق
- معمارية Docker Compose تجمع Peppermint مع PostgreSQL ومجلدات التخزين الدائم للبيانات
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:3000/signup لإنشاء حساب المشرف الأساسي
- سجل الدخول وانتقل إلى Settings ← General لضبط اسم مكتب الدعم وشعار النظام
- انتقل إلى Settings ← Email لضبط إعدادات خادم البريد SMTP لإرسال تنبيهات التذاكر
- أنشئ حسابات لأعضاء الفريق من قسم Settings ← Users وحدد أدوارهم (مشرف أو موظف دعم)
- أنشئ تذكرتك الأولى لاختبار لوحة كانبان ومستويات الأولوية وتنسيقات Markdown
- ضع Peppermint خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL لتأمين بيئة الإنتاج
- أعد سكريبت نسخ احتياطي دوري لقاعدة بيانات PostgreSQL في المجلد `./postgres`
أفضل ممارسات الأمان
- أنشئ حساب المشرف الأساسي فور تشغيل الحاوية لمنع أي طرف غريب من أخذ ملكية النظام
- استخدم تشفير HTTPS دائماً عبر وكيل عكسي لحماية بيانات العملاء وكلمات مرور الموظفين أثناء النقل
- أبقِ منفذ قاعدة البيانات PostgreSQL 5432 معزولاً داخل شبكة Docker ولا تكشفه للإنترنت العام
- اضبط مفتاح سري معقد (`SECRET` / `JWT_SECRET`) في متغيرات البيئة لتشفير رموز الجلسات
- افرض استخدام كلمات مرور معقدة لكافة حسابات موظفي الدعم الفني
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار
المنافذ وإعدادات جدار الحماية
يقدم تطبيق Peppermint واجهته عبر منفذ TCP 3000 (أو 3050 حسب التكوين). في الإنتاج، قم بتهيئة وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 3000، مع إبقاء المنفذ 3000 مغلقاً في جدار الحماية الخارجي وفتح المنفذين القياسيين 80 و443 لاستقبال الزوار.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./postgres` احتياطياً، والذي يحتوي على قاعدة بيانات PostgreSQL بكافة التذاكر والمستخدمين والملاحظات
- انسخ مجلد `./data` لحفظ المرفقات وإعدادات التطبيق
- استخرج نسخة احتياطية دورية لقاعدة البيانات عبر pg_dump: `docker exec peppermint-postgres pg_dump -U peppermint peppermint > peppermint_backup.sql`
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
- اختبر الاستعادة باسترجاع نسخة البيانات داخل حاوية تجريبية للتأكد من ظهور كافة التذاكر بنجاح
الأخطاء الشائعة
- ترك المفتاح السري `JWT_SECRET` الافتراضي دون تغييره في الإنتاج، مما يعرض الجلسات للتلاعب
- كشف منفذ قاعدة البيانات PostgreSQL 5432 للإنترنت العام مباشرة
- عدم ربط مجلدات التخزين الدائم `./postgres` و`./data`، مما يسبب فقدان التذاكر بالكامل عند تحديث الحاوية
- نسيان ضبط إعدادات خادم البريد SMTP، مما يحرم الموظفين من معرفة التذاكر الجديدة الواردة
- التشغيل في بيئة الإنتاج عبر HTTP غير المشفر بدون شهادة SSL
استكشاف الأخطاء وإصلاحها
- فشل الاتصال بقاعدة البيانات عند بدء التشغيل — تأكد من عمل حاوية PostgreSQL (`docker ps`) وصحة بيانات الاتصال
- صفحة التسجيل تظهر خطأ — تأكد من تفعيل التسجيل واكتمال تهيئة جداول قاعدة البيانات
- رسائل البريد لا تُرسل عند إنشاء التذاكر — اختبر إعدادات SMTP في Settings ← Email وتأكد من فتح المنفذ 587/465
- ظهور خطأ HTTP 500 في الواجهة — افحص سجلات الحاوية بالأمر: `docker logs peppermint -f`
- نسيان كلمة مرور المشرف — حدث سجل المشرف في جدول `users` داخل قاعدة بيانات PostgreSQL عبر سطر الأوامر
البدائل
منصة osTicket نظام تذاكر كلاسيكي مجرب مبني بـ PHP. منصة Zammad نظام دعم فني شامل يدعم المحادثة الحية والهاتف. منصة FreeScout نظام تذاكر خفيف بـ Laravel. منصة Chatwoot لإدارة المحادثات وخدمة العملاء. حزم Zendesk وFreshdesk حلول سحابية تجارية.
متى لا تستخدمه
تجنب استخدام Peppermint إذا كنت تحتاج لنظام خدمة عملاء شامل متعدد القنوات (محادثة حية بالموقع، اتصالات هاتفية VoIP، وتكامل مع واتساب وفيسبوك في صندوق واحد) — حيث تعد Zammad أو Chatwoot مخصصة للتواصل متعدد القنوات. وإذا كنت تحتاج لقواعد تصعيد وتوجيه معقدة للغاية حسب الأقسام، فإن osTicket أو Zammad أكثر نضجاً.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي قاعدة البيانات التي يعتمد عليها Peppermint؟
يعتمد Peppermint على قاعدة بيانات PostgreSQL كقاعدة بيانات علائقية أساسية لتخزين كافة التذاكر وحسابات المستخدمين والوسوم وسجلات التدقيق.
هل يمكن لـ Peppermint إرسال إشعارات البريد الإلكتروني؟
نعم، يتكامل Peppermint مع أي خادم SMTP قياسي (مثل Postfix أو Sendgrid أو Mailgun أو Google Workspace) لإرسال تنبيهات آلية عند إنشاء التذاكر أو تحديث حالتها.
هل يدعم Peppermint تنسيقات نصوص Markdown؟
نعم! يوفر Peppermint دعماً كاملاً لـ Markdown في وصف التذاكر وسلاسل الردود، بما في ذلك تلوين الأكواد والقوائم والجداول وإرفاق الصور.
هل يمكن تعيين التذاكر لموظفين محددين؟
نعم، يمكن إسناد أي تذكرة لموظف دعم محدد في الفريق أو تركها في الطابور العام ليقوم أي موظف متاح باستلامها.
كم يستهلك Peppermint من الذاكرة العشوائية (RAM)؟
تستهلك حاوية Peppermint مع قاعدة بيانات PostgreSQL حوالي 150 إلى 250 ميجابايت فقط من الذاكرة العشوائية مجتمعة، مما يجعلها خفيفة جداً ومناسبة للسيرفرات الاقتصادية.
