📚 تثبيت Wiki.js — قاعدة المعرفة والتوثيق والويكي العصري على Docker
نشر منصة Wiki.js على Ubuntu باستخدام Docker — المنصة مفتوحة المصدر الرائدة للتوثيق وإدارة المعرفة وبديل Confluence مع محررات Markdown وWYSIWYG والمزامنة مع Git على المنفذ 3000.
📦 الملفات والأكواد المطلوبة
قبل البدء، يرجى التأكد من تحميل الأكواد المطلوبة من مستودعنا على GitHub لتتمكن من تطبيق الخطوات مع الفيديو بسهولة.
التثبيت السريع:
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/tools/wikijs/wikijs-ubuntu.sh
chmod +x wikijs-ubuntu.sh
sudo bash wikijs-ubuntu.sh
خطوات التنفيذ
1 تحميل السكريبت
wget https://raw.githubusercontent.com/mhmdali94/Docker/refs/heads/main/tools/wikijs/wikijs-ubuntu.sh
2 منح صلاحية التنفيذ
chmod +x wikijs-ubuntu.sh
3 تشغيل المثبت
يقوم السكريبت بتثبيت Docker وتجهيز مجلد قاعدة البيانات (`./postgres-data`) ومجلد المرفقات (`./data`) وضبط متغيرات البيئة وتشغيل منصة Wiki.js على المنفذ 3000.
sudo bash wikijs-ubuntu.sh
4 إكمال معالج الإعداد وإنشاء الصفحة الأولى
افتح متصفحك على الرابط http://ip-سيرفرك:3000. أكمل شاشة التثبيت الأولى بكتابة بريدك وكلمة المرور ورابط موقعك، ثم أنشئ الصفحة الرئيسية باختيار المحرر البصري أو محرر Markdown.
http://<your-server-ip>:3000
المنافذ المستخدمة
| المنفذ | الغرض |
|---|---|
| 3000 | Wiki.js Web UI (HTTP) |
| 5432 | PostgreSQL (internal only) |
نظرة عامة
تعد Wiki.js منصة ويكي وقاعدة معرفة وتوثيق عصرية وقابلة للتوسع ومفتوحة المصدر تم بناؤها بالاعتماد على Node.js وVue.js وقاعدة بيانات PostgreSQL. تعمل المنصة عبر المنفذ 3000 لتقدم تجربة مستخدم متميزة لكتابة توثيقات الفرق البرمجية، وإجراءات العمل القياسية (SOPs)، ومراكز المساعدة العامة. وتدعم محررات متعددة (Markdown مع المعاينة الحية، ومحرر WYSIWYG البصري، ومحرر الأكواد، والجداول)، والمزامنة التلقائية باتجاهين مع مستودعات Git، والبحث بالنص الكامل، والمصادقة المؤسسية الموحدة (LDAP وSAML و2FA).
لماذا تستخدمه
تتميز برمجيات الويكي القديمة (مثل MediaWiki) بواجهات معقدة وغير مريحة، بينما تفرض المنصات السحابية التجارية (مثل Confluence وNotion) اشتراكات باهظة تُحسب لكل موظف شهرياً وتخزن مستندات شركتك الحساسة على خوادم أجنبية. تمنحك Wiki.js مركز توثيق مؤسسي فائق السرعة والأناقة: تصفح متجاوب بالكامل مع الهواتف، ومرونة فائقة في التحرير، ونسخ احتياطي تلقائي بملفات Markdown على Git، مع ملكية كاملة لبياناتك على سيرفرك الخاص.
متى تحتاجه
- تحتاج إلى قاعدة معرفة وويكي داخلي مركزي لتوثيق إجراءات العمل (SOPs) وتدريب الموظفين والسياسات
- تبحث عن بديل مفتوح المصدر ومستضاف ذاتياً بنسبة 100% لمنصات Confluence وNotion وGitBook
- تريد توفير خيارات تحرير متعددة لتمكين الموظفين غير التقنيين من استخدام المحرر البصري والمطورين من استخدام Markdown
- تريد مزامنة تلقائية مع مستودعات Git لحفظ كافة صفحات الويكي كملفات Markdown نصية في مستودع خاص
- تحتاج لنظام صلاحيات دقيق على مستوى المجلدات والصفحات مع تسجيل الدخول الموحد بـ LDAP وActive Directory
من يحتاجه
- فرق هندسة البرمجيات لتوثيق الواجهات البرمجية (APIs) ومخططات البنية التحتية وأدلة التشغيل
- أقسام تقنية المعلومات والدعم الفني لبناء قواعد المعرفة الداخلية وحفظ طبولوجيا الشبكات وسجلات الأعطال
- مديرو الموارد البشرية والعمليات لنشر أدلة الموظفين، وسياسات الشركة، وإجراءات التهيئة الوظيفية
- المشاريع مفتوحة المصدر والشركات التقنية لاستضافة مراكز الدعم الفني والتوثيقات العامة للمستخدمين
- أصحاب السيرفرات المنزلية لتنظيم توثيقات السيرفرات وعناوين الـ IP المنزلية وإعدادات الخدمات
حالات الاستخدام الشائعة
- بناء موسوعة هندسية شاملة للشركة تربط صفحات Markdown بمخططات Mermaid التفاعلية للبنية التحتية
- إنشاء مركز مساعدة ودعم فني عام بهوية مخصصة ودعم متعدد اللغات لعملاء شركتك
- مزامنة كافة مقالات الويكي تلقائياً إلى مستودع GitHub خاص كملفات `.md` عند كل تعديل
- مصادقة دخول أكثر من 100 موظف عبر خدمات الدخول الموحد (SSO) باستخدام Azure AD أو Keycloak
- إدارة السيرفرات المنزلية بحفظ مخططات الشبكة ومنافذ الخدمات وأوامر الصيانة والترقية
الميزات الرئيسية
- محررات متعددة متكاملة على المنفذ 3000: محرر Markdown مع معاينة حية، ومحرر WYSIWYG بصري، ومحرر أكواد وجداول
- مزامنة باتجاهين مع مستودعات Git: حفظ وتصدير كافة الصفحات تلقائياً كملفات Markdown في مستودعات Git
- بحث قوي بالنص الكامل: محرك بحث مدمج يعتمد على PostgreSQL مع دعم ربط Elasticsearch وAlgolia
- مصادقة مؤسسية موحدة: دعم الدخول بـ LDAP وActive Directory وSAML وOpenID Connect والتوثيق الثنائي (2FA)
- صلاحيات دقيقة للمجموعات: تقييد القراءة والتعديل والإدارة على مستوى المجلدات أو المسارات أو الصفحات الفردية
- دعم متعدد اللغات والتعريب: كتابة وتنسيق التوثيقات بعدة لغات في وقت واحد مع سهولة التبديل بينها
- مدير وسائط ومرفقات متطور: رفع وتنظيم الصور والملفات ومستندات الـ PDF مع معاينات مصغرة
- معمارية Docker Compose تجمع منصة Wiki.js مع قاعدة بيانات PostgreSQL 16 على المنفذ 3000
كيفية الاستخدام بعد التثبيت
- افتح المتصفح وانتقل إلى الرابط http://ip-سيرفرك:3000 لعرض شاشة التثبيت الأولى
- أدخل بريد المشرف، وكلمة المرور القوية، ورابط الموقع العام (مثل `https://wiki.example.com`)
- سجل دخولك واضغط 'Create Home Page' واختر محرر Markdown أو المحرر البصري
- توجه إلى Administration ← Storage واضبط المزامنة التلقائية مع مستودع Git الخاص بك
- ضع Wiki.js خلف وكيل عكسي مشفر بـ HTTPS (مثل Nginx) مع شهادة SSL صالحة
- أعد سكريبت نسخ احتياطي دوري لمجلد قاعدة بيانات PostgreSQL (`./postgres-data`)
أفضل ممارسات الأمان
- تنبيه أمني حاسم: أكمل معالج التثبيت فور تشغيل الحاوية ولا تترك شاشة الإعداد الأولى مفتوحة بدون تسجيل
- فعل التوثيق الثنائي (2FA) لحسابات المشرفين من إعدادات المستخدمين
- استخدم تشفير HTTPS دائماً لحماية كوكيز الجلسات ومستندات الشركة الحساسة المنقولة بالشبكة
- أبقِ منفذ قاعدة البيانات الداخلي PostgreSQL 5432 معزولاً عن الإنترنت العام
- احمِ مجلد البيانات `./postgres-data` بصلاحيات نظام صارمة بالسيرفر (`chmod 700`)
- حدّث صورة الحاوية دورياً للحصول على التحديثات الأمنية وإصلاحات الاستقرار
المنافذ وإعدادات جدار الحماية
يقدم Wiki.js واجهة الويب عبر منفذ TCP 3000. اسمح بالمنفذ 3000 للشبكة المحلية (`ufw allow 3000/tcp`). وفي الإنتاج، وجه حركة المرور عبر وكيل عكسي مشفر بـ SSL على المنفذ 443 ووجهه لمنفذ 3000، مع إبقاء المنفذ 3000 مغلقاً خارجياً وقاعدة البيانات معزولة.
النسخ الاحتياطي والصيانة
- انسخ مجلد `./postgres-data` احتياطياً، والذي يحتوي على كامل قاعدة بيانات PostgreSQL بكافة الصفحات والتاريخ والمستخدمين
- انسخ مجلد `./data` الذي يحتوي على الصور والمرفقات والملفات المرفوعة
- استخرج نسخة احتياطية يومية لقاعدة البيانات عبر pg_dump: `docker exec wikijs-db pg_dump -U wikijs wikijs > wikijs_backup.sql`
- احتفظ بنسخة من ملف `docker-compose.yml` وملف المتغيرات `.env`
- أتمت النسخ الاحتياطي اليومي للمجلدات وارفعه إلى مساحة تخزين سحابية عبر restic أو rsync
الأخطاء الشائعة
- ترك شاشة التثبيت الأولى مفتوحة بدون تهيئة على سيرفر عام مما يسمح لأي زائر بإنشاء حساب المشرف والاستيلاء على السيرفر
- كتابة رابط الموقع Site URL بشكل خاطئ في الإعدادات مما يعطل تحميل ملفات التنسيق CSS والخطوط عبر HTTPS
- عدم ربط مجلد التخزين الدائم لقاعدة البيانات، مما يسبب مسح كافة صفحات الويكي عند تحديث الحاوية
- استخدام SQLite لويكي كبير لفرق العمل بدلاً من PostgreSQL (حيث يوصى بـ Postgres للأداء والبحث)
- نسيان تفعيل المزامنة مع Git للاحتفاظ بنسخة نصية احتياطية لكافة الصفحات بملفات Markdown
استكشاف الأخطاء وإصلاحها
- ظهور خطأ 502 Bad Gateway في الواجهة — انتظر 30 ثانية لاكتمال إقلاع PostgreSQL وراجع السجلات: `docker logs wikijs -f`
- تنسيقات الموقع مكسورة — عدل رابط الموقع من Administration ← General ← Site URL
- فشل مزامنة Git — تأكد من صلاحيات مفتاح الـ SSH في مستودع GitHub وصحة اسم الفرع المستهدف
- البحث بالنص الكامل لا يعيد نتائج — أعد بناء فهرس البحث من Administration ← Search Engine ← Reindex
- فشل الاتصال بقاعدة البيانات — تأكد من عمل حاوية `wikijs-db` وتطابق البيانات بملف `.env`
البدائل
منصة BookStack بنظام الكتب والفصول والصفحات. منصة Outline العصرية المشابهة لـ Notion. منصة Docmost للتوثيق التفاعلي. منصة DokuWiki للملفات النصية البسيطة. منصة Confluence التجارية الشهيرة.
متى لا تستخدمه
تجنب استخدام Wiki.js إذا كنت تفضل بنية هرمية صارمة تشبه الكتب (كتاب ← فصل ← صفحة) حيث صُممت BookStack خصيصاً لهذا النمط. وإذا كنت تفضل محرراً تفاعلياً حديثاً كـ Notion يعتمد على أوامر السلاش `/` السريعة، فإن Outline أو Docmost توفر تجربة كتابة مماثلة لـ Notion.
هل تحتاج مساعدة احترافية؟
توفر PrismaTechWork خدمات بنية تحتية شاملة — من النشر الأولي وتصليب الأمان إلى المراقبة المستمرة والنسخ الاحتياطي التلقائي والدعم المخصص. سواء كنت تحتاج إعداد سيرفر واحد أو شبكة متعددة المواقع، يضمن فريقنا بناء بنيتك التحتية بشكل صحيح وتأمينها بالشكل المناسب وصيانتها باستمرار.
- التثبيت وتجهيز السيرفر
- الإعداد المتقدم وإعداد التوجيه
- تصليب الأمان وتحسين جدار الحماية
- إعداد شهادات SSL/TLS مع Let's Encrypt
- ربط النطاق المخصص والوكيل العكسي
- جدولة النسخ الاحتياطي التلقائي والتعافي من الكوارث
- المراقبة الفورية وتنبيهات الجاهزية
- الترحيل من المنصات القائمة
- استكشاف مشكلات الاتصال والأداء وإصلاحها
- سكريبتات أتمتة مخصصة وعقود دعم مستمر
الأسئلة الشائعة
ما هي قاعدة البيانات التي يتطلبها نظام Wiki.js؟
يعمل Wiki.js بأعلى كفاءة واستقرار مع قاعدة بيانات PostgreSQL (الإصدارات 12 إلى 16)، والتي توفر بحثاً سريعاً بالنص الكامل وتكاملاً بيانياً ممتازاً. كما يدعم قواعد MySQL وMariaDB وMS SQL Server.
هل يمكن استيراد الصفحات من Confluence أو MediaWiki إلى Wiki.js؟
نعم! يدعم Wiki.js استيراد ملفات Markdown ومستندات HTML، ويوفر أدوات تحويل لاستيراد الصفحات المصدرة من منصات Confluence وMediaWiki ومستودعات Git.
هل يدعم Wiki.js تسجيل الدخول بـ LDAP وActive Directory؟
نعم! يتضمن Wiki.js وحدات مصادقة مؤسسية جاهزة تدعم LDAP وMicrosoft Active Directory وSAML 2.0 وOpenID Connect وKeycloak وOkta وGoogle وGitHub وAzure AD.
كيف أقوم بتفعيل البحث بالنص الكامل في Wiki.js؟
يوفر Wiki.js ميزة البحث بالنص الكامل المعتمدة على PostgreSQL بشكل أصلي ومباشر وبدون أي إضافات خارجية. كما يمكنك ربط محركات بحث خارجية مثل Elasticsearch أو Algolia من لوحة الإدارة.
ما هي المحررات التي يدعمها نظام Wiki.js لكتابة التوثيقات؟
يدعم Wiki.js خمسة محررات متنوعة: محرر Markdown (مع المعاينة الحية ومخططات Mermaid)، والمحرر البصري Visual WYSIWYG (لتنسيق النصوص بسهولة لغير المبرمجين)، ومحرر HTML المباشر، ومحرر الأكواد البرمجية، ومحرر الجداول.
