Docker ve SpotDL ile Spotify Savaşları: Karşılaşacağınız 4 Büyük Engel ve Kurşun Geçirmez Çözümleri

Bir sysadmin veya ev sunucusu (Self-hosting) meraklısıysanız, hayatınızın bir noktasında mutlaka şu illüzyona kapılmışsınızdır: “Altı üstü basit bir Docker konteyneri ayağa kaldıracağım, iki parametre yazıp arkama yaslanacağım.”

İşte tam o Enter tuşuna bastığınız an, terminal ekranınıza adeta bir Matrix kodu gibi akan kırmızı hata satırları düşmeye başlar.

Bu yazıda, Spotify çalma listelerimizi kendi yerel sunucumuza (NAS) yedeklemek için yola çıktığımızda; Spotify’ın hız limitlerinden Alpine Linux’un kütüphane uyumsuzluklarına, YouTube’un arka plan güncellemelerinden şifrelenmiş koruma engellerine kadar karşılaştığımız 4 büyük teknik savaşı ve bu kısırdöngüleri nasıl kökten çözdüğümüzü adım adım anlatıyorum.

Kahvelerinizi hazırlayın; çünkü Docker dünyasının en karanlık dehlizlerine iniyoruz.

🧱 Engel 1: Spotify’ın Görünmez Duvarı (Rate Limit 429)

SpotDL, varsayılan olarak Spotify çalma listelerindeki şarkı isimlerini, albüm kapaklarını ve sanatçı bilgilerini çekmek için anonim bir bağlantı kullanır. Ancak popüler bir playlisti (örneğin 300-400 şarkılık bir listeyi) çekmeye çalıştığınızda Spotify sistemi sizi bir bot olarak algılar ve anında kapıyı yüzünüze kapatır: Error 429 – Too Many Requests.

🛠️ Kurşun Geçirmez Çözüm:

Bu engeli aşmanın yolu, Spotify’a “Ben bir bot değilim, lisanslı bir geliştiriciyim” demektir.

1. Spotify Developer Dashboard adresine kendi hesabınızla giriş yapın.
2. Create an App butonuna basarak rastgele bir isimle kendinize özel bir uygulama oluşturun.
3. Uygulama detaylarından size özel üretilen Client ID ve Client Secret anahtarlarını alın.
4. Bu anahtarları SpotDL komutunuza --client-id ve --client-secret parametreleriyle beslediğinizde, Spotify limitsiz indirme kapılarını size sonuna kadar açacaktır.

🧱 Engel 2: Alpine Linux ve “Kayıp Kütüphane” Faciası (libresolv.so.2)

Resmi SpotDL Docker imajı, sistemin olabildiğince küçük olması için Alpine Linux tabanlı olarak derlenmiştir. Ancak TrueNAS SCALE veya bazı özel Linux çekirdeklerinde bu konteyneri ayağa kaldırmak istediğinizde, konteyner daha ilk saniyede çöker ve terminale şu hatayı kusar:

Error: libresolv.so.2: cannot open shared object file: No such file or directory

🛠️ Neden Oluyor?

Alpine Linux, standart Linux dağıtımlarının kullandığı glibc kütüphanesi yerine musl kütüphanesini kullanır. Bazı ağ çözme (DNS) süreçlerinde sistem libresolv.so.2 dosyasını arar ama Alpine dünyasında bu dosya fiziksel olarak var olmadığından program kilitlenir.

🧱 Engel 3: YouTube’un Sinsi Değişiklikleri (webCommandMetadata Hatası)

Engel 2’yi aşmak için akla gelen ilk mantıklı çözüm, kütüphane sorunu yaşatmayan daha eski ve kararlı bir SpotDL Docker sürümünü (örneğin v4.4.3) kullanmaktır. Evet, eski sürüm kütüphane hatası vermeden açılır. Ancak bu sefer de karşınıza şu hata çıkar:

KeyError: 'webCommandMetadata' -> LookupError: No results found

🛠️ Neden Oluyor?

SpotDL, Spotify’daki şarkıyı bulmak için arka planda YouTube aramalarını kullanır. YouTube ise arka plandaki arama ve veri yapılarını (metadata) sürekli günceller. Siz Docker imajınızı eski bir sürümde kilitlediğinizde, o sürüm YouTube’un yeni dilini anlayamaz. Sonuç: Konteyner açılır ama tek bir şarkı bile bulamaz!

🚀 Mühendislik Zaferi: Debian Tabanlı Temiz Bir Sayfa

Hem yeni sürümü kullanmak (YouTube engeline takılmamak) hem de Alpine Linux’un kütüphane hatasından kurtulmak için kısırdöngüyü harika bir taktikle kırdık: Resmi Debian tabanlı Python imajını (python:3.12-slim) geçici bir çalışma alanı olarak kullanmak.

Sıfır, tertemiz bir Debian konteynerini ayağa kaldırıp, içerisine saniyeler içinde sistem ffmpeg kütüphanesini kurup, en güncel SpotDL aracını dinamik olarak yükleyerek her iki engeli de aynı anda yok ettik!

🧱 Engel 4: Şifrelenmiş YouTube Videoları (“Deno Required” Engeli)

Sistemimiz harıl harıl indirme yaparken, bazı popüler veya telif hakları sıkı korunan şarkılarda aniden şu uyarıyı verir ve indirmeyi keser:

Some YouTube downloads require Deno. Run spotdl --download-deno or install Deno system-wide.

🛠️ Neden Oluyor?

YouTube, bazı müzik kliplerinde indirmeyi engellemek için tarayıcı tabanlı karmaşık şifreleme yöntemleri (signature cipher) kullanır. SpotDL’in bu şifreleri çözebilmesi için konteynerin içinde hızlı bir JavaScript motoruna ihtiyacı vardır. Bu motorun adı Deno‘dur ve varsayılan Docker imajlarında bulunmaz.

🛠️ Kurşun Geçirmez Çözüm:

Konteynerimiz çalışmaya başlarken araya küçük bir spotdl --download-deno talimatı sıkıştırmak. Böylece sistem, şifreli şarkılarla karşılaşmadan önce gerekli JavaScript motorunu otomatik olarak kendi hafızasına yazar ve en inatçı YouTube şifrelerini bile jilet gibi çözer.

🏆 İşte Tüm Bu Engelleri Aşan “Kurşun Geçirmez” Nihai Docker Komutu!

Yaşadığımız tüm bu teknik tecrübelerin, kütüphane savaşlarının ve kısırdöngülerin ardından ortaya çıkan; tek bir satırıyla tüm engelleri dize getiren o efsanevi komutumuz:

Bash

sudo docker run --rm \
  -v /mnt/hdd_data/Medya/Muzik:/music \
  -w /music \
  python:3.12-slim \
  sh -c "apt-get update && apt-get install -y --no-install-recommends ffmpeg curl && pip install --no-cache-dir spotdl && spotdl --download-deno && spotdl download 'SPOTIFY_PLAYLIST_LINKIN' --client-id 'SENIN_CLIENT_ID_ANAHTARIN' --client-secret 'SENIN_CLIENT_SECRET_ANAHTARIN' --use-official-api --audio youtube"

🔍 Komutun Anatomisi: Neler Yaptık?

• -v /.../Muzik:/music: Ev sunucumuzdaki müzik klasörünü konteynere bağladık.
• -w /music: Konteynere “Ne indiriyorsan doğrudan bizim klasörümüze yaz” talimatı verdik.
• python:3.12-slim: Alpine yerine Debian tabanlı kararlı bir işletim sistemi seçtik.
• ffmpeg curl: Ses dönüştürme motorunu ve internetten Deno çekebilmek için gerekli aracı kurduk.
• spotdl --download-deno: YouTube’un şifreli koruma kalkanını kırdık.
• --use-official-api: Spotify Developer portalından aldığımız kimlikle resmi API üzerinden limitsiz sorgu yaptık.

🎯 Sonuç

Açık kaynak dünyasında bir projeyi ayağa kaldırmak bazen sadece “çalıştır” demekten çok daha fazlasıdır. Karşılaştığınız her hata, arka plandaki işletim sistemi mimarilerini, API politikalarını ve web protokollerini daha iyi anlamanız için birer fırsattır.

Biz bu savaşta Docker’ı, Python’u, Debian’ı ve SpotDL’i kendi lehimize bükmeyi başardık. Artık kütüphanemiz tıkır tıkır doluyor!

Peki, indirdiğimiz bu dosyalar neden TrueNAS ve Windows ağımızda bir anda görünmez oldu? Bir harfin büyüklüğü dosya sistemini nasıl kaosa sürükler?

Serinin bir sonraki yazısında, “Linux Dosya İzinleri ve Büyük/Küçük Harf Hassasiyeti Savaşları” başlığı altında buluşmak üzere!