Kuidas majutada Lavalinki serverit

Mida Lavalink vajab

• Java 17 või uuem. Lavalink soovitab uusimat LTS-versiooni.
• Lavalink 4.2 või uuem. Alates 2026. aasta märtsist lubab Discord ainult otspunktkrüpteeritud häält (DAVE protokoll) ja Lavalink 4.2.0 oli esimene versioon, mis seda toetas. Vanemad serverid ei saa Discordis enam heli esitada.
• Klienditeek sinu botis, mis toetab sama versiooni — praegused lavalink-client, Shoukaku, Wavelink, lavalink.py ja teised toetavad. Valikut käsitleb juhend kuidas teha Discordi muusikabotti.
• Masin, mis jääb sisse lülitatuks, sest muusika peatub koos Lavalinkiga.

Lavalinki allalaadimine ja käivitamine

1. Laadi Lavalink.jar uusimast väljalaskest GitHubis tühja kausta.
2. Loo samasse kausta application.yml (järgmine jaotis).
3. Käivita see sellest kaustast:

java -jar Lavalink.jar

Lavalink on valmis, kui logi näitab, et see on käivitunud. Linuxi serveris soovitab Lavalinki dokumentatsioon käitada seda systemd teenusena, et see taaskäivituks pärast kokkujooksmist ja masina taaskäivitust; avaldatud on ka Docker image.

application.yml seadistamine

Minimaalne Lavalink 4 konfiguratsioon koos YouTube'i pluginaga:

server:
  port: 2333
  address: 0.0.0.0
lavalink:
  plugins:
    - dependency: "dev.lavalink.youtube:youtube-plugin:1.18.2"
      snapshot: false
  server:
    password: "a-long-random-password"
    sources:
      youtube: false
      soundcloud: true
      bandcamp: true
      twitch: true
      vimeo: true
      http: true
      local: false
plugins:
  youtube:
    enabled: true
    allowSearch: true

• password — muuda see ära. Näidiskonfiguratsioonis on youshallnotpass, mis on avalik; igaüks, kes su serveri leiab, saaks seda vaikeparooliga kasutada.
• port — vaikimisi 2333; sinu bot ühendub selle pordiga.
• sources.youtube: false — sisseehitatud YouTube'i allikas on aegunud. Plugin asendab selle ja selle dokumentatsioon ütleb, et sisseehitatud allikas tuleb välja lülitada.
• http: true lubab botil esitada otselinke; ametlik näide märgib, et ilma proksita võib see paljastada sinu serveri IP.

YouTube, Spotify ja muud allikad

Pluginad loetletakse jaotises lavalink.plugins ja laaditakse alla käivitamisel. Kaht tasub teada:

• youtube-source (dev.lavalink.youtube:youtube-plugin) — YouTube'i esitus ja otsing. YouTube blokeerib aktiivselt automatiseeritud ligipääsu, nii et see võib lakata töötamast, kuni pluginat uuendatakse; hoia see uusimal versioonil.
• LavaSrc (com.github.topi314.lavasrc:lavasrc-plugin) — lisab Spotify, Apple Musicu, Deezeri ja muud. Spotify ja Apple Musicu linkidest loetakse loo andmed ning heli esitatakse teisest allikast.

Boti ühendamine Lavalinkiga

Iga Lavalinki klient küsib samu nelja väärtust, mida nimetatakse sõlmeks (node):

Näiteks Wavelink Pythonis võtab wavelink.Node(uri="http://your-host:2333", password="..."). Kui bot ei saa ühendust, kontrolli kõigepealt parooli ja seejärel, kas port on kättesaadav sealt, kus bot töötab.

Lavalinki majutus HytHostis

1. Vali keskkonnaks Lavalink. Lehel Discordi botimajutus vali pakett ja keeleks Lavalink. Server paigaldab uusima Lavalinki Java 21 peale koos ametliku näidiskonfiguratsiooniga.
2. Muuda parool. Ava application.yml failihalduris ja asenda vaikeparool. Paneel määrab aadressi ja pordi juba sinu serveri enda pordile, nii et jäta need kaks nii, nagu need on.
3. Lisa YouTube'i plugin, kui soovid YouTube'i: plugina plokk ja youtube: false ülaltoodud konfiguratsioonist, seejärel taaskäivita.
4. Ühenda oma bot paneelis kuvatud serveri aadressi ja pordi ning enda määratud parooliga.

Lavalink töötab omaette serverina, botist eraldi. Telli üks pakett botile ja teine Lavalinki keskkonnaga või palu meil mitme botikohaga paketi puhul üks neist Lavalinki keskkonda üle viia. Meie testides kasutab Lavalink jõudeolekus alla 200 MB; ühele väikesele botile soovitame 1 GB, rohkem, kui see mängib korraga paljudes serverites.