الاستضافة الذاتية والتطبيقات الأدلة التقنية

Docmost: مساحات وصفحات مثل Confluence على سيرفرك

نشغل Docmost على صفحات فريق حقيقي ونقيس ما تعطيه النسخة المفتوحة: الكتابة المشتركة والصلاحيات والبحث بالعربية والاستعادة، وما لا تعطيه إلا النسخة المدفوعة.

Docmost: مساحات وصفحات مثل Confluence على سيرفرك

قرر فريق نقاط البيع الذي تابعناه في مقال «قاعدة معرفة الفريق Wiki» من هذه المرحلة أن ينقل معرفته من المحادثة والمجلد المشترك إلى Wiki واحدة، واتفق على خمس مساحات بحسب المالك، وعلى قاعدة المرة الثانية، وعلى أن القراءة مفتوحة إلا في مساحة الموارد البشرية. وبقي السؤال الذي يؤجله كل فريق: أي أداة؟ ونصف الفريق عمل سابقاً في شركات تستخدم Confluence، والنصف الآخر يكتب ملاحظاته في Notion، والطلب الذي اتفق عليه الجميع هو محرر يشبه ما تعودوا عليه، يكتب فيه شخصان الصفحة نفسها في الوقت نفسه، ويعمل على سيرفر الشركة.

📌
أعلنت Atlassian نهاية نسخ Data Center من منتجاتها ومنها Confluence Data Center، ففي 30 مارس 2026 توقف بيع اشتراكات Data Center للعملاء الجدد، وفي 28 مارس 2029 تنتهي الاشتراكات وتصبح هذه النسخ للقراءة فقط، والطريق الذي تقترحه الشركة هو الانتقال إلى سحابتها. فالمؤسسة التي تحتاج أن تبقى معرفتها على سيرفراتها، لأسباب تنظيمية أو تعاقدية، لم يعد أمامها Confluence على سيرفرها بعد هذا التاريخ.

وأقرب الأدوات المفتوحة إلى هذا الطلب هو Docmost، وهو Wiki مفتوحة المصدر تقدم نفسها بديلاً عن Confluence وNotion، ففيها مساحات Spaces وصفحات متداخلة، ومحرر مرئي بأوامر الشرطة المائلة Slash Commands، وكتابة مشتركة في الوقت الفعلي Realtime Collaboration، وتعليقات وسجل للصفحات ومخططات. ولكن Docmost مشروع شاب، وأول إصدار له كان قبل أقل من ثلاث سنوات، ونسخته المفتوحة تختلف عن نسخه المدفوعة في ميزات يحتاجها فريقنا، لذلك سوف نشغله على صفحات الفريق نفسها، ونقيس ما يهمنا بالأرقام قبل أن نحكم عليه.

وسوف نناقش في هذا المقال ما يلي:

  • ما الذي في النسخة المفتوحة Community وما الذي في Business، وكم يكلف ذلك لفريق من 14 شخصاً.
  • كيف يعمل Docmost من الداخل: PostgreSQL وRedis وسيرفر الكتابة المشتركة عبر WebSocket.
  • التثبيت بال Docker Compose وإنشاء مساحة العمل واستيراد الصفحات الإحدى عشرة من Markdown.
  • العربية واتجاه النص، والصلاحيات، ومشكلة واجهناها مع المساحات الجديدة.
  • البحث بالعربية بالاستعلامات الاثني عشر نفسها، ولماذا تعطي نتائجه ما تعطيه.
  • الكتابة المشتركة في متصفحين، والتصدير، وماذا يحدث إذا توقف Redis.
  • النسخ الاحتياطي مع اختبار استعادة كامل، والتحديث، ونقاط القوة والضعف.

ما الذي يقدمه Docmost؟ Overview

Docmost تطبيق ويب مكتوب ب TypeScript، الخلفية فيه بإطار NestJS والواجهة بإطار React، والمحرر مبني على مكتبة Tiptap، ويخزن بياناته في PostgreSQL ويحتاج إلى Redis. وآخر إصدار وقت كتابة المقال هو 0.97.0 الصادر في 25 أكتوبر 2026، وفيه بحسب صفحة الإصدار تكاملات مع GitHub وGitLab وJira، ووضع العرض Presentation Mode، وتحسينات في أداء البحث، وإصلاحات أمنية لثغرات Node.js، ولاحظ أن الرقم ما زال تحت 1.0، أي أن المشروع لم يعلن بعد إصداراً يعده مستقراً بالمعنى الكامل.

وطريقة التنظيم فيه قريبة من Confluence: مساحة العمل Workspace واحدة للشركة، وفيها مساحات Spaces، وفي كل مساحة شجرة صفحات Pages يمكن أن تتداخل إلى أي عمق، والصلاحيات تكون على المساحة. وهذا يختلف عن BookStack الذي يفرض أربعة مستويات ثابتة من الرف إلى الصفحة، ويقترب من Outline الذي فيه مجموعات Collections ومستندات متداخلة. وما يميز Docmost عن الاثنين هو المحرر نفسه، ففيه الجداول والمخططات بال Draw.io وExcalidraw وMermaid، والمعادلات، والصفحات الفرعية، والتبويبات Tabs، وكلها من قائمة واحدة تظهر عند كتابة الشرطة المائلة.

النسخة المفتوحة Community أم Business؟ Editions

قبل التثبيت يجب أن تعرف ما الذي ستحصل عليه مجاناً، لأن هذا هو الفرق الأكبر بين Docmost والأدوات الأخرى في هذه المرحلة. ف Docmost يأتي بثلاث نسخ بحسب صفحة النسخ في التوثيق: النسخة المفتوحة Open Source أو Community بترخيص AGPL-3.0، ونسختا Business وEnterprise بترخيص تجاري. والكود كله في مستودع واحد، والميزات المدفوعة في مجلدات ee عليها ترخيص Docmost Enterprise الذي لا يسمح باستخدامها في الإنتاج دون اشتراك، وتفعل بمفتاح ترخيص License Key من الإعدادات. والصورة التالية تلخص ما يهم فريقنا من صفحة الأسعار كما كانت في 5 نوفمبر 2026:

ثلاثة أعمدة لنسخ Docmost: في Community مجاناً بترخيص AGPL-3.0 المساحات والصلاحيات على مستوى المساحة والمجموعات والكتابة المشتركة وسجل الصفحة والوسوم والتعليقات والمخططات والبحث النصي والاستيراد من Markdown وHTML وNotion والتصدير إلى Markdown وHTML، وفي Business فقط الدخول الموحد SSO والمصادقة الثنائية MFA والصلاحيات على مستوى الصفحة والقوالب ومفاتيح API وإغلاق التعليقات والاستيراد من Confluence وDOCX وPDF والبحث في المرفقات والذكاء الاصطناعي، وفي Enterprise SCIM وسجل التدقيق وSIEM ومراجعة الصفحات وسياسات الاحتفاظ
الدخول الموحد والقوالب والصلاحيات على الصفحة في Business وليست في النسخة المفتوحة

وهنا ثلاث نقاط تؤثر في قرار فريقنا مباشرة:

  • لا يوجد دخول موحد SSO في النسخة المفتوحة: فإذا كان لديك authentik يدخل به الموظفون إلى Outline وBookStack وMattermost، فلن يدخلوا به إلى Docmost Community، وإنما بحساب وكلمة مرور منفصلين، والموظف الذي يغادر يجب أن تعطل حسابه في Docmost يدوياً. ولا توجد المصادقة الثنائية MFA أيضاً.
  • لا توجد قوالب Templates: وقد رأينا في مقال قاعدة المعرفة أن القالب هو ما يجعل أدلة المهام والقرارات متشابهة، فالبديل في النسخة المفتوحة هو صفحة «قوالب» ينسخ منها الكاتب.
  • الصلاحيات على المساحة فقط: أي أن صفحة واحدة لا يمكن إخفاؤها داخل مساحة مفتوحة، فإذا أردت إخفاء صفحة فمكانها مساحة أخرى. وهذا لا يضر فريقنا لأن قسمتنا أصلاً بحسب المالك، والمساحة المقيدة واحدة.

وسعر Business في الصفحة نفسها 6 دولارات للمستخدم في الشهر عند الدفع السنوي، بحد أدنى 10 مستخدمين، فلفريق من 14 شخصاً يكون الحساب 14 × 6 × 12 = 1,008 دولارات في السنة. ولاحظ أيضاً أن ال API نفسها، أي إنشاء مفاتيح API Keys للوصول البرمجي، ميزة مدفوعة بحسب صفحة ال API في التوثيق، وهذا يعني أن السكربتات التي تنشئ الصفحات أو تنقلها من نظام آخر لا تملك طريقة رسمية في النسخة المفتوحة، وسوف نرى في المختبر كيف عملنا مع ذلك.

كيف يعمل Docmost من الداخل؟ Architecture

من الخارج يبدو Docmost Container واحداً، ولكنه في الحقيقة يعتمد على ثلاثة أشياء أخرى، ويجب أن تعرف دور كل واحد منها لأنك سوف تحتاجه في النسخ الاحتياطي وفي تشخيص الأعطال، والصورة التالية تبين المكونات كما شغلناها:

مكونات Docmost من اليمين إلى اليسار: متصفحان فيهما محرر Tiptap ونسخة Yjs من المستند، يتصلان بطريقين هما HTTP على المسار api للدخول والبحث والمساحات والاستيراد والتصدير، وWebSocket على المسار collab لتعديلات Yjs عبر Hocuspocus، ثم تطبيق Docmost بإطار NestJS، وخلفه PostgreSQL للصفحات والمستخدمين والصلاحيات وعمود البحث tsv، وRedis لطوابير المهام BullMQ ومزامنة الكتابة المشتركة، والتخزين للمرفقات في app/data/storage أو S3، وتحتها أن النسخة الاحتياطية تشمل قاعدة البيانات ومجلد التخزين وملفي Compose و.env
الكتابة المشتركة تمر في WebSocket مستقل عن طلبات ال API
  • PostgreSQL: فيها كل شيء تقريباً: الصفحات بمحتواها، والمستخدمون، والمساحات، والصلاحيات، والسجل، وعمود اسمه tsv في جدول الصفحات يحمل الكلمات المفهرسة للبحث، وسوف نعود إليه في قسم البحث.
  • Redis: تستخدمه مكتبة BullMQ لطوابير المهام Queues، مثل الاستيراد والتصدير وإرسال البريد وحفظ سجل الصفحات في الخلفية، ويستخدمه سيرفر الكتابة المشتركة لمزامنة التعديلات إذا شغلت أكثر من نسخة من Docmost.
  • التخزين Storage: المرفقات والصور وملفات الاستيراد، على القرص في /app/data/storage بشكل افتراضي، أو على S3 أو Azure Blob Storage كما في صفحة المتغيرات.
  • سيرفر الكتابة المشتركة Collaboration: داخل Docmost نفسه، ويعمل بمكتبة Hocuspocus على المسار /collab.

والنقطة الأخيرة تحتاج إلى شرح، لأنها سبب أغلب مشكلات التثبيت خلف Reverse Proxy. فعندما يكتب شخصان الصفحة نفسها، لا يرسل كل متصفح الصفحة كاملة عند الحفظ، لأن آخر من يحفظ سوف يمسح تعديل الآخر. وإنما يحمل كل متصفح نسخة من المستند بصيغة Yjs، وهي نوع من البيانات اسمه CRDT أي Conflict-free Replicated Data Type، وكل تعديل صغير، مثل حرف أضيف في موضع معين، يرسل عبر WebSocket إلى السيرفر الذي يرسله إلى بقية المتصفحات، وتصميم CRDT يضمن أن كل النسخ تصل إلى المحتوى نفسه مهما كان ترتيب وصول التعديلات. والسيرفر يحفظ المستند في PostgreSQL بعد التعديلات. لذلك إذا لم يمرر ال Reverse Proxy اتصال WebSocket، فالصفحة تفتح وتقرأ، ولكن المحرر يتحول إلى القراءة فقط، كما يحذر توثيق ال Reverse Proxy.

التثبيت مع Docker Compose Installation

يقدم المشروع ملف Compose في المستودع وصفحة تثبيت، والملف الرسمي يستخدم الوسم latest وكلمات مرور مكتوبة داخله، فعدلنا عليه ثلاثة أشياء سوف نشرحها.

الأسرار Secrets في ملف .env

نضع الأسرار في ملف .env بجانب ملف Compose، ونولدها بالأمر openssl:

mkdir docmost && cd docmost
cat > .env <<EOF
DOCMOST_TAG=0.97.0
APP_SECRET=$(openssl rand -hex 32)
DB_PASSWORD=$(openssl rand -hex 16)
EOF
chmod 600 .env

والقيمة APP_SECRET هي الأهم، فالتوثيق يطلب ألا تقل عن 32 حرفاً، ويقول في صفحة النسخ الاحتياطي إنها لازمة لفك تشفير أسرار المصادقة الثنائية والتكاملات بعد الاستعادة، لذلك إذا فقدتها فقدت معها هذه البيانات، فاحفظ نسخة من الملف خارج السيرفر.

ملف docker-compose.yml

name: wr-kb-dm
services:
  docmost:
    image: docmost/docmost:${DOCMOST_TAG}
    depends_on:
      db:
        condition: service_healthy
      redis:
        condition: service_started
    environment:
      APP_URL: http://localhost:23100
      APP_SECRET: ${APP_SECRET}
      DATABASE_URL: postgresql://docmost:${DB_PASSWORD}@db:5432/docmost
      REDIS_URL: redis://redis:6379
      MAIL_DRIVER: smtp
      SMTP_HOST: mailpit
      SMTP_PORT: "1025"
      MAIL_FROM_ADDRESS: [email protected]
      MAIL_FROM_NAME: Docmost
    ports:
      - "127.0.0.1:23100:3000"
    restart: unless-stopped
    volumes:
      - docmost:/app/data/storage

  db:
    image: postgres:18.6-alpine
    environment:
      POSTGRES_DB: docmost
      POSTGRES_USER: docmost
      POSTGRES_PASSWORD: ${DB_PASSWORD}
    restart: unless-stopped
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U docmost -d docmost"]
      interval: 5s
      retries: 20
    volumes:
      - db_data:/var/lib/postgresql

  redis:
    image: redis:8.10.3-alpine
    command: ["redis-server", "--appendonly", "yes", "--maxmemory-policy", "noeviction"]
    restart: unless-stopped
    volumes:
      - redis_data:/data

  mailpit:
    image: axllent/mailpit:v1.27
    ports:
      - "127.0.0.1:23125:8025"

volumes:
  docmost:
  db_data:
  redis_data:

في الإعداد أعلاه لاحظ التالي:

  • الوسم ثابت 0.97.0 بدلاً من latest، لأن التحديث في مشروع سريع التغير يجب أن يكون قراراً بعد نسخة احتياطية، وليس نتيجة إعادة تشغيل.
  • شرط service_healthy مع فحص pg_isready يجعل Docmost ينتظر حتى تقبل PostgreSQL الاتصالات، فلا يفشل في تشغيل تغييرات الجداول Migrations في الثواني الأولى.
  • Redis مع --appendonly yes يحفظ الطوابير على القرص، وnoeviction يمنع Redis من حذف مفاتيح عندما تمتلئ ذاكرته، لأن حذف مهمة من الطابور يعني أنها لن تنفذ أبداً.
  • المسار /var/lib/postgresql للـ Volume وليس /var/lib/postgresql/data، لأن Docker Image الخاصة بالإصدار 18 غيرت مكان البيانات إلى مجلد باسم الإصدار تحت هذا المسار.
  • Docmost يحتاج إلى بريد لكي يرسل الدعوات، فبدونه لا يستطيع المدير أن يضيف زملاءه إلا برابط الدعوة، لذلك أضفنا في المختبر Mailpit الذي يستقبل البريد ويعرضه في واجهة ويب، وعلى سيرفرك تضع إعدادات SMTP حقيقية كما في مقال SMTP Relay.
  • المنفذ على 127.0.0.1 فقط، لأن الوصول من الخارج يكون عبر ال Reverse Proxy كما سوف نرى.

التشغيل الأول First Run

docker compose pull
docker compose up -d
docker compose logs -f docmost

وحجم Docker Image الخاصة ب Docmost بعد التنزيل 1.2 جيجابايت على القرص، وفي التشغيل الأول نفذ Docmost 53 تغييراً على الجداول Migration، ثم ظهر السطر التالي بعد 18 ثانية من الأمر up:

{"level":"info","context":"DatabaseMigrationService","msg":"Migration \"20260905T126412-integrations\" executed successfully"}
{"level":"info","context":"NestApplication","msg":"Nest application successfully started"}
{"level":"info","context":"NestApplication","msg":"Listening on http://127.0.0.1:3000 / http://localhost:23100"}

والسجل بصيغة JSON، وكل سطر فيه المستوى level والمكون context والرسالة، وهذا مفيد إذا جمعت السجلات في نظام مراقبة. ولاحظ السطر الأخير، فهو يكتب العنوان الداخلي والعنوان الذي قرأه من APP_URL، فإذا ظهر هنا عنوان غير الذي يكتبه المستخدمون فالروابط في رسائل البريد سوف تكون خاطئة.

إنشاء مساحة العمل Workspace

عند فتح العنوان أول مرة يحولك Docmost إلى الصفحة /setup/register، وفيها اسم مساحة العمل واسمك وبريدك وكلمة المرور، ومن يكمل هذه الصفحة يصبح مالك مساحة العمل Owner:

صفحة إعداد Docmost الأولى وفيها حقول اسم مساحة العمل شركة نقاط البيع والاسم الكامل مدير الويكي والبريد admin@example.com وكلمة المرور وزر Create workspace
أول من يفتح الموقع يصبح المالك، فأكمل هذه الصفحة قبل أن تجعل الموقع متاحاً
⚠️
صفحة الإعداد مفتوحة لأي شخص يصل إلى الموقع قبل أن ينشئ أحد مساحة العمل، فإذا ربطت النطاق بال Reverse Proxy قبل أن تكمل الإعداد، فقد يسبقك إليها شخص آخر ويصبح هو المالك. لذلك أكمل الإعداد من العنوان المحلي أو عبر نفق SSH، ثم افتح الموقع للناس.

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

المساحات Spaces لفريق نقاط البيع

أنشأنا المساحات الخمس التي اتفق عليها الفريق: العمليات، والدعم، والتقنية، والمبيعات، والموارد البشرية. وفي الواجهة تنشئ المساحة من Settings ثم Spaces، كما في صفحة المساحات، بالاسم والمعرف Slug الذي يظهر في الرابط. ولأن مفاتيح ال API في Business، فقد أنشأنا المساحات في المختبر بسكربت يفتح الواجهة في متصفح Chrome دون شاشة Headless، ويسجل الدخول، ثم يرسل من داخل الصفحة الطلبات نفسها التي ترسلها الواجهة إلى المسار /api، وهذا هو الجزء المهم منه:

const spaces = { 'العمليات': 'ops', 'الدعم': 'support', 'التقنية': 'tech', 'الموارد البشرية': 'hr', 'المبيعات': 'sales' };
for (const [name, slug] of Object.entries(spaces)) {
  const r = await api('/spaces/create', { name, slug, description: '' });
  // ثم رفع ملف zip فيه صفحات المساحة إلى /api/pages/import-zip
}

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

استيراد الصفحات Import من Markdown

يدعم Docmost في النسخة المفتوحة الاستيراد من Markdown وHTML وتصدير Notion، ويقبل ملف zip فيه عدة ملفات دفعة واحدة، بحسب صفحة الاستيراد والتصدير. فوضعنا صفحات كل مساحة في ملف zip، واسم كل ملف هو عنوان الصفحة، مثل إجراء إضافة مطعم جديد.md، ثم رفعناه، فكان رد الطلب كما يلي بعد اختصاره:

import ops 200 {"data":{"type":"import","source":"generic","status":"processing","fileName":"العمليات.zip","fileSize":2644,"fileExt":"zip",...
import hr 200 {"data":{"type":"import","source":"generic","status":"processing","fileName":"الموارد_البشرية.zip","fileSize":761,...

لاحظ أن الحالة processing، أي أن الاستيراد مهمة في طابور BullMQ تنفذ في الخلفية، وهذا أحد أسباب حاجة Docmost إلى Redis. ولاحظ أيضاً أن اسم الملف «الموارد البشرية.zip» أصبح الموارد_البشرية.zip، فالمسافة في اسم الملف المرفوع تحولت إلى شرطة سفلية عند التخزين، ولم يؤثر ذلك على أسماء الصفحات. وبعد ثوان طلبنا قائمة الصفحات في كل مساحة، فكانت الصفحات الإحدى عشرة كلها في أماكنها:

tech التقنية | استعادة قاعدة البيانات PostgreSQL من النسخة الاحتياطية ; الدخول إلى السيرفرات عبر VPN ; قرار: لماذا اخترنا PostgreSQL لخدمة الطلبات ; مراجعة حادثة: تكرار الطلبات في تطبيق الكاشير
support الدعم | ربط طابعة الإيصالات بجهاز الكاشير ; مستوى الخدمة للعملاء SLA
ops العمليات | إجراء إضافة مطعم جديد ; دليل الموظف الجديد في الأسبوع الأول ; قائمة الأنظمة الداخلية ومالك كل نظام
sales المبيعات | أسعار الباقات والخصومات
hr الموارد البشرية | سياسة الإجازات السنوية

والعنوان من السطر الأول # … في الملف أصبح عنوان الصفحة، ولم يتكرر داخل المحتوى، والجداول والقوائم المرقمة بقيت جداول وقوائم. وأما الرابط فقد أصبح لصفحة «إجراء إضافة مطعم جديد» الشكل /s/ops/p/ajrae-adaft-mtem-jdyd-5wRMwGVckv، فالعنوان العربي حول إلى حروف لاتينية تقريبية، وفي آخره معرف ثابت 5wRMwGVckv، وهذا المعرف هو ما يعتمد عليه Docmost، فالرابط يبقى يعمل إذا تغير العنوان، وهذه نقطة لصالحه مقارنة بالروابط التي تتغير مع العنوان كما رأينا في BookStack.

العربية واتجاه النص RTL

المحرر يضبط اتجاه كل فقرة تلقائياً بحسب أول حرف قوي فيها، وهذا ما يسمى dir="auto" في HTML، وقد وجدنا في كود الواجهة للإصدار 0.97.0 أن المحرر يعمل بالإعداد textDirection: "auto" في Tiptap. فالفقرة التي تبدأ بالعربية تصبح من اليمين إلى اليسار دون أي إعداد، والصورة التالية تبين صفحة «إجراء إضافة مطعم جديد» كما استوردناها:

صفحة إجراء إضافة مطعم جديد في Docmost، والعنوان والفقرات العربية من اليمين إلى اليسار، وقائمة مرقمة بأربع خطوات نصها على اليمين ولكن أرقامها 1 إلى 4 على الجهة اليسرى بعيداً عن النص، والقائمة الجانبية فيها مساحة العمليات وصفحاتها الثلاث والقوائم بالإنجليزية
الفقرات من اليمين إلى اليسار تلقائياً، ولكن أرقام القائمة بقيت على اليسار

النص العربي سليم، ولكن لاحظ القائمة المرقمة، فنص كل خطوة على اليمين، وأرقامها من 1 إلى 4 على الجهة اليسرى من الصفحة بعيداً عن النص، وكذلك النقاط في القوائم غير المرقمة. والسبب أن الاتجاه التلقائي يطبق على عناصر القائمة li، أما القائمة نفسها ol فتبقى من اليسار إلى اليمين لأنها ترث اتجاه الصفحة الإنجليزي، ومكان الرقم يحدده اتجاه القائمة وليس اتجاه العنصر. وفي دليل مهمة طويل يصبح ربط الرقم بالخطوة صعباً على القارئ، وهذا من الأشياء التي يجب أن تجربها بنفسك مع فريقك قبل القرار. وفي قائمة الصفحات ونتائج البحث مشكلة مشابهة، فالعنوان «الدخول إلى السيرفرات عبر VPN» يظهر أحياناً بترتيب كلمات غير صحيح لأن العنصر الذي يحمله اتجاهه من اليسار إلى اليمين، كما سوف ترى في صور البحث.

الصلاحيات Permissions: المساحة الجديدة خاصة افتراضياً

في Docmost ثلاثة أدوار على المساحة بحسب صفحة المساحات: Full Access للتحكم الكامل، وCan Edit للإنشاء والتعديل، وViewer أو Can view للقراءة. وعلى مستوى مساحة العمل أدوار Owner وAdmin وMember. ثم أرسلنا دعوة إلى موظف الدعم بالبريد [email protected] بدور Member، فوصلت الرسالة إلى Mailpit بالعنوان «مدير الويكي invited you to Docmost»، وفيها رابط بالشكل /invites/<id>?token=…، ففتحه وكتب اسمه وكلمة المرور، ثم دخل.

المشكلة التي واجهناها: الموظف لا يرى إلا General

عندما دخل موظف الدعم لم يجد أي مساحة من المساحات الخمس، وإنما General وحدها، ولم يجد البحث شيئاً عن «إجراء»، وهذا ما أعاده السكربت من حسابه:

before spaces: general | إجراء -> 0 | الإجازات -> 0
before HR page direct -> 404 Not Found
الصفحة الرئيسية لموظف الدعم في Docmost، وتحت Spaces you belong to مساحة واحدة هي General بعضوين، وتحتها No pages yet
المساحات الخمس موجودة ولكن الموظف ليس عضواً في أي منها

والسبب ظهر عندما طلبنا أعضاء كل مساحة: المساحة الجديدة في Docmost يكون عضوها الوحيد من أنشأها، بدور Full Access، ولا يضاف إليها أحد تلقائياً، أما مجموعة Everyone فهي عضو في General فقط:

general [["user","مدير الويكي","admin"],["group","Everyone","writer"]]
tech    [["user","مدير الويكي","admin"]]
support [["user","مدير الويكي","admin"]]
ops     [["user","مدير الويكي","admin"]]
sales   [["user","مدير الويكي","admin"]]
hr      [["user","مدير الويكي","admin"]]

أي أن Docmost يطبق عكس القاعدة التي اتفق عليها فريقنا، فكل مساحة مغلقة حتى تفتحها. وهذا آمن من جهة، لأن المساحة لا تنكشف بالخطأ، ولكنه يعني أن كل مساحة جديدة تحتاج خطوة يتذكرها من أنشأها، وإلا يبني الفريق Wiki لا يرى فيها أحد إلا ما كتبه بنفسه، ويستنتج أن البحث لا يعمل. والحل من Space Settings ثم Members ثم Add space members، فنضيف مجموعة Everyone بدور Can view إلى المساحات الأربع المفتوحة، ونترك الموارد البشرية كما هي:

نافذة إعدادات مساحة العمليات في Docmost على تبويب Members، وفيها عضوان: مدير الويكي بدور Full access، ومجموعة Everyone بعضوين بدور Can view، وزر Add space members
مجموعة Everyone بدور القراءة تجعل المساحة مفتوحة لكل الموظفين

وعندما أضفنا المجموعة بالطلب نفسه الذي ترسله الواجهة دون الحقل userIds، رفضه السيرفر بالرسالة each value in userIds must be a UUID، فأضفنا userIds: [] مع groupIds فقبله، وهذه من تفاصيل الواجهة الداخلية التي لا تحتاجها إذا عملت من الإعدادات. وبعد الإضافة أعاد السكربت من حساب موظف الدعم ما يلي:

after spaces: general,tech,support,ops,sales | إجراء -> 2 | الإجازات -> 0
after HR page direct -> 404 Not Found

أصبح يرى المساحات الأربع، والبحث عن «إجراء» يعيد صفحتين، أما «الإجازات» فلا يعيد شيئاً لأن صفحتها في مساحة الموارد البشرية، وطلب الصفحة مباشرة بمعرفها يعيد 404 Not Found وليس 403 Forbidden، أي أن Docmost لا يؤكد له وجود الصفحة أصلاً، وهذا السلوك الصحيح لأن رسالة «ممنوع» تخبر الموظف أن هناك صفحة بهذا المعرف. ونصيحتنا لفريقك أن تجعل إضافة Everyone بدور القراءة خطوة مكتوبة في إجراء إنشاء أي مساحة، وأن تراجع قائمة الأعضاء في كل مساحة مرة كل ربع سنة.

شغلنا الاستعلامات الاثني عشر نفسها التي وضعناها في مقال قاعدة المعرفة عبر المسار /api/search من حساب المدير، واعتبرنا الاستعلام ناجحاً إذا ظهرت صفحته المتوقعة في أول خمس نتائج، فكان المخرج كما يلي:

OK   إجراء          -> p01,p07
MISS اجراء          -> -
MISS الفاتوره       -> -
MISS سيرفر          -> -
OK   طابعة          -> p02
MISS مستوي          -> -
OK   الإجازات       -> p04
OK   الاسترجاع      -> p03
OK   wireguard      -> p05
OK   postgres       -> p06,p03
OK   تكرار الطلبات  -> p08
OK   الموظف الجديد  -> p07

النتيجة 8 من 12، والاستعلامات الأربعة التي فشلت هي الهمزة والتاء المربوطة والألف المقصورة، و«سيرفر» والنص فيه «السيرفرات». ولكي نفهم السبب نظرنا في قاعدة البيانات نفسها، فوجدنا أن الدالة التي تملأ عمود البحث في جدول الصفحات هي التالية:

new.tsv := setweight(to_tsvector('english', f_unaccent(coalesce(new.title, ''))), 'A') ||
           setweight(to_tsvector('english', f_unaccent(substring(coalesce(new.text_content, ''), 1, 1000000))), 'B');

وفي ملف search.service.ts يبنى الاستعلام بالشكل to_tsquery('english', f_unaccent(query + '*')). وهذا يفسر كل النتائج:

  • الإعداد english لا يعرف العربية، فيترك الكلمات العربية كما هي دون توحيد للهمزة ودون حذف «ال»، وهذا ما رأيناه في عمود tsv لصفحة VPN، حيث الكلمات مخزنة بالشكل 'السيرفرات':3A و'الدخول':1A,13B.
  • الدالة f_unaccent تحذف علامات اللغات الأوروبية مثل é، ولكنها لا توحد «إ» مع «ا»، فلم يجد «اجراء».
  • النجمة * في آخر الاستعلام تجعل البحث بأول الكلمة Prefix، ولذلك وجد «postgres» صفحتي PostgreSQL، ووجد «الإجازات» لأن الكلمة نفسها في النص، ولكن «سيرفر» لا تجد «السيرفرات» لأن الكلمة المخزنة تبدأ ب «ال» وليس ب «سيرفر».
  • الوزن A للعنوان وB للمحتوى يجعل الصفحة التي فيها الكلمة في العنوان أعلى في الترتيب، ولذلك ظهرت p01 قبل p07 في استعلام «إجراء».

والصورتان التاليتان من الواجهة نفسها تبينان أثر ذلك على المستخدم، فالبحث عن «سيرفر» لا يجد شيئاً، والبحث عن «السيرف» يجد ثلاث صفحات ويميز الكلمة المطابقة:

نافذة البحث في Docmost وفيها الكلمة سيرفر ونتيجة No results found، وخلفها قائمة الصفحات الحديثة ومنها الدخول إلى السيرفرات عبر VPN
«سيرفر» لا تجد شيئاً، مع أن الصفحة في القائمة خلف النافذة
نافذة البحث في Docmost وفيها الكلمة السيرف، وثلاث نتائج هي الدخول إلى السيرفرات عبر VPN من مساحة التقنية، وإجراء إضافة مطعم جديد ودليل الموظف الجديد من مساحة العمليات، مع سطر من المحتوى فيه الكلمة المطابقة بخط عريض، وخيارات Space وType وTitle only وFilter
«السيرف» تجد كل كلمة تبدأ بها، والسطر المطابق يظهر تحت العنوان

وفي النافذة خيار Title only، وهو يعمل بطريقة مختلفة تماماً، فبحسب الكود نفسه يبحث في العنوان بالمطابقة LIKE '%…%'، أي عن الحروف في أي موضع من العنوان. فجربنا الاستعلامات نفسها بهذا الخيار، فكانت النتيجة 7 من 12، ولكنها مختلفة: وجد «سيرفر» لأنها جزء من «السيرفرات» في العنوان، وفقد «الاسترجاع» و«wireguard» لأنهما في المحتوى وليستا في العنوان. والصورة التالية تجمع الطريقتين:

جدول الاستعلامات الاثني عشر في Docmost 0.97.0: البحث الكامل نجح في إجراء وطابعة والإجازات والاسترجاع وwireguard وpostgres وتكرار الطلبات والموظف الجديد وفشل في اجراء والفاتوره وسيرفر ومستوي فالمجموع 8 من 12، والعنوان فقط نجح في إجراء وسيرفر وطابعة والإجازات وpostgres وتكرار الطلبات والموظف الجديد وفشل في اجراء والفاتوره ومستوي والاسترجاع وwireguard فالمجموع 7 من 12
البحث الكامل يفهم أول الكلمة، والبحث في العنوان يجد الحروف في أي موضع

فالعادة التي تعلمها لفريقك في Docmost: ابحث بالكلمة كما تكتب في النص مع «ال» والهمزة، أو بأول الكلمة، وإذا كنت تعرف أن الكلمة في العنوان فاستخدم Title only ليجد الكلمة حتى مع «ال» أو حروف الجر. أما الهمزة والتاء المربوطة والألف المقصورة فلا تعالجها أي من الطريقتين، ولذلك اكتب العناوين بالإملاء الشائع، واكتب في السطر الأول من الصفحة الأشكال الأخرى للكلمة المهمة. ولاحظ أن Business فيها محرك بحث آخر هو Typesense، ولم نختبره لأنه خارج النسخة المفتوحة.

الكتابة المشتركة Realtime Collaboration في متصفحين

هذه هي الميزة التي جعلت الفريق ينظر إلى Docmost أصلاً، فاختبرناها بمتصفحين منفصلين، لكل واحد ملف تعريف Profile مستقل، فتحا صفحة «ربط طابعة الإيصالات» في الوقت نفسه. ثم كتبنا في المتصفح الأول جملة في آخر الفقرة الأخيرة، وفي المتصفح الثاني عبارة «(المتصفح الثاني)» في سطر آخر من القائمة، وهذه الصورة من المتصفح الثاني بعد ثانيتين ونصف:

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

ظهرت جملة المتصفح الأول في الثاني، ومعها مؤشر Caret عليه اسم «مدير الويكي»، وبقي تعديل المتصفح الثاني في مكانه، فلم يمسح أحد التعديلين الآخر. ولاحظ أن عبارة المتصفح الثاني دخلت في منتصف كلمة «والمنفذ» لأن السكربت ضغط في ذلك الموضع، وهذا خطأ منا في المختبر وليس من Docmost، ولكنه يذكرك بأن الكتابة المشتركة تضمن ألا يضيع تعديل، ولا تضمن أن يكون التعديل منطقياً، فالمراجعة البشرية تبقى لازمة. وسوف نختبر الكتابة المشتركة بتفصيل أكبر، مع انقطاع الشبكة أثناء الكتابة، في مقال HedgeDoc من هذه المرحلة.

التصدير Export إلى Markdown أو HTML

التصدير في النسخة المفتوحة يكون لصفحة واحدة أو لمساحة كاملة، بصيغة Markdown أو HTML، مع المرفقات. فصدرنا مساحة التقنية بالصيغتين، فجاء ملف zip باسم التقنية-space-export.zip، وفيه ما يلي بصيغة Markdown:

استعادة قاعدة البيانات PostgreSQL من النسخة الاحتياطية.md   781
الدخول إلى السيرفرات عبر VPN.md                              571
قرار لماذا اخترنا PostgreSQL لخدمة الطلبات.md                653
مراجعة حادثة تكرار الطلبات في تطبيق الكاشير.md               656
docmost-metadata.json                                       2021

الأرقام أحجام الملفات بالبايت، وأسماء الملفات بالعربية كما هي، إلا أن النقطتين في «قرار:» و«مراجعة حادثة:» حذفتا لأنهما غير مسموحتين في أسماء الملفات على Windows. والملف docmost-metadata.json يحفظ شجرة الصفحات وترتيبها لكي يعيد Docmost بناءها عند الاستيراد. ومحتوى ملف صفحة VPN خرج كما أدخلناه تماماً: العنوان بعلامة #، والقائمة المرقمة، والعنوان 10.8.0.0/24. وهذا مهم لأي أداة تختارها، لأنه يعني أنك تستطيع الخروج من Docmost إلى أداة أخرى دون أن تفقد المحتوى، وإن فقدت التعليقات والسجل والصلاحيات.

ماذا لو توقف Redis؟ What If

قد يبدو Redis مكوناً ثانوياً، فالصفحات كلها في PostgreSQL، فماذا يحدث إذا توقف؟ أوقفناه بالأمر docker compose stop redis وتركنا بقية الخدمات تعمل، ثم جربنا:

docker compose stop redis
curl -s -o /dev/null -w 'home %{http_code}\n' http://localhost:23100/
time curl -s -m 60 -X POST http://localhost:23100/api/auth/login -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","password":"…"}' -w '\nHTTP %{http_code}\n'

والمخرج سوف يكون كما يلي:

home 200
HTTP 000

real	1m0.132s

الصفحة الرئيسية ترد ب 200، فأي فحص صحة Health Check يطلب الصفحة الرئيسية سوف يقول إن كل شيء يعمل. ولكن طلب الدخول بقي معلقاً حتى قطعه curl بعد 60 ثانية دون أي رد، والرمز 000 يعني أنه لم يصل رد أصلاً، وفي المتصفح بقيت صفحة الدخول كما هي دون رسالة خطأ. وفي سجل Docmost ظهر السطر التالي مكرراً:

[ioredis] Unhandled error event: Error: connect ETIMEDOUT

ثم شغلنا Redis مرة أخرى بالأمر docker compose start redis، فنجح الدخول بعد ثوان ورد ب 200 دون أن نعيد تشغيل Docmost، لأن مكتبة ioredis تعيد الاتصال وحدها. والدرس العملي هنا أمران: الأول أن فحص الصحة يجب أن يختبر مساراً يحتاج Redis وقاعدة البيانات، مثل محاولة دخول بحساب للمراقبة، وليس الصفحة الرئيسية فقط، كما شرحنا في فحص التوفر Uptime Checks، والثاني أن Redis جزء من النسخة، فلا تشغله على سيرفر آخر بلا مراقبة، ولا تضع له حداً للذاكرة يجعله يتوقف.

خلف الـ Reverse Proxy مع WebSocket

على سيرفر حقيقي يكون Docmost خلف Reverse Proxy بشهادة TLS، والشرط الوحيد الخاص به هو تمرير WebSocket كما شرحنا في قسم المكونات. وهذا مثال لإعداد Caddy، وفيه يمرر Caddy ترويسات Upgrade تلقائياً:

wiki.example.com {
    reverse_proxy 127.0.0.1:23100
}

وإذا كنت تستخدم Nginx فأضف proxy_http_version 1.1 والترويستين Upgrade وConnection كما في تطبيقك خلف Reverse Proxy. ثم غير APP_URL إلى https://wiki.example.com، لأن Docmost يبني منه روابط الدعوات في البريد، ويبني الواجهة منه عنوان WebSocket فيستخدم wss:// إذا كان العنوان https://. وأسهل اختبار بعد الإعداد هو أن تفتح صفحة وتكتب فيها حرفاً، فإذا ظهرت رسالة أن المحرر للقراءة فقط، فالمشكلة في WebSocket وليست في Docmost.

النسخ الاحتياطي Backup ثم اختبار الاستعادة Restore

تقول صفحة النسخ الاحتياطي إن النسخة ثلاثة أشياء: نسخة من قاعدة البيانات بالأمر pg_dump، ومجلد التخزين، وملفات الإعداد ومعها APP_SECRET، وإن Redis لا يدخل في النسخة. فنفذنا الأوامر كما في التوثيق:

umask 077
bd=backups/docmost-$(date +%Y%m%d-%H%M%S); mkdir -p $bd
docker compose exec -T db pg_dump -U docmost -d docmost -Fc > $bd/docmost-database.dump
docker compose run --rm --no-deps -T --user root --entrypoint tar docmost \
  -czf - -C /app/data/storage . > $bd/docmost-storage.tar.gz
cp docker-compose.yml .env $bd/
ls -l $bd
-rw------- 1 wajdy 197609   1318 Nov  5 21:03 docker-compose.yml
-rw------- 1 wajdy 197609 208721 Nov  5 21:03 docmost-database.dump
-rw------- 1 wajdy 197609    310 Nov  5 21:03 docmost-storage.tar.gz

في الأوامر أعلاه لاحظ التالي:

  • umask 077 يجعل الملفات للمالك فقط، كما ترى في -rw-------، لأن النسخة فيها كل محتوى الشركة، وملف .env فيه الأسرار، ولا يظهر في ls -l لأنه يبدأ بنقطة.
  • -Fc يأخذ النسخة بالصيغة المخصصة Custom Format، وهي مضغوطة وتستعاد بالأمر pg_restore، وpg_dump يأخذ نسخة متسقة دون أن يوقف الموقع.
  • الأمر docker compose run --entrypoint tar docmost يشغل Container مؤقتاً من Docker Image الخاصة ب Docmost مع ال Volume نفسه، فيقرأ مجلد التخزين دون أن تعرف اسم ال Volume. وحجم ملف التخزين 310 بايت فقط لأنه لا توجد مرفقات في صفحاتنا، وفي فريق حقيقي سوف يكون أكبر ملف في النسخة.

ثم حذفنا كل شيء بالأمر docker compose down -v، أي أن الـ Volumes حذفت مع الـ Containers، واستعدنا بالترتيب الذي يذكره التوثيق: قاعدة البيانات وRedis أولاً، ثم الاستعادة، ثم التخزين، ثم Docmost:

docker compose down -v
docker compose up -d db redis
docker compose exec -T db pg_isready -U docmost -d docmost
docker compose exec -T db pg_restore -U docmost -d docmost \
  --clean --if-exists --no-owner --no-privileges --single-transaction < $bd/docmost-database.dump
docker compose run --rm --no-deps -T --user root --entrypoint tar docmost \
  -xzf - -C /app/data/storage < $bd/docmost-storage.tar.gz
docker compose up -d docmost
/var/run/postgresql:5432 - accepting connections
{"level":"info","context":"DatabaseMigrationService","msg":"No pending database migrations"}
{"level":"info","context":"NestApplication","msg":"Listening on http://127.0.0.1:3000 / http://localhost:23100"}

السطر «No pending database migrations» هو الدليل الأول على أن الاستعادة نجحت، فلو وجد Docmost قاعدة بيانات فارغة لنفذ تغييرات الجداول الثلاثة والخمسين من جديد وأنشأ مساحة عمل فارغة، وهذا أخطر ما يحدث في استعادة لأنه يبدو كأنه نجح. ثم تحققنا بثلاثة أشياء: عدد الصفحات غير المحذوفة في قاعدة البيانات 11، ودخل موظف الدعم بكلمة مروره فرد السيرفر ب 200، وأعاد البحث النتائج نفسها التي رأيناها قبل الحذف. ولاحظ أن التوثيق يطلب أن تستعيد بالإصدار نفسه من Docmost وبالإصدار الرئيسي نفسه من PostgreSQL، وأن تحدث بعد الاستعادة وليس أثناءها، ثم انقل ملفات النسخة خارج السيرفر كما في قاعدة 3-2-1.

من Confluence أو Notion إلى Docmost؟ Migration

أغلب الفرق التي تنظر إلى Docmost لا تبدأ من الصفر، وإنما عندها محتوى في أداة أخرى، وهنا يجب أن تعرف ما الذي يستورده كل نسخة قبل أن تعد الفريق بنقل سهل. فبحسب صفحة الأسعار وصفحة الاستيراد، النسخة المفتوحة تستورد ملفات Markdown وHTML وتصدير Notion بصيغة zip، أما المستورد الخاص ب Confluence، والاستيراد من DOCX وPDF، ففي Business. وهذا يعني أن الفريق الذي يخرج من Notion يستطيع أن يجرب النقل كاملاً في النسخة المفتوحة، ويقول التوثيق إن Docmost يحافظ عند استيراد Notion على شجرة الصفحات، أما الفريق الذي يخرج من Confluence Data Center قبل تاريخ نهايته فأمامه طريقان: أن يشتري Business ويستخدم المستورد الرسمي، أو أن يصدر المساحات من Confluence إلى HTML ويستوردها كملفات HTML عادية، وهذا الطريق الثاني لم نختبره في المقال، فجربه على مساحة صغيرة قبل أن تعتمد عليه، لأن الماكروهات Macros في Confluence، مثل جداول المحتويات والتنبيهات، لا يوجد لها مقابل في ملف HTML عادي.

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

التحديث Upgrade إلى إصدار أحدث

تقول صفحة التثبيت إن التحديث يبدأ بنسخة احتياطية، ثم تغيير الوسم في ملف Compose أو .env، مثل من 0.96.0 إلى 0.97.0، ثم:

docker compose pull docmost
docker compose up -d --force-recreate docmost
docker compose logs -f docmost

وعند التشغيل ينفذ Docmost تغييرات الجداول الجديدة تلقائياً، فتظهر أسطر «executed successfully» كما في التشغيل الأول. ولأن الإصدارات تحت 1.0 وتصدر كل شهر أو شهرين تقريباً، فاقرأ صفحة الإصدارات قبل كل تحديث، وخاصة قسم Security، فالإصدار 0.97.0 مثلاً نشر معه المشروع تنبيهات أمنية Security Advisories لثغرات أصلحتها إصدارات سابقة. ولا تتخط إصدارات كثيرة دفعة واحدة دون أن تقرأ ملاحظاتها، والسبب أن الرجوع إلى إصدار أقدم بعد تغيير الجداول لا يكون إلا من النسخة الاحتياطية.

كم يستهلك من الموارد؟ Resources

بعد الاستيراد والاختبارات أخذنا قراءة من الأمر docker stats:

wr-kb-dm-docmost-1 483.6MiB / 31.29GiB 0.21%
wr-kb-dm-db-1      126.9MiB / 31.29GiB 3.44%
wr-kb-dm-redis-1    15.68MiB / 31.29GiB 0.32%
wr-kb-dm-mailpit-1  26.14MiB / 31.29GiB 0.00%

أي نحو 630 ميجابايت للخدمات الثلاث الأساسية مع 11 صفحة ومستخدمين، وأغلبها ل Docmost نفسه لأنه تطبيق Node.js فيه الواجهة البرمجية وسيرفر الكتابة المشتركة. فسيرفر افتراضي VPS بذاكرة 2 جيجابايت يكفي لفريق بحجم فريقنا مع هامش، وسوف نقارن هذه الأرقام بالأدوات الأخرى على المحتوى نفسه في مقال المقارنة.

متى تختار Docmost؟ نقاط القوة Strengths ثم نقاط الضعف

نقاط القوة:

  • محرر قريب جداً من Notion وConfluence، بكتابة مشتركة تعمل دون أي إعداد، ومخططات وجداول وتبويبات داخل الصفحة، والفريق الذي جاء من هذه الأدوات لا يحتاج إلى تدريب تقريباً.
  • تثبيت بسيط: Container واحد مع PostgreSQL وRedis، والتشغيل الأول في أقل من 20 ثانية.
  • روابط ثابتة بمعرف لا يتغير إذا تغير العنوان، وصلاحيات المساحة تحترم في البحث وفي الطلب المباشر.
  • تصدير المساحة إلى Markdown بأسماء ملفات عربية سليمة، ونسخ احتياطي واستعادة موثقان وعملا كما في التوثيق.

نقاط الضعف:

  • لا يوجد دخول موحد ولا مصادقة ثنائية ولا قوالب ولا مفاتيح API في النسخة المفتوحة، وهذه ميزات يتوقعها أي فريق عنده authentik.
  • لا توجد واجهة عربية، وأرقام القوائم تبقى على اليسار، وبعض العناوين المختلطة تظهر بترتيب غير صحيح.
  • البحث بالإعداد english لا يفهم العربية، فلا يوحد الهمزة ولا يحذف «ال»، والنتيجة 8 من 12.
  • المساحة الجديدة خاصة افتراضياً، وهذا يحتاج إلى خطوة يتذكرها المدير في كل مساحة.
  • المشروع تحت الإصدار 1.0 وسريع التغير، فالتحديث يحتاج إلى متابعة.

والحكم لفريقنا: إذا كان الأهم عند الفريق هو تجربة الكتابة، وكان الدخول بكلمة مرور منفصلة مقبولاً، أو كانت الميزانية تسمح ب Business، فـ Docmost خيار جيد. أما إذا كان الدخول الموحد عبر authentik شرطاً، أو كانت العربية في الواجهة والبحث أهم من المحرر، فقارن قبل القرار، وهذا ما سوف نفعله في مقال المقارنة بين Outline وBookStack وWiki.js وDocmost على المحتوى نفسه.

قائمة تحقق Checklist قبل أن يبدأ الفريق

البندكيف تتحقق منه
الوسم ثابت والأسرار في .envDOCMOST_TAG رقم إصدار، وAPP_SECRET بطول 64 حرفاً محفوظ خارج السيرفر
صفحة الإعداد أكملها المدير قبل فتح الموقعمالك مساحة العمل هو الحساب الذي تتوقعه
البريد يعملدعوة تجريبية تصل، والرابط فيها يبدأ ب APP_URL الصحيح
كل مساحة مفتوحة فيها Everyone بدور القراءةحساب موظف عادي يرى المساحات المتوقعة فقط
المساحة المقيدة مقيدة فعلاًالبحث من حساب عادي لا يعيد صفحاتها، والطلب المباشر يعيد 404
WebSocket يعمل خلف ال Reverse Proxyمتصفحان على الصفحة نفسها يريان تعديلات بعضهما
فحص الصحة يختبر الدخولإيقاف Redis في بيئة تجريبية يطلق التنبيه
الفريق يعرف عادات البحثأول الكلمة مع «ال»، وTitle only للعناوين
النسخة الاحتياطية مختبرةاستعادة على Volumes فارغة، وفي السجل No pending database migrations
التحديث بعد قراءة ملاحظات الإصدارنسخة احتياطية قبله، وقسم Security مقروء

تدريب عملي Practice

  • أنشئ مساحة سادسة باسم «المنتج» ولا تضف إليها أحداً، ثم ادخل بحساب موظف عادي وتأكد أنها لا تظهر له ولا تظهر صفحاتها في البحث، ثم أضف Everyone بدور Can view وتأكد من العكس.
  • شغل Docmost خلف Caddy أو Nginx دون ترويسات WebSocket، وافتح صفحة في المحرر وسجل الرسالة التي تظهر، ثم أضف الترويسات وجرب الكتابة من متصفحين.

حذف المختبر Cleanup

docker compose down -v
docker rmi docmost/docmost:0.97.0 redis:8.10.3-alpine axllent/mailpit:v1.27
rm -rf backups

هذا المقال جزء من مرحلة التوثيق والمعرفة، وقبله مقال «قاعدة معرفة الفريق Wiki» الذي وضعنا فيه الصفحات والاستعلامات، وبعده Wiki.js مع مزامنة Git، ثم HedgeDoc، ثم المقارنة. وهذه المقالات المنشورة المرتبطة به:

دليلOutline: قاعدة معرفة فريقك على سيرفرككيف تشغل Outline على سيرفرك ليكتب فيه فريقك إجراءاته وقراراته، ويدخل إليه الموظفون بحساباتهم في authentik.دليلBookStack: توثيق فريقك في كتب وفصول على سيرفرككيف تشغل BookStack على سيرفرك وتنظم توثيق فريقك في أرفف وكتب وفصول، مع صلاحيات ودخول موحد وبحث بالعربية.دليلتثبيت authentik للدخول الموحد SSO إلى تطبيقاتككيف تثبت authentik حتى يدخل كل موظف إلى تطبيقات الفريق بحساب واحد، مع فرض المصادقة الثنائية على الجميع.دليلكيف يرى تطبيقك عنوان الزائر الحقيقي خلف ال Reverse Proxyإذا كان تطبيقك يرى عنوان ال Proxy بدلاً من الزائر أو يولد روابط http، فهذا هو السبب والإعداد الصحيح لإطار عملك.دليلالنسخ الاحتياطي بقاعدة 3-2-1 واختبار الاستعادةكيف تحدد كم بيانات تقبل أن تخسر، وتبني نسخاً لا يستطيع المخترق حذفها، وتتأكد أنك تستطيع استعادتها فعلاً.

الخلاصة Summary

وصلنا لنهاية الموضوع، وأهم ما فيه:

  • Docmost Wiki مفتوحة المصدر بترخيص AGPL-3.0 قريبة من Confluence وNotion، فيها مساحات وصفحات متداخلة ومحرر غني وكتابة مشتركة، وآخر إصدار 0.97.0.
  • الدخول الموحد والمصادقة الثنائية والقوالب والصلاحيات على الصفحة ومفاتيح API في Business بسعر 6 دولارات للمستخدم شهرياً، أي 1,008 دولارات سنوياً لفريق من 14 شخصاً.
  • يحتاج إلى PostgreSQL وRedis، والكتابة المشتركة بال Yjs عبر WebSocket على المسار /collab، فإذا لم يمررها ال Reverse Proxy أصبح المحرر للقراءة فقط.
  • التشغيل الأول في 18 ثانية مع 53 تغييراً على الجداول، والاستيراد من Markdown نقل الصفحات الإحدى عشرة كما هي، والرابط بمعرف ثابت.
  • المساحة الجديدة خاصة بمن أنشأها، فأضف Everyone بدور القراءة إلى كل مساحة مفتوحة، والمساحة المقيدة تختفي من البحث وتعيد 404.
  • البحث بإعداد english مع بحث بأول الكلمة: 8 من 12، وTitle only يجد الحروف في أي موضع من العنوان: 7 من 12، ولا توجد واجهة عربية، وأرقام القوائم على اليسار.
  • إذا توقف Redis ردت الصفحة الرئيسية ب 200 وعلق الدخول 60 ثانية، والاستعادة من pg_dump ومجلد التخزين عملت كاملة.

وفي المقال القادم بإذن الله نشغل Wiki.js 3.1 على الصفحات نفسها، ونربطه بمستودع Git لكي تصبح كل صفحة ملف Markdown يراجع كما يراجع الكود.

سجل التحديثات Changelog

  • نوفمبر 2026: كتابة الدليل واختباره على Docmost 0.97.0 من docmost/docmost:0.97.0 مع postgres:18.6-alpine وredis:8.10.3-alpine وaxllent/mailpit:v1.27 على Docker Engine 29.8.0، والأسعار والميزات من صفحة الأسعار الرسمية في 5 نوفمبر 2026.
نشرة عرب رووت | ArabRoot

معرفة تستحق مكاناً في بريدك.

مقالات مختارة وأدوات مفيدة وأفكار لمشروعك القادم، في رسالة واحدة كل أسبوع.

يمكنك إلغاء الاشتراك متى شئت. الخصوصية

تم استلام طلبك. افتح بريدك واضغط رابط التأكيد لإتمام الاشتراك.