الوصول
- اتبع الوثائق الرسمية للإعداد الكامل والميزات:
https://booklore.org/docs/getting-started - افتح متصفحك وزُر:
https://<SERVER_IP> - تحذير SSL من المتصفح متوقع (شهادة موقعة ذاتيًا)
- قد يستغرق تشغيل BookLore بالكامل بضع دقائق.
- أنشئ حساب المسؤول الخاص بك خلال الزيارة الأولى.
- ابدأ ببناء مكتبتك.
المجلدات والملفات الهامة
/root/booklore/mariadb/config→ إعداد قاعدة البيانات والبيانات الوصفية (حساس، لا تحذفه)/root/booklore/data→ بيانات التطبيق، الذاكرة المؤقتة، السجلات/root/booklore/books→ تخزين كتب المكتبة/root/booklore/bookdrop→ مجلد الاستيراد التلقائي/root/booklore/.env→ متغيرات البيئة بما فيها بيانات اعتماد قاعدة البيانات/root/booklore/docker-compose.yml→ تنسيق الحاويات-
/etc/nginx/ssl→ شهادات TLS (privkey.pem، fullchain.pem) /etc/nginx/sites-available/booklore→ إعداد Nginx لـ HTTPS
ملاحظات
- بيانات اعتماد MariaDB مخزنة في
.env. - لا تحذف
mariadb/config؛ فهو يحتوي على كل البيانات الوصفية لقاعدة البيانات. - ضع الكتب الجديدة في
/root/booklore/booksor/root/booklore/bookdropللاستيراد التلقائي. - يقرأ Booklore ويكتب كل البيانات الوصفية إلى
mariadb/config. - البيانات دائمة عبر عمليات إعادة تشغيل الحاوية.
- احتفظ دائماً بنسخة احتياطية من
mariadb/configوbooks.
تفعيل SSL مع نطاق
1. وجِّه نطاقك إلى IP الخادم.
2. حرّر إعدادات Nginx واستبدل كليهما server_name <IP>; بنطاقك (<your-domain>) لكلا كتلتي HTTP (المنفذ 80) وHTTPS (المنفذ 443):
vim /etc/nginx/sites-available/booklore
3. ثبّت Certbot:
apt install -y certbot python3-certbot-nginx
4. شغّل الأمر التالي لإنشاء شهادة Let's Encrypt صالحة:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. استبدل مسارات SSL في إعدادات Nginx:
vim /etc/nginx/sites-available/booklore
# Before:
# ssl_certificate /etc/nginx/ssl/fullchain.pem;
# ssl_certificate_key /etc/nginx/ssl/privkey.pem;
# After:
# ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
6. أعد تشغيل Nginx لتطبيق التغييرات:
systemctl restart nginx
7. افتح متصفحك وزُر: https://yourdomain.com
