لماذا تستضيف BookStack ذاتيًا على خادم VPS
تتميّز BookStack ببساطتها: فحيث تُغرِق ويكيات أخرى المستخدمَ بالخيارات، تفرض هي تراتبية واضحة من الأرفف والكتب والفصول والصفحات، ما يجعل التوثيق قابلًا للتصفّح فورًا. مبنيّة على إطار عمل Laravel، فهي خفيفة وسهلة الصيانة. عند استضافتها ذاتيًا على خادم VPS، تُبقي كامل توثيقك الداخلي — الإجراءات وrunbooks وقاعدة معرفة العملاء — على بنيتك التحتية الخاصة، دون اشتراك لكل مستخدم. وبالنسبة إلى وكالة توثّق مشاريعها أو فريق تقني يوحّد إجراءاته، فهي ويكي خاص تتحكّم فيه من طرف إلى طرف، مع بحث بالنص الكامل، وإدارة دقيقة للأذونات، ومحرّر WYSIWYG أو Markdown.
فوائد ملموسة لـBookStack ذاتية الاستضافة
- بنية واضحة من الأرفف/الكتب/الفصول/الصفحات: توثيق قابل للتصفّح بلا عناء.
- محرّر WYSIWYG وMarkdown حسب اختيارك، مع مخططات Draw.io مدمجة.
- أذونات دقيقة حسب الدور وحسب الكتاب لعزل المحتوى الحسّاس.
- بحث سريع بالنص الكامل عبر كامل قاعدة المعرفة.
- مصادقة LDAP أو SAML أو OAuth للتكامل مع دليل مؤسستك.
- بصمة خفيفة: خادم VPS متواضع يكفي لتوثيق فريق.
المتطلبات العتادية والبرمجية
BookStack قليلة التطلّب. يستضيف خادم VPS بمعالج إلى معالجَين افتراضيَّين (1 إلى 2 vCPU) و2 غيغابايت من الذاكرة (RAM) توثيق فريق بأريحية؛ يرتفع الاستهلاك خصوصًا مع حجم الصور المرفوعة. تعتمد على MySQL أو MariaDB. خصّص من 15 إلى 25 غيغابايت من SSD بحسب كمية المرفقات. على الجانب البرمجي: Docker وDocker Compose، ونطاق فرعي wiki.yourdomain.com مع سجل A، وخادم SMTP لإرسال الدعوات والإشعارات البريدية.
نشر BookStack مع Docker وSSL
تجهيز خادم VPS
ثبّت Docker وإضافة Compose، ثم أنشئ /opt/bookstack. الصورة المجتمعية lscr.io/linuxserver/bookstack هي الأكثر انتشارًا والأفضل صيانةً للنشر عبر الحاويات.
التصريح عن MySQL وBookStack
في ملف docker-compose.yml، أضِف خدمة mariadb بقاعدة بيانات ومستخدم مخصّصين، إضافةً إلى خدمة bookstack. أدخِل المتغير APP_URL بقيمة https://wiki.yourdomain.com — إذ يكسر عنوان URL خاطئ الروابطَ الداخلية وعمليات الرفع.
تشغيل الحزمة
نفّذ docker compose up -d، ثم راقِب docker compose logs -f bookstack. عند التشغيل الأول، تنفّذ BookStack تلقائيًا ترحيلات Laravel لإنشاء مخطط قاعدة البيانات.
إعداد reverse proxy وSSL
مع Caddy: wiki.yourdomain.com { reverse_proxy localhost:6875 }، تُدار الشهادة وحدها. مع Nginx، مرّر الطلبات إلى 127.0.0.1:6875 واحصل على الشهادة عبر certbot --nginx.
أول تسجيل دخول وSMTP
سجّل الدخول بالحساب الافتراضي [email protected] ثم غيّر كلمة المرور فورًا. أعدّ متغيرات SMTP (MAIL_HOST وMAIL_USERNAME...) لتفعيل دعوات المستخدمين وإعادة تعيين كلمة المرور.
اعتنِ باستراتيجية النسخ الاحتياطي: تُستعاد نسخة BookStack من ثلاثة عناصر — نسخة قاعدة بيانات MySQL/MariaDB، ومجلد uploads (الصور والمرفقات)، وملف الإعداد الذي يحتوي على المفتاح APP_KEY. من دون مفتاح تطبيق Laravel هذا، لا يمكن فكّ تشفير المحتوى المشفَّر بعد الاستعادة. أتمِت mysqldump يوميًا إضافةً إلى نسخة من وحدة تخزين uploads إلى تخزين خارجي، واحتفظ بعناية بـAPP_KEY خارج الخادم.
