Як розмістити сервер Lavalink

Що потрібно для Lavalink

• Java 17 або новіша. Lavalink рекомендує останній LTS-реліз.
• Lavalink 4.2 або новіший. З березня 2026 року Discord дозволяє лише голос із наскрізним шифруванням (протокол DAVE), і Lavalink 4.2.0 став першим релізом із його підтримкою. Старіші сервери більше не можуть відтворювати звук у Discord.
• Клієнтська бібліотека в боті з підтримкою тієї ж версії — актуальні lavalink-client, Shoukaku, Wavelink, lavalink.py та інші її підтримують. Про вибір бібліотеки йдеться в гайді як зробити музичного бота Discord.
• Машина, яка не вимикається, бо музика зупиняється разом із Lavalink.

Завантажте й запустіть Lavalink

1. Завантажте Lavalink.jar з останнього релізу на GitHub у порожню папку.
2. Створіть application.yml у тій самій папці (наступний розділ).
3. Запустіть його з цієї папки:

java -jar Lavalink.jar

Lavalink готовий, коли в лозі з'явиться повідомлення про запуск. На Linux-сервері документація Lavalink радить запускати його як службу systemd, щоб він перезапускався після збою та перезавантаження; також доступний Docker-образ.

Налаштування application.yml

Мінімальна конфігурація Lavalink 4 з плагіном YouTube:

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 — обов'язково змініть. У прикладі конфігурації стоїть youshallnotpass, він загальновідомий; будь-хто, хто знайде ваш сервер, зможе скористатися ним із паролем за замовчуванням.
• port — за замовчуванням 2333; до цього порту підключається бот.
• sources.youtube: false — вбудоване джерело YouTube застаріло. Його замінює плагін, і в документації плагіна сказано, що вбудоване джерело треба вимкнути.
• http: true дозволяє боту відтворювати прямі посилання; в офіційному прикладі зазначено, що без проксі це може розкрити IP вашого сервера.

YouTube, Spotify та інші джерела

Плагіни перелічуються в lavalink.plugins і завантажуються під час запуску. Варто знати два з них:

• youtube-source (dev.lavalink.youtube:youtube-plugin) — відтворення та пошук на YouTube. YouTube активно блокує автоматизований доступ, тож плагін може перестати працювати до виходу оновлення; тримайте його на останній версії.
• LavaSrc (com.github.topi314.lavasrc:lavasrc-plugin) — додає Spotify, Apple Music, Deezer та інші. З посилань Spotify і Apple Music беруться дані про трек, а звук відтворюється з іншого джерела.

Підключення бота до Lavalink

Будь-який клієнт Lavalink запитує ті самі чотири значення, які називаються нодою:

Наприклад, Wavelink у Python приймає wavelink.Node(uri="http://your-host:2333", password="..."). Якщо бот не може підключитися, спершу перевірте пароль, потім — чи доступний порт з тієї машини, де працює бот.

Хостинг Lavalink на HytHost

1. Оберіть Lavalink як середовище виконання. На сторінці хостингу Discord-ботів оберіть тариф і вкажіть Lavalink як мову. Сервер встановить останню версію Lavalink на Java 21 з офіційним прикладом конфігурації.
2. Змініть пароль. Відкрийте application.yml у файловому менеджері та замініть пароль за замовчуванням. Панель уже прописує адресу й порт вашого сервера, тож ці два параметри залиште як є.
3. Додайте плагін YouTube, якщо потрібен YouTube: блок плагіна та youtube: false з конфігурації вище, потім перезапустіть.
4. Підключіть бота, вказавши адресу й порт сервера з панелі та заданий вами пароль.

Lavalink працює як окремий сервер, незалежно від бота. Замовте один тариф для бота й ще один із середовищем Lavalink або, якщо в тарифі кілька слотів для ботів, попросіть нас перевести один із них на середовище Lavalink. У наших тестах Lavalink у простої займає менше 200 MB; для одного невеликого бота ми рекомендуємо 1 GB, більше — якщо він грає на багатьох серверах одночасно.