استضافة BookStack على خادم VPS الخاص بك

لماذا تستضيف BookStack ذاتيًا على خادم VPS

فوائد ملموسة لـBookStack ذاتية الاستضافة

• بنية واضحة من الأرفف/الكتب/الفصول/الصفحات: توثيق قابل للتصفّح بلا عناء.
• محرّر ‏WYSIWYG‏ و‏Markdown‏ حسب اختيارك، مع مخططات ‏Draw.io‏ مدمجة.
• أذونات دقيقة حسب الدور وحسب الكتاب لعزل المحتوى الحسّاس.
• بحث سريع بالنص الكامل عبر كامل قاعدة المعرفة.
• مصادقة ‏LDAP‏ أو ‏SAML‏ أو ‏OAuth‏ للتكامل مع دليل مؤسستك.
• بصمة خفيفة: خادم ‏VPS‏ بذاكرة 2 غيغابايت يكفي لتوثيق فريق.
• لا اشتراك لكل مستخدم — عدد غير محدود من المساهمين بلا تكاليف إضافية.

المتطلبات العتادية والبرمجية

BookStack مقارنةً بالبدائل ذاتية الاستضافة

مرّر الجدول أفقيًا

نشر BookStack مع Docker Compose وSSL

1. 01

   تجهيز خادم VPS وتثبيت Docker

   اتصل عبر ‏SSH‏ ثم ثبّت ‏Docker‏ وإضافة ‏Compose‏:

   curl -fsSL https://get.docker.com | sh
   apt install docker-compose-plugin
   mkdir -p /opt/bookstack && cd /opt/bookstack

   للتحقق: يجب أن يُظهر docker compose version‏ الإصدار v2.x أو أعلى. الصورة المجتمعية lscr.io/linuxserver/bookstack‏ هي الأكثر انتشارًا والأفضل صيانةً للنشر عبر الحاويات.

2. 02

   إنشاء ملف docker-compose.yml

   أنشئ /opt/bookstack/docker-compose.yml‏ بخدمتَين — ‏MariaDB‏ و‏BookStack‏ — على شبكة مخصصة:

   services:
     mariadb:
       image: mariadb:10.11
       environment:
         MYSQL_ROOT_PASSWORD: changeme_root
         MYSQL_DATABASE: bookstack
         MYSQL_USER: bookstack
         MYSQL_PASSWORD: changeme_bk
       volumes:
         - ./data/mariadb:/var/lib/mysql
       networks: [bookstack]
   
     bookstack:
       image: lscr.io/linuxserver/bookstack:latest
       environment:
         PUID: 1000
         PGID: 1000
         APP_URL: https://wiki.yourdomain.com
         DB_HOST: mariadb
         DB_USER: bookstack
         DB_PASS: changeme_bk
         DB_DATABASE: bookstack
         MAIL_DRIVER: smtp
         MAIL_HOST: smtp.yourdomain.com
         MAIL_PORT: 587
         MAIL_FROM: [email protected]
         MAIL_USERNAME: [email protected]
         MAIL_PASSWORD: your_smtp_password
       ports:
         - "6875:80"
       volumes:
         - ./data/bookstack:/config
       depends_on: [mariadb]
       networks: [bookstack]
   
   networks:
     bookstack:

   يجب أن يتطابق APP_URL‏ تمامًا مع عنوان ‏HTTPS‏ النهائي. قيمة خاطئة تكسر الروابط الداخلية وعمليات الرفع.

3. 03

   تشغيل الحزمة والتحقق من السجلات

   docker compose up -d
   docker compose logs -f bookstack

   عند التشغيل الأول، تنفّذ ‏BookStack‏ تلقائيًا ترحيلات ‏Laravel‏ لإنشاء مخطط قاعدة البيانات. انتظر السطر Server running on http://0.0.0.0:80‏ قبل المتابعة — يستغرق ذلك من 30 إلى 60 ثانية.

4. 04

   إعداد reverse proxy وSSL

   مع Caddy (إدارة تلقائية للشهادة):

   wiki.yourdomain.com {
       reverse_proxy localhost:6875
   }

   أعِد تحميل ‏Caddy‏: systemctl reload caddy‏.

   مع Nginx + Certbot:

   server {
       listen 80;
       server_name wiki.yourdomain.com;
       return 301 https://$host$request_uri;
   }
   server {
       listen 443 ssl;
       server_name wiki.yourdomain.com;
       ssl_certificate /etc/letsencrypt/live/wiki.yourdomain.com/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/wiki.yourdomain.com/privkey.pem;
       location / {
           proxy_pass http://127.0.0.1:6875;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_set_header X-Forwarded-Proto $scheme;
       }
   }

   aحصل على الشهادة مع certbot --nginx -d wiki.yourdomain.com‏.

5. 05

   أول تسجيل دخول وتأمين حساب المسؤول

   افتح https://wiki.yourdomain.com‏. الحساب الافتراضي هو [email protected]‏ بكلمة المرور password‏. غيّرهما فورًا في الإعدادات ← الملف الشخصي.

   تحقّق بعد ذلك من عمل ‏SMTP‏: الإعدادات ← إعداد البريد الإلكتروني ← إرسال بريد اختباري. إذا فشل الاختبار، تحقّق من السجلات: docker compose logs bookstack | grep -i mail‏.

الإعداد المتقدم: SSO وLDAP وSAML

النسخ الاحتياطي واستعادة BookStack

#!/bin/bash
BACKUP_DIR=/var/backups/bookstack
mkdir -p $BACKUP_DIR
DATE=$(date +%Y%m%d)
docker exec $(docker ps -qf name=mariadb) \
  mysqldump -u bookstack -pchangeme_bk bookstack \
  > $BACKUP_DIR/bookstack-db-$DATE.sql
tar -czf $BACKUP_DIR/bookstack-uploads-$DATE.tar.gz /opt/bookstack/data/bookstack/uploads
find $BACKUP_DIR -mtime +14 -delete

تشخيص الأخطاء: المشكلات الشائعة

المشكلات المتكررة وحلولها

• خطأ SMTP «Connection refused» أو انتهاء المهلة: تحقّق أن MAIL_PORT‏ يطابق المنفذ الفعلي (587 لـ‏STARTTLS‏، 465 لـ‏SSL‏). بعض خوادم ‏SMTP‏ تحجب المنفذ 25 الصادر. اختبر الاتصال من الحاوية: docker exec -it bookstack curl -v telnet://smtp.yourdomain.com:587‏.
• أذونات storage/: خطأ 500 أو صفحة بيضاء: يجب أن يملك مجلد /opt/bookstack/data/bookstack‏ المعرِّف ‏UID 1000‏ (المتغير PUID‏). صحّح بـchown -R 1000:1000 /opt/bookstack/data/bookstack‏ ثم أعِد تشغيل الحاوية.
• بطء أو انتهاء مهلة MariaDB عند الإقلاع: تنتظر ‏BookStack‏ أن تصبح ‏MariaDB‏ جاهزة. إذا أعادت حاوية ‏BookStack‏ التشغيل في حلقة خلال الثواني الأولى فهذا طبيعي. أضِف healthcheck‏ لخدمة mariadb‏ في ملف ‏Compose‏ أو انتظر 30 ثانية قبل فحص السجلات.
• الصور لا تظهر بعد تغيير النطاق: يجب أن يتطابق APP_URL‏ تمامًا مع عنوان ‏HTTPS‏ العام. إذا غيّرت النطاق، حدّث APP_URL‏ في ملف ‏Compose‏، وأعِد تشغيل الحاوية، ثم نفّذ php artisan bookstack:update-url‏ من داخل الحاوية لتحديث ‏URL‏ المخزّنة في قاعدة البيانات.
• توقف الترحيلات عند التشغيل الأول (OOM): إذا كان خادم ‏VPS‏ بذاكرة أقل من 2 غيغابايت، قد تُوقَف ترحيلات ‏Laravel‏ بواسطة ‏OOM killer‏. أضِف ملف مبادلة (‏swap‏) بحجم 2 غيغابايت (fallocate -l 2G /swapfile && mkswap /swapfile && swapon /swapfile‏) أو زِد ذاكرة ‏VPS‏ قبل إعادة المحاولة.

تحديث BookStack

cd /opt/bookstack
docker compose pull
docker compose up -d
docker compose logs -f bookstack

لمزيد من المعلومات

• استضافة Nextcloud على VPS — التخزين السحابي والتعاون الوثائقي.
• استضافة Gitea على VPS — منصة Git ذاتية الاستضافة لفرق التطوير.
• ‏Authentik على VPS‏ — SSO مفتوح المصدر لمركزة مصادقة BookStack وتطبيقاتك الأخرى.