SinusBot Kurulumu: TeamSpeak ve Discord Müzik Botu

SinusBot, TeamSpeak 3 ve Discord sunucularında arkadaşlarınızla birlikte müzik dinlemenizi sağlayan bir müzik botudur; web arayüzü üzerinden yönetilir ve kendi script'leriyle genişletilebilir. Kurulumu göründüğünden biraz daha teknik: bot, arka planda gerçek bir TeamSpeak istemcisi çalıştırdığı için sunucunuzda grafik kütüphaneleri ve sanal ekran gerektirir — ve bu yüzden her sanal sunucuda çalışmaz. Bu rehberde gereksinimleri, üç farklı kurulum yolunu, ilk yapılandırmayı ve sık yapılan hataları anlatıyoruz.

SinusBot nedir, ne işe yarar?

SinusBot, ses kanalınıza katılıp müzik çalan bir bottur. Resmî tanımıyla, TeamSpeak 3 ya da Discord üzerinde arkadaşlarınızla birlikte müzik dinlemenizi sağlar. Öne çıkan yanları:

• Web arayüzü. Bot tarayıcıdan yönetilir; çalma listesi, ses seviyesi ve bot ayarları buradan kontrol edilir.
• Sohbet komutları. Kullanıcılar TeamSpeak ya da Discord sohbetinden komutla şarkı isteyebilir.
• Script desteği. Topluluk tarafından yazılan script'lerle sunucu yönetimi ve ek işlevler eklenebilir.
• Metinden sese (TTS). Yerleşik bir metin okuma motoru vardır — varsayılan olarak kapalıdır.
• Tek kurulumla iki platform. Aynı bot hem TeamSpeak hem Discord'da çalışabilir; yalnızca Discord için ayrı bir imaj da mevcuttur.

Bilinmesi gereken bir ayrıntı: SinusBot uzun süredir 1.0.0-beta sürüm serisinde ilerliyor. Yaygın olarak kullanılıyor ve geliştirmesi sürüyor, ancak "beta" etiketi hâlâ üzerinde — bunu üretim kararınızda hesaba katın.

Sistem gereksinimleri: kurulumdan önce doğrulayın

Kurulum hatalarının çoğu, gereksinimlerin baştan kontrol edilmemesinden çıkar. Resmî dokümantasyonun belirttiği koşullar:

• 64-bit işletim sistemi. 32-bit desteklenmiyor.
• Debian 10+, Ubuntu 20.04+ veya CentOS 8+.
• Linux çekirdeği 3.17 veya üzeri. TeamSpeak istemcisi 3.3+ bunu gerektiriyor. uname -a ile doğrulayın.
• En az 512 MB – 1 GB boş RAM ve yeterli disk alanı.
• KVM veya LXC tabanlı sanallaştırma. Dokümantasyon OpenVZ tabanlı VPS'lerden kaçınmayı açıkça öneriyor — bu, kurulumun başarısız olmasının en yaygın sebeplerinden biridir.

Bu son madde önemli: ucuz VPS paketlerinin bir kısmı hâlâ OpenVZ üzerinde çalışır ve SinusBot orada düzgün çalışmaz. Sunucu alırken sanallaştırma tipini sormak, kurulumdan sonra sorun aramaktan çok daha ucuzdur. Sanallaştırma tiplerinin farkını VDS ile VPS arasındaki fark yazımızda ele aldık.

Üç kurulum yolu

1. Installer script (en kolay)

Linux'a yeniyseniz ya da her şeyin sizin için kurulmasını istiyorsanız resmî dokümantasyon installer script kullanmanızı öneriyor. Bağımlılıkları, TeamSpeak istemcisini ve servis tanımını tek seferde halleder.

2. Manuel kurulum

Neyin nereye kurulduğunu görmek isteyenler için. Aşağıda adımları veriyoruz.

3. Docker

Resmî Docker imajı mevcut. Sistem bağımlılıklarıyla uğraşmak istemiyorsanız en temiz yol budur — özellikle sunucuda başka servisler de çalışıyorsa izolasyon avantajı sağlar.

Manuel Linux kurulumu: adım adım

Bağımlılıkları kurun

SinusBot arka planda gerçek bir TeamSpeak istemcisi çalıştırır; bu yüzden sanal ekran ve grafik kütüphaneleri gerekir. Gereken paketler:

x11vnc xvfb libxcursor1 ca-certificates curl bzip2 libnss3 libegl1-mesa x11-xkb-utils libasound2 libpci3 libxslt1.1 libxcomposite1

Ubuntu 18.04 kullanıyorsanız x11vnc ve xvfb için universe deposunu etkinleştirmeniz gerekir.

Ayrı bir kullanıcı oluşturun

adduser --disabled-login sinusbot

Botu root olarak çalıştırmayın. Bu, dokümantasyonun açıkça belirttiği bir güvenlik kuralıdır. Web arayüzü internete açık bir servistir; root yetkisiyle çalışan bir web servisi gereksiz risktir.

SinusBot'u indirin ve açın

En güncel sürümü indirip /opt/sinusbot altına çıkarın ve sahipliğini oluşturduğunuz kullanıcıya verin.

TeamSpeak 3 istemcisini kurun

Bot, TeamSpeak'e bağlanmak için gerçek istemciyi kullanır. Dokümantasyon 3.5.6 sürümünü öneriyor. İstemci yolu tipik olarak:

/opt/sinusbot/TeamSpeak3-Client-linux_amd64/ts3client_linux_amd64

Eklentiyi kopyalayın

SinusBot'un TeamSpeak eklentisini istemcinin plugins dizinine kopyalayın. Bu adım atlanırsa bot sunucuya bağlanır ama ses işlevleri çalışmaz — en sık karşılaşılan kurulum hatalarından biridir.

config.ini dosyasını düzenleyin

TeamSpeak istemci yolunu, dinlenecek adresi ve gerekli diğer ayarları burada tanımlarsınız.

Servisi başlatın ve ilk parolayı alın

Bot ilk çalıştırıldığında admin kullanıcısı için bir parola üretir ve konsola yazar. Bu parolayı hemen kaydedin — TeamSpeak sunucusundaki ayrıcalık anahtarı gibi, kaçırırsanız uğraştırır.

Docker ile kurulum

Docker tarafında bilmeniz gerekenler:

• Port: 8087 (web arayüzü).
• Kalıcı dizinler: /opt/sinusbot/scripts ve /opt/sinusbot/data.
• Resmî dokümantasyonun ilkesi net: uygulama verisi konteynerin içinde tutulmamalı, volume'larda saklanmalıdır — böylece sürüm yükseltmeleri sorunsuz olur.
• Etiketleme sürüm bazlıdır (örneğin 1.0.0-beta.6-... biçiminde) ve latest ile yalnızca Discord için discord etiketleri bulunur.

Volume tanımlamadan kurulum yaparsanız ilk güncellemede çalma listeleriniz, ayarlarınız ve script'leriniz gider. Bu, Docker kurulumlarında en pahalı hatadır.

Web arayüzü ve ilk giriş

Kurulum bittiğinde arayüze http://sunucu-ip:8087 adresinden erişirsiniz. Kullanıcı adı admin, parola ilk çalıştırmada üretilen değerdir.

İlk girişte yapılacaklar:

• Parolayı değiştirin. Üretilen parolayı olduğu gibi bırakmayın.
• Portu internete açık bırakmayın. 8087, botun tam yönetim arayüzüdür. Güvenlik duvarında yalnızca kendi IP'nize izin verin ya da bir ters proxy (NGINX veya Apache 2) arkasına alıp TLS ile yayınlayın — dokümantasyon bunun için ayrı bir bölüm sunuyor.
• Bot örneğini oluşturun ve bağlanacağı TeamSpeak sunucusunun adresini, varsa parolasını girin.

TeamSpeak tarafında yapılandırma

Bot bağlandıktan sonra sunucu tarafında birkaç ayar gerekir:

• Bot için ayrı bir sunucu grubu oluşturun. Ona ihtiyacı olan izinleri verin: kanala girme, ses gönderme, gerekiyorsa kanal değiştirme. Server Admin vermeyin.
• Botun duracağı kanalı belirleyin. Müzik kanalını ayrı tutmak, sohbet kanallarındaki ses kalitesini korur.
• Müzik kanalının kalitesini ayrı ayarlayın. Ses sunucusunda bant genişliği aynı anda konuşan/yayın yapan kaynak sayısıyla artar; tüm sunucuyu yüksek kaliteye çekmek yerine yalnızca müzik kanalını yükseltin.
• Ayrıcalık anahtarı kullanın. Botu gruba elle eklemek yerine, o gruba ekleyen tek kullanımlık bir anahtar üretmek daha temizdir.

Sunucu grupları, kanal tipleri ve izin katmanlarının tamamını TeamSpeak 3 sunucusu nasıl yapılandırılır yazımızda ele aldık.

Discord tarafı

Aynı bot Discord'da da çalışabilir. Discord tarafı için bir bot uygulaması oluşturup token almanız ve bunu SinusBot arayüzüne tanımlamanız gerekir. Yalnızca Discord kullanacaksanız, resmî Docker imajının discord etiketli sürümü daha hafif bir kurulum sunar — TeamSpeak istemcisi ve grafik bağımlılıkları gerekmez.

Müzik kaynakları ve telif tarafı

Bu bölüm çoğu rehberde atlanır ama topluluk yöneticisi olarak bilmeniz gerekir.

SinusBot, yerel ses dosyalarını çalabilir ve harici kaynaklardan akış yapabilir. Ancak telifli müziği bir topluluğa yayınlamak, kişisel dinlemeden farklı bir hukuki zemindir. Kapalı bir arkadaş grubuyla dinlemek ile herkese açık, üye alan ve gelir elde eden bir topluluğa yayın yapmak aynı şey değildir.

Ayrıca üçüncü taraf platformlardan otomatik indirme/akış yapmak, o platformların kullanım şartlarına aykırı olabilir. Pratik yaklaşım:

• Telifsiz ya da lisansı uygun müzik kütüphaneleri kullanın.
• Kendi yüklediğiniz, hakkına sahip olduğunuz dosyaları tercih edin.
• Ticari bir topluluk işletiyorsanız hukuki durumu bir danışmana sorun.

Bu genel bir bilgilendirmedir, hukuki tavsiye değildir.

Performans ve kaynak kullanımı

SinusBot ağır bir uygulama değildir ama sıfır da değildir: arka planda bir TeamSpeak istemcisi ve sanal ekran çalıştırdığı için boşta bile bellek tutar. Pratik notlar:

• Tek bot örneği için 512 MB – 1 GB boş RAM yeterlidir; birden fazla örnek çalıştıracaksanız oranlayın.
• Ses kodlama CPU kullanır; çok sayıda eşzamanlı bot örneği tek çekirdek performansına yüklenir.
• Müzik dosyalarını sunucuda barındıracaksanız disk alanını ve okuma hızını hesaba katın.
• Botu ses sunucunuzla aynı makinede çalıştırmak gecikme açısından avantajlıdır.

Sık yapılan 7 hata

• OpenVZ tabanlı bir VPS'te kurmaya çalışmak. Dokümantasyon bundan açıkça kaçınmayı öneriyor; KVM veya LXC kullanın.
• Çekirdek sürümünü kontrol etmemek. TeamSpeak istemcisi 3.17+ istiyor.
• TeamSpeak eklentisini kopyalamayı atlamak. Bot bağlanır ama ses çalışmaz.
• Botu root olarak çalıştırmak.
• İlk çalıştırmada üretilen admin parolasını kaydetmemek.
• 8087 portunu internete açık bırakmak. Ters proxy ve TLS kullanın ya da IP kısıtlayın.
• Docker'da volume tanımlamamak. İlk güncellemede tüm veri gider.

Nubitro ses ve bot sunucuları

SinusBot kurulumunun en sık takıldığı yer sanallaştırma tipidir. Nubitro sunucularında kaynaklar fiziksel bölümlendirme ile tanımlanır ve altyapı KVM tabanlıdır — yani dokümantasyonun kaçınılmasını önerdiği OpenVZ sorunu yaşanmaz.

Sunucular Türkiye / İstanbul lokasyonunda, NVMe M.2 SSD disk ve 1 Gbps sınırsız trafik ile çalışır; altyapı genelinde 200 Tbps üzeri DDoS koruması standarttır. Ses trafiği UDP üzerinden aktığı için bu korumanın UDP'yi kapsaması önemlidir.

Ses sunucusu paketlerini TeamSpeak 3 sunucu kiralama sayfamızdan, botu kendi sunucunuzda çalıştırmak isterseniz Ryzen VDS paketlerinden inceleyebilirsiniz. Tüm hizmetler için nubitro.com ana sayfamızı ziyaret edebilirsiniz.

Sıkça Sorulan Sorular

SinusBot paylaşımlı hostingte çalışır mı?

Hayır. Bot, arka planda kendi süreçlerini ve sanal ekran çalıştırdığı için kök erişimi olan bir sunucu gerekir. Paylaşımlı hosting bunun için uygun değildir; KVM tabanlı bir VDS ya da hazır kurulu bir bot paketi gerekir.

Kurulum sırasında bot bağlanıyor ama ses gelmiyor.

En yaygın sebep, SinusBot eklentisinin TeamSpeak istemcisinin plugins dizinine kopyalanmamış olmasıdır. İkinci sebep, config.ini içindeki TeamSpeak istemci yolunun yanlış olmasıdır. Üçüncüsü, botun sunucu grubunda ses gönderme izninin bulunmamasıdır.

Admin parolasını kaybettim.

Bot verisi üzerinden parola sıfırlaması yapılabilir. Hazır kurulu bir pakette çalışıyorsanız sağlayıcınızın paneli genellikle sıfırlama seçeneği sunar.

Web arayüzünü alan adımla açabilir miyim?

Evet. Dokümantasyon NGINX veya Apache 2 ile ters proxy kurulumunu ayrı bir bölümde anlatıyor. Böylece hem TLS kullanabilir hem 8087 portunu doğrudan internete açmaktan kurtulursunuz. DNS tarafı için DNS kayıtları rehberimize bakabilirsiniz.

Aynı botu hem TeamSpeak hem Discord'da kullanabilir miyim?

Evet, SinusBot her iki platformu da destekler. Yalnızca Discord kullanacaksanız Docker tarafında discord etiketli daha hafif bir imaj mevcut.

Kaç bot örneği çalıştırabilirim?

Sunucunuzun belleği ve CPU'su belirler. Her örnek kendi TeamSpeak istemcisini çalıştırdığı için bellek tüketimi örnek başına artar. Birkaç örnekten fazlasını planlıyorsanız RAM'i buna göre ölçeklendirin.

Özet

• SinusBot, TeamSpeak 3 ve Discord için web arayüzlü bir müzik botudur.
• Uzun süredir 1.0.0-beta serisinde ilerliyor; üretim kararınızda bunu hesaba katın.
• 64-bit işletim sistemi ve Linux çekirdeği 3.17+ gerekir.
• Debian 10+, Ubuntu 20.04+ veya CentOS 8+ desteklenir.
• KVM veya LXC kullanın; dokümantasyon OpenVZ'den kaçınmayı öneriyor.
• En az 512 MB – 1 GB boş RAM gerekir.
• Bot arka planda gerçek bir TeamSpeak istemcisi çalıştırır; grafik bağımlılıkları şarttır.
• TeamSpeak istemcisinde 3.5.6 sürümü öneriliyor ve eklenti plugins dizinine kopyalanmalıdır.
• Botu root olarak çalıştırmayın.
• Web arayüzü 8087 portundadır; ters proxy ve TLS ile yayınlayın.
• Docker kurulumunda scripts ve data dizinlerini volume olarak tanımlayın.
• Bota Server Admin değil, ihtiyacı kadar izni olan ayrı bir grup verin.
• Telifli müziği topluluğa yayınlamanın hukuki boyutunu göz ardı etmeyin.