Entegrasyon
Video relay
Görüntülü aramaların ve canlı yayınların nasıl taşındığı ve coturn ile kendi TURN sunucunu nasıl çalıştıracağın.
#Hiçbir şey kurman gerekmez
FX Phone, görüntülü aramanın görüntüsünü iki telefon arasında WebRTC ile bir TURN relay'i üzerinden taşır. Ses, senin ses resource'unda kalır.
config_server.lua içindeki TURN alanları boş bırakılırsa görüntü Fixitfy relay'inden geçer (ServerConfig.Video.Hosted = true). Server ilk görüntülü aramada kendini kaydeder. Hiçbir relay yanıt vermezse kamera kapalı kalır, aramanın kendisi yine çalışır.
Bu sayfa, görüntünün kendi makinelerinden geçmesini isteyen sunucular içindir. Kendi TURN ayarlarını doldurduğunda o sunucu için Fixitfy relay'i kullanılmaz.
Oyuncuların IP adresleri birbirlerine asla gösterilmez: AllowDirect = false ile görüntünün tamamı TURN sunucusundan geçer.
Ayarlar: config_server.lua (ServerConfig.Video) ve Arama ayarları (Config.Video).
#Neye ihtiyacın var
Aşağıdaki adımlar Ubuntu 22.04 veya 24.04 içindir. TURN sunucusu FiveM sunucusuyla aynı makine olabilir; ayrı bir makine önerilir. coturn'ün resmi bir Windows sürümü yoktur; bu yüzden Windows'ta çalışan bir oyun sunucusu TURN için ayrı, küçük bir Linux makinesine ihtiyaç duyar.
- Sabit bir genel IP adresi.
- İsteğe bağlı ama önerilir: TLS için o IP'yi gösteren bir alan adı.
- Açık portlar:
3478UDP ve TCP,5349TCP (TLS),49160-49660UDP (medya) ve TLS kuruyorsan sertifika için80TCP. - Bant genişliği: görüntü sunucudan geçer; bu yüzden sunucu her akışı hem alır hem gönderir. Bir arama, iki yönün her biri için
Config.Video.MaxBitrate'e kadar giriş ve çıkış kullanır. Sağlayıcının trafik kotasını buna göre seç.
Bu kurulumun dosyaları fx-phone/setup/integration/video-relay/ içindedir: bir turnserver.conf şablonu ve bir sağlık kontrolü script'i.
#1. coturn'ü kur
bashsudo apt update
sudo apt install -y coturn
sudo sed -i 's/^#\?TURNSERVER_ENABLED=.*/TURNSERVER_ENABLED=1/' /etc/default/coturn
Bir gizli anahtar (secret) oluştur. Kimseyle paylaşma; 4. adımda config_server.lua'ya girer.
bashopenssl rand -hex 32
#2. Yapılandır
Kurulum klasöründeki turnserver.conf şablonunu sunucuya kopyala ve değerlerini doldur:
bashsudo cp /etc/turnserver.conf /etc/turnserver.conf.backup
sudo nano /etc/turnserver.conf
| Alan | Değer |
|---|---|
static-auth-secret |
1. adımdaki gizli anahtar |
realm |
Alan adın ya da herhangi bir ad |
external-ip |
Yalnızca NAT arkasındaysan (genel IP makinenin ağ kartında görünmüyorsa): PUBLIC_IP/PRIVATE_IP |
cert, pkey |
TLS kuruyorsan 5. adımdan sonra açılır |
coturn makinenin bütün adreslerini dinler; bir listening-ip satırına ihtiyacın yoktur.
Şablondaki güvenlik satırlarını değiştirme. no-tcp-relay ve denied-peer-ip satırları, aramadaki bir oyuncunun TURN üzerinden sunucunun kendi servislerine ya da özel ağa ulaşmasını engeller.
#3. Güvenlik duvarı ve servis
bashsudo ufw allow 3478/udp
sudo ufw allow 3478/tcp
sudo ufw allow 5349/tcp
sudo ufw allow 49160:49660/udp
sudo systemctl enable coturn
sudo systemctl restart coturn
sudo systemctl status coturn --no-pager
Sağlayıcının panelinde kendi güvenlik duvarı varsa aynı portları orada da aç.
#4. FX Phone ayarları
config_server.lua içindeki ServerConfig.Video'yu doldur. Bu dosya oyunculara asla gönderilmez.
luaServerConfig.Video = {
IceServers = {
{ urls = { 'turn:SERVER_IP:3478?transport=udp', 'turn:SERVER_IP:3478?transport=tcp' } },
-- With TLS: { urls = { 'turns:turn.example.com:5349?transport=tcp' } },
},
TurnSecret = 'THE_SECRET_FROM_STEP_1',
CredentialSeconds = 600,
AllowDirect = false,
}
Config.Video.Enabled = true olduğundan emin ol ve fx-phone'u yeniden başlat.
Bir aramanın giriş bilgisi, her taraf için ayrı ayrı server tarafında üretilir ve yalnızca CredentialSeconds boyunca geçerlidir. Sabit bir şifre asla client'a ulaşmaz.
#5. TLS
Bazı oyuncuların ağları UDP'yi engeller. 5349 portundaki TLS bu durumda da çalışır. Bir alan adı gerektirir.
coturn turnserver kullanıcısı olarak çalışır ve /etc/letsencrypt altındaki anahtarı okuyamaz. Aşağıdaki hook, sertifika her çıkarıldığında veya yenilendiğinde onu coturn'ün okuyabileceği bir yere kopyalar ve coturn'ü yeniden başlatır:
bashsudo apt install -y certbot
sudo ufw allow 80/tcp
sudo tee /usr/local/bin/coturn-cert-hook >/dev/null <<'EOF'
#!/bin/sh
set -e
install -d -o turnserver -g turnserver -m 750 /etc/coturn/certs
install -o turnserver -g turnserver -m 644 "$RENEWED_LINEAGE/fullchain.pem" /etc/coturn/certs/fullchain.pem
install -o turnserver -g turnserver -m 600 "$RENEWED_LINEAGE/privkey.pem" /etc/coturn/certs/privkey.pem
systemctl restart coturn
EOF
sudo chmod +x /usr/local/bin/coturn-cert-hook
sudo certbot certonly --standalone -d turn.example.com --deploy-hook /usr/local/bin/coturn-cert-hook
80/tcp portu açık kalmalıdır: certbot her yenilemede doğrulamayı bu port üzerinden yapar. Bu makinede 80 portunu zaten bir web sunucusu kullanıyorsa --standalone çalışmaz; onun yerine --webroot -w <your web root> kullan.
Sertifika yenilendiğinde hook coturn'ü yeniden başlatır. O anda süren görüntülü aramalarda görüntü bir anlığına kesilir ve telefon bir kez yeniden bağlanmayı dener. Ses etkilenmez.
Ardından turnserver.conf içindeki cert ve pkey satırlarının başındaki # işaretini kaldır, coturn'ü yeniden başlat ve IceServers'a turns: satırını ekle.
#6. Sağlık kontrolü
Kurulum klasöründeki sağlık kontrolü script'ini TURN sunucusuna kopyala ve sunucunun genel IP'si ya da alan adıyla çalıştır:
bashchmod +x saglik.sh
./saglik.sh SERVER_IP
Script gizli anahtarı ekranda göstermeden ister; böylece anahtar shell geçmişine girmez. İçeriden servisin çalıştığını, portların dinlediğini ve geçici bir girişin TURN'den UDP ve TCP üzerinden adres aldığını kontrol eder.
İçeriden yapılan bir test sağlayıcının güvenlik duvarını göremez. Bu yüzden script son olarak 10 dakika geçerli bir kullanıcı adı ve şifre yazdırır. Bunları kendi bilgisayarında bir WebRTC "Trickle ICE" test sayfasına gir ve aday topla. Listede relay türünde bir satır görünüyorsa sunucu dışarıdan çalışıyor demektir. Ardından oyunda bir görüntülü arama dene.
#Sorun giderme
| Belirti | Neden ve çözüm |
|---|---|
| Arama yalnızca sesle devam ediyor ve görüntünün bağlanamadığını söylüyor | Portlar kapalı ya da TurnSecret coturn ile config_server.lua arasında farklı. Sağlık kontrolünü ve dış testi çalıştır |
Dış testte relay satırı yok |
3478 portu veya 49160-49660 UDP aralığı sağlayıcının panelinde kapalı; NAT arkasındaysan external-ip eksik |
coturn başlamıyor, log Cannot bind diyor |
Elle bir listening-ip eklenmiş ve o IP makinede yok. Satırı kaldır |
Konsol: video calls are off: ServerConfig.Video has no TURN server, Hosted is false and AllowDirect is false |
Hosted, false yapılmış ve IceServers boş ya da TurnSecret eksik |
| Bazı oyuncular hiç görüntü alamıyor | Ağları UDP'yi engelliyor. TLS kur (5. adım) |
| Görüntü takılıyor | TURN sunucusunda yeterli bant genişliği yok ya da Config.Video.MaxBitrate çok yüksek. Düşür |
coturn logları: sudo journalctl -u coturn -f.
#Canlı yayınlar
Canlı yayınlar aynı relay'i kullanır. Yayıncının telefonu her izleyiciye ayrı bir görüntü gönderir; bu yüzden dolu bir yayın Config.Live.MaxViewers çarpı Config.Live.MaxBitrate kadar bant genişliği kullanabilir. Bkz. Canlı yayın ve sosyal ayarları ve Canlı yayın.