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: 3478 UDP ve TCP, 5349 TCP (TLS), 49160-49660 UDP (medya) ve TLS kuruyorsan sertifika için 80 TCP.
  • 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.