كيف تستضيف سيرفر Lavalink على مدار الساعة 24/7

لإبقاء سيرفر Lavalink يعمل 24/7 تحتاج إلى أربعة أشياء: جهاز لا ينام أبدًا، وJava 17 أو أحدث، وملف Lavalink.jar من إصدارات Lavalink على GitHub مع ملف application.yml يضبط كلمة مرور خاصة بك، وشيء يعيد تشغيل Lavalink بعد انهيار أو إعادة تشغيل الجهاز. بعدها يتصل بوتك بعنوان السيرفر ومنفذه وكلمة مروره. وللتشغيل من YouTube تحتاج أيضًا إلى إضافة YouTube مسجَّلًا دخولها بحساب Google احتياطي؛ وإصدارها الحالي يحتاج إلى أكثر من ذلك، راجع كيف تشغّل YouTube على Lavalink 4. باقة Lavalink من PlayNHost فيها كل ذلك مثبّتًا: Lavalink 4.2.2 وإضافة YouTube وكلمة مرور أُنشئت لعقدتك. في اختبارنا على باقة 1 GB كانت العقدة جاهزة بعد 11 إلى 13 ثانية من التشغيل، واستهلكت نحو 240 MiB من الذاكرة في حالة الخمول.

ما الذي يحتاجه سيرفر Lavalink ليعمل 24/7

شغّله على سيرفر Linux خاص بك

هذه هي الخطوات من وثائق Lavalink نفسها.

1. ثبّت Java 17 أو أحدث وتحقق منها بالأمر java -version.
2. أنشئ مجلدًا، مثل /home/lavalink/lavalink، وضع فيه Lavalink.jar الذي نزّلته من أحدث إصدار على GitHub الخاص بـ Lavalink. في 6 نوفمبر 2026 هو 4.2.2.
3. بجانبه أنشئ application.yml. أصغر ملف مفيد يضبط المنفذ والعنوان وكلمة مرور خاصة بك، ويوقف مصدر YouTube القديم المدمج الذي لم يعد Lavalink يحدّثه:

server:
  port: 2333
  address: 0.0.0.0
lavalink:
  server:
    password: "change-this-to-a-long-random-password"
    sources:
      youtube: false
      soundcloud: true
      http: true

4. شغّله مرة واحدة يدويًا بالأمر java -jar Lavalink.jar وانتظر ظهور Lavalink is ready to accept connections.
5. لإبقائه يعمل، اجعله خدمة systemd. تقدّم وثائق Lavalink هذه الوحدة؛ احفظها باسم /usr/lib/systemd/system/lavalink.service مع مستخدمك ومجلدك:

[Unit]
Description=Lavalink Service
After=syslog.target network.target

[Service]
User=lavalink
Group=lavalink
WorkingDirectory=/home/lavalink/lavalink
ExecStart=java -Xmx4G -jar /home/lavalink/lavalink/Lavalink.jar
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target

6. نفّذ sudo systemctl daemon-reload ثم sudo systemctl enable lavalink ثم sudo systemctl start lavalink. ويعرض sudo journalctl -u lavalink سجلّه.
7. اضبط -Xmx بما يناسب الجهاز: -Xmx4G يسمح لذاكرة heap في Java بالنمو حتى 4 GB، وهذا أكثر مما يملكه سيرفر صغير. افتح المنفذ في جدار الحماية، ثم اختبره كما في الخطوة 2 أدناه.

من ذلك الحين تحدّث Java وLavalink وإضافاته بنفسك وتراقب الانهيارات. وYouTube يحتاج إلى الإضافة: كيف تشغّل YouTube على Lavalink 4.

على باقة PlayNHost: ما الذي يضبطه التثبيت

• Lavalink 4.2.2، منزَّل من إصدار Lavalink على GitHub ومفحوص بمجموع تحقق ثابت.
• إضافة مصدر YouTube، الإصدار 1.18.2 مع إصلاحات PlayNHost، في مجلد plugins باسم youtube-plugin-1.18.2-playnhost1.jar.
• ملف application.yml بكلمة مرور أُنشئت لعقدتك وحدها، مع تفعيل هذه المصادر: Bandcamp وTwitch وVimeo وNiconico وروابط http المباشرة. مصدرا SoundCloud وYouTube الأصليان في Lavalink معطّلان، ويمر YouTube عبر الإضافة. وكل مرشحات الصوت (equalizer وtimescale وkaraoke وغيرها) مفعّلة.

إعادة التثبيت لاحقًا تُبقي ملف application.yml وتطبع Kept your application.yml.

1. اعثر على العنوان وكلمة المرور

1. افتح سيرفرك في لوحة التحكم. تعرض نظرة عامة بطاقة Lavalink مع اسم العقدة والعنوان وكلمة المرور.
2. بجانب العنوان اضغط أيقونة النسخ. تنسخ host:port.
3. تظهر في كلمة المرور العبارة في application.yml. اضغط فتح application.yml. تحت lavalink: ثم server: انسخ قيمة password: دون علامتي الاقتباس.

تعامل مع كلمة المرور كأنها مفتاح: كل من يملك العنوان وكلمة المرور يستطيع استخدام عقدتك. لتغييرها، عدّل password: في الملف نفسه، واحفظ، وأعد تشغيل العقدة، ثم حدّث بوتك.

2. شغّلها وتحقق منها

1. افتح Console (أو اضغط السجلات على البطاقة) واضغط تشغيل.
2. تكون Lavalink جاهزة عندما تعرض Console:

Lavalink is ready to accept connections.

3. للاختبار من حاسوبك، اطلب من العقدة إصدارها بكلمة مرورك:

curl -H "Authorization: YOUR_PASSWORD" http://HOST:PORT/version

تردّ بـ 4.2.2 عندما تعمل. الرد 403 يعني أن كلمة المرور خاطئة، و401 يعني أن ترويسة Authorization ناقصة، وغياب أي رد يعني أن العنوان خاطئ أو أن العقدة متوقفة.

ثم اربط بوتك: كيف تربط بوت Discord الخاص بك بـ Lavalink. تستخدم العقدة http وws العاديين، لذلك اترك خيار الاتصال الآمن أو SSL مغلقًا في عميلك. يجب أن يكون عميلك إصدارًا يدعم تشفير الصوت DAVE من Discord؛ ويسرد دليل الاتصال الإصدارات.

3. سجّل الدخول إلى YouTube مرة واحدة

عند أول تشغيل تطلب الـ Console منك تسجيل دخول إضافة YouTube بحساب Google، بسطر مثل:

OAUTH INTEGRATION: To give youtube-source access to your account, go to https://www.google.com/device and enter code XXXX-XXXX

استخدم حساب Google احتياطيًا أنشأته لهذا الغرض، وليس حسابك الشخصي أبدًا: يحذّر مؤلفو الإضافة من أن الحساب قد يُغلق. في اختبارنا بتاريخ 6 نوفمبر 2026 (اختبار تشغيل مدته 15 ثانية لكل أغنية، دون قناة صوتية) لم تستطع العقدة تشغيل أي أغنية من 12 أغنية على YouTube قبل تسجيل الدخول، وشغّلت بلا خطأ كل اختبار من الاختبارات الـ 10 التي اكتملت بعده. وهل يقدّم YouTube أغنية معيّنة لسيرفر ما فهذا قرار YouTube، ولا نستطيع أن نعد بذلك. الخطوات، وكيف تحتفظ بتسجيل الدخول بعد إعادة التشغيل: كيف تشغّل YouTube على Lavalink 4.

ما الذي تعيد اللوحة كتابته عند كل تشغيل

تضبط اللوحة قيمتين في application.yml عند كل تشغيل للعقدة. أي تغيير عليهما يُعاد كما كان:

• server.port: منفذ سيرفرك، وهو المنفذ الوحيد المفتوح على الإنترنت. تُستبدل القيمة 2333 المكتوبة عند التثبيت.
• plugins.youtube.remoteCipher.url: خدمة من PlayNHost تستخدمها إضافة YouTube، ولا يمكن الوصول إليها إلا من سيرفراتنا.

الإصدار

في تبويب الإعدادات، إعدادات اللعبة، حقل الإصدار مضبوط على 4.2.2، وهو الإصدار الذي نختبره وندعمه. وهو في 6 نوفمبر 2026 أيضًا أحدث إصدار من Lavalink. تُنزَّل الإصدارات الأخرى دون مجموع تحقق وهي غير مدعومة. تُقرأ القيمة أثناء تثبيت السيرفر فقط، لذلك تسري عند إعادة التثبيت.

إعادة التثبيت

تنزّل إعادة التثبيت Lavalink وإضافاتها من جديد، وهذا يصلح أيضًا ملف Lavalink.jar أو ملف إضافة تالفًا أو محذوفًا. يبقى ملف application.yml بكلمة مروره وتغييراتك.

1. افتح تبويب الإعدادات واضغط تفاصيل التشغيل.
2. في بطاقة إعادة التثبيت («ينزّل Lavalink وإضافاته من جديد بالإصدارات التي اختبرتها PlayNHost. يبقى ملف application.yml.») اضغط إعادة التثبيت.
3. أكّد في إعادة تثبيت هذا الخادم؟ بالضغط على إعادة التثبيت. تتوقف العقدة أثناء التثبيت.
4. عند الانتهاء اضغط تشغيل في Console.

الإضافات التي رفعتها بنفسك تبقى في مجلد plugins. يستبدل التثبيت ملف إضافة YouTube الذي يأتي معه فقط.

كم من الذاكرة تستهلك عقدة Lavalink

ذاكرة heap في Java لـ Lavalink على باقاتنا محدودة بثلاثة أرباع حد ذاكرة السيرفر. شغّلنا العقدة المثبّتة ثلاث أو أربع مرات على كل حجم باقة في 6 نوفمبر 2026، بحدود الذاكرة والمعالج نفسها والصورة وأمر التشغيل نفسهما اللذين تستخدمهما اللوحة، على أحد عقد الإنتاج المشغولة لدينا، وقرأنا ذاكرتها بعد 60 ثانية من جاهزيتها، دون أي بوت متصل:

استهلكت العقدة الخاملة تقريبًا الذاكرة نفسها على كل باقة، أي نحو ربع باقة 1 GB. تمنح الباقات الأكبر الـ heap مساحة للنمو، وبمعالج أقوى بدأت أسرع في اختبارنا. وكل مشغّل يبثّ الصوت يضيف إلى ذلك. لم نقِس بعد كم مشغّلًا تخدمه كل باقة، ولذلك لا نذكر رقمًا لذلك. راقب بطاقة الاستخدام في نظرة عامة بعد يوم من الاستخدام الفعلي: كيف تقرأ رسوم استخدام سيرفرك.

هل تحتاج عقدة Lavalink خاصة بك؟

العقدة العامة المجانية مناسبة للتجربة أو لبوت خاص صغير جدًا. أما البوت الذي يعتمد عليه الناس فالأفضل له عقدة تتحكم بها، لأنك تختار إضافاتها ومصادرها وكلمة مرورها.

قبل أن تعتمد على عقدة عامة، تأكد أن إصدار Lavalink الرئيسي فيها يطابق عميلك: العميل المخصص للإصدار 3 لا يعمل مع عقدة من الإصدار 4. والانتقال إلى عقدتك الخاصة لاحقًا يعني تغيير ثلاث قيم في بوتك: المضيف والمنفذ وكلمة المرور. الباقات: استضافة Lavalink.

الخطوة التالية

• اربط بوتك: كيف تربط بوت Discord الخاص بك بـ Lavalink.
• شغّل YouTube: كيف تشغّل YouTube على Lavalink 4.
• أضف مصادر وميزات: كيف تضيف إضافات إلى Lavalink.
• إذا فشل شيء: أخطاء Lavalink ومعناها.