Docker Compose ile Jellyfin medya sunucusu kurulumu

Jellyfin, kendi sunucunuzda çalışan ücretsiz ve açık kaynaklı bir medya sunucusudur. Kendi arşivinizi (ör. kendi çektiğiniz videolar, lisanslı içerikler, müzik koleksiyonunuz) telefon, tablet, TV ve tarayıcıdan izlemenizi sağlar; abonelik ve takip yoktur.

Not: Yalnızca yasal olarak sahip olduğunuz ya da paylaşma hakkınız bulunan içerikleri barındırın.

Gereksinimler

• Docker ve Compose kurulu bir sunucu (bkz. Docker kurulumu).
• Arşiviniz için yeterli disk: video arşivi hızla büyür; paketinizi yükseltebilir ya da ek disk için talep oluşturabilirsiniz.
• Gerçek zamanlı dönüştürme (transcoding) CPU yoğundur: 4 vCPU ve üzeri önerilir; mümkünse istemcilerde doğrudan oynatmayı (direct play) tercih edin.

1. Klasörleri hazırlayın

mkdir -p ~/jellyfin/{config,cache} /srv/media/{filmler,diziler,muzik}
cd ~/jellyfin

2. Compose dosyası

compose.yaml dosyasını oluşturun:

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    restart: unless-stopped
    ports:
      - "127.0.0.1:8096:8096"
    volumes:
      - ./config:/config
      - ./cache:/cache
      - /srv/media:/media:ro
    environment:
      - TZ=Europe/Istanbul

Port yalnızca 127.0.0.1’e bağlanır; internete doğrudan açılmaz. Medya klasörü :ro (salt okunur) bağlanır, böylece uygulama arşivinizi değiştiremez.

3. Başlatın ve ilk kurulumu yapın

docker compose up -d
docker compose logs -f jellyfin

Başlangıçta yerelden denemek için SSH tüneli açın: ssh -L 8096:127.0.0.1:8096 kullanici@SUNUCU_IP, ardından tarayıcıda http://localhost:8096 adresini açın. Sihirbazda yönetici kullanıcıyı oluşturun, kütüphaneler ekleyin (/media/filmler gibi) ve dilinizi seçin.

4. HTTPS ile yayınlayın

Dışarıdan erişim için bir alan adı ve ters proxy kullanın. Caddy rehberindeki adımlarla medya.alanadiniz.com adresini jellyfin:8096 hedefine yönlendirip otomatik sertifika alabilirsiniz. Önce alan adının A kaydını sunucu IP adresine yönlendirin (bkz. DNS kayıtları).

5. Güvenlik ve bakım

• Güçlü bir yönetici parolası kullanın; kullanılmayan hesapları silin.
• Kayıt/anonim erişimi kapalı tutun; aile ve arkadaşlar için ayrı kullanıcılar oluşturun.
• Güncellemek için: docker compose pull && docker compose up -d
• config klasörünü (kütüphane ve kullanıcı ayarları) düzenli yedekleyin; medyanın yedeği ayrıca önemlidir.

Performans ipuçları

Melinhost ile başlayın

Medya sunucusu için yeterli disk ve çekirdek sayısına sahip bir bulut sunucu seçin; ihtiyacınız arttıkça paketinizi yükseltebilirsiniz.