في فريق نقاط البيع الذي نتابعه في هذه المرحلة طلب واحد يتكرر من المطورين ومهندسي العمليات كلما تحدثنا عن الـ Wiki: «لا نريد محرراً جديداً، نريد أن نكتب Markdown في المحرر الذي نستخدمه للكود، وأن تمر الصفحات في Git كما يمر الكود». وهذا طلب منطقي من أشخاص يقضون يومهم في المستودعات، فدليل استعادة قاعدة البيانات Database يتغير مع تغير السكربتات، ومن الطبيعي أن يتغير معها في الطلب نفسه. ولكن في الفريق نفسه موظفو دعم ومبيعات لن يفتحوا Git أبداً، ويريدون أن يعدلوا الصفحة من المتصفح. فهل توجد أداة تخدم الطرفين على المحتوى نفسه؟
هذا ما يعد به Wiki.js: Wiki مفتوحة المصدر تكتب فيها من المتصفح، وتحفظ كل صفحة في الوقت نفسه ملفاً في مستودع Git يتزامن مع GitHub أو GitLab أو Gitea في الاتجاهين. ولكن التوقيت هنا مهم، فقد صدر Wiki.js 3.0 المستقر في 1 نوفمبر 2026 بعد إعادة كتابة كاملة للمشروع، ثم 3.0.2 في 2 نوفمبر، ثم 3.1.0 في 5 نوفمبر ومعه إصلاحات لعدة ثغرات أمنية. أي أن أغلب ما تجده على الإنترنت عن Wiki.js يخص الإصدار 2.x، وكثير منه لا ينطبق على الإصدار الجديد. لذلك شغلنا 3.1.0 على صفحات الفريق الإحدى عشرة نفسها، وربطناه بمستودع على Gitea، وجربنا كل اتجاه من اتجاهات المزامنة، ومنها التعارض.
وسوف نناقش في هذا المقال ما يلي:
- ما الجديد في Wiki.js 3، وما يحتاجه من السيرفر.
- التثبيت بال Docker Compose مع PostgreSQL، والتشغيل الأول.
- إضافة الصفحات، ومشكلة الصفحة الفارغة عند الإنشاء عبر ال API.
- العربية: اللغة واتجاه النص والترجمة، والبحث الذي يتغير قاموسه بحسب لغة الصفحة.
- ربط الصفحات بمستودع Git، والتعديل من المستودع، وماذا يحدث إذا تغير السطر نفسه في الطرفين.
- الصلاحيات Permissions بقواعد المسارات، وهل المستودع نسخة احتياطية، والتحديث ونقاط القوة والضعف.
ما الجديد في Wiki.js 3؟ Wiki.js 3.0
Wiki.js مشروع بدأه Nicolas Giard سنة 2017، وترخيصه AGPL-3.0، وكان الإصدار 2.x لسنوات من أشهر أدوات الـ Wiki التي تستضيفها الفرق بنفسها. ويقول إعلان الإصدار 3.0 إنه إعادة كتابة كاملة للخلفية والواجهة لكي يعالج مشكلات أساسية في 2.x، وإن ما أتاحته إعادة الكتابة هو تعدد المواقع Multi-site، والكتابة المشتركة في الوقت الفعلي، والكتل الديناميكية Content Blocks، والتوافرية Availability العالية High Availability. ومن الإعلان نفسه ما يهم فريقنا مباشرة:
- المحررات Editors: محرر Markdown مبني على Monaco، وهو محرر VS Code نفسه، ومحرر مرئي جديد يحفظ المحتوى بصيغة Markdown خلف الواجهة، ومحرر AsciiDoc، وكلها تدعم الكتابة المشتركة.
- أنواع صفحات جديدة: الرسم بال Excalidraw، ولوحات الاقتراحات Feedback Boards، والمدونة Blog، والملاحظات الحية Live Notes.
- الموافقات Approvals وقواعد دورة الحياة Lifecycle Rules: مجموعة تقترح تعديلات ومجموعة أخرى تراجعها، وتنبيه على الصفحة التي لم تحدث منذ ثلاثة أشهر يرسل إلى مالكيها، وهذا ما وصفناه في مقال «قاعدة معرفة الفريق Wiki» من هذه المرحلة حين تحدثنا عن الملكية والمراجعة.
- التعليقات Comments والتعليقات على المقاطع Annotations: في تبويب Talk لكل صفحة.
والنقطة التي لا تظهر في الإعلان ولكنها تظهر عند التثبيت هي أن Wiki.js يأتي بعدة امتدادات Extensions داخل Docker Image الخاصة به، فعند التشغيل كتب في السجل أن git وpandoc وpuppeteer وsharp مثبتة، والمهم منها لنا هو puppeteer، أي متصفح Chromium كامل يشغله السيرفر بلا شاشة، وسوف نرى لماذا يحتاجه.
ما تحتاجه قبل التثبيت Requirements
بحسب صفحة المتطلبات، يحتاج Wiki.js 3 إلى ما يلي:
- PostgreSQL 17 أو 18 فقط، مع الإضافتين ltree وpg_trgm، وهما موجودتان في Docker Image الرسمية ل PostgreSQL. ولم يعد يدعم MySQL أو SQLite كما كان 2.x، فإذا كنت تشغل 2.x على قاعدة أخرى فالنقل يمر عبر دليل الترقية من 2.x.
- Node.js 26 إذا ثبته دون Docker، والصفحة تقول إن الإصدارات الأقدم لن تعمل.
- ذاكرة 1 جيجابايت على الأقل على Linux، ونواة واحدة تكفي ونواتان أفضل للمهام الخلفية Workers.
- نطاق فرعي خاص به مثل
wiki.example.com، والتوثيق يقول بوضوح إن التثبيت في مسار فرعي مثل/wiki/على نطاق موجود غير مدعوم ولن يدعم. - اتصال صادر إلى
api.github.comللتحقق من الإصدارات، وgithub.comلجلب ملفات الترجمة، وapi.iconify.designللأيقونات.
والصفحة نفسها تقول إن حجم Docker Image نحو 850 ميجابايت لأنها تحمل كل الامتدادات، ولكن بعد التنزيل وفك الضغط أظهر الأمر docker images عندنا الحجم 3.45 جيجابايت على القرص، واستغرق التنزيل نحو أربع دقائق، فخصص مساحة كافية قبل أن تبدأ، خاصة إذا احتفظت بالإصدار السابق عند التحديث.
التثبيت مع Docker Compose Installation
الملف التالي مبني على صفحة التثبيت، ومعه Gitea في الملف نفسه لأننا سوف نربط الـ Wiki بمستودع، وعلى سيرفرك يكون Gitea غالباً موجوداً في مكانه كما في دليل تثبيت Gitea، أو تستخدم GitHub أو GitLab:
ملف compose.yaml
name: wr-kb-wj
services:
db:
image: postgres:18.6-alpine
environment:
POSTGRES_DB: wiki
POSTGRES_USER: wiki
POSTGRES_PASSWORD: ${DB_PASSWORD}
healthcheck:
test: ["CMD-SHELL", "pg_isready -U wiki -d wiki"]
interval: 5s
retries: 20
restart: unless-stopped
volumes:
- db-data:/var/lib/postgresql
wiki:
image: ghcr.io/requarks/wiki:${WIKI_TAG}
depends_on:
db:
condition: service_healthy
environment:
ADMIN_EMAIL: [email protected]
ADMIN_PASS: ${ADMIN_PASS}
DB_HOST: db
DB_NAME: wiki
DB_USER: wiki
DB_PASS: ${DB_PASSWORD}
restart: unless-stopped
ports:
- "127.0.0.1:23200:3000"
gitea:
image: gitea/gitea:28.3.0-rootless
environment:
GITEA__security__INSTALL_LOCK: "true"
GITEA__database__DB_TYPE: sqlite3
GITEA__server__ROOT_URL: http://gitea:3000/
GITEA__server__HTTP_PORT: "3000"
GITEA__service__DISABLE_REGISTRATION: "true"
restart: unless-stopped
ports:
- "127.0.0.1:23230:3000"
volumes:
- gitea-data:/var/lib/gitea
- gitea-config:/etc/gitea
volumes:
db-data:
gitea-data:
gitea-config:وبجانبه ملف .env فيه WIKI_TAG=3.1.0 وكلمة مرور قاعدة البيانات المولدة بالأمر openssl rand -hex 16 وكلمة مرور المدير الأولى. وفي الإعداد أعلاه لاحظ التالي:
- التوثيق ينصح بالوسم
ghcr.io/requarks/wiki:3لكي تصلك الإصدارات الفرعية تلقائياً، ويحذر منlatestالذي لم يعد يوضع على 3.x أصلاً، أما نحن فثبتنا3.1.0لأن المشروع في أيامه الأولى بعد إعادة الكتابة، وصدرت منه ثلاثة إصدارات في خمسة أيام، فالأفضل أن يكون التحديث قراراً بعد قراءة ملاحظاته. ADMIN_EMAILوADMIN_PASSتنشئان المدير الأول عند التشغيل الأول فقط، ولا أثر لهما بعد ذلك، فإذا تركتهما فارغين يكون الدخول بالبريد[email protected]وكلمة المرور Password12345678كما يقول التوثيق، وهي قيم يعرفها كل من قرأه.- لا يوجد Volume لخدمة
wikiنفسها، لأن كل شيء في قاعدة البيانات، حتى المرفقات بشكل افتراضي، والمستودع المحلي لمزامنة Git يعاد بناؤه من المستودع البعيد عند الحاجة كما يقول تعريف وحدة Git. - لا يوجد Redis، فالمهام الخلفية وتنسيق الكتابة المشتركة بين أكثر من نسخة يمران عبر PostgreSQL نفسها، بحسب صفحة التثبيت التي تقول إن النسخ المتعددة تتنسق عبر قاعدة البيانات ولا تحتاج جلسات لاصقة Sticky Sessions.
التشغيل الأول First Start
بعد docker compose up -d مرت 56 ثانية حتى ردت الصفحة الرئيسية ب 200، أغلبها في انتظار قاعدة البيانات وتشغيل Container الكبير، وهذه أهم أسطر السجل:
info: = Wiki.js 3.1.0 =======================
info: Running node.js v26.13.0 [ OK ]
info: Using PostgreSQL v18.6.0 [ OK ]
info: Ensuring required DB extensions are installed...
info: Ensuring DB migrations have been applied...
warn: No settings found in DB. Initializing with defaults...
info: Inserting default site...
info: Inserting default groups...
info: Inserting default users...
info: HTTP Server: [ RUNNING ]
info: Extension git is installed. [ OK ]
info: Extension puppeteer is installed. [ OK ]
info: Collaborative editing initialized successfully: [ OK ]
info: Scheduler: [ STARTED ]السطر No settings found in DB يظهر بالتحذير warn في التشغيل الأول فقط، ومعناه أن قاعدة البيانات فارغة فأنشأ Wiki.js الموقع الافتراضي والمجموعات والمستخدمين، فإذا رأيته بعد استعادة نسخة احتياطية فالاستعادة لم تنجح. والمجموعات التي أنشأها ثلاث: Administrators، وGuests للزوار غير المسجلين، وUsers لكل من يدخل. وقد طلبنا قواعد مجموعة Guests فوجدنا فيها قاعدة واحدة من نوع DENY على القراءة في كل المسارات، أي أن الـ Wiki الجديدة لا يقرؤها أحد دون دخول، وهذا خيار افتراضي آمن لقاعدة معرفة داخلية، وتأكدنا منه بطلب بحث دون جلسة فرجع {"results":[],"totalHits":0}.
إضافة صفحات الفريق Pages
في Wiki.js لا توجد مساحات بالمعنى الذي رأيناه في Docmost، وإنما مسارات Paths مثل المجلدات، فالصفحة ops/add-restaurant في المجلد ops، وكل مجلد يقابل مساحة من المساحات الخمس في فريقنا: ops وsupport وtech وsales وhr. والصلاحيات تكتب على المسارات كما سوف نرى. ولكل صفحة لغة Locale، وهذا مهم للبحث كما سوف نرى أيضاً. وأنشأنا الصفحات الإحدى عشرة بسكربت يسجل الدخول في متصفح Chrome بلا شاشة، ثم يرسل إلى ال API الخاص ب Wiki.js 3 الطلب POST /_api/sites/:siteId/pages لكل صفحة:
const r = await b.api('POST', `/sites/${site}/pages`, {
path: `${folder[p.space]}/${slug[p.key]}`, locale: 'en', title: p.title,
editor: 'markdown', content, publishState: 'published' });ورجع كل طلب ب 200 ومعه معرف الصفحة. ولاحظ أن Wiki.js 3 فيه API REST موثق على المسار /_api، ومفاتيح API ورموز شخصية Personal Tokens في النسخة نفسها، فلا توجد نسخة مدفوعة، وكل ما في المشروع مجاني.
المشكلة: صفحة فارغة بعد الإنشاء عبر ال API Render
عندما فتحنا صفحة «إجراء إضافة مطعم جديد» ظهر العنوان، وظهرت الصفحة في القائمة الجانبية، ولكن المحتوى كان فارغاً تماماً:

وكذلك البحث، فقد شغلنا الاستعلامات Queries الاثني عشر فكانت النتيجة 5 من 12، كلها كلمات في العناوين، فالاستعلام «إجراء» وجد صفحة الإجراء لأن الكلمة في عنوانها، ولم يجد «دليل الموظف الجديد» مع أن الكلمة في محتواها. وعندما نظرنا في جدول الصفحات وجدنا أن العمودين render وsearchContent طولهما صفر لكل الصفحات. والسبب في وصف ال API نفسه: الطلب يحمل المصدر content، ويحمل أيضاً render، وهو HTML الذي ينتجه المحرر في المتصفح، ومنه يبني السيرفر الصفحة المعروضة ونص البحث. فإذا لم ترسله فلا يوجد ما يعرض ولا ما يبحث فيه. وفي Wiki.js 3 تحول Markdown إلى HTML يحدث في الواجهة وليس في السيرفر، ولذلك يحتاج السيرفر إلى puppeteer: فالطلب POST /_api/sites/:siteId/pages/:pageId/render يضع الصفحة في طابور، ثم يفتحها السيرفر في Chromium بلا شاشة، ويشغل عليها كود الواجهة نفسه، ويحفظ الناتج:
58ab82b0-a752-469d-94a7-338ede9cd928 202 Page queued for rendering.
c849f4aa-824b-4d06-87e3-ca15a7ec0b10 202 Page queued for rendering.
...والرمز 202 Accepted يعني أن الطلب قبل وسوف ينفذ لاحقاً، فالمتصفح أثقل من أن ينتظر الطلب انتهاءه. وبعد ثوان أصبح طول render بين 338 و505 حروف لكل صفحة، وظهر المحتوى، وأصبح البحث 7 من 12. وأول طلب أرسلناه دون جسم رفضه السيرفر بالرسالة Body cannot be empty when content-type is set to 'application/json'، فأرسلنا جسماً فارغاً {}. والدرس لمن ينقل محتوى إلى Wiki.js 3 بسكربت: إما أن ترسل render مع كل صفحة، أو أن تطلب التوليد من السيرفر بعدها، أو أن تستورد من Git كما سوف نرى، فالاستيراد من المستودع يولد الصفحات تلقائياً. أما من يكتب من المحرر فلا يرى هذه المشكلة أبداً، لأن المتصفح يرسل الاثنين.
أفضل طريق لنقل المحتوى: الاستيراد من Git Import
بعد مشكلة الصفحة الفارغة، وبعد تجربة البناء من المستودع التي سوف نشرحها في قسم النسخ الاحتياطي، وصلنا إلى أن أسهل طريق لنقل معرفة موجودة إلى Wiki.js 3 ليس ال API، وإنما المستودع نفسه. فإذا كانت صفحاتك ملفات Markdown في مجلد، أو صدرتها من أداة أخرى، فضعها في مستودع بمجلد للغة مثل ar، وتحته مجلدات المساحات، وفي أول كل ملف ترويسة فيها title على الأقل، ثم اربط المستودع بهدف Git وشغل Import Everything. وعندها يقرأ Wiki.js الملفات، وينشئ الصفحات، ويولدها بنفسه في الخلفية، فتظهر كاملة ويبحث فيها دون أي خطوة إضافية، وقد أعاد بهذه الطريقة الصفحات الاثنتين والعشرين كلها كاملة في تجربتنا. والتحذير الذي يكتبه التعريف بجانب هذا الإجراء يستحق أن تقرأه: المستودع يفوز في كل تعارض، إلا مع تعديلات لم تنشر بعد في الـ Wiki، والملف المرفق الذي يستبدل يضيع من كل أهداف التخزين. لذلك شغله على Wiki جديدة أو بعد نسخة احتياطية، وليس على Wiki يكتب فيها الفريق.
العربية في Wiki.js: اللغة Locale مع اتجاه النص RTL
لاحظ في الصورة السابقة أن الحروف العربية في العنوان والقائمة الجانبية متباعدة لا تتصل، والسبب أن الواجهة الإنجليزية تضيف تباعداً بين الحروف Letter Spacing في بعض العناوين، وهذا لا يضر الحروف اللاتينية، ولكنه يفصل الحروف العربية عن بعضها. والحل أن تكون لغة الموقع العربية، وهنا ظهرت خطوة لم نتوقعها: الأمر POST /_api/locales/ar/install رجع بالرسالة Locale ar is not published upstream، لأن رمز اللغة في قائمة اللغات هو ar-SA وليس ar. فثبتناها بهذا الرمز، ثم جعلناها اللغة الأساسية للموقع مع إبقاء الإنجليزية نشطة، فأصبحت الصفحة كما يلي:

الواجهة كلها انقلبت من اليمين إلى اليسار، والقائمة الجانبية على اليمين، وأرقام القائمة المرقمة على يمين النص في مكانها الصحيح، وهذا ما لم يفعله Docmost في مقاله. ولكن الأزرار والقوائم بقيت بالإنجليزية، والسبب يظهر في شاشة اللغات في الإدارة:

نسبة الترجمة العربية صفر، أي أن ملف اللغة موجود بخصائصه، ومنها الاتجاه من اليمين إلى اليسار، ولكن لم يترجم منه أي نص بعد لأن الإصدار 3 صدر قبل أيام، والترجمات تأتي من المتطوعين. فإذا كان فريقك يحتاج واجهة عربية فهذه فرصة لأن يساهم أحد أفراده في الترجمة من زر Contribute في الشاشة نفسها، وإلى أن يحدث ذلك تبقى الأزرار بالإنجليزية.
البحث بالعربية Arabic Search: القاموس بحسب لغة الصفحة
هنا أهم نقطة في هذا المقال للفرق العربية. ففي ملف search.ts جدول يقابل كل لغة بقاموس البحث في PostgreSQL، وأوله ar: 'arabic'، ويقول التعليق فوقه إن كل لغة يوجد لها محلل Snowball في PostgreSQL تستخدمه، وما عداها يستخدم simple. ويبنى عمود البحث ts لكل صفحة بقاموس لغتها، ويحلل الاستعلام بالقاموس نفسه عبر websearch_to_tsquery. أي أن الصفحة العربية المسجلة بلغة en تفهرس بالقاموس الإنجليزي، وهذا ما حدث مع صفحاتنا الأولى. فأنشأنا الصفحات الإحدى عشرة مرة ثانية بلغة ar-SA، وشغلنا الاستعلامات على كل لغة وحدها:

بلغة ar-SA أصبحت النتيجة 8 من 12، وهي النتيجة نفسها التي حصلنا عليها من المحلل العربي مباشرة في مختبر مقال قاعدة المعرفة، والفرق الوحيد عن en هو «اجراء» دون همزة، لأن محلل Snowball العربي يوحد الهمزة. أما الأربعة الباقية فهي نفسها لأسبابها التي شرحناها هناك: «الفاتوره» بالهاء، و«سيرفر» التي يحولها المحلل إلى «يرفر»، و«مستوي» بالياء. والخامسة «postgres» لا يجدها Wiki.js بأي لغة، لأن websearch_to_tsquery يطابق الكلمة كاملة ولا يبحث بأول الكلمة كما يفعل Docmost بالنجمة.
والقاعدة العملية من هذا القسم: اجعل العربية اللغة الأساسية للموقع من اليوم الأول، قبل أن يكتب أحد أي صفحة، لأن الصفحة تأخذ لغتها عند إنشائها، ولأن تغيير لغة الصفحات لاحقاً نقل لها وليس تعديلاً لإعداد. ويقول التعليق في الملف نفسه إن المدير يستطيع أن يغير القاموس لأي لغة من منطقة الإدارة، فإذا أضفت إلى PostgreSQL قاموساً عربياً أفضل يمكنك أن تربطه بالعربية دون تغيير الكود.
ربط الصفحات بمستودع Git Storage
في Wiki.js 3 سبع وحدات تخزين Storage Modules بحسب السجل: قاعدة البيانات، والقرص، وGit، وS3، وAzure، وGoogle Cloud Storage، وSFTP. وقاعدة البيانات مفعلة دائماً ولا يمكن تعطيلها، والبقية أهداف إضافية Targets. والفكرة المهمة التي يشرحها تعريف وحدة Git هي أن المحتوى يكتب إلى كل هدف مفعل، ولكن الصفحة تقرأ دائماً من قاعدة البيانات، أي أن المستودع ليس المكان الذي يعرض منه الموقع، وإنما نسخة ثانية تتبادل معها التعديلات، والصورة التالية تبين الدورة:

إعداد هدف Git Target
أنشأنا في Gitea مستخدماً ومستودعاً خاصاً فارغاً اسمه kb/wiki، ورمز وصول Access Token بصلاحية write:repository، ثم فعلنا هدف Git بالإعدادات التالية، وهي الحقول نفسها التي تراها في شاشة Storage في منطقة الإدارة:
config: { authType: 'basic', repoUrl: 'http://gitea:3000/kb/wiki.git', branch: 'main', syncMode: 'sync',
basicUsername: 'kb', basicPassword: token, alwaysUseDefaultAuthor: false,
defaultName: 'Wiki.js', defaultEmail: '[email protected]', localRepoPath: './data/repo' }
في الإعداد أعلاه لاحظ التالي:
authTypeبقيمةbasicمع رمز الوصول بدلاً من كلمة المرور، والتعريف ينصح ب SSH كخيار أكثر أماناً، وفي SSH يجب ألا يكون على المفتاح الخاص Private Key كلمة مرور.syncModeله ثلاث قيم:syncيسحب ثم يدفع، وpushيدفع بالقوة Force Push فتفوز الـ Wiki دائماً ولا تأخذ شيئاً، وpullيأخذ فقط ولا يكتب، فيصبح المستودع هو المرجع. وسوف نعود إلى هذا الاختيار في قسم سير العمل Workflow.alwaysUseDefaultAuthorإذا فعلته تكتب كل Commits باسم المؤلف الافتراضي، فلا يصل اسم أي موظف ولا بريده إلى المستودع، وهذا مهم إذا كان المستودع على خدمة خارجية.repoUrlإذا تركته فارغاً يبقى المستودع محلياً على قرص النسخة فقط، ويحتاج عندها إلى Volume دائم ونسخة واحدة من Wiki.js.
أول Commit: الصفحات التي سبقت المزامنة
الصفحات التي أنشئت قبل تفعيل Git لا تدخل المستودع وحدها، ويسميها التعريف غير متتبعة Untracked، ولها زر Add Untracked Changes، فشغلناه فكان الرد:
Synced. The remote did not have this branch yet, and 0 queued change(s) created it.
Committed the untracked part of 22 page(s) and 0 asset(s).الصفحات 22 لأن لدينا الصفحات الإحدى عشرة بلغتين. ثم نسخنا المستودع على الجهاز بالأمر git clone، فوجدنا مجلداً لكل لغة، وفي كل مجلد مسارات الصفحات نفسها، مثل ar/tech/vpn-access.md وen/tech/vpn-access.md، وفي أول كل ملف ترويسة YAML Front Matter:
---
title: الدخول إلى السيرفرات عبر VPN
description: ''
published: true
date: '2026-11-05T18:36:15.903Z'
tags: []
editor: markdown
dateCreated: '2026-11-05T18:36:15.903Z'
---
لا تفتح أي منفذ SSH على الإنترنت. الدخول للسيرفرات يكون عبر شبكة WireGuard الخاصة فقط.والترويسة تحمل ما لا يحمله Markdown نفسه: العنوان، والوصف، وحالة النشر، والوسوم، ونوع المحرر، وتاريخ الإنشاء والتعديل. ولاحظ أن اسم المجلد ar وليس ar-SA، لأن المستودع يستخدم رمز اللغة المختصر. والمهم هنا أن المستودع يقرأ في أي محرر نصوص، وأن كل صفحة ملف Markdown عادي، فإذا تركت Wiki.js يوماً ما فالمحتوى معك بشكل يقرؤه أي نظام آخر.
تعديل من المستودع Git to Wiki
الآن الاتجاه الثاني الذي طلبه المهندسون: أضفنا في الملف ar/tech/vpn-access.md خطوة رابعة عن ضبط ساعة الجهاز، ثم Commit وPush باسم «مهندس العمليات»، ثم ضغطنا Force Sync بدلاً من انتظار المزامنة الدورية كل خمس دقائق:
git commit -qam "VPN: خطوة رابعة عند فشل الاتصال" && git pushSynced. Took in 1 page(s) and 0 asset(s).والصفحة في المتصفح ظهرت فيها الخطوة الرابعة مباشرة، كما رأيت في صورة الصفحة العربية أعلاه، وفي سجل الصفحة History ظهرت نسخة جديدة. ولكن لاحظ أمراً يهمك إذا كانت المراجعة مهمة في فريقك: النسخة الجديدة في سجل Wiki.js سجلت باسم Administrator، وليس باسم «مهندس العمليات» الذي كتب ال Commit، فالسجل الصحيح لمن غير ماذا في هذه الحالة هو سجل Git نفسه، وهذه صورته في Gitea بعد كل التجارب:

ماذا لو تغير السطر نفسه في الطرفين؟ What If
هذه هي التجربة التي يجب أن تجريها قبل أن تعد الفريق بأن «الطرفين يعملان معاً». ففي Wiki.js عدلنا السطر الأول من صفحة VPN إلى «لا تفتح أي منفذ SSH أو RDP على الإنترنت»، وفي الوقت نفسه، قبل أي مزامنة، عدل مهندس العمليات السطر نفسه في المستودع إلى «لا تفتح أي منفذ SSH أو منفذ قاعدة البيانات على الإنترنت» ودفعه. ثم ضغطنا Force Sync:
Synced. Took in 1 page(s) and 0 asset(s). 1 file(s) had changed both here and on the remote,
and the remote's version won. A page it replaced keeps its previous version in its history; a file has none.وفي سجل Wiki.js الأسطر التالية:
info: (STORAGE/GIT) Rebasing onto origin/main...
warn: (STORAGE/GIT) Rolling back an unfinished rebase...
warn: (STORAGE/GIT) 1 path(s) conflict with origin/main; taking the remote's version...
info: (STORAGE/GIT) Pushing to origin/main...ولنقرأ ما حدث خطوة خطوة: حاول Wiki.js أن يضع Commit الخاص به فوق آخر ما في المستودع البعيد بال Rebase، فوجد تعارضاً Conflict في الملف نفسه، فتراجع عن ال Rebase، وأخذ نسخة المستودع البعيد للملف المتعارض، ثم دفع. والنتيجة أن الصفحة الآن فيها «منفذ قاعدة البيانات»، وتعديل «RDP» الذي كتب في المتصفح لم يعد في الصفحة، ولكنه لم يضع، فهو نسخة في سجل الصفحة يمكن استعادتها. وهذا تصميم معقول، لأن البديل هو أن تتوقف المزامنة كلها حتى يحل شخص التعارض يدوياً، ولكنه يعني أن الكاتب في المتصفح قد يخسر تعديله دون أن يعرف، والرسالة نفسها تقول إن الملف المرفق، مثل صورة، ليس له سجل فإذا استبدل ضاع. لذلك اتفق مع الفريق على قاعدة بسيطة: الصفحات التي يعدلها المهندسون من المستودع، مثل أدلة التشغيل، لا تعدل من المتصفح، والعكس صحيح لصفحات الدعم والمبيعات.
مراجعة قبل النشر؟ Review Workflow
بعض الفرق تريد أن تمر كل تعديلات أدلة التشغيل بطلب دمج Pull Request يراجعه شخص آخر قبل أن تظهر في الـ Wiki، كما يمر الكود. وهنا يفيد الخيار pull في syncMode: فالمستودع يصبح المرجع، والفرع main لا يدخله إلا ما دمج بعد المراجعة، والـ Wiki تأخذ منه فقط ولا تكتب إليه، فأي تعديل في المتصفح لن يصل إلى المستودع. وهذا يناسب مجلداً واحداً مثل أدلة التشغيل، ولكنه لا يناسب الـ Wiki كلها، لأن موظف الدعم لن يفتح طلب دمج. والحل الذي يقدمه Wiki.js 3 للجميع هو الموافقات Approvals، حيث تقترح مجموعة تعديلاً وتراجعه مجموعة أخرى من داخل الـ Wiki، ويمكن أن تحصر قاعدة الموافقة في مسار معين. وقد شرحنا أساسيات طلبات الدمج والفروع في إدارة النسخ وGit للمبتدئين.
الدخول الموحد Authentication: ما المتاح دون اشتراك؟
في فريقنا يدخل الموظفون إلى Outline وBookStack وMattermost بحساباتهم في authentik، ورأينا في مقال Docmost أن الدخول الموحد هناك في النسخة المدفوعة فقط. أما في Wiki.js 3.1 فقد طلبنا قائمة وحدات الدخول من المسار /_api/authentication/modules فكانت ثمانية:
local:Local Database | discord:Discord | github:GitHub | google:Google | ldap:LDAP / Active Directory |
entra:Microsoft Entra ID | oidc:OpenID Connect / OAuth2 | saml:SAML 2.0أي أن OpenID Connect وSAML وLDAP كلها في النسخة نفسها دون مفتاح ترخيص، وتربط authentik بوحدة oidc بالطريقة التي شرحناها في شرح OAuth وOpenID Connect: عنوان المصدر Issuer، ومعرف العميل وسره، وعنوان العودة الذي يبنيه Wiki.js من ترويسات ال Reverse Proxy كما ذكرنا. ولم نربطه ب authentik في هذا المقال لأن تركيزه على Git والبحث، ولكن انتبه إلى سطرين في ملاحظات الإصدارات قبل أن تبدأ: الإصدار 3.1.0 أضاف خياراً يسمح بعناوين OIDC عبر http العادي وجعله معطلاً افتراضياً، فإذا كان authentik عندك عبر https كما يجب فلا تحتاجه، وأصلح الإصدار 3.0.2 ثغرة كانت تترك جلسات المستخدم صالحة بعد تعطيل حسابه أو تغيير مجموعاته، وهذا بالضبط ما تعتمد عليه عندما يغادر موظف وتعطل حسابه في مكان واحد. ومع الدخول الموحد تصبح المجموعات في Wiki.js هي ما يحدد الصلاحيات، فخطط من الآن لربط مجموعات authentik بمجموعات Wiki.js، بدلاً من إضافة كل موظف يدوياً.
الصلاحيات بالقواعد Page Rules
الصلاحيات في Wiki.js قواعد Rules على المجموعات، وكل قاعدة فيها أدوار مثل read:pages وwrite:pages، ونوع المطابقة على المسار، مثل أن يبدأ المسار ب hr، والنتيجة ALLOW أو DENY، ويمكن أن تقيد القاعدة بلغة أو وسم أو موقع. ومجموعة Users عندها افتراضياً قاعدة واحدة اسمها Default Rule تسمح بقراءة كل الصفحات والتعليق عليها، وهذا يوافق قاعدة فريقنا بأن القراءة مفتوحة. فأضفنا إلى المجموعة قاعدة ثانية من نوع DENY على القراءة في المسارات التي تبدأ ب hr، وأنشأنا موظف الدعم في مجموعة Users، ثم دخلنا بحسابه:
support search الإجازات -> 0
support search إجراء -> 2 ops/add-restaurant,ops/new-employee
hr page: 403 | Unauthorized | You don't have the required permissions to access this page.
البحث يحترم القاعدة، فلا تظهر صفحة الإجازات في النتائج، وصفحات العمليات تظهر. ولكن الفتح المباشر يعيد 403 برسالة صريحة، وهذا يختلف عن Docmost الذي أعاد 404. وفي أغلب الحالات لا يهم ذلك، ولكن اعرف أن من يعرف المسار يعرف أن الصفحة موجودة، فلا تضع معلومة حساسة في مسار الصفحة نفسه. وميزة القواعد على المسارات أنها أدق من صلاحيات المساحات، فتستطيع أن تمنع صفحة واحدة، أو أن تسمح لمجموعة المبيعات بالكتابة في sales فقط، وعيبها أن القاعدة المكتوبة على مسار تتأثر بنقل الصفحات، فالصفحة التي تنقل من hr إلى مكان آخر تخرج من القاعدة.
المسارات Paths بدلاً من المساحات: كيف تنظمها؟
لأن Wiki.js يبني كل شيء على المسار، فقرار تسمية المسارات أهم فيه من الأدوات الأخرى، وهو قرار يصعب تغييره لاحقاً لثلاثة أسباب: المسار هو رابط الصفحة، وهو اسم الملف في المستودع، وهو ما تكتب عليه قواعد الصلاحيات. لذلك اتفقنا في فريقنا على ثلاث قواعد قبل أن نكتب أول صفحة. الأولى أن المستوى الأول من المسار هو المساحة بحسب المالك، أي ops وsupport وtech وsales وhr، وهذا يجعل قاعدة صلاحية واحدة تغطي مساحة كاملة، ويجعل مجلدات المستودع مرتبة بالطريقة نفسها التي يرى بها الفريق الـ Wiki.
والثانية أن المسارات بحروف لاتينية قصيرة، مثل tech/vpn-access، والعناوين بالعربية. فالمسار العربي ممكن، ولكنه يظهر في الروابط المنسوخة بالشكل المرمز الطويل مثل %D8%A7%D9%84...، ويصبح اسم ملف عربياً في المستودع يتعامل معه كل نظام تشغيل وكل أداة سطر أوامر بطريقة مختلفة. والعنوان العربي هو ما يظهر للقارئ في القائمة الجانبية وفي البحث، فلا يخسر القارئ شيئاً.
والثالثة أن نقل الصفحة من مسار إلى آخر قرار وليس تعديلاً عادياً. فعند النقل يعيد Wiki.js حساب الروابط النسبية داخل الصفحة المنقولة، ويعيد بناء عمود البحث لها لأن اللغة جزء من المسار، كما تقول التعليقات في كود النقل، أما الصفحات الأخرى التي تشير إلى المسار القديم فروابطها لا تعود تعمل Broken Links، ويلونها Wiki.js بلون مختلف لأن الخيار colorizeBrokenLinks مفعل افتراضياً في إعدادات الموقع، فتراها وتصلحها. والنقل أيضاً يخرج الصفحة من قاعدة الصلاحيات المكتوبة على مسارها القديم، فالصفحة التي تنقل من hr إلى ops تصبح مقروءة لكل الموظفين في اللحظة نفسها. لذلك اجعل النقل بين المساحات من صلاحية المدير فقط، وراجع الروابط العكسية Backlinks في تبويب Links قبل أي نقل.
خلف الـ Reverse Proxy مع WebSocket
صفحة المتطلبات Requirements واضحة في هذا الجزء، وأغلب مشكلات التشغيل الأولى تأتي من إهماله. فإذا كان Wiki.js خلف Nginx أو Caddy أو Cloudflare Tunnel فيجب أن يمرر ال Reverse Proxy ثلاث ترويسات هي X-Forwarded-Proto وX-Forwarded-Host وX-Forwarded-For، وأن يسمح بترقية الاتصال إلى WebSocket لأن الكتابة المشتركة تمر عبر المسار /_collab، ثم تفعل من منطقة الإدارة في قسم Security الخيار Trust X-Forwarded-* Proxy Headers. والسبب الذي تذكره الصفحة أن Wiki.js يبني عنوان العودة في الدخول الموحد من هذه الترويسات، ويستخدم عنوان الزائر الحقيقي في تحديد معدل الطلبات Rate Limiting وفي سجل التدقيق Audit Log، فإذا لم تفعل الخيار يرى كل الزوار بعنوان ال Reverse Proxy نفسه، فيمنع الجميع معاً إذا تجاوز أحدهم الحد. وفي مثال Nginx في الصفحة سطر آخر مهم هو client_max_body_size 10m، لأن حد Nginx الافتراضي 1 ميجابايت أقل من حد الرفع في Wiki.js، فبدونه يفشل رفع أي صورة أكبر من ذلك برسالة من Nginx وليس من Wiki.js. وقد شرحنا بقية إعداد ال Reverse Proxy والشهادات في تطبيقك خلف Reverse Proxy.
هل مستودع Git نسخة احتياطية؟ Backup
هذا سؤال يسأله كل من يرى المحتوى في Git، والإجابة القصيرة: لا، والطويلة جربناها. أخذنا أولاً نسخة من قاعدة البيانات بالأمر pg_dump -Fc فكان حجمها 370,338 بايت، ثم حذفنا Container قاعدة البيانات و Volume الخاص بها، وشغلنا Wiki.js على قاعدة فارغة، وجربنا طريقين:
docker compose exec -T db pg_dump -U wiki -d wiki -Fc > backup/wiki.dump
docker compose rm -sf wiki db && docker volume rm wr-kb-wj_db-data
docker compose up -d db wikiالطريق الأول هو البناء من المستودع: ثبتنا العربية من جديد، وأعدنا إعداد هدف Git، ثم شغلنا الإجراء Import Everything، فكان الرد:
This target had no commit agreed with origin/main ... so the remote's branch was taken up as it stands.
Nothing in the wiki itself was changed: run Import Everything if the repository holds content this wiki does not.
Imported 22 page(s) and 0 asset(s).والطريق الثاني هو الاستعادة من النسخة: أوقفنا Wiki.js، واستعدنا بالأمر pg_restore --clean --if-exists --no-owner --single-transaction، ثم شغلناه. والصورة التالية تقارن ما عاد في كل طريق:

المستودع أعاد كل الصفحات بمحتواها، وولدها السيرفر تلقائياً فظهرت كاملة، ولكنه لم يعد المستخدمين ولا المجموعات ولا القواعد ولا التعليقات ولا السجل الكامل لكل صفحة، لأن هذه كلها في قاعدة البيانات فقط. أما pg_restore فأعاد كل شيء، ودخل موظف الدعم بكلمة مروره، وبقيت صفحة الإجازات مخفية عنه. لذلك فالنسخة الاحتياطية Backup في Wiki.js هي pg_dump بشكل دوري مع قاعدة 3-2-1، والمستودع طبقة إضافية مفيدة: نسخة من المحتوى خارج السيرفر بصيغة مفتوحة، وطريق للخروج من Wiki.js إذا احتجت. ولاحظ أننا عند الاستعادة لم نر السطر No settings found in DB، وهذا ما يؤكد أن Wiki.js وجد بياناته.
التحديث Upgrade داخل الإصدار 3
تقول صفحة التحديث إن التحديث داخل 3.x هو إعادة إنشاء ال Container بالإصدار الجديد بالأمرين docker compose pull wiki وdocker compose up --force-recreate -d، وتحذر بأمرين يجب أن تأخذهما بجدية: لا يمكن الرجوع إلى إصدار أقدم بعد أن يتغير شكل قاعدة البيانات، لذلك خذ نسخة احتياطية قبل كل تحديث، وهذا التحديث في المكان In-place لا يستخدم أبداً للانتقال من 2.x، فلذلك قسم خاص في الصفحة نفسها ودليل نقل منفصل. ولأن الإصدار 3.1.0 أصلح ثغرات منها GHSA-3c74-j8g3-p255 الخاصة بتنقية HTML في الواجهة، فمن يشغل 3.0.1 أو 3.0.2 يجب أن يحدث، ومن يثبت اليوم يبدأ من 3.1.0.
الموارد Resources
بعد التجارب أخذنا قراءتين من docker stats، الأولى بعد إنشاء الصفحات والثانية بعد المزامنات:
wr-kb-wj-wiki-1 348.7MiB 288.3MiB
wr-kb-wj-db-1 56.71MiB 62.46MiB
wr-kb-wj-gitea-1 105.7MiB 109.5MiBأي نحو 350 إلى 410 ميجابايت ل Wiki.js مع قاعدة بياناته، دون Redis، وهذا أقل من Docmost في مقاله، مع أن Docker Image أكبر بكثير. ولكن تذكر أن توليد الصفحات بال puppeteer يشغل Chromium عند الحاجة، فاستهلاك الذاكرة يرتفع أثناء الاستيراد أو إعادة التوليد، وهذا سبب أن التوثيق يطلب 1 جيجابايت على الأقل.
متى تختار Wiki.js؟ نقاط القوة Strengths ثم نقاط الضعف
نقاط القوة:
- مزامنة Git حقيقية في الاتجاهين، بملف Markdown مع ترويسة لكل صفحة، وتعارض يحل بقاعدة واضحة ولا يفقد التعديل من السجل.
- كل الميزات Features مجانية بترخيص AGPL-3.0: ال API، والرموز الشخصية، والدخول الموحد بال OIDC وSAML وLDAP بحسب سجل الإصدارات، والموافقات وقواعد دورة الحياة.
- العربية لغة كاملة الاتجاه: الواجهة من اليمين إلى اليسار وأرقام القوائم في مكانها، والبحث بالقاموس العربي عندما تكون لغة الصفحة عربية.
- صلاحيات دقيقة بقواعد على المسارات، والزائر ممنوع افتراضياً.
- لا يحتاج إلى Redis، والنسخ المتعددة تتنسق عبر PostgreSQL.
نقاط الضعف:
- الإصدار 3 عمره أيام، وصدرت منه ثلاثة إصدارات في خمسة أيام بعضها لإصلاحات أمنية، وأغلب ما على الإنترنت يخص 2.x.
- الترجمة العربية للواجهة صفر في المئة، والحروف العربية تتباعد في بعض العناوين إذا بقيت الواجهة إنجليزية.
- Docker Image بحجم 3.45 جيجابايت على القرص، لأنها تحمل Chromium وامتدادات أخرى.
- الصفحات المنشأة عبر ال API تحتاج إلى توليد من السيرفر، والبحث لا يدعم أول الكلمة.
- تعديل من Git يسجل في سجل الـ Wiki باسم المدير وليس باسم كاتبه.
- القواعد على المسارات تتأثر بنقل الصفحات بين المجلدات، فالصفحة المنقولة تخرج من قاعدة مسارها القديم في اللحظة نفسها.
والحكم لفريقنا: إذا كان للمطورين والمهندسين وزن كبير في الكتابة، وكان وجود المحتوى في Git مهماً، وكان الفريق مستعداً لأن يتعامل مع مشروع خرج من إعادة كتابة كبيرة قبل أيام، فـ Wiki.js 3 هو الأقرب إلى ما طلبه. ونصيحتنا أن تبدأ به في بيئة تجريبية لعدة أسابيع، وأن تراقب صفحة الإصدارات، قبل أن تنقل إليه المعرفة كلها، ثم تقارنه بالأدوات الأخرى في مقال المقارنة من هذه المرحلة.
قائمة تحقق Checklist قبل الاعتماد عليه
| البند | كيف تتحقق منه |
|---|---|
| الإصدار 3.1.0 أو أحدث | الشعار في أول السجل، وصفحة الإصدارات للثغرات المصلحة |
| كلمة مرور المدير ليست الافتراضية | ADMIN_PASS في .env وتغييرها بعد الدخول الأول |
| العربية لغة أساسية قبل أول صفحة | شاشة Locale، والرمز ar-SA |
الصفحات العربية بلغة ar-SA | البحث عن «اجراء» دون همزة يجد «إجراء» |
| هدف Git بحالة Healthy | Commit يظهر في المستودع بعد تعديل في المتصفح |
| اتفاق على من يعدل من أين | أدلة التشغيل من المستودع، وبقية الصفحات من المتصفح |
| قواعد المسارات المقيدة مختبرة | حساب عادي لا يجد صفحاتها في البحث |
نسخة pg_dump دورية مختبرة | استعادة على قاعدة فارغة دون السطر No settings found in DB |
| نطاق فرعي خاص | ليس في مسار فرعي، وترويسات X-Forwarded مع WebSocket في ال Reverse Proxy |
تدريب عملي Practice
- غير
syncModeإلىpull، ثم عدل صفحة من المتصفح وأخرى من المستودع، وشغل Force Sync، وسجل ما وصل إلى كل طرف. - ارفع صورة إلى صفحة، ثم غيرها في المستودع وفي الـ Wiki قبل المزامنة، وتحقق من رسالة التعارض ومما بقي من الصورة القديمة.
حذف المختبر Cleanup
docker compose down -v
docker rmi ghcr.io/requarks/wiki:3.1.0 gitea/gitea:28.3.0-rootlessمقالات المرحلة Related Posts
هذا المقال جزء من مرحلة التوثيق والمعرفة، وقبله مقال قاعدة معرفة الفريق ومقال Docmost على الصفحات نفسها، وبعده HedgeDoc للكتابة المشتركة، ثم المقارنة. وهذه المقالات المنشورة المرتبطة به:
دليلOutline: قاعدة معرفة فريقك على سيرفرككيف تشغل Outline على سيرفرك ليكتب فيه فريقك إجراءاته وقراراته، ويدخل إليه الموظفون بحساباتهم في authentik.
دليلBookStack: توثيق فريقك في كتب وفصول على سيرفرككيف تشغل BookStack على سيرفرك وتنظم توثيق فريقك في أرفف وكتب وفصول، مع صلاحيات ودخول موحد وبحث بالعربية.
دليلGitea: خادم Git خاص لفريقك على سيرفرككيف تثبت Gitea على سيرفرك حتى يبقى كود فريقك عندك بتجربة تشبه GitHub، مع النسخ الاحتياطي والتحديث.
دليلإدارة النسخ مع Git للمبتدئين: لماذا نحتاجها وكيف تعمللماذا تضيع الملفات بأسماء final_v2 ويمسح الزملاء عمل بعضهم، وكيف يحل Git ذلك على مشروع حقيقي من أول commit.
دليلالنسخ الاحتياطي بقاعدة 3-2-1 واختبار الاستعادةكيف تحدد كم بيانات تقبل أن تخسر، وتبني نسخاً لا يستطيع المخترق حذفها، وتتأكد أنك تستطيع استعادتها فعلاً.الخلاصة Summary
وصلنا لنهاية الموضوع، وأهم ما فيه:
- Wiki.js 3 إعادة كتابة كاملة صدر مستقراً في 1 نوفمبر 2026، و3.1.0 في 5 نوفمبر مع إصلاحات أمنية، بترخيص AGPL-3.0 دون نسخة مدفوعة، ويحتاج إلى PostgreSQL 17 أو 18 فقط.
- الصفحة تقرأ من قاعدة البيانات دائماً، وGit هدف إضافي يأخذ ملف Markdown مع ترويسة لكل صفحة، ويتزامن كل خمس دقائق أو بزر Force Sync.
- الإنشاء عبر ال API دون
renderيعطي صفحة فارغة لا يبحث فيها إلا بالعنوان، والحل طلب التوليد من السيرفر الذي يشغل Chromium بلا شاشة. - البحث يستخدم قاموس لغة الصفحة: 7 من 12 بلغة
en، و8 من 12 بلغةar-SA، والعربية تقلب الواجهة إلى اليمين ولكن ترجمتها صفر. - الدخول الموحد بال OpenID Connect وSAML وLDAP موجود في النسخة نفسها دون ترخيص، والزائر ممنوع من القراءة افتراضياً، وقاعدة DENY على المسار
hrأخفت صفحاته من البحث وأعادت 403 عند الفتح المباشر. - إذا تغير السطر نفسه في الطرفين تفوز نسخة المستودع البعيد، والنسخة المستبدلة تبقى في سجل الصفحة.
- البناء من Git أعاد الصفحات فقط، والاستعادة من
pg_dumpأعادت المستخدمين والقواعد والسجل، فالنسخة الاحتياطية هي قاعدة البيانات.
وفي المقال القادم بإذن الله ننتقل من الـ Wiki إلى الكتابة المشتركة نفسها مع HedgeDoc، فنكتب الملاحظة نفسها من متصفحين في اللحظة نفسها، ونقطع الشبكة عن أحدهما.
سجل التحديثات Changelog
- نوفمبر 2026: كتابة الدليل واختباره على Wiki.js 3.1.0 من
ghcr.io/requarks/wiki:3.1.0معpostgres:18.6-alpineوgitea/gitea:28.3.0-rootlessعلى Docker Engine 29.8.0.