> ## Content Index
> Fetch the complete content index at: https://arabroot.io/llms.txt
> Use this file to discover other available public pages before exploring further.

# Wiki.js 3: صفحات Markdown تتزامن مع Git على سيرفرك
- URL: https://arabroot.io/articles/wikijs-3-صفحات-markdown-تتزامن-مع-git/
- Published: 2026-11-05T21:37:43.000Z
- Updated: 2026-11-05T22:32:45.000Z
- Description: نشغل Wiki.js 3.1 على صفحات فريق حقيقي ونربطه بمستودع Git، ونختبر التعديل من الطرفين والتعارض والبحث بالعربية، ونعرف لماذا لا يغني المستودع عن النسخة الاحتياطية.
- Author: فريق عرب رووت
- Tags: الأدلة التقنية, الاستضافة الذاتية والتطبيقات, تطبيقات لفريقك, الاستضافة الذاتية, Wiki.js

في فريق نقاط البيع الذي نتابعه في هذه المرحلة طلب واحد يتكرر من المطورين ومهندسي العمليات كلما تحدثنا عن الـ Wiki: «لا نريد محرراً جديداً، نريد أن نكتب Markdown في المحرر الذي نستخدمه للكود، وأن تمر الصفحات في Git كما يمر الكود». وهذا طلب منطقي من أشخاص يقضون يومهم في المستودعات، فدليل استعادة قاعدة البيانات يتغير مع تغير السكربتات، ومن الطبيعي أن يتغير معها في الطلب نفسه. ولكن في الفريق نفسه موظفو دعم ومبيعات لن يفتحوا Git أبداً، ويريدون أن يعدلوا الصفحة من المتصفح. فهل توجد أداة تخدم الطرفين على المحتوى نفسه؟

هذا ما يعد به [Wiki.js](https://js.wiki/?ref=arabroot.io): Wiki مفتوحة المصدر تكتب فيها من المتصفح، وتحفظ كل صفحة في الوقت نفسه ملفاً في مستودع Git يتزامن مع GitHub أو GitLab أو Gitea في الاتجاهين. ولكن التوقيت هنا مهم، فقد صدر [Wiki.js 3.0](https://github.com/requarks/wiki/releases/tag/3.0.1?ref=arabroot.io) المستقر في 1 نوفمبر 2026 بعد إعادة كتابة كاملة للمشروع، ثم 3.0.2 في 2 نوفمبر، ثم [3.1.0](https://github.com/requarks/wiki/releases/tag/3.1.0?ref=arabroot.io) في 5 نوفمبر ومعه إصلاحات لعدة ثغرات أمنية. أي أن أغلب ما تجده على الإنترنت عن Wiki.js يخص الإصدار 2.x، وكثير منه لا ينطبق على الإصدار الجديد. لذلك شغلنا 3.1.0 على صفحات الفريق الإحدى عشرة نفسها، وربطناه بمستودع على Gitea، وجربنا كل اتجاه من اتجاهات المزامنة، ومنها التعارض.

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

- ما الجديد في Wiki.js 3، وما يحتاجه من السيرفر.
- التثبيت بال Docker Compose مع PostgreSQL، والتشغيل الأول.
- إضافة الصفحات، ومشكلة الصفحة الفارغة عند الإنشاء عبر ال API.
- العربية: اللغة واتجاه النص والترجمة، والبحث الذي يتغير قاموسه بحسب لغة الصفحة.
- ربط الصفحات بمستودع Git، والتعديل من المستودع، وماذا يحدث إذا تغير السطر نفسه في الطرفين.
- الصلاحيات بقواعد المسارات، وهل المستودع نسخة احتياطية، والتحديث ونقاط القوة والضعف.

## ما الجديد في Wiki.js 3؟ Wiki.js 3.0

Wiki.js مشروع بدأه Nicolas Giard سنة 2017، وترخيصه [AGPL-3.0](https://github.com/requarks/wiki/blob/3.1.0/LICENSE?ref=arabroot.io)، وكان الإصدار 2.x لسنوات من أشهر أدوات الـ Wiki التي تستضيفها الفرق بنفسها. ويقول [إعلان الإصدار 3.0](https://js.wiki/blog/2026-wiki-js-3-release/?ref=arabroot.io) إنه إعادة كتابة كاملة للخلفية والواجهة لكي يعالج مشكلات أساسية في 2.x، وإن ما أتاحته إعادة الكتابة هو تعدد المواقع Multi-site، والكتابة المشتركة في الوقت الفعلي، والكتل الديناميكية Content Blocks، والتوافرية العالية 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

بحسب [صفحة المتطلبات](https://docs.js.wiki/setup/requirements?ref=arabroot.io)، يحتاج 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

الملف التالي مبني على [صفحة التثبيت](https://docs.js.wiki/setup/installation?ref=arabroot.io)، ومعه Gitea في الملف نفسه لأننا سوف نربط الـ Wiki بمستودع، وعلى سيرفرك يكون Gitea غالباً موجوداً في مكانه كما في [دليل تثبيت Gitea](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-gitea-%D9%85%D8%B9-docker-compose/)، أو تستخدم GitHub أو GitLab:

### ملف compose.yaml

```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: admin@example.com
      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` تنشئان المدير الأول عند التشغيل الأول فقط، ولا أثر لهما بعد ذلك، فإذا تركتهما فارغين يكون الدخول بالبريد `admin@example.com` وكلمة المرور `12345678` كما يقول التوثيق، وهي قيم يعرفها كل من قرأه.
- لا يوجد Volume لخدمة `wiki` نفسها، لأن كل شيء في قاعدة البيانات، حتى المرفقات بشكل افتراضي، والمستودع المحلي لمزامنة Git يعاد بناؤه من المستودع البعيد عند الحاجة كما يقول تعريف وحدة Git.
- لا يوجد Redis، فالمهام الخلفية وتنسيق الكتابة المشتركة بين أكثر من نسخة يمران عبر PostgreSQL نفسها، بحسب صفحة التثبيت التي تقول إن النسخ المتعددة تتنسق عبر قاعدة البيانات ولا تحتاج جلسات لاصقة Sticky Sessions.

### التشغيل الأول First Start

بعد `docker compose up -d` مرت 56 ثانية حتى ردت الصفحة الرئيسية ب `200`، أغلبها في انتظار قاعدة البيانات وتشغيل Container الكبير، وهذه أهم أسطر السجل:

```text
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` لكل صفحة:

```javascript
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

عندما فتحنا صفحة «إجراء إضافة مطعم جديد» ظهر العنوان، وظهرت الصفحة في القائمة الجانبية، ولكن المحتوى كان فارغاً تماماً:

![صفحة إجراء إضافة مطعم جديد في Wiki.js 3.1 بالإنجليزية، والعنوان ظاهر في الأعلى والقائمة الجانبية فيها صفحات مجلد ops الثلاث، ولكن منطقة المحتوى تحت تبويب Article فارغة تماماً، والحروف العربية في العنوان والقائمة متباعدة لا تتصل](https://arabroot.io/content/images/2026/11/wikijs-04-api-page-empty.webp)

العنوان موجود والمحتوى فارغ، والحروف العربية متباعدة في الواجهة الإنجليزية

وكذلك البحث، فقد شغلنا الاستعلامات الاثني عشر فكانت النتيجة 5 من 12، كلها كلمات في العناوين، فالاستعلام «إجراء» وجد صفحة الإجراء لأن الكلمة في عنوانها، ولم يجد «دليل الموظف الجديد» مع أن الكلمة في محتواها. وعندما نظرنا في جدول الصفحات وجدنا أن العمودين `render` و`searchContent` طولهما صفر لكل الصفحات. والسبب في وصف ال API نفسه: الطلب يحمل المصدر `content`، ويحمل أيضاً `render`، وهو HTML الذي ينتجه المحرر في المتصفح، ومنه يبني السيرفر الصفحة المعروضة ونص البحث. فإذا لم ترسله فلا يوجد ما يعرض ولا ما يبحث فيه. وفي Wiki.js 3 تحول Markdown إلى HTML يحدث في الواجهة وليس في السيرفر، ولذلك يحتاج السيرفر إلى puppeteer: فالطلب `POST /_api/sites/:siteId/pages/:pageId/render` يضع الصفحة في طابور، ثم يفتحها السيرفر في Chromium بلا شاشة، ويشغل عليها كود الواجهة نفسه، ويحفظ الناتج:

```text
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`. فثبتناها بهذا الرمز، ثم جعلناها اللغة الأساسية للموقع مع إبقاء الإنجليزية نشطة، فأصبحت الصفحة كما يلي:

![صفحة الدخول إلى السيرفرات عبر VPN في Wiki.js بعد جعل العربية لغة الموقع: الواجهة كلها من اليمين إلى اليسار، والقائمة الجانبية على اليمين، وأرقام الخطوات من 1 إلى 4 على يمين النص، والخطوة الرابعة عن ضبط ساعة الجهاز جاءت من مستودع Git، وأزرار الواجهة ما زالت بالإنجليزية مثل Edit وArticle وTalk](https://arabroot.io/content/images/2026/11/wikijs-05-page-rtl-git.webp)

بعد جعل العربية لغة الموقع: الواجهة من اليمين إلى اليسار، وأرقام القائمة في مكانها، والأزرار بالإنجليزية

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

![شاشة Locale في منطقة الإدارة في Wiki.js، واللغة الأساسية Arabic، وفي اللغات النشطة Arabic بعلامة RTL ونسبة ترجمة صفر في المئة، وEnglish بنسبة مئة في المئة](https://arabroot.io/content/images/2026/11/wikijs-08-locale-ar.webp)

العربية مثبتة ومعها علامة RTL، ولكن نسبة ترجمتها صفر

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

## البحث بالعربية Arabic Search: القاموس بحسب لغة الصفحة

هنا أهم نقطة في هذا المقال للفرق العربية. ففي ملف [search.ts](https://github.com/requarks/wiki/blob/3.1.0/backend/models/search.ts?ref=arabroot.io) جدول يقابل كل لغة بقاموس البحث في PostgreSQL، وأوله `ar: 'arabic'`، ويقول التعليق فوقه إن كل لغة يوجد لها محلل Snowball في PostgreSQL تستخدمه، وما عداها يستخدم `simple`. ويبنى عمود البحث `ts` لكل صفحة بقاموس لغتها، ويحلل الاستعلام بالقاموس نفسه عبر `websearch_to_tsquery`. أي أن الصفحة العربية المسجلة بلغة `en` تفهرس بالقاموس الإنجليزي، وهذا ما حدث مع صفحاتنا الأولى. فأنشأنا الصفحات الإحدى عشرة مرة ثانية بلغة `ar-SA`، وشغلنا الاستعلامات على كل لغة وحدها:

![جدول الاستعلامات الاثني عشر في Wiki.js 3.1: الصفحات بلغة en وجدت 7 من 12 وفشلت في اجراء والفاتوره وسيرفر ومستوي وpostgres، والصفحات بلغة ar-SA وجدت 8 من 12 وأضافت اجراء دون همزة وفشلت في الفاتوره وسيرفر ومستوي وpostgres، وتحته أن النتيجة كانت 5 من 12 قبل توليد HTML للصفحات](https://arabroot.io/content/images/2026/11/wikijs-02-search-locale.webp)

القاموس العربي أضاف «اجراء» دون همزة، والبحث بأول الكلمة غير موجود

بلغة `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](https://github.com/requarks/wiki/blob/3.1.0/backend/modules/storage/git/definition.yml?ref=arabroot.io) هي أن المحتوى يكتب إلى كل هدف مفعل، ولكن الصفحة تقرأ دائماً من قاعدة البيانات، أي أن المستودع ليس المكان الذي يعرض منه الموقع، وإنما نسخة ثانية تتبادل معها التعديلات، والصورة التالية تبين الدورة:

![رسم لمزامنة Git في Wiki.js 3: محرر Wiki.js يعدل فيه موظف الدعم، وPostgreSQL فيها الصفحة وسجلها والمستخدمون ومنها تقرأ الصفحات، ثم المستودع المحلي في data/repo بملف لكل صفحة وCommit لكل تعديل، والمزامنة كل 5 دقائق بال Pull ثم Rebase ثم Push أو بزر Force Sync، ثم المستودع البعيد في Gitea أو GitHub أو GitLab، ومهندس العمليات يعدل الملف ويرسل Commit أو يفتح Pull Request، وتحتها أن نسخة المستودع البعيد تفوز إذا تغير السطر نفسه في الطرفين والنسخة المستبدلة تبقى في سجل الصفحة](https://arabroot.io/content/images/2026/11/wikijs-01-git-sync.webp)

قاعدة البيانات تعرض الصفحات، والمستودع يتبادل معها التعديلات في كل مزامنة

### إعداد هدف Git Target

أنشأنا في Gitea مستخدماً ومستودعاً خاصاً فارغاً اسمه `kb/wiki`، ورمز وصول Access Token بصلاحية `write:repository`، ثم فعلنا هدف Git بالإعدادات التالية، وهي الحقول نفسها التي تراها في شاشة Storage في منطقة الإدارة:

```javascript
config: { authType: 'basic', repoUrl: 'http://gitea:3000/kb/wiki.git', branch: 'main', syncMode: 'sync',
  basicUsername: 'kb', basicPassword: token, alwaysUseDefaultAuthor: false,
  defaultName: 'Wiki.js', defaultEmail: 'wiki@example.com', localRepoPath: './data/repo' }
```

![شاشة Storage في منطقة إدارة Wiki.js، وفي قائمة الأهداف Database وGit بحالة Pages and Assets والباقي Inactive، وفي الوسط أنواع المحتوى Pages وImages وDocuments وOthers محددة وLarge Files غير محددة، ثم Target Configuration بنوع المصادقة Basic، وعلى اليمين وصف وحدة Git وحالة Healthy](https://arabroot.io/content/images/2026/11/wikijs-06-admin-git.webp)

هدف Git مفعل للصفحات والصور والمستندات، والحالة Healthy

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

- `authType` بقيمة `basic` مع رمز الوصول بدلاً من كلمة المرور، والتعريف ينصح ب SSH كخيار أكثر أماناً، وفي SSH يجب ألا يكون على المفتاح الخاص كلمة مرور.
- `syncMode` له ثلاث قيم: `sync` يسحب ثم يدفع، و`push` يدفع بالقوة Force Push فتفوز الـ Wiki دائماً ولا تأخذ شيئاً، و`pull` يأخذ فقط ولا يكتب، فيصبح المستودع هو المرجع. وسوف نعود إلى هذا الاختيار في قسم سير العمل.
- `alwaysUseDefaultAuthor` إذا فعلته تكتب كل Commits باسم المؤلف الافتراضي، فلا يصل اسم أي موظف ولا بريده إلى المستودع، وهذا مهم إذا كان المستودع على خدمة خارجية.
- `repoUrl` إذا تركته فارغاً يبقى المستودع محلياً على قرص النسخة فقط، ويحتاج عندها إلى Volume دائم ونسخة واحدة من Wiki.js.

### أول Commit: الصفحات التي سبقت المزامنة

الصفحات التي أنشئت قبل تفعيل Git لا تدخل المستودع وحدها، ويسميها التعريف غير متتبعة Untracked، ولها زر Add Untracked Changes، فشغلناه فكان الرد:

```text
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:

```text
---
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 بدلاً من انتظار المزامنة الدورية كل خمس دقائق:

```bash
git commit -qam "VPN: خطوة رابعة عند فشل الاتصال" && git push
```

```text
Synced. Took in 1 page(s) and 0 asset(s).
```

والصفحة في المتصفح ظهرت فيها الخطوة الرابعة مباشرة، كما رأيت في صورة الصفحة العربية أعلاه، وفي سجل الصفحة History ظهرت نسخة جديدة. ولكن لاحظ أمراً يهمك إذا كانت المراجعة مهمة في فريقك: النسخة الجديدة في سجل Wiki.js سجلت باسم Administrator، وليس باسم «مهندس العمليات» الذي كتب ال Commit، فالسجل الصحيح لمن غير ماذا في هذه الحالة هو سجل Git نفسه، وهذه صورته في Gitea بعد كل التجارب:

![صفحة Commits في Gitea 28.3.0 لمستودع kb/wiki وفيها أربعة Commits: Administrator بالرسالة docs: add all untracked content، ثم مهندس العمليات مرتين بالرسالتين خطوة رابعة عند فشل الاتصال ومنفذ قاعدة البيانات، ثم Administrator بالرسالة docs: update ar-SA tech/vpn-access](https://arabroot.io/content/images/2026/11/wikijs-07-gitea-commits.webp)

سجل Git يحفظ اسم كاتب كل تعديل، سواء جاء من الـ Wiki أو من المستودع

### ماذا لو تغير السطر نفسه في الطرفين؟ What If

هذه هي التجربة التي يجب أن تجريها قبل أن تعد الفريق بأن «الطرفين يعملان معاً». ففي Wiki.js عدلنا السطر الأول من صفحة VPN إلى «لا تفتح أي منفذ SSH أو RDP على الإنترنت»، وفي الوقت نفسه، قبل أي مزامنة، عدل مهندس العمليات السطر نفسه في المستودع إلى «لا تفتح أي منفذ SSH أو منفذ قاعدة البيانات على الإنترنت» ودفعه. ثم ضغطنا Force Sync:

```text
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 الأسطر التالية:

```text
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 للمبتدئين](https://arabroot.io/articles/%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D9%88-git-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/).

## الدخول الموحد Authentication: ما المتاح دون اشتراك؟

في فريقنا يدخل الموظفون إلى Outline وBookStack وMattermost بحساباتهم في [authentik](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-authentik-%D9%84%D9%84%D8%AF%D8%AE%D9%88%D9%84-%D8%A7%D9%84%D9%85%D9%88%D8%AD%D8%AF/)، ورأينا في مقال Docmost أن الدخول الموحد هناك في النسخة المدفوعة فقط. أما في Wiki.js 3.1 فقد طلبنا قائمة وحدات الدخول من المسار `/_api/authentication/modules` فكانت ثمانية:

```text
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](https://arabroot.io/articles/%D8%B4%D8%B1%D8%AD-oauth-%D9%88-openid-connect-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/): عنوان المصدر 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، ثم دخلنا بحسابه:

```text
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 Unauthorized في Wiki.js لموظف الدعم عند فتح صفحة سياسة الإجازات في المسار hr/annual-leave، مع رسالة أنه لا يملك الصلاحيات وزري الذهاب إلى الرئيسية والدخول بحساب آخر](https://arabroot.io/content/images/2026/11/wikijs-09-support-hr.webp)

البحث لا يعيد صفحات hr، والفتح المباشر يعيد 403

البحث يحترم القاعدة، فلا تظهر صفحة الإجازات في النتائج، وصفحات العمليات تظهر. ولكن الفتح المباشر يعيد `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

صفحة المتطلبات واضحة في هذا الجزء، وأغلب مشكلات التشغيل الأولى تأتي من إهماله. فإذا كان 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](https://arabroot.io/articles/%D8%AA%D8%B7%D8%A8%D9%8A%D9%82%D9%83-%D8%AE%D9%84%D9%81-reverse-proxy/).

## هل مستودع Git نسخة احتياطية؟ Backup

هذا سؤال يسأله كل من يرى المحتوى في Git، والإجابة القصيرة: لا، والطويلة جربناها. أخذنا أولاً نسخة من قاعدة البيانات بالأمر `pg_dump -Fc` فكان حجمها 370,338 بايت، ثم حذفنا Container قاعدة البيانات و Volume الخاص بها، وشغلنا Wiki.js على قاعدة فارغة، وجربنا طريقين:

```bash
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، فكان الرد:

```text
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`، ثم شغلناه. والصورة التالية تقارن ما عاد في كل طريق:

![مقارنة بين البناء من Git والاستعادة من pg_dump: البناء من Git أعاد 22 صفحة من 22 مع نسخة واحدة في السجل لكل صفحة أي 22، ومستخدمين اثنين فقط وضاع حساب موظف الدعم، وضاعت قاعدة منع مجلد hr، واحتجنا إلى إعادة اللغة وإعداد Git يدوياً، أما الاستعادة من pg_dump فأعادت 22 صفحة و25 نسخة في السجل و3 مستخدمين ودخل موظف الدعم بكلمة مروره وعملت قاعدة hr وإعداد المزامنة كما كان](https://arabroot.io/content/images/2026/11/wikijs-03-backup-scope.webp)

المستودع نسخة من المحتوى، وقاعدة البيانات هي النسخة الاحتياطية

المستودع أعاد كل الصفحات بمحتواها، وولدها السيرفر تلقائياً فظهرت كاملة، ولكنه لم يعد المستخدمين ولا المجموعات ولا القواعد ولا التعليقات ولا السجل الكامل لكل صفحة، لأن هذه كلها في قاعدة البيانات فقط. أما `pg_restore` فأعاد كل شيء، ودخل موظف الدعم بكلمة مروره، وبقيت صفحة الإجازات مخفية عنه. لذلك فالنسخة الاحتياطية في Wiki.js هي `pg_dump` بشكل دوري مع قاعدة [3-2-1](https://arabroot.io/articles/%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D8%A7%D9%84%D8%A7%D8%AD%D8%AA%D9%8A%D8%A7%D8%B7%D9%8A-%D8%A8%D9%82%D8%A7%D8%B9%D8%AF%D8%A9-3-2-1-%D9%88%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%B9%D8%A7%D8%AF%D8%A9/)، والمستودع طبقة إضافية مفيدة: نسخة من المحتوى خارج السيرفر بصيغة مفتوحة، وطريق للخروج من Wiki.js إذا احتجت. ولاحظ أننا عند الاستعادة لم نر السطر `No settings found in DB`، وهذا ما يؤكد أن Wiki.js وجد بياناته.

## التحديث Upgrade داخل الإصدار 3

تقول [صفحة التحديث](https://docs.js.wiki/setup/upgrade?ref=arabroot.io) إن التحديث داخل 3.x هو إعادة إنشاء ال Container بالإصدار الجديد بالأمرين `docker compose pull wiki` و`docker compose up --force-recreate -d`، وتحذر بأمرين يجب أن تأخذهما بجدية: لا يمكن الرجوع إلى إصدار أقدم بعد أن يتغير شكل قاعدة البيانات، لذلك خذ نسخة احتياطية قبل كل تحديث، وهذا التحديث في المكان In-place لا يستخدم أبداً للانتقال من 2.x، فلذلك قسم خاص في الصفحة نفسها ودليل نقل منفصل. ولأن الإصدار 3.1.0 أصلح ثغرات منها [GHSA-3c74-j8g3-p255](https://github.com/requarks/wiki/security/advisories/GHSA-3c74-j8g3-p255?ref=arabroot.io) الخاصة بتنقية HTML في الواجهة، فمن يشغل 3.0.1 أو 3.0.2 يجب أن يحدث، ومن يثبت اليوم يبدأ من 3.1.0.

## الموارد Resources

بعد التجارب أخذنا قراءتين من `docker stats`، الأولى بعد إنشاء الصفحات والثانية بعد المزامنات:

```text
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 مع ترويسة لكل صفحة، وتعارض يحل بقاعدة واضحة ولا يفقد التعديل من السجل.
- كل الميزات مجانية بترخيص 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

```bash
docker compose down -v
docker rmi ghcr.io/requarks/wiki:3.1.0 gitea/gitea:28.3.0-rootless
```

## مقالات المرحلة Related Posts

هذا المقال جزء من [مرحلة التوثيق والمعرفة](https://arabroot.io/start/#stage-knowledge)، وقبله مقال قاعدة معرفة الفريق ومقال Docmost على الصفحات نفسها، وبعده HedgeDoc للكتابة المشتركة، ثم المقارنة. وهذه المقالات المنشورة المرتبطة به:

[![](https://arabroot.io/content/images/2026/10/outline-cover-cover.webp)دليلOutline: قاعدة معرفة فريقك على سيرفرككيف تشغل Outline على سيرفرك ليكتب فيه فريقك إجراءاته وقراراته، ويدخل إليه الموظفون بحساباتهم في authentik.](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-outline-%D9%84%D9%82%D8%A7%D8%B9%D8%AF%D8%A9-%D9%85%D8%B9%D8%B1%D9%81%D8%A9-%D8%A7%D9%84%D9%81%D8%B1%D9%8A%D9%82/)[![](https://arabroot.io/content/images/2026/10/bookstack-cover-cover.webp)دليلBookStack: توثيق فريقك في كتب وفصول على سيرفرككيف تشغل BookStack على سيرفرك وتنظم توثيق فريقك في أرفف وكتب وفصول، مع صلاحيات ودخول موحد وبحث بالعربية.](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-bookstack-%D9%84%D8%AA%D9%88%D8%AB%D9%8A%D9%82-%D8%A7%D9%84%D9%81%D8%B1%D9%8A%D9%82/)[![](https://arabroot.io/content/images/2026/10/gitea-cover-cover.webp)دليلGitea: خادم Git خاص لفريقك على سيرفرككيف تثبت Gitea على سيرفرك حتى يبقى كود فريقك عندك بتجربة تشبه GitHub، مع النسخ الاحتياطي والتحديث.](https://arabroot.io/articles/%D8%AA%D8%AB%D8%A8%D9%8A%D8%AA-gitea-%D9%85%D8%B9-docker-compose/)[![](https://arabroot.io/content/images/2026/11/git-basics-cover-cover.webp)دليلإدارة النسخ مع Git للمبتدئين: لماذا نحتاجها وكيف تعمللماذا تضيع الملفات بأسماء final\_v2 ويمسح الزملاء عمل بعضهم، وكيف يحل Git ذلك على مشروع حقيقي من أول commit.](https://arabroot.io/articles/%D8%A7%D8%AF%D8%A7%D8%B1%D8%A9-%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D9%88-git-%D9%84%D9%84%D9%85%D8%A8%D8%AA%D8%AF%D8%A6%D9%8A%D9%86/)[![](https://arabroot.io/content/images/2026/10/backup-321-cover-cover.webp)دليلالنسخ الاحتياطي بقاعدة 3-2-1 واختبار الاستعادةكيف تحدد كم بيانات تقبل أن تخسر، وتبني نسخاً لا يستطيع المخترق حذفها، وتتأكد أنك تستطيع استعادتها فعلاً.](https://arabroot.io/articles/%D8%A7%D9%84%D9%86%D8%B3%D8%AE-%D8%A7%D9%84%D8%A7%D8%AD%D8%AA%D9%8A%D8%A7%D8%B7%D9%8A-%D8%A8%D9%82%D8%A7%D8%B9%D8%AF%D8%A9-3-2-1-%D9%88%D8%A7%D8%AE%D8%AA%D8%A8%D8%A7%D8%B1-%D8%A7%D9%84%D8%A7%D8%B3%D8%AA%D8%B9%D8%A7%D8%AF%D8%A9/)

## الخلاصة 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.