Bedrud, gerçek zamanlı video ve ses iletişimini yönetmek için LiveKit kullanır. LiveKit SFU (Seçici İletim Birimi) medya sunucusunu sağlar; Bedrud ise kimlik doğrulama, oda yönetimi ve yönetici kontrollerini üstlenir.

Gömülü ve Harici Modlar

Bedrud iki LiveKit dağıtım modunu destekler:

1. Gömülü Mod (Varsayılan): Arka uç, bir LiveKit sunucu sürecini dahili olarak başlatır ve yönetir. Ek bir altyapı gerekmez - arka uç LiveKit süreç yaşam döngüsünü halleder.
2. Harici Mod: Bedrud ayrı bir LiveKit sunucusuna veya kümesine bağlanır. Bu, yatay ölçeklendirme veya yönetilen bir LiveKit Cloud örneği kullanıldığında faydalıdır.

Harici Modu Yapılandırma

Harici bir LiveKit sunucusu kullanmak için config.yaml dosyasında şu anahtarları ayarlayın:

livekit:
  host: "wss://livekit.example.com:7880"    # Client WebSocket URL (ws:// or wss://)
  internalHost: "https://livekit.example.com:7880"  # Server-to-server API URL
  apiKey: "your-api-key"
  apiSecret: "your-api-secret"
  external: true          # Skip embedded LiveKit startup
  skipTLSVerify: false    # Set true if LiveKit uses self-signed certs

embedded false olduğunda, Bedrud gömülü LiveKit ikili dosyasını başlatmayı atlar. API anahtarı ve gizli anahtar, harici sunucunun kimlik bilgileriyle eşleşmelidir.

LiveKit küme kurulumu ve yapılandırması için LiveKit dokümantasyonuna bakın.

Webhook Yapılandırması (Yalnızca Harici)

Harici bir LiveKit sunucusu kullanırken, LiveKit’in Bedrud’a katılımcı bağlantı kesilmeleri ve oda kapanışları hakkında bildirim gönderebilmesi için webhook’ları yapılandırmanız gerekir. Webhook’lar olmadan, veritabanı durumu güncelliğini yitirir.

Uç Nokta: https://<your-domain>/api/livekit/webhook

Kimlik Doğrulama: LiveKit’in JWT imzasını kullanır — yukarıda yapılandırdığınız aynı apiKey/apiSecret. Ayrı bir gizli anahtar gerekmez.

LiveKit Cloud: Ayarlar → Webhooks → Yeni webhook oluştur. Uç nokta URL’sini girin ve API anahtarınızı seçin.

Kendi sunucunuzda LiveKit: LiveKit YAML yapılandırmanıza (örn. livekit.yaml) ekleyin:

webhook:
  urls: ["https://bedrud.example.com/api/livekit/webhook"]
  api_key: "your-api-key"

LiveKit Sürüm Uyumluluğu

Bedrud’un gömülü LiveKit modu uyumlu bir yapılandırmayı otomatik olarak oluşturur. Ancak, harici bir LiveKit sunucusunu kendiniz barındırıyorsanız, LiveKit sürümleri arasındaki kırıcı değişikliklerin farkında olun:

• LiveKit v1.12+ yapılandırmasından üst düzey tls alanını kaldırdı. LiveKit YAML’ınızda tls: kullanıyorsanız, kaldırın. Bedrud yapılandırmasında internalHost için http:// ve host için ws:// yapılandırın. TURN TLS, turn: bölümü altında hâlâ desteklenmektedir.
• LiveKit v1.11 ve öncesi üst düzeyde tls: destekler. internalHost için https:// ve host için wss:// kullanın.

Emin değilseniz, livekit-server --version ile LiveKit sunucu sürümünüzü kontrol edin ve LiveKit sürüm notlarına başvurun.

Gömülü Yapılandırma Oluşturma (Embedded Config Generation)

TLS gömülü modda etkinleştirildiğinde, Bedrud geçici bir LiveKit YAML yapılandırması oluşturur (/tmp/bedrud-livekit-*.yaml):

• TURN etkin, domain server.host’tan otomatik ayarlanır, udp_port: 3478, tls_port: 5349, sunucunun TLS sertifikası TURN/TLS için yeniden kullanılır
• node_ip şu sırayla çözülür: livekit.nodeIP → server.host → giden IP otomatik algılama
• bind_addresses atlanır (LiveKit varsayılan olarak tüm arayüzlere bağlanır)

Geçici dosya, LiveKit işlemi sona erdiğinde temizlenir. Statik bir yapılandırma ile otomatik oluşturmayı atlamak için livekit.configPath veya LIVEKIT_CONFIG_PATH ayarlayın.

Nasıl Çalışır

1. Oda Oluşturma

Bir kullanıcı Bedrud’da oda oluşturduğunda, sunucu hemen bir LiveKit odası oluşturmaz. LiveKit odaları ilk katılımcı katıldığında talep üzerine oluşturulur.

2. Katılım Jetonları

Bir kullanıcı bir toplantıya katıldığında:

1. Ön uç /api/room/join uç noktasına bir istek gönderir.

2. Arka uç, kullanıcın o odaya katılma izni olduğunu doğrular.

3. Arka uç, API Anahtarını ve Gizli Anahtarını kullanarak imzalı bir JWT (Katılım Jetonu) üretir.

4. Jeton şunları içerir:

   • Oda adı.
   • Kullanıcının kimliği (görünen ad).
   • İzinler - örneğin, kullanıcının ses yayımlayıp yayımlayamayacağı veya ekranını paylaşabileceği.

5. Ön uç bu jetonu alır ve doğrudan LiveKit medya portuna (varsayılan 7880) bağlanır.

3. Oda Kontrolleri (Yönetici)

Arka uç, yönetimsel eylemleri gerçekleştirmek için LiveKit Go SDK’sını kullanır:

• Atma: Bir katılımcının bağlantısını keser.
• Sessize Alma: Bir katılımcının mikrofonunu zorla sessize alır.
• İzinler: Bir katılımcının gerçek zamanlı olarak neler yapabileceğini değiştirir.

Ağ Mimarisi

• API Portu (8090/443): HTTP isteklerini ve arama kurulumu için WebSocket sinyalleşmesini yönetir.
• Medya Portu (7880): WebRTC protokollerini kullanarak video ve ses verilerini yönetir. UDP engellendiğinde ICE/TCP yedek portu olarak 7881 kullanılır.
• TURN Portu (3478 UDP / 5349 TLS): Kısıtlayıcı NAT veya güvenlik duvarları arkasındaki istemciler için medyayı aktarır. Bkz. TURN Sunucu Kılavuzu.

Güvenlik duvarı ve port gereksinimleri için bkz. WebRTC Bağlantısı.

Troubleshooting

Startup & Config Crashes

Connectivity

Media & TURN

Webhook & State

Recording (Egress)

Bedrud uses LiveKit’s RoomCompositeEgress API to record rooms as MP4 files.

Prerequisites

• Redis — LiveKit egress requires Redis for coordinating egress workers. Without Redis, StartRoomCompositeEgress returns permission errors.

• Egress S3 storage (external mode only) — For external LiveKit, you must configure an egress: section in your LiveKit YAML so recordings are stored to durable S3-compatible storage. Otherwise the FileURL is a local path unreachable from Bedrud.

  egress:
    s3:
      access_key: "your-s3-access-key"
      secret_key: "your-s3-secret-key"
      endpoint: "http://minio:9000"
      bucket: "bedrud-recordings"
      region: "us-east-1"
      force_path_style: true

Troubleshooting: Recording

Ayrıca bakınız

• TURN Sunucu Kılavuzu - TURN mimarisi, yapılandırma, TLS ve sorun giderme
• WebRTC Bağlantısı - tam STUN/ICE/TURN/SFU bağlantı yığını
• Mimari Genel Bakış - tam sistem mimarisi