تحجيم خادم VPS لتشغيل Jellyfin وNavidrome وImmich

لماذا جهاز واحد لأربع مكتبات

ما تكسبه من جمع كل شيء

• نقطة دخول واحدة — وكيل عكسي واحد، ونطاق فرعي لكل خدمة، وشهادات تُصدر وتُجدد تلقائيًا.
• ذاكرة مشتركة — يستهلك Navidrome وAudiobookshelf القليل، والذاكرة التي يتركها أحدهما حرة تفيد ذروة الآخر.
• خطة نسخ احتياطي واحدة — أربعة مجلدات إعداد، ونسخة واحدة من PostgreSQL، ونص برمجي واحد.
• توسعة عمودية — حين تكبر المكتبة ترفع الذاكرة والمعالجات والقرص على الخادم نفسه دون إعادة تثبيت.
• وصول root كامل — تختار التوزيعة وتضبط النواة وتثبّت ما تتطلبه الحزمة.

ميزانية الذاكرة والمعالج، خدمة بخدمة

ميزانية الحجز لكل خدمة

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

ميزانية القرص: احسب بالغيغابايت قبل الاختيار

لا تحوّل الترميز: القاعدة التي تحمي الخادم الصغير

تركيب الحزمة: شبكة واحدة ووكيل واحد ونطاق فرعي لكل خدمة

1. 01

   إنشاء المجلدات والصلاحيات والشبكة المشتركة

   افصل الوسائط والصور والإعدادات، وامنح الملكية للمستخدم 1000، وأنشئ الشبكة التي ستتشاركها كل الحاويات:

   sudo mkdir -p /srv/media/video /srv/media/music /srv/media/audiobooks /srv/photos /srv/stack/media /srv/stack/immich
sudo mkdir -p /srv/stack/jellyfin/config /srv/stack/jellyfin/cache /srv/stack/navidrome/data /srv/stack/audiobookshelf/config /srv/stack/audiobookshelf/metadata
sudo chown -R 1000:1000 /srv/stack /srv/photos
sudo chmod -R a+rX /srv/media
docker network create edge

2. 02

   توجيه أربعة نطاقات فرعية إلى الخادم

   أنشئ أربعة سجلات A (jellyfin وmusic وbooks وphotos) تشير إلى عنوان IPv4 للخادم. لا يحصل Caddy على الشهادات إلا إذا كانت سجلات A أو AAAA تشير إلى الخادم وكان المنفذان 80 و443 مفتوحين من الخارج.

3. 03

   كتابة ملف compose للخدمات الثلاث الخفيفة

   في /srv/stack/media/compose.yaml عرّف Jellyfin وNavidrome وAudiobookshelf. لا يُنشر أي منفذ: Caddy وحده يتحدث مع الشبكة edge. تُركَّب الوسائط للقراءة فقط في Jellyfin وNavidrome.

   services:
jellyfin:
image: jellyfin/jellyfin
user: 1000:1000
volumes:
- /srv/stack/jellyfin/config:/config
- /srv/stack/jellyfin/cache:/cache
- /srv/media/video:/media:ro
restart: unless-stopped
networks: [edge]
navidrome:
image: navidrome/navidrome:latest
user: 1000:1000
volumes:
- /srv/stack/navidrome/data:/data
- /srv/media/music:/music:ro
restart: unless-stopped
networks: [edge]
audiobookshelf:
image: ghcr.io/advplyr/audiobookshelf:latest
user: 1000:1000
volumes:
- /srv/stack/audiobookshelf/config:/config
- /srv/stack/audiobookshelf/metadata:/metadata
- /srv/media/audiobooks:/audiobooks
restart: unless-stopped
networks: [edge]

4. 04

   إضافة Caddy إلى الملف نفسه

   أكمل الملف بخدمة الوكيل، ثم تعريفات الشبكة الخارجية ووحدة تخزين الشهادات:

   caddy:
image: caddy:2
ports:
- "80:80"
- "443:443"
volumes:
- ./Caddyfile:/etc/caddy/Caddyfile:ro
- caddy_data:/data
restart: unless-stopped
networks: [edge]
networks:
edge:
external: true
volumes:
caddy_data:

5. 05

   كتابة Caddyfile بكتلة لكل خدمة

   في /srv/stack/media/Caddyfile يكفي اسم النطاق لتفعيل TLS التلقائي، ويحوّل Caddy طلبات HTTP إلى HTTPS من تلقاء نفسه:

   jellyfin.your-domain.com {
reverse_proxy jellyfin:8096
}
music.your-domain.com {
reverse_proxy navidrome:4533
}
books.your-domain.com {
reverse_proxy audiobookshelf:80
}
photos.your-domain.com {
reverse_proxy immich_server:2283
}

6. 06

   تثبيت Immich بملف compose الرسمي

   نزّل ملفَي آخر إصدار ولا تعدّل ملف compose نفسه:

   cd /srv/stack/immich
wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env

   في .env اضبط القيم الثلاث التالية (كلمة المرور لا تقبل إلا الحروف والأرقام):

   UPLOAD_LOCATION=/srv/photos/library
DB_DATA_LOCATION=/srv/stack/immich/postgres
DB_PASSWORD=<mot-de-passe-A-Za-z0-9>

7. 07

   ربط Immich بالشبكة المشتركة

   أنشئ /srv/stack/immich/docker-compose.override.yml. يدمجه Docker Compose تلقائيًا مع الملف الرسمي الذي يبقى سليمًا وقابلًا للاستبدال عند كل تحديث:

   services:
immich-server:
networks: [default, edge]
networks:
edge:
external: true

8. 08

   التشغيل والتحقق من كل مدخل

   شغّل الحزمتين وانتظر إصدار الشهادات، ثم اختبر ترويسات HTTP وTLS. يجب أن تحصل على رمز 2xx أو 3xx عبر HTTPS، وليس خطأ شهادة أبدًا:

   cd /srv/stack/media && docker compose up -d
cd /srv/stack/immich && docker compose up -d

   curl -I https://jellyfin.your-domain.com
curl -I https://photos.your-domain.com

9. 09

   القياس ثم ضبط Immich

   أثناء الفهرسة اقرأ docker stats --no-stream وحمل المعالج. إذا اقتربت الذاكرة من السقف فعطّل ميزة من التعلم الآلي (البحث الذكي أو التعرف على الوجوه) في إعدادات الإدارة، أو خفّض تزامن المهام دون رفعه فوق عدد النوى.

انسخ كل خدمة احتياطيًا واختبر الاستعادة قبل أن تحتاجها

خطة النسخ الاحتياطي لكل خدمة

• Immich، القاعدة — نسخة مضغوطة خارج الخادم: docker exec -t immich_postgres pg_dump --clean --if-exists --dbname=immich --username=postgres | gzip > "/srv/backup/immich-db.sql.gz"، مع مواءمة اسم القاعدة والمستخدم مع ملف .env لديك.
• Immich، الملفات — تُنسخ library وupload وprofile بواسطة rsync إلى تخزين بعيد؛ ويمكن إعادة توليد thumbs وencoded-video.
• Jellyfin — مجلد /srv/stack/jellyfin/config (المكتبات والمستخدمون والبيانات الوصفية) والحاوية متوقفة أثناء الأرشفة. أما الذاكرة المؤقتة فتُعاد بناءً.
• Navidrome — المجلد /srv/stack/navidrome/data (القاعدة وقوائم التشغيل والذاكرة المؤقتة)؛ والموسيقى نفسها هي مصدر الحقيقة وتُنسخ كأي مجلد ملفات.
• Audiobookshelf — /config و/metadata: قاعدة SQLite وتقدم الاستماع في الأول، والنسخ الداخلية في الثاني.
• الاستعادة تُختبر — أعد تنفيذ إجراء Immich الرسمي المفصَّل أعلاه على جهاز اختبار قبل الاعتماد عليه.

استكشاف الأخطاء: ذاكرة ممتلئة وصلاحيات مرفوضة وعمليات رفع مقطوعة

الأخطاء المصادَفة وعلاجها

• Immich يعيد التشغيل في حلقة على خطة صغيرة — تقتل النواة حاوية التعلم الآلي (ابحث عن out of memory في dmesg). عطّل البحث الذكي والتعرف على الوجوه، أو انتقل إلى خطة بذاكرة 8 غيغابايت على الأقل.
• can't set healthcheck.start_interval as feature require Docker Engine v25 or later — إصدار Docker لديك قديم جدًا. حدّثه أو علّق السطر start_interval في قسم database من ملف compose كما يشير توثيق Immich.
• رفع الفيديو ينقطع بعد دقيقة — يشير توثيق Immich إلى الرمز 499 خلف Traefik مع مهلة القراءة الافتراضية البالغة 60 ثانية، ويوصي بـ 600 ثانية. تحقق من مهلة الوكيل لديك.
• Navidrome: unable to open database file — لا يمكن الكتابة في مجلد /data. امنح الملكية للمعرّف المحدد في التوجيه user.
• يعمل Navidrome لكن المكتبة تبقى فارغة مع permission denied في السجلات — مجلد الموسيقى غير مقروء: نفّذ chmod -R a+rX على /srv/media/music.
• Jellyfin لا يرى الأفلام — لا يستطيع المستخدم 1000 في الحاوية قراءة المجلد المركَّب. اختبر بالأمر docker exec jellyfin ls /media وصحّح الصلاحيات؛ فالمتغيران PUID وPGID لا يعملان مع هذه الصور، والمعتمد هو التوجيه user وحده.

أي خطة لأي مكتبة

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

التوثيق الرسمي والخطوة التالية