تیم‌اسپیک

نصب و تنظیم ربات‌های تیم‌اسپیک

راهنمای انتخاب و راه‌اندازی ربات تیم‌اسپیک: تفاوت سینوس بات، موزیک بات و JTS3، ساخت دسترسی کوئری، پورت‌ها، لیست مجاز IP و نکات امنیتی.

زمان مطالعه: ۷ دقیقه

ربات‌ها بخشی از کارهای تکراری ادمین را خودکار می‌کنند: پخش موسیقی، جابه‌جا کردن کاربران بی‌حرکت، دادن گروه به اعضای جدید و ثبت آمار. در این آموزش یاد می‌گیرید چه ربات‌هایی وجود دارد، کدام برای شما مناسب است و پیش‌نیازهای مشترک همه‌ی آن‌ها چیست.

چه رباتی انتخاب کنم؟

رباتکاربرد اصلیمناسب برای
SinusBotپخش موزیک و رادیو در کانال، با پنل تحت وبسرورهایی که موزیک بات می‌خواهند
TS3AudioBotپخش موزیک متن‌باز، کنترل با دستور متنیکاربران فنی و مدیران VPS
JTS3ServerModمدیریت خودکار: انتقال کاربر بی‌حرکت، گروه خودکار، اطلاع‌رسانیمدیریت سرورهای شلوغ
ربات اختصاصیقابلیت دلخواه، مثل رتبه‌بندی یا اتصال به سایتجامعه‌هایی با نیاز خاص

هر ربات نیازمندی‌ها و مستندات رسمی خودش را دارد (مثل نصب ffmpeg یا یک ابزار دانلود برای پخش موزیک). قبل از نصب حتماً مستندات همان ربات را بخوانید؛ این آموزش بخش مشترک آماده‌سازی تیم‌اسپیک را توضیح می‌دهد.

مرحله ۱: یک دسترسی مخصوص ربات بسازید

  1. در سرور یک گروه جدید به نام «Bot» بسازید (Permissions، سپس Server Groups).
  2. فقط دسترسی‌هایی را بدهید که ربات لازم دارد: ورود به کانال‌ها، صحبت و در صورت نیاز جابه‌جا کردن کاربران.
  3. به ربات هرگز گروه Server Admin ندهید؛ اگر ربات یا فایل تنظیمات آن لو برود، کل سرور در خطر است.

مرحله ۲: دسترسی کوئری (ServerQuery)

بسیاری از ربات‌ها از طریق ServerQuery به سرور وصل می‌شوند. در کلاینت از منوی Tools گزینه‌ی «ServerQuery Login» را بزنید، یک نام کاربری بنویسید و رمز تولیدشده را نگه دارید. پورت‌هایی که معمولاً درگیرند:

پورتنوعکاربرد
9987UDPصدا (اتصال کاربران)
10011TCPServerQuery (خام)
10022TCPServerQuery روی SSH
30033TCPانتقال فایل
مهم: سرورها برای کوئری محدودیت ارسال (anti-flood) دارند. آی‌پی ماشینی که ربات روی آن اجراست را در فایل query_ip_allowlist.txt (در نسخه‌های قدیمی‌تر query_ip_whitelist.txt) بنویسید تا ربات به‌خاطر درخواست‌های زیاد بن نشود. در سرور اشتراکی این فایل را پشتیبانی تغییر می‌دهد.

مرحله ۳: نصب و اتصال

ربات را طبق مستندات خودش روی یک VPS یا کامپیوتر همیشه‌روشن نصب کنید؛ ربات روی سیستمی که خاموش می‌شود کار نمی‌کند. برای اجرای دائمی، یک سرور مجازی VPS انتخاب مناسبی است. سپس آدرس سرور، پورت، نام کاربری و رمز کوئری را در تنظیمات ربات بنویسید و گروه «Bot» را به آن بدهید.

نکات امنیتی

  • ربات را فقط از سایت یا مخزن رسمی سازنده بگیرید؛ فایل‌های «نسخه‌ی کرک‌شده» اغلب بدافزار دارند.
  • رمز کوئری و توکن‌ها را در فایل عمومی یا گروه چت نگذارید.
  • ربات‌ها را به‌روز نگه دارید، چون ضعف‌های امنیتی و تغییرات منبع‌های پخش مرتب اصلاح می‌شوند.

سوالات پرتکرار

ربات موزیک چرا بعد از مدتی کار نمی‌کند؟
معمولاً به‌خاطر تغییر منبع پخش (مثل یوتیوب) است و با به‌روزرسانی ابزار دانلود مرتبط ربات حل می‌شود.
آیا روی سرور اشتراکی هم می‌شود ربات نصب کرد؟
بله، با ثبت تیکت تیم ما ربات را روی سرور شما نصب و تنظیم می‌کند. جزئیات در صفحه‌ی ربات تیم‌اسپیک آمده است.
کوئری یاتکا چیست؟
پلن‌های تیم‌اسپیک با یاتکا تعداد کوئری فعال بیشتری برای ربات‌ها و ابزارهای مدیریتی دارند.