🛠️ تثبيت Easy!Appointments — نظام حجز مواعيد ذاتي الاستضافة

انشر Easy!Appointments على Ubuntu بـ Docker — نظام حجز مواعيد مفتوح المصدر بصفحة حجز عامة ومزامنة مع Google Calendar، مدعوم بـ MySQL، على المنفذ 8250.

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

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

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

سكريبت تثبيت آلي — أمر واحد ينشر Easy!Appointments مع MySQL على المنفذ 8250. أكمل معالج التثبيت عند أول زيارة لإنشاء حساب المشرف وضبط BASE_URL.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/easyappointments/easyappointments-ubuntu.sh
chmod +x easyappointments-ubuntu.sh
./easyappointments-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/main/tools/easyappointments/easyappointments-ubuntu.sh

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

chmod +x easyappointments-ubuntu.sh

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

./easyappointments-ubuntu.sh

4 إكمال معالج التثبيت

http://your-server-ip:8250

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

المنفذالغرض
8250Easy!Appointments web interface (mapped from container port 80)
3306MySQL — internal to the Docker network, not exposed to the host

نظرة عامة

Easy!Appointments هو نظام حجز مواعيد مجاني ومفتوح المصدر برخصة GPL — بديل ذاتي الاستضافة لـ Calendly أو Cal.com. مبني بلغة PHP وقاعدة بيانات MySQL، ويستخدم مكتبات FullCalendar وjQuery وBootstrap للواجهة. يمنحك صفحة حجز عامة يختار فيها العملاء الخدمة ومقدم الخدمة والموعد المتاح بأنفسهم، مع دعم لخدمات ومقدمي خدمة ومواقع متعددة، وساعات عمل قابلة للتخصيص، وإشعارات بريد إلكتروني، ومزامنة ثنائية الاتجاه مع Google Calendar — كل ذلك يعمل بالكامل على بنيتك التحتية الخاصة.

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

الجاذبية الأساسية لـ Easy!Appointments هي استبدال أدوات جدولة SaaS مدفوعة مثل Calendly بأداة مجانية بالكامل وذاتية الاستضافة تُبقي بيانات حجز العملاء على سيرفرك الخاص. يدعم سير العمل الأساسي الذي تحتاجه معظم الأعمال الصغيرة فعلياً — خدمات متعددة، موظفون متعددون، قواعد ساعات عمل، ومزامنة Google Calendar في كلا الاتجاهين — دون اشتراك شهري أو حد للمقاعد أو سقف استخدام. ولأنه حزمة PHP/MySQL خفيفة واحدة، يعمل بارتياح على VPS صغير جنباً إلى جنب مع أدوات ذاتية الاستضافة أخرى.

متى تحتاجه

  • تدير عملاً خدمياً (صالون، عيادة، استشارات، مركز صيانة) وتريد أن يحجز العملاء مواعيدهم بأنفسهم عبر الإنترنت دون مكالمات هاتفية
  • تريد التخلص من رسوم اشتراك Calendly أو Cal.com الشهرية مقابل تقويم حجز بسيط بموظف واحد أو أكثر
  • تحتاج صفحة حجز عامة تحجب تلقائياً الأوقات المشغولة بالفعل في تقويم Google الخاص بأحد الموظفين
  • تدير عدة مقدمي خدمة أو فروع وتحتاج جدولاً مستقلاً للتوفر والخدمات لكل منهم
  • تريد أن تبقى بيانات المواعيد بالكامل على بنيتك التحتية الخاصة بدلاً من منصة SaaS خارجية
  • تحتاج أداة جدولة خفيفة تعمل بارتياح على VPS صغير دون بنية تحتية معقدة

من يحتاجه

  • أصحاب الأعمال الصغيرة — الصالونات، مراكز التجميل، العيادات، المدرّسون، الاستشاريون — الذين يستقبلون حجوزات بالموعد
  • مقدمو الرعاية الصحية والعافية الذين يحتاجون أن يحجز المرضى زياراتهم بأنفسهم ضمن ساعات عمل محددة
  • المستقلون والاستشاريون الذين يريدون رابط حجز عامة احترافياً بدون اشتراك
  • الأعمال متعددة الفروع التي تحتاج إدارة موظفين وخدمات وجداول منفصلة لكل فرع
  • فرق تقنية المعلومات وهواة الاستضافة الذاتية الذين يستبدلون أدوات جدولة SaaS بأخرى ذاتية الاستضافة
  • المدرّسون والمدرّبون الذين يجدولون جلسات فردية أو جماعية
  • أي فريق يريد أن يبقى Google Calendar المصدر الوحيد الموثوق لتوفر الموظفين

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

  • صفحة حجز عامة لصالون أو مركز تجميل يختار فيها العملاء الخدمة والحلاق والموعد
  • جدولة عيادة أو مركز علاج بساعات عمل ووقت فاصل مخصص لكل مقدم خدمة
  • استشاريون يشاركون رابط حجز شخصي بدلاً من تبادل رسائل بريدية لتحديد موعد
  • أعمال متعددة الموظفين حيث لكل موظف توفر مستقل مُزامن مع تقويم Google الخاص به
  • مراكز الصيانة أو الخدمة التي تحجز مواعيد لتسليم واستلام الأجهزة
  • المدرّسون والمدرّبون الذين يجدولون جلسات فردية متكررة مع الطلاب أو العملاء
  • جدولة داخلية للفريق للعروض التوضيحية أو المقابلات أو الاستشارات دون أداة مدفوعة

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

  • صفحة حجز عامة ذاتية الخدمة — يختار العملاء الخدمة ومقدم الخدمة والموعد المتاح دون إنشاء حساب
  • مزامنة ثنائية الاتجاه مع Google Calendar — تظهر الحجوزات في تقويم مقدم الخدمة، والأحداث الموجودة تحجب التوفر تلقائياً
  • دعم خدمات وموظفين ومواقع متعددة بجداول مستقلة
  • ساعات عمل واستراحات وإجازات قابلة للتخصيص لكل مقدم خدمة
  • إشعارات بريد إلكتروني تلقائية للحجوزات والتذكيرات والإلغاءات لكل من العميل ومقدم الخدمة
  • دعم تعدد اللغات والمناطق الزمنية للأعمال الدولية أو ثنائية اللغة
  • واجهة متجاوبة مبنية على FullCalendar وjQuery وBootstrap تعمل على الجوال والأجهزة اللوحية
  • واجهة برمجية REST لدمج الحجوزات مع أنظمة أخرى أو بناء واجهة أمامية مخصصة

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

  • أكمل معالج التثبيت عند أول تشغيل عبر http://your-server-ip:8250 لإنشاء حساب المشرف
  • اضبط BASE_URL ليطابق عنوان سيرفرك أو نطاقك الفعلي — فهو أساس روابط الحجز ومسار استدعاء Google Calendar
  • أضف خدماتك تحت Services، وحدد المدة والسعر والتوفر لكل خدمة
  • أضف حسابات الموظفين/مقدمي الخدمة تحت Users وخصّص لكل منهم الخدمات التي يقدمها
  • اضبط ساعات عمل كل مقدم خدمة واستراحاته وأيام إجازته من ملفه الشخصي
  • اربط Google Calendar لكل مقدم خدمة من إعدادات ملفه الشخصي لتفعيل المزامنة الثنائية
  • شارك رابط صفحة الحجز العامة مع عملائك أو ضمّنه في موقعك الإلكتروني

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

  • ضع Easy!Appointments خلف وكيل عكسي مع HTTPS — صفحة الحجز تجمع أسماء وبريد وهواتف العملاء التي يجب ألا تنتقل دون تشفير
  • اضبط BASE_URL بشكل صحيح ليطابق نطاق HTTPS الخاص بك، لأن عنوان URL غير المطابق قد يُعطل استدعاء Google OAuth ويسبب مشكلات إعادة توجيه
  • استخدم كلمة مرور قوية وفريدة لحساب المشرف المُنشأ أثناء معالج الإعداد
  • أبقِ حاوية MySQL على شبكة Docker الداخلية فقط — لا تنشر المنفذ 3306 للمضيف أو الإنترنت أبداً
  • حدّث صورة Docker بانتظام لتحصل على تصحيحات الأمان من المشروع الأساسي
  • قيّد الوصول للوحة المشرف على عناوين IP موثوقة أو VPN إذا كانت صفحة الحجز فقط هي الجزء الذي يحتاج أن يكون عاماً
  • راجع أذونات OAuth المرتبطة بـ Google Calendar دورياً وألغِ الوصول للموظفين الذين غادروا

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

يربط سكريبت التثبيت المنفذ 8250 على المضيف بالمنفذ الداخلي 80 للحاوية، والذي يخدم صفحة الحجز العامة ولوحة المشرف معاً عبر http://your-server-ip:8250. يعمل MySQL على المنفذ 3306 لكن داخل شبكة Docker الداخلية فقط — لا يُنشر أبداً على المضيف، فلا يمكن الوصول إليه من خارج شبكة Docker بالتصميم. بما أن صفحة الحجز تجمع بيانات شخصية للعملاء ولوحة المشرف تتحكم في جدولة عملك بالكامل، لا تكشف المنفذ 8250 مباشرة للإنترنت أبداً بدون HTTPS. ضع Nginx Proxy Manager أو وكيلاً عكسياً مشابهاً أمامه على المنفذ 443 بشهادة صالحة، واضبط BASE_URL ليطابق نطاق HTTPS ذاك حتى تستمر روابط الحجز ومزامنة Google Calendar بالعمل بشكل صحيح.

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

  • انسخ قاعدة بيانات MySQL احتياطياً بانتظام — تحتوي كل خدمة وحساب موظف وقاعدة ساعات عمل وسجل مواعيد
  • انسخ ملف .env أو ملف الإعدادات الذي يحتوي BASE_URL وبيانات اعتماد Google OAuth احتياطياً حتى لا تحتاج إعادة إعداد التكاملات بعد الاستعادة
  • صدّر نسخة من قاعدة البيانات قبل كل تحديث تحسباً لفشل الترحيل أو حدوث تغييرات غير متوقعة في البنية
  • خزّن النسخ الاحتياطية بعيداً عن المضيف الذي تعمل عليه الحاويات الفعلية، ويُفضّل بنفس جدولة خدماتك ذاتية الاستضافة الأخرى
  • اختبر عملية الاستعادة على نسخة تجريبية حتى تتأكد أن المواعيد وروابط Google Calendar تنجو من عملية الاستعادة
  • وثّق خطوات إعداد Google Calendar OAuth بشكل منفصل، لأن إعادة ربط التقاويم بعد إعادة بناء كاملة تتطلب إعادة تفويض كل مقدم خدمة

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

  • ترك BASE_URL على القيمة الافتراضية أو عنوان IP داخلي بعد نقل التطبيق خلف نطاق أو وكيل عكسي، مما يُعطل روابط الحجز ومزامنة التقويم
  • كشف المنفذ 8250 مباشرة للإنترنت بدون HTTPS، مما يرسل بيانات حجز العملاء بنص عادي
  • نسيان ضبط ساعات العمل لكل مقدم خدمة، مما يجعل الحجوزات تظهر متاحة في أوقات لا يعمل فيها أحد فعلياً
  • عدم ربط Google Calendar لكل موظف، مما يسبب حجوزات مزدوجة لأن الأحداث الموجودة لا تحجب التوفر
  • نشر منفذ MySQL على المضيف دون داعٍ، مما يوسّع سطح الهجوم دون أي فائدة وظيفية
  • تخطي النسخ الاحتياطي المنتظم لقاعدة البيانات، مما يخاطر بفقدان كامل سجل المواعيد والعملاء
  • افتراض أن إشعارات البريد الإلكتروني تعمل تلقائياً دون ضبط مُرحّل SMTP، فلا يستلم العملاء أي تأكيد أبداً

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

  • فشل روابط الحجز أو استدعاء Google Calendar — تحقق أن BASE_URL يطابق تماماً النطاق الذي يستخدمه العملاء فعلياً، بما في ذلك http مقابل https
  • البريد الإلكتروني لا يُرسَل — اضبط مُرحّل SMTP فعّالاً في الإعدادات، فالإعداد الافتراضي لا يتضمن واحداً
  • Google Calendar لا يُزامن — أعد ربط التقويم من الملف الشخصي لمقدم الخدمة وتأكد أن إذن OAuth لم يُلغَ
  • تعذر الوصول للمثبّت أو لوحة المشرف — تحقق عبر docker ps أن الحاوية تعمل وأن المنفذ 8250 غير محظور بالجدار الناري
  • ظهور حجوزات مزدوجة — تأكد من ضبط ساعات عمل مقدم الخدمة وأن أي أحداث Google Calendar مرتبطة مضبوطة بشكل صحيح
  • أخطاء اتصال بقاعدة البيانات بعد إعادة التشغيل — تحقق أن حاوية MySQL سليمة وأن بيانات اعتماد قاعدة البيانات في التطبيق تطابق ما تولّد أثناء الإعداد
  • صفحة الحجز لا تُظهر أي مواعيد متاحة — تحقق أن الخدمة مرتبطة بمقدم خدمة وأن لهذا المقدم ساعات عمل محددة لذلك اليوم

البدائل

Cal.com منصة أحدث ومصقولة وتحت تطوير نشط بجدولة فرق وتكاملات أغنى وخيار استضافة سحابية — غالباً الخيار الأقوى إذا أردت الأداة الأكثر قدرة ولا تمانع حزمة Node.js أثقل. Calendly هو الخيار التجاري السائد بأنعم تجربة مستخدم، لكنه يفرض رسوماً لكل مقعد ويُبقي بيانات حجزك على سيرفراته. Rallly يركّز على التصويت الجماعي وإيجاد وقت مشترك بدلاً من حجز مواعيد قائمة على الخدمة، فهو يحل مشكلة مختلفة. كل من Cal.com وEasy!Appointments قابلان للاستضافة الذاتية، لكن حزمة Easy!Appointments الأبسط من PHP/MySQL أخف في التشغيل وأسهل في الصيانة إذا لم تكن تحتاج ميزات جدولة الفرق والتكاملات المتقدمة في Cal.com.

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

إذا احتجت جدولة فرق متقدمة أو توزيعاً دورياً (round-robin) أو منظومة تكاملات واسعة (Zoom، Stripe، Zapier، وعشرات غيرها)، فإن Cal.com هو الخيار ذاتي الاستضافة الأكثر قدرة حتى لو كانت حزمته أثقل. إذا كنت تحتاج فقط إيجاد وقت اجتماع مشترك بين عدة أشخاص بدلاً من حجز موعد خدمة، فإن Rallly أو أداة تصويت بسيطة أنسب. وإذا لم تكن مرتاحاً لصيانة تطبيق PHP/MySQL ذاتي الاستضافة — تطبيق التحديثات، إدارة النسخ الاحتياطي، إصلاح مشكلات SMTP — وتفضّل الدفع مقابل وقت تشغيل ودعم مضمونين، فإن خدمة Calendly السحابية تُزيل هذا العبء التشغيلي بالكامل.

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

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

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

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

ما هو Easy!Appointments؟

Easy!Appointments هو نظام حجز مواعيد مفتوح المصدر — بديل ذاتي الاستضافة لـ Calendly. يمنحك صفحة حجز عامة يختار فيها العملاء الخدمة ومقدم الخدمة والموعد المتاح بأنفسهم.

ما المنفذ الذي يستخدمه وكيف أُعدّه؟

يعمل Easy!Appointments على المنفذ 8250 على المضيف، المُربوط بالمنفذ 80 للحاوية. عند أول زيارة، تُكمل معالج تثبيت يُنشئ حساب المشرف ويُنهي الإعداد. افتح http://your-server:8250 واتبع المعالج.

هل يُزامن مع Google Calendar؟

نعم، بطريقتين. تظهر المواعيد المحجوزة عبر Easy!Appointments في تقويم Google الخاص بمقدم الخدمة، والأحداث الموجودة مسبقاً في ذلك التقويم تحجب التوفر حتى لا يحجز العملاء فوقها.

لماذا لا تعمل روابط الحجز أو المزامنة؟

غالباً لأن BASE_URL مضبوط بشكل خاطئ. يُضبط على عنوان سيرفرك ويُشكّل أساس روابط الحجز العامة التي تشاركها ومسار استدعاء Google Calendar. إذا نقلت التطبيق خلف نطاق أو وكيل عكسي، حدّث BASE_URL ليطابقه، وإلا قد تتعطل الروابط ومزامنة التقويم.

كيف يُقارَن بـ Cal.com؟

Cal.com منصة أحدث ومصقولة وتحت تطوير نشط بجدولة فرق وتكاملات أغنى — غالباً الخيار الأقوى إذا أردت الأداة الأكثر قدرة ولا تمانع حزمة أثقل.