📘 Reflektör Kurulum Kılavuzu

Reflektör, DVPX kullanıcılarının buluştuğu sunucudur. Uygulamalar ona TCP ile bağlanıp kimliğini bildirir ve bir talkgroup seçer; konuşurken ses paketleri UDP ile reflektöre gider, reflektör de aynı talkgroup'taki herkese dağıtır.

Reflektörler birbirine de bağlanır: bir talkgroup ağın tamamında ortaktır, hangi reflektöre bağlı olduğunuz konuşmayı bölmez. Reflektör veritabanına DOĞRUDAN BAĞLANMAZ — panelle yalnızca kendisine verilen API token'ı üzerinden konuşur. Bu yüzden sizin sunucunuzda hiçbir veritabanı bilgisi bulunmaz.

1. Kaydolun. Çağrı işaretiniz kullanıcı adınız olur. Hesabınız panel yöneticisinin onayını bekler.
2. Reflektör ekleme talebi gönderin. Sunucunuzun adresini, portlarını ve gerekçenizi yazın. Sunucuyu bu adımdan önce kiralamış olmanız gerekmez, ama adresini biliyor olmanız gerekir.
   Formda SSH bilgileri de sorulur ama ZORUNLU DEĞİLDİR — boş bırakabilirsiniz. Verirseniz panel yöneticisi bir arıza anında sunucunuza bakıp kurulumda size yardım edebilir; parola şifreli saklanır ve yalnızca panel yöneticisi görür.
3. Onay ve token. Panel yöneticisi talebi onaylar ve reflektör kaydını oluşturur. Token ürettiği anda token BU PANODA sizi bekler: "Panom" ekranındaki Reflektörlerim listesinden ⚿ Token'ı Göster düğmesine basarsınız ve hazır bir config.json ile birlikte görünür. Token'ın WhatsApp'tan ya da e-postadan gönderilmesi GEREKMEZ — zaten gönderilmemesi gerekir.
   Panoda beklerken token şifreli durur ve anahtarı veritabanında değildir. Kurulumu bitirince "Aldım, panodan kaldır" düğmesiyle silin.
4. Sunucuyu hazırlayın. Node.js kurun, dosyaları yerleştirin, config.json yazın, portları açın, servisi başlatın. Aşağıdaki bölümler bunu anlatır.
5. Doğrulayın. Reflektörünüz panele haber vermeye başlayınca panonuzdaki "Reflektörlerim" listesinde YAYINDA görünür. Görünmüyorsa nedenini aynı satır yazar.

Bir talkgroup numarası ÜLKE KODUYLA BAŞLAR. Kaydolurken seçtiğiniz ülke bu kodu belirler ve yalnızca kendi kodunuzla başlayan numaraları talep edebilirsiniz. Böylece numara alanı ülkelere göre kendiliğinden bölünür ve iki ülkenin operatörü aynı numarayı istemez.

1) Node.js

Önce kurulu mu bakın: sürüm 18 veya üzeriyse bu adımı atlayın.

💡 npm install ÇALIŞTIRMANIZA GEREK YOK. DVPX reflektörünün hiçbir dış paket bağımlılığı yoktur; Node'un kendi modüllerini kullanır.

2) Dosyaları depodan çekin

Dosyalar herkese açık GitHub deposundadır. Git ile çekmeniz önerilir: güncelleme daha sonra tek komuta iner.

Komutun sonundaki /opt/dvpx-reflector yolunu atlamayın: hedef dizini açıkça vermek dosyaların tam olarak oraya inmesini sağlar (mkdir yapmanız gerekmez, git dizini kendisi oluşturur). Bu yolu bilerek seçiyoruz — depoyla gelen dvpx-reflector.service dosyası da aynı yolu kullanır, böylece onu hiç düzenlemeden kopyalayabilirsiniz. Depo yalnızca reflektördür; panel ağın merkezinde çalışır ve sizin sunucunuza kurulmaz.

3) config.json

Aşağıdaki şablonu /opt/dvpx-reflector/config.json olarak kaydedin. Panelin adresi bu kuruluma göre önceden yazılmıştır; token'ı yöneticiden aldığınız değerle değiştirin. Portlar talebinizde yazdıklarınızla AYNI olmalıdır.

4) Güvenlik duvarı

Sağlayıcınızın panelinde İKİNCİ bir güvenlik duvarı olabilir (Hetzner, AWS, Oracle Cloud, Azure, Google Cloud…). En sık atlanan yer burasıdır: aynı kuralları oraya da ekleyin.

5) Deneme çalıştırması

Log temiz görünüyorsa (panele kayıt başarılı, TCP/UDP dinleniyor) Ctrl+C ile durdurup servise geçin.

6) Servis olarak kurun

Böylece SSH penceresini kapatsanız da çalışır, sunucu yeniden başlarsa kendiliğinden açılır, çökerse kendiliğinden geri gelir. Reflektörü root ile ÇALIŞTIRMAYIN.

Kurulum yolunuz /opt/dvpx-reflector değilse servis dosyasındaki WorkingDirectory, Documentation ve ReadWritePaths satırlarını düzeltin. node başka bir yerdeyse (which node) ExecStart satırını da düzeltin.

1) Önce yedek alın

config.json sizin dosyanızdır ve depoda tutulmaz; git pull üzerine yazmaz. Yine de yedek bir dakikanızı alır ve token'ınızı yeniden istemek zorunda kalmanızı önler.

2) Güncellemeyi indirin ve kurun

Git ile kurduysanız (önerilen yol) tamamı beş komut. git kurulu değilse ilk satır onu kurar.

Git ile kurmadıysanız (tek seferlik geçiş)

Dizin bir git deposu değilse (zip ile kurduysanız) bir kereye mahsus yeniden klonlayın; config.json'ınız korunur. Bundan sonraki güncellemeler yukarıdaki beş komuta iner.

3) Güncellendiğini nasıl anlarsınız?

Log satırlarında yeni sürüm numarasını görürsünüz. Reflektör panele ilk bildirimini yaptığı an (en fazla birkaç dakika) panonuzdaki kırmızı uyarı KENDİLİĞİNDEN kalkar — "okudum" düğmesine basmanız ya da yöneticiye haber vermeniz gerekmez. Uyarı kalkmıyorsa güncelleme gerçekten uygulanmamıştır.

config.json her değişiklikten sonra servisi YENİDEN BAŞLATMAK gerekir; dosya yalnızca açılışta okunur.

• Reflektörünüzü sürekli açık tutun. Planlı bakımı önceden haber verin.
• Yazılımı güncel tutun; panel yöneticisi bir sürüm duyurduğunda geçin.
• API token'ını gizli tutun. Sızdığını düşünüyorsanız panonuzdaki "Yeni Token İste" düğmesiyle DERHAL yenisini talep edin.
• Bir sorun olduğunda panonuzdaki 💬 Yönetici ile Yazış ekranından yazın; yazışma anlık ilerler ve bütün panel yöneticileri görür.
• Reflektörü root ile çalıştırmayın; ayrıcalıksız bir kullanıcı kullanın.
• Anlık iletişim bilgilerinizi güncel tutun — acil durumda size oradan ulaşılır.
• Kullanıcı trafiğini kaydetmeyin ve üçüncü taraflara aktarmayın.

Reflektör yöneticisi hesabı BİLEREK çok sınırlıdır. Yaptığınız hiçbir işlem ağa doğrudan dokunmaz; her şey panel yöneticisinin onayından geçer.