איך לארח שרת 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 מבקש את אותם ארבעה ערכים, שנקראים יחד צומת (node):

לדוגמה, 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, ויותר אם הוא מנגן בשרתים רבים בו-זמנית.