📅 تثبيت Cal.com — منصة جدولة وحجز المواعيد ذاتية الاستضافة
انشر Cal.com على Ubuntu بـ Docker وPostgreSQL — البديل مفتوح المصدر لـ Calendly لجدولة المواعيد ذاتياً مع تقويمات الفريق وقواعد التوفر وتكامل Google/Outlook.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/tools/calcom/calcom-ubuntu.sh
chmod +x calcom-ubuntu.sh
sudo bash calcom-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/tools/calcom/calcom-ubuntu.sh
2 منحه صلاحية التنفيذ
chmod +x calcom-ubuntu.sh
3 تشغيل المثبّت
يثبّت السكريبت Docker، وينشر حاويتي PostgreSQL وCal.com، ويولّد NEXTAUTH_SECRET وCALENDSO_ENCRYPTION_KEY عشوائيين، ويشغّل ترحيلات قاعدة بيانات Prisma، ثم يشغّل واجهة الويب على المنفذ 3000.
sudo bash calcom-ubuntu.sh
4 الدخول إلى واجهة الويب
افتح المتصفح وانتقل إلى واجهة Cal.com:
http://<your-server-ip>:3000
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3000 | Cal.com Web UI |
| 5432 | PostgreSQL (internal only) |
نظرة عامة
Cal.com (يُعرف سابقاً باسم Calendso) هو منصة جدولة وحجز مواعيد مفتوحة المصدر — بديل ذاتي الاستضافة لـ Calendly. يتيح للأفراد والفرق تحديد أوقات توفرهم، وإنشاء أنواع أحداث للحجز، ومشاركة رابط حجز حتى يتمكن العملاء أو الزملاء من تحديد موعد دون تبادل رسائل بريدية. يدعم Cal.com المزامنة الثنائية مع Google Calendar وMicrosoft Outlook، وتأكيدات بريد إلكتروني عبر SMTP، وجدولة الفرق بنظام Round-Robin، وتكامل الدفع عبر Stripe للحجوزات المدفوعة، وواجهة برمجة عامة (API). الاستضافة الذاتية تمنحك تحكماً كاملاً في بيانات الحجز وتلغي التسعير بالمقعد.
لماذا تستخدمه
تفرض Calendly رسوماً شهرية لكل مستخدم وتخزّن كل بيانات حجزك على خوادمها. Cal.com مجاني بالكامل للاستضافة الذاتية — شغّل عدداً غير محدود من المستخدمين وصفحات الحجز على سيرفرك الخاص. بالنسبة للوكالات والعيادات والاستشاريين وأي فريق يحجز مواعيد خارجية، يلغي Cal.com تكاليف الاشتراك مع منحك ملكية كاملة للبيانات. الشيفرة مفتوحة المصدر تعني أنك تستطيع تخصيص تدفقات الحجز والهوية البصرية والتكاملات بما يتجاوز ما تسمح به Calendly.
متى تحتاجه
- تدفع حالياً رسوماً لكل مقعد في Calendly أو أداة مشابهة وتريد إلغاء هذه التكلفة المتكررة عبر استضافة عدد غير محدود من المستخدمين
- تحتاج ملكية كاملة لبيانات الحجز وتفاصيل التواصل مع العملاء بدلاً من تخزينها على خوادم طرف ثالث
- يحتاج فريقك جدولة Round-Robin أو جماعية موزعة على عدة موظفين مثل مندوبي المبيعات أو فريق الدعم
- تريد تضمين أداة حجز بهويتك الكاملة على موقعك دون أي علامة تجارية لطرف ثالث
- تحتاج تشغيل أتمتة داخلية عند إنشاء الحجوزات عبر Webhooks أو الـ API العامة، مثل المزامنة مع نظام CRM
- تتطلب متطلبات الامتثال أو إقامة البيانات ألا تغادر بيانات حجز العملاء البنية التحتية التي تتحكم بها
من يحتاجه
- الوكالات والاستشاريون الذين يحجزون مكالمات مع العملاء ويحتاجون صفحة حجز احترافية بهويتهم الخاصة
- فرق المبيعات والدعم التي تحتاج توزيعاً تلقائياً لطلبات الاجتماعات الواردة على المندوبين المتاحين
- العيادات الصحية والشركات الخدمية التي تحجز مواعيد وتحتاج التحكم في مكان تخزين بيانات المرضى أو العملاء
- شركات SaaS التي تريد تضمين الجدولة مباشرة داخل منتجها أو موقعها التسويقي
- فرق التوظيف والموارد البشرية التي تنسّق جدولة المقابلات بين عدة مُقابِلين
- المستقلون والفرق الصغيرة الذين يريدون تجنّب تسعير Calendly بالمقعد
- المطورون الذين يحتاجون تحكماً برمجياً في الحجوزات عبر API وWebhooks الخاصة بـ Cal.com لتنفيذ تدفقات عمل مخصصة
حالات الاستخدام الشائعة
- استبدال Calendly لحجز الاجتماعات الفردية والجماعية بصفحة ذاتية الاستضافة بهويتك الكاملة
- إعداد جدولة Round-Robin بحيث تُوزَّع العملاء المحتملون الواردون تلقائياً على المندوبين المتاحين
- تضمين أداة حجز مباشرة داخل موقع أو منتج الشركة باستخدام سكريبت تضمين Cal.com
- مزامنة التوفر ثنائياً مع Google Calendar أو Outlook حتى لا يحدث تعارض في الحجوزات أبداً
- أتمتة تأكيدات الحجز والتذكيرات ورسائل المتابعة عبر تدفقات عمل (Workflows) قابلة للتخصيص
- تحصيل الدفع عند الحجز للاستشارات المدفوعة باستخدام تكامل Stripe المدمج
- تنسيق جدولة المقابلات عبر عدة مُقابِلين باستخدام أنواع أحداث جماعية أو Round-Robin
الميزات الرئيسية
- عدد غير محدود من أنواع الأحداث والمستخدمين والحجوزات — الاستضافة الذاتية تلغي تسعير Calendly بالمقعد تماماً
- مزامنة تقويم ثنائية مع Google Calendar وMicrosoft Outlook وApple Calendar وأي مزود CalDAV
- جدولة الفريق بأنواع أحداث Round-Robin وجماعية ومُدارة لتوزيع الاجتماعات على الفريق
- تدفقات عمل (Workflows) لتذكيرات وتأكيدات تلقائية عبر الرسائل النصية والبريد الإلكتروني قبل الحجز وبعده
- تكامل Stripe لتحصيل الدفع عند الحجز للمواعيد المدفوعة
- أداة حجز قابلة للتضمين (React أو HTML أو JS عادي) لإضافة الجدولة مباشرة إلى موقعك
- REST API عامة وWebhooks تُشغّل أتمتة مخصصة عند إنشاء الحجوزات أو إعادة جدولتها أو إلغائها
- نماذج توجيه (Routing Forms) تُوجّه الحاجزين إلى نوع الحدث أو عضو الفريق الصحيح بناءً على إجاباتهم
كيفية الاستخدام بعد التثبيت
- أكمل معالج الإعداد الأولي بإنشاء أول حساب مسؤول وضبط المنطقة الزمنية
- اربط Google Calendar أو Outlook تحت Settings → Calendars حتى تتزامن أوقات التوفر تلقائياً بالاتجاهين
- أنشئ أول نوع حدث لديك، مثل اجتماع 30 دقيقة، وحدد مدته والفاصل الزمني ونطاق التوفر
- اضبط متغيرات بيئة SMTP حتى تصل فعلياً رسائل تأكيد الحجز والتذكيرات
- أنشئ فريقاً تحت Settings → Teams إذا احتاج عدة أشخاص جدولة Round-Robin أو جماعية
- شارك رابط الحجز الخاص بك (yourdomain.com/username/event-type) أو ضمّن الأداة في موقعك
- اضبط تدفقات العمل تحت Workflows لأتمتة رسائل التذكير أو الرسائل النصية قبل كل حجز وبعده
- عيّن NEXT_PUBLIC_WEBAPP_URL على نطاقك العام حتى تستخدم روابط الحجز والرسائل المُولَّدة العنوان الصحيح
أفضل ممارسات الأمان
- استبدل NEXTAUTH_SECRET وCALENDSO_ENCRYPTION_KEY الافتراضيين اللذين ولّدهما سكريبت التثبيت بقيم خاصة بك قبل الانتقال للإنتاج
- ضع Cal.com خلف وكيل عكسي مع HTTPS — صفحات الحجز تجمع أسماء وبريداً إلكترونياً وأحياناً بيانات دفع
- أبقِ PostgreSQL على شبكة Docker الداخلية فقط — لا تكشف المنفذ 5432 للإنترنت العام أبداً
- استخدم بيانات اعتماد OAuth مخصصة لتكاملات تقويم Google وMicrosoft وأعد توليدها فوراً في حال تسريبها
- فعّل المصادقة الثنائية لحسابات المسؤولين تحت إعدادات الأمان
- حدّث صورة Cal.com Docker باستمرار — يصدر تصحيحات أمنية متكررة نظراً لسلسلة اعتماديات Next.js وNode.js
- عطّل التسجيل العام في متغيرات البيئة إذا كنت المؤسسة الوحيدة التي تستخدم هذا النسخة
المنافذ وإعدادات جدار الحماية
تستمع واجهة ويب Cal.com على المنفذ 3000 افتراضياً. يستمع PostgreSQL على المنفذ 5432 لكن يجب أن يبقى داخلياً على شبكة Docker فقط — تصل إليه حاوية Cal.com فقط ولا يحتاج أبداً أن يكون متاحاً من خارج المضيف. لا تكشف المنفذ 3000 مباشرة للإنترنت؛ ضعه خلف وكيل عكسي مثل Nginx Proxy Manager على المنفذ 443 مع شهادة TLS صالحة، لأن صفحات الحجز تنقل أسماء وبريداً إلكترونياً وأحياناً معلومات دفع. في جدار الحماية، اسمح بالمنفذ 3000 فقط من الوكيل العكسي أو الشبكات الداخلية الموثوقة واحظر المنفذ 5432 عن كل حركة المرور الخارجية.
النسخ الاحتياطي والصيانة
- انسخ قاعدة بيانات PostgreSQL احتياطياً بانتظام — تحتوي على كل حجز ومستخدم ونوع حدث ورمز تقويم
- جدول تصدير pg_dump لقاعدة بيانات Cal.com إلى حجم منفصل أو تخزين بعيد
- انسخ ملف البيئة احتياطياً بشكل منفصل — فقدان NEXTAUTH_SECRET أو CALENDSO_ENCRYPTION_KEY يُبطل الجلسات النشطة ورموز التقويم المشفّرة
- خزّن docker-compose.yml مع نسخك الاحتياطية حتى تتمكن من إعادة إنشاء نفس إعدادات الحاويات على مضيف جديد
- اختبر الاستعادة دورياً على نسخة منفصلة للتأكد من عودة الحجوزات والتكاملات وأنواع الأحداث سليمة
- خذ لقطة من قاعدة البيانات قبل الترقيات الكبرى — ترحيلات مخطط Prisma ليست قابلة للتراجع دائماً
الأخطاء الشائعة
- كشف منفذ PostgreSQL 5432 مباشرة للإنترنت بدلاً من إبقائه على شبكة Docker الداخلية
- نسيان ضبط NEXT_PUBLIC_WEBAPP_URL على النطاق العام الحقيقي، فتشير روابط الحجز والرسائل إلى localhost أو IP داخلي
- عدم ضبط SMTP — تنجح الحجوزات لكن رسائل التأكيد والتذكير تفشل في الإرسال بصمت
- إعادة توليد CALENDSO_ENCRYPTION_KEY بعد الإطلاق، مما يكسر رموز OAuth المخزنة للتقويم ويجبر على إعادة ربط كل تكامل تقويم
- تشغيل Cal.com بدون وكيل عكسي وHTTPS في الإنتاج، مما يكشف بيانات الحجز وبيانات تسجيل الدخول بنص عادي
- تخطي النسخ الاحتياطي لقاعدة البيانات — فقدان حجم PostgreSQL يعني فقدان كل حجز ومستخدم واتصال تقويم دون إمكانية استرجاع
- عدم التحقق من مزامنة التقويم بعد ربط Google أو Outlook، مما قد يؤدي لتعارض حجوزات إذا فشلت المزامنة بصمت
استكشاف الأخطاء وإصلاحها
- واجهة الويب لا تُحمَّل — تأكد أن حاويتي Cal.com وPostgreSQL تعملان باستخدام docker ps وراجع السجلات بـ docker logs
- رسائل تأكيد الحجز لا تصل — تحقق من متغيرات بيئة SMTP واختبرها مقابل مُرحِّل SMTP معروف بأنه يعمل
- مزامنة التقويم لا تعمل — أعد ربط التقويم تحت Settings → Calendars وتأكد أن بيانات اعتماد OAuth لـ Google أو Microsoft صالحة وغير منتهية
- أخطاء الجلسة أو NEXTAUTH_SECRET بعد إعادة النشر — تأكد من استخدام نفس قيمة السر باستمرار وعدم إعادة توليدها عند إعادة التشغيل
- أخطاء ترحيل قاعدة البيانات عند بدء التشغيل — تأكد أن حاوية PostgreSQL جاهزة تماماً قبل بدء حاوية التطبيق وأن DATABASE_URL صحيح
- صفحة الحجز تُظهر منطقة زمنية خاطئة — تحقق أن المنطقة الزمنية المضبوطة في ملف المستخدم مطابقة للمتوقع، وتحقق من المنطقة الزمنية المحلية للمتصفح
- بطء تحميل الصفحات — خصّص موارد أكثر للحاوية؛ يستفيد تطبيق Next.js من معالجين افتراضيين على الأقل و2 جيجابايت رام في الإنتاج
البدائل
Calendly هو البديل التجاري المستضاف بواجهة أنيقة لكن بتسعير لكل مقعد ودون خيار استضافة ذاتية. Rallly (مشمول أيضاً في هذه الأكاديمية) أداة استطلاع مواعيد أبسط — بديل لـ Doodle — لجدولة جماعية دون مزامنة تقويم فردية، وليست منصة حجز كاملة. تقدّم Zcal وReclaim.ai جدولة مستضافة مشابهة بمفاضلات ميزات مختلفة. للجدولة الداخلية للفريق فقط، يتضمن كل من Google Calendar وOutlook صفحات جدولة مواعيد مدمجة قد تكون كافية دون نشر منصة منفصلة.
متى لا تستخدمه
إذا كنت تحتاج فقط استطلاعات مواعيد بسيطة، مثل إيجاد وقت يناسب مجموعة، استخدم Rallly بدلاً من ذلك — Cal.com مبني لصفحات حجز فردية أو جماعية مع مزامنة تقويم حية، وليس استطلاع توفر غير رسمي. يحمل Cal.com أيضاً متطلبات بنية تحتية حقيقية: تطبيق Node.js وقاعدة بيانات PostgreSQL وتسليم بريد SMTP يعمل بشكل صحيح. بالنسبة لشخص واحد بدون ميزات فريقية يحجز بشكل عرضي فقط، قد لا يستحق هذا العبء مقارنة بالخطة المجانية من Calendly.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما قاعدة البيانات التي يتطلبها Cal.com؟
يتطلب Cal.com قاعدة بيانات PostgreSQL. ينشر سكريبت التثبيت PostgreSQL جنباً إلى جنب مع حاوية Cal.com على شبكة Docker مشتركة مع كل بيانات اعتماد الاتصال مضبوطة مسبقاً.
هل يدعم Cal.com مزامنة Google Calendar وOutlook؟
نعم. يدعم Cal.com المزامنة الثنائية مع Google Calendar وMicrosoft Outlook. يجب ضبط بيانات اعتماد تطبيق OAuth في Settings → Integrations بعد التثبيت.
هل يمكن لـ Cal.com إرسال رسائل تأكيد بالبريد الإلكتروني؟
نعم. يرسل Cal.com تأكيدات الحجز والتذكيرات عبر SMTP. اضبط EMAIL_SERVER_HOST وEMAIL_SERVER_PORT وEMAIL_SERVER_USER وEMAIL_SERVER_PASSWORD وEMAIL_FROM في متغيرات بيئة Docker.
ما المنفذ الافتراضي لـ Cal.com؟
يعمل Cal.com على المنفذ 3000 افتراضياً. استخدم Nginx Proxy Manager مع HTTPS ونطاق مخصص لعمليات النشر الإنتاجية.
هل يدعم Cal.com جدولة الفرق؟
نعم. يدعم Cal.com أنواع أحداث الفريق مع إمكانية تعيين عدة أعضاء، وتوزيع حجوزات Round-Robin، وأحداث جماعية يجب أن يكون فيها كل الأعضاء متاحين.
