📝 تثبيت Etherpad — محرر تعاوني لحظي

انشر Etherpad على Ubuntu بـ Docker — محرر نصوص تعاوني ذاتي الاستضافة يعمل في الزمن الحقيقي، حيث يستطيع عدة مستخدمين الكتابة في نفس المستند في آنٍ واحد.

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

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

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

سكريبت تثبيت آلي — ينشر Etherpad مع وصول مشرف وتخزين دائم على المنفذ 9001.
عرض على GitHub

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/tools/etherpad/etherpad-ubuntu.sh
chmod +x etherpad-ubuntu.sh
sudo bash etherpad-ubuntu.sh

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

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

wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/tools/etherpad/etherpad-ubuntu.sh

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

chmod +x etherpad-ubuntu.sh

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

يثبّت السكريبت Docker إن لزم الأمر، يضبط كلمة مرور المشرف، وينشر Etherpad على المنفذ 9001. يجب على Nginx تمرير اتصالات WebSocket إذا استُخدم كوكيل عكسي.

sudo bash etherpad-ubuntu.sh

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

افتح المتصفح وانتقل إلى Etherpad:

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

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

المنفذالغرض
9001Etherpad Web UI + WebSocket (HTTP)

نظرة عامة

Etherpad محرر ويب ذاتي الاستضافة ومفتوح المصدر للكتابة التعاونية في الزمن الحقيقي. يفتح عدة أشخاص نفس الصفحة (pad) ويكتبون في آنٍ واحد، وتظهر مساهمة كل كاتب بلون مميز مع ظهور التغييرات على شاشة الجميع فوراً عبر اتصال WebSocket. يُستخدم لتدوين الملاحظات الحية في المؤتمرات والهاكاثونات ومجتمعات المصادر المفتوحة منذ أكثر من عقد، ويحتفظ بتاريخ مراجعات كامل حتى تستطيع إرجاع الصفحة لأي نقطة سابقة ورؤية من كتب ماذا بالضبط.

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

يمنحك Etherpad تحريراً تعاونياً لحظياً بأسلوب Google Docs دون إرسال مستنداتك لسحابة طرف ثالث. إنه مبسّط عن قصد — لا مجلدات، لا تنسيق معقد، لا نظام حسابات يجب إدارته افتراضياً — فقط رابط تشاركه ومستند يستطيع الجميع الكتابة فيه في آنٍ واحد، مع تلوين يوضح من كتب ماذا. لتدوين ملاحظات تعاوني سريع أو محاضر اجتماعات أو تمارين ورش عمل حيث يكون منصة مستندات كاملة مبالغة، تحافظ استضافة Etherpad ذاتياً على المحتوى على بنيتك التحتية الخاصة مع إبقاء تجربة التعاون فورية بنفس القدر.

متى تحتاجه

  • تحتاج عدة أشخاص يحررون نفس المستند النصي في آنٍ واحد دون تبادل نسخ عبر البريد الإلكتروني
  • تريد تدوين ملاحظات تعاوني حي أثناء اجتماعات أو ورش عمل أو محاضرات مؤتمر يمكن لأي شخص الانضمام إليه عبر رابط
  • تحتاج بديلاً خفيفاً لـ Google Docs يبقي المستندات على سيرفرك الخاص بدلاً من سحابة طرف ثالث
  • تريد رؤية من ساهم بأي نص بالضبط من خلال تلوين مميز لكل كاتب
  • تحتاج محرراً تعاونياً قابلاً للتضمين داخل أداة أخرى ذاتية الاستضافة أو لوحة معلومات داخلية

من يحتاجه

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

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

  • تدوين ملاحظات اجتماع حية ومشتركة يستطيع كل حاضر تحريرها وقراءتها في آنٍ واحد
  • إجراء جلسات عصف ذهني أو تخطيط تعاوني أثناء ورش العمل والهاكاثونات
  • كتابة ملاحظات محاضرة مؤتمر أو ملخصات أسئلة وأجوبة يستطيع الجمهور بأكمله المساهمة فيها
  • صياغة مستندات بسيطة كفريق دون الحاجة لمنظومة مكتبية كاملة أو نظام حسابات
  • تضمين صفحة داخل ويكي داخلي أو لوحة معلومات كمساحة تعاونية سريعة
  • مشاركة رابط صفحة عامة لمساهمات تعاونية مجهولة وبأقل احتكاك من مجموعة

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

  • تحرير تعاوني في الزمن الحقيقي عبر WebSocket مع مزامنة فورية ومنخفضة الكمون بين كل المستخدمين المتصلين
  • تلوين مميز لكل كاتب حتى يكون نص كل مساهم قابلاً للتمييز بصرياً بنظرة واحدة
  • تاريخ مراجعات كامل — إرجاع الصفحة لأي نقطة سابقة في الجدول الزمني للتحرير (شريط الوقت)
  • استيراد وتصدير المستندات بصيغ مثل النص العادي وHTML وODF وDOC وPDF (عبر تكامل AbiWord أو LibreOffice)
  • منظومة إضافات لتوسيع الوظائف — تدقيق إملائي، صور مضمّنة، دعم جداول، والمزيد
  • شريط دردشة مدمج لكل صفحة حتى يستطيع المتعاونون النقاش دون مغادرة المستند
  • إطار iframe قابل للتضمين بسهولة وواجهة برمجة HTTP لدمج الصفحات في أدوات ومواقع ذاتية الاستضافة أخرى
  • لا يوجد نظام حسابات إلزامي افتراضياً — أي شخص لديه الرابط يستطيع الانضمام والبدء بالكتابة فوراً

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

  • افتح Etherpad في متصفحك وأنشئ أول صفحة لك باختيار اسم من الصفحة الرئيسية
  • شارك رابط الصفحة مع المتعاونين — أي شخص لديه الرابط يستطيع الانضمام والبدء بالكتابة فوراً
  • اضبط اسمك الظاهر ولونك عند الطلب حتى تكون مساهماتك قابلة للتمييز من قِبل الآخرين
  • استخدم شريط الوقت لمراجعة تاريخ مراجعات الصفحة ورؤية من كتب كل جزء بالضبط
  • سجّل الدخول إلى /admin بكلمة المرور المضبوطة أثناء التثبيت لإدارة الإضافات وإعدادات السيرفر
  • ثبّت إضافات مفيدة من لوحة المشرف، مثل التدقيق الإملائي أو امتدادات صيغ التصدير، حسب الحاجة
  • صدّر الصفحات المكتملة إلى PDF أو HTML أو نص عادي عندما تكون جاهزاً لأرشفة أو مشاركة المستند النهائي
  • أعدّ وكيلاً عكسياً مع HTTPS إذا كنت تخطط للوصول لـ Etherpad عن بُعد، مع التأكد من تمرير رؤوس ترقية WebSocket

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

  • ضع Etherpad خلف وكيل عكسي مع HTTPS حتى لا يُنقل محتوى الصفحات وبيانات اعتماد المشرف بنص عادي
  • عيّن كلمة مرور مشرف قوية بدلاً من الاعتماد على الافتراضية، لأن لوحة المشرف تستطيع تثبيت إضافات عشوائية
  • قيّد إنشاء الصفحات العامة إذا كنت لا تريد مستخدمين مجهولين ينشئون ويشاركون صفحات على نسختك
  • اضبط وكيلك العكسي ليمرر حركة WebSocket (رؤوس Upgrade/Connection) بشكل صحيح، وإلا ستتعطل المزامنة اللحظية بصمت
  • انتقل من تخزين DirtyDB الافتراضي إلى قاعدة بيانات حقيقية (PostgreSQL أو MySQL أو SQLite) لأي استخدام حقيقي أو إنتاجي
  • أبقِ صورة Etherpad Docker وأي إضافات مثبّتة محدّثة للحصول على إصلاحات أمنية
  • تعامل مع روابط الصفحات كرموز وصول — أي شخص لديه الرابط يستطيع التحرير افتراضياً، لذا تجنب لصق روابط صفحات حساسة في قنوات عامة

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

يخدم Etherpad كلاً من واجهة الويب واتصال WebSocket للمزامنة اللحظية عبر منفذ واحد، 9001، افتراضياً. إذا وصلت إليه مباشرة، يحتاج فقط المنفذ 9001 أن يكون قابلاً للوصول، ويجب تقييده على شبكات موثوقة أو وضعه خلف VPN إلا إذا أردت تحديداً جعله عاماً. للاستخدام الإنتاجي، ضع وكيلاً عكسياً مثل Nginx Proxy Manager أمامه على المنفذ 443 مع شهادة TLS صالحة — لكن تأكد أن الوكيل مُعدّ صراحة لتمرير رؤوس ترقية WebSocket (Connection: Upgrade، Upgrade: websocket)، لأن إعدادات وكيل HTTP فقط القياسية ستسمح بتحميل الصفحة لكنها تُعطّل التعاون اللحظي بصمت. احجب الوصول المباشر للمنفذ 9001 من الإنترنت بمجرد وضع الوكيل العكسي.

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

  • انسخ قاعدة بيانات Etherpad احتياطياً — تخزين DirtyDB القائم على الملفات افتراضياً، أو قاعدة بيانات MySQL/PostgreSQL/SQLite المضبوطة للإعدادات الإنتاجية
  • انسخ ملف settings.json احتياطياً، الذي يحتفظ بكلمة مرور المشرف وإعدادات قاعدة البيانات وإعدادات الإضافات المفعّلة
  • صدّر الصفحات المهمة إلى HTML أو نص عادي دورياً كنسخة احتياطية قابلة للقراءة البشرية مستقلة عن صيغة قاعدة البيانات
  • وثّق الإضافات المثبّتة حتى تتمكن من إعادة تثبيت نفس المجموعة بعد الترحيل أو التعافي من كارثة
  • خزّن النسخ الاحتياطية خارج نفس مضيف النسخة الحية حتى لا يأخذ فشل السيرفر نسختك الوحيدة معه
  • اختبر الاستعادة بتوجيه نسخة Etherpad جديدة لقاعدة بيانات منسوخة والتأكد من تحميل الصفحات والتاريخ الموجودين بشكل صحيح

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

  • إبقاء تخزين DirtyDB الافتراضي في الإنتاج — إنه مخصص للاختبار فقط وغير مناسب للاستخدام المتزامن والدائم متعدد المستخدمين
  • نسيان تمرير رؤوس WebSocket في وكيل عكسي، مما يُعطّل المزامنة اللحظية بينما تظهر الصفحة وكأنها تُحمّل بشكل طبيعي
  • استخدام كلمة مرور مشرف ضعيفة أو افتراضية، مما يمنح أي شخص يجدها القدرة على تثبيت إضافات عشوائية
  • مشاركة رابط تحرير صفحة علناً بينما أردت مشاركة وصول قراءة فقط — روابط Etherpad تمنح صلاحية تحرير افتراضياً
  • عدم نسخ settings.json احتياطياً، وفقدان بيانات اعتماد المشرف وإعدادات الإضافات إذا أُعيد إنشاء الحاوية
  • كشف المنفذ 9001 مباشرة للإنترنت بدون HTTPS، مما يرسل محتوى الصفحات وتسجيل دخول المشرف بنص عادي
  • تثبيت إضافات كثيرة جداً دون اختبار التوافق، مما قد يسبب مشاكل في عرض الصفحات أو المزامنة

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

  • المزامنة اللحظية لا تعمل — تحقق أن وكيلك العكسي يمرر رؤوس ترقية WebSocket؛ إعدادات HTTP فقط القياسية تُعطّل التعاون الحي بصمت
  • لا يمكن الوصول لـ /admin — تأكد أن كلمة مرور المشرف في settings.json أو متغير البيئة ADMIN_PASSWORD مطابقة لما تُدخله
  • محتوى الصفحة يختفي أو يفشل الحفظ — تحقق أن خلفية قاعدة البيانات قابلة للوصول وغير ممتلئة أو تالفة، خاصة بعد الانتقال من DirtyDB
  • الاستيراد/التصدير إلى DOC أو PDF يفشل — تأكد أن AbiWord أو LibreOffice مثبّت ومضبوط في settings.json، لأن Etherpad يفوّض تلك التحويلات لهما
  • تثبيت الإضافة يفشل من لوحة المشرف — تحقق من وصول الحاوية للإنترنت وراجع سجلات Etherpad بحثاً عن خطأ npm المحدد
  • يرى عدة مستخدمين محتوى مختلفاً للحظة — عادة إعادة اتصال WebSocket مؤقتة؛ تحقق أن إعدادات مهلة الوكيل ليست صارمة جداً
  • الصفحة تُحمّل فارغة أو تُظهر خطأ عند الفتح — تحقق من وحدة تحكم المتصفح بحثاً عن أخطاء JavaScript وتأكد أن سجلات حاوية Etherpad لا تُظهر فشل بدء تشغيل

البدائل

يركّز HackMD (ونسخته ذاتية الاستضافة CodiMD/HedgeDoc) على التحرير التعاوني القائم على Markdown مع معاينة حية، وهو أنسب للتوثيق والكتابة التقنية من صفحات Etherpad النصية البسيطة. يضيف CryptPad تشفيراً طرفياً ومنظومة مكتبية أوسع (جداول بيانات، نماذج، لوحات كانبان) فوق التحرير التعاوني، على حساب كونه أثقل في التشغيل. يوفر OnlyOffice وCollabora Online تحرير مستندات وجداول بيانات وعروض تقديمية متوافقة بالكامل مع Microsoft Office مع تعاون لحظي، وهو الخيار الصحيح عندما تحتاج مستندات منسّقة حقيقية بدلاً من نص مشترك بسيط. يبقى Google Docs الخيار الافتراضي لمعظم الناس لكنه يتطلب الثقة بسحابة طرف ثالث ببياناتك. للتعاون النصي البسيط والسريع في الزمن الحقيقي الذي تتحكم به بالكامل، لا يزال Etherpad صعب المنافسة من ناحية البساطة والسرعة.

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

Etherpad ليس محرر مستندات بمعنى Word أو Google Docs — لا يحتوي تنسيقاً غنياً أو تخطيط صفحات أو أنماطاً، فإذا احتجت تقارير منسّقة أو جداول بيانات أو عروض تقديمية، فإن OnlyOffice أو Collabora Online هو الأداة الصحيحة بدلاً منه. كما أنه لا يحتوي هيكل مجلدات أو إدارة مستندات مدمجة، فتنظيم عشرات الصفحات مع الوقت قد يصبح فوضوياً دون أدوات خارجية. إذا كانت أولويتك توثيقاً تقنياً بصيغة Markdown أصلية مع معاينة حية بدلاً من نص تعاوني بسيط، فإن HedgeDoc أو منصة ويكي مثل Wiki.js ستخدمك بشكل أفضل. وإذا كان التشفير الطرفي للمحتوى نفسه متطلباً أساسياً، فانظر إلى CryptPad بدلاً منه، لأن نموذج تعاون Etherpad يفترض أن السيرفر يستطيع قراءة محتوى الصفحة.

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

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

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

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

هل Etherpad مجاني ومفتوح المصدر حقاً؟

نعم. Etherpad (مشروع Apache Etherpad، المعروف سابقاً باسم Etherpad Lite) مفتوح المصدر بالكامل برخصة Apache 2.0. لا توجد باقات مدفوعة أو متطلبات حساب أو حدود استخدام عند استضافته ذاتياً — تُشغّل البرنامج على سيرفرك الخاص وتتحكم بالبيانات بالكامل.

هل يحتاج المتعاونون إنشاء حساب لتحرير صفحة؟

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

ما قاعدة البيانات التي يستخدمها Etherpad، وهل الافتراضية مناسبة للإنتاج؟

افتراضياً يستخدم Etherpad DirtyDB، وهو تخزين بسيط قائم على الملفات مخصص للاختبار فقط. لأي نشر حقيقي أو إنتاجي، اضبطه لاستخدام MySQL أو PostgreSQL أو SQLite في settings.json بدلاً منه — DirtyDB غير مصمم لكتابات متزامنة موثوقة متعددة المستخدمين.

لماذا توقف التعاون اللحظي عن العمل بعد وضع Etherpad خلف وكيل عكسي؟

هذا يعني تقريباً دائماً أن الوكيل لا يُمرر اتصالات WebSocket. تعتمد المزامنة الحية في Etherpad على اتصال WebSocket دائم، فيحتاج إعداد Nginx أو الوكيل العكسي لديك تمرير رؤوس Connection: Upgrade وUpgrade: websocket صراحة، وليس مجرد وكيل HTTP قياسي.

هل يمكنني تصدير صفحة لصيغة مستند عادية؟

نعم. يستطيع Etherpad تصدير الصفحات إلى نص عادي وHTML، و(مع تثبيت AbiWord أو LibreOffice) إلى صيغ DOC وODF وPDF. ابحث عن خيارات التصدير في شريط أدوات الصفحة، أو استخدم واجهة برمجة HTTP الخاصة بـ Etherpad لأتمتة التصدير برمجياً.