Как разместить сервер 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, больше — если он играет на многих серверах одновременно.