Lavalink 4’te YouTube nasıl oynatılır

Lavalink 4 YouTube’u kendi başına değil, bir plugin üzerinden oynatır: yerleşik YouTube kaynağı kullanımdan kaldırılmıştır ve kapalı kalmalıdır. YouTube kaynak plugin’ini (dev.lavalink.youtube:youtube-plugin) kurun, youtube: false değerini lavalink.server.sources altında ayarlayın ve plugin’i plugins.youtube altında açın. Sunucularımızda bu yetmedi: YouTube giriş istedi. Bu yüzden plugin’e yedek bir Google hesabıyla bir kez giriş yaptırın ve refresh token’ı saklayın. 1.18.2 sürümünde tek başına giriş de yetmiyor (aşağıdaki “1.18.2 sürümü ve giriş” bölümüne bakın). Kendi Lavalink sunucularımızdan birinde, 6 Kasım 2026’da, 1.18.2 ile yayımlanmamış düzeltmeler ve bir cipher sunucusuyla plugin 12 test şarkısının hepsini buldu, ancak girişten önce hiçbirini başlatamadı; girişten sonra tamamlanan 10 testin hepsini başlattı (her biri 15 saniye, ses kanalı olmadan).

YouTube bir Lavalink sunucusunda neden başarısız olur

Plugin’in kendi belgeleri, YouTube’un bazı istekleri işaretlediğini ve “bot olmadığınızı doğrulamak için giriş yapmanızı” istediğini söyler. Sunucularımızda gördüğümüz tam olarak buydu. Giriş yapılmadığında plugin her test şarkısını aramayla ve bağlantıyla buldu, ama oynatmaya çalışınca istemcilerinin her biri reddedildi:

Client [WEB] failed: This video requires login.
Client [TVHTML5_SIMPLY] failed: Sign in to confirm you’re not a bot
Client [TVHTML5] failed: This video requires login.
Client [WEB_EMBEDDED_PLAYER] failed: This video is unavailable
dev.lavalink.youtube.AllClientsFailedException: (yts.version: 1.18.2) All clients failed to load the item.

Testimizde arama girişsiz çalıştı; oynatma çalışmadı. Botunuz şarkının başladığını ve hemen bir track exception ile başarısız olduğunu görür.

İki şey daha zaman zaman oynatmayı bozar ve plugin’in belgeleri ikisini de ele alır:

• İmza şifresi. YouTube, akışlarının kilidini açan kodu sık sık değiştirir. Plugin bu işi, açık kaynaklı yt-cipher gibi uzak bir cipher sunucusuna (remoteCipher) devredebilir.
• İstemciler. Plugin YouTube ile birkaç uygulama gibi konuşur (WEB, MWEB, ANDROID_VR, TV ve diğerleri) ve onları sizin listelediğiniz sırayla dener. Oynatma için girişi yalnızca TV kullanır, arama yapabilmek için de istemcinin buna uygun işaretlenmiş olması gerekir.

1.18.2 sürümü ve giriş

Girişi TV istemcisi kullanır ve 1.18.2 sürümündeki TV istemcisinin bilinen bir sorunu var: Ağustos 2026’dan beri YouTube ona “The page needs to be reloaded” yanıtını veriyor (plugin’in GitHub deposunda #226 numaralı sorun, 6 Kasım 2026’da hâlâ açık). Plugin geliştiricileri bunun için 19 Ağustos 2026’da bir düzeltmeyi, aynı gün uzunluk bildirmeyen akışlar için bir düzeltmeyi ve 17 Eylül 2026’da cipher bağlantıları için bir düzeltmeyi birleştirdi, ancak 6 Kasım 2026’ya kadar bunları içeren bir sürüm yayımlanmadı. Plugin’in README’si, sürüm yerine belirli bir commit’in derlemesini nasıl yükleyeceğinizi anlatır: commit karması sürüm olarak, snapshot: true ile. Önce sürümler sayfasında daha yeni bir sürüm olup olmadığına bakın.

Plugin’i kendi Lavalink’inizde kurun

1. Plugin’i application.yml içinde lavalink.plugins altına, plugin’in GitHub sürümlerindeki sürümle ekleyin. 1.18.2 (27 Temmuz 2026), 6 Kasım 2026 itibarıyla en yeni sürümdür. Yukarıda anlatılan TV istemcisi sorunu bunda var, bu yüzden sürümü seçmeden önce o bölümü okuyun:

lavalink:
  plugins:
    - dependency: "dev.lavalink.youtube:youtube-plugin:1.18.2"
      snapshot: false
  server:
    sources:
      youtube: false

2. Plugin’i açın ve ona istemcilerini verin:

plugins:
  youtube:
    enabled: true
    allowSearch: true
    clients:
      - MUSIC
      - ANDROID_VR
      - WEB
      - WEBEMBEDDED
      - TV
    oauth:
      enabled: true

3. İsterseniz plugins.youtube.remoteCipher altına (url ve password) bir cipher sunucusu ekleyin; plugin’in README’si bunu anlatır.
4. Lavalink’i başlatın. Konsol bir kod ve bir adres yazdırır: https://www.google.com/device adresini açın, kodu girin ve yedek bir Google hesabıyla erişime izin verin. Plugin’in yazarları hesabın kapatılabileceği konusunda uyarıyor, bu yüzden asla ana hesabınızı kullanmayın.
5. Konsol ardından köşeli parantez içinde token’la birlikte OAUTH INTEGRATION: Token retrieved successfully. Store your refresh token as this can be reused. yazdırır. Node’un yeniden başlatmadan sonra tekrar sormaması için bunu application.yml içine kopyalayın:

    oauth:
      enabled: true
      refreshToken: "PASTE_THE_TOKEN_HERE"

6. Lavalink’i yeniden başlatın. Çalışan bir token’la YouTube access token refreshed successfully kaydı düşer.

Refresh token o Google hesabını açar: application.yml dosyasını gizli tutun.

Bir PlayNHost Lavalink paketinde

Kurulum plugin kısmını zaten yapar: PlayNHost düzeltmeli YouTube plugin’i 1.18.2, plugins içinde youtube-plugin-1.18.2-playnhost1.jar adıyla durur, Lavalink’in kendi YouTube kaynağı kapalıdır, giriş açıktır ve plugin kendi ağımızda çalıştırdığımız bir cipher sunucusunu kullanır. Düzeltmeler, plugin geliştiricilerinin Ağustos ve Eylül 2026’da birleştirdiği ama henüz yayımlamadığı TV istemcisi, cipher ve akış uzunluğu değişiklikleridir. Siz tek bir şey yaparsınız: girişi.

1. Sunucunuzu panelde açın ve Console sayfasında Başlat düğmesine basın.
2. OAUTH INTEGRATION: To give youtube-source access to your account, go to https://www.google.com/device and enter code XXXX-XXXX satırını bulun, adresi açın, kodu girin ve yedek bir Google hesabıyla erişime izin verin.
3. Konsol Token retrieved successfully yazdırınca token’ı parantezlerin içinden kopyalayın, node’u durdurun ve yukarıdaki 5. adımdaki gibi oauth: altına, application.yml dosyasına (Files altında) ekleyin. Girintiyi koruyun.
4. Node’u yeniden başlatın ve YouTube access token refreshed successfully satırını arayın.

plugins.youtube.remoteCipher.url değerini olduğu gibi bırakın: panel onu her başlatmada yazar ve adres yalnızca sunucularımızdan çalışır. Yeniden kurulum, içinde token olan application.yml dosyanızı korur.

YouTube’un belirli bir şarkıyı bir sunucuya verip vermeyeceğine YouTube karar verir ve bu haber verilmeden değişir. Node’u ve plugin’i çalışır tutarız; YouTube’un neye izin vereceğini garanti edemeyiz. YouTube’u hiç istemiyorsanız enabled: false değerini plugins:, youtube: altında ayarlayın.

Konsoldaki YouTube mesajları

YouTube olmadan müzik almanın diğer yolları

Aynı node, giriş gerektirmeyen kaynaklardan oynatabilir. Paketlerimizde Bandcamp, Twitch, Vimeo, Niconico ve doğrudan http bağlantıları baştan açıktır. LavaSrc gibi plugin’ler daha fazla site ekler; bazıları kendi API anahtarlarınızı gerektirir: Lavalink’e plugin nasıl eklenir.

Sonraki

• Node’u kurun: Lavalink sunucusu 7/24 nasıl barındırılır.
• Botunuzu bağlayın: Discord botunuzu Lavalink’e nasıl bağlarsınız.
• Diğer hatalar: Lavalink hataları ve ne anlama geldikleri.
• Paketler: Lavalink barındırma.