Icecast ile Canlı Yayın Kurulumu Rehberi: Adım Adım Yapılandırma (ffmpeg/encoder + testler)

Icecast ile canlı yayın kurmak, yalnızca Icecast’i çalıştırmakla bitmiyor. Asıl kritik nokta şurada: encoder (çoğu zaman ffmpeg) sesi doğru formatta üretip Icecast’e push etmeli; Icecast de doğru mount üzerinden dinleyiciye akışı kusursuz şekilde iletmeli. Bu rehber de tam olarak bu mantığı takip ederek, icecast ile canlı yayın için kurulum rehberi vaadini “konfigürasyon şablonları + mount mantığı + test kontrol listesi” çizgisinde uçtan uca anlatır.

Özellikle VPS/VM üzerinde kurulum yapanların en çok takıldığı yerler genelde aynı başlıklarda toplanıyor: yanlış port planı, mount-name uyumsuzluğu, codec/bitrate eşleşmemesi ve logları incelemeden tahmin yürütmek. Aşağıda adım adım ilerleyerek bu noktaları tek tek kontrol edeceksiniz; böylece “çalışıyor gibi ama yayın yok” durumlarının önüne geçersiniz.

Icecast nedir? Canlı yayın mimarisi (encoder → Icecast → dinleyici)

Icecast, internet üzerinden ses/video akışlarını dinleyicilere dağıtan bir streaming sunucusudur. Sunucu; “kaynak” (source/encoder) tarafından itilen canlı akışı alır ve bu akışı “mount” adıyla dinleyicinin erişebileceği URL’lere servis eder.

Mimariyi zihninizde netleştirmek için zinciri düşünün: Encoder canlı sesi üretir (mikrofon/line-in, dosyadan loop, capture vb.) → Icecast bu akışı mount üzerinden kabul eder → Dinleyici stream URL ile bağlanır ve player üzerinden duyar. Her halka birbirinin devamı olduğu için, bir yerde küçük bir uyumsuzluk bile yayın tarafında büyük fark yaratır.

Ön koşullar (VPS/hosting, domain/DNS, port planı, SSL kararı, codec tercihleri)

Kuruluma başlamadan önce altyapı kararlarını netleştirin. VPS’te yeterli bant genişliği ve CPU gerekecektir; çünkü canlı yayın, dinleyici sayısına paralel şekilde bant tüketir. Ayrıca yönetim paneli erişimi ve kaynak push yetkileri güvenlik açısından baştan planlanmalıdır—sonradan düzeltmek yerine baştan güvenli kurgulamak her zaman daha rahattır.

Domain/DNS kullanıyorsanız stream URL’yi kalıcı hale getirmeyi düşünün. SSL kararı da aynı şekilde önemlidir: Dinleyicilerin çoğu HTTPS’i daha sorunsuz karşılar; fakat ters proxy/sertifika/redirect tarafında bir hata olursa dinleyici bağlanamaz. Bu yüzden SSL’e geçmeden önce HTTP ile çalıştığını kesinleştirin.

Codec/format tercihinde de “genel uyumluluk” ile “verimlilik” arasında denge kurun. MP3 başlangıç için genellikle daha sorunsuzdur; AAC daha verimli olabilir ama hedef kitlenizin kullandığı player’ların desteğini test etmeden “tamamdır” demeyin.

Kurulum seçenekleri: (Docker ile) ve (doğrudan paketlerle) kısa karşılaştırma

Docker ile kurulum, konfigürasyonu container içinde yönetmenize ve sürüm izole etmenize yardımcı olur. Konfigürasyon dosyalarını (icecast.xml/icecast.conf) ve logları volume olarak bağlarsanız bakım daha kolay ilerler. Dezavantajı ise loglara erişimin ve dosya izinlerinin container bağlamında doğru kurgulanması gerektiğidir; küçük bir izin hatası bile servis davranışını etkileyebilir.

Doğrudan paketlerle kurulumda Icecast genellikle systemd servisi olarak çalışır. Standart dosya yolları ve “servis yönetimi” tarafı daha tanıdıktır. Burada dikkat edilmesi gereken, config dosyalarının yolu ile ilgili kullanıcı/izinlerin doğru ayarlanmasıdır; çünkü yanlış yol veya eksik yetki, servis görünürde ayağa kalksa bile beklenen davranışı vermeyebilir.

Hangisini seçerseniz seçin, kritik olan şey konfigürasyonun mantığıdır: admin erişimi, listen-socket, limits ve mounts doğru olmalıdır. Aksi halde encoder bağlansa bile dinleyici akışı alamaz ve problem zincirin neresinde kaldığını anlamak zorlaşır.

Icecast yapılandırma dosyası mantığı (admin, listen-socket, limits, mounts)

Icecast config dosyasında genelde benzer kavramlar yer alır: admin bölümünde yönetim paneli/kimlik bilgileri, listen-socket bölümünde Icecast’in hangi portta dinlediği, limits bölümünde bağlantı ve kaynak limitleri, mounts bölümünde ise yayın akışlarının tanımları bulunur.

Mount mantığı özellikle önemlidir. Encoder belirli bir mount’a push eder; dinleyici de aynı mount URL’sinden çalar. Bu yüzden mount adındaki tek bir karakter farkı bile “bağlanıyor ama çalmıyor” gibi sinir bozucu bir problem yaratabilir.

Icecast config örneği: basic ayarlar + mount (şablon formatında)

Aşağıdaki şablon, temel ayarları ve iki mount örneğini gösterir. Değerleri kendi domaininiz, portlarınız ve şifrelerinizle güncelleyin; özellikle source-password ve mount-name tarafını kontrol etmeden geçmeyin.

<icecast>
  <location>TR / Istanbul</location>

  <admin>
    <connection>
      <hostname>localhost</hostname>
      <port>8001</port>
    </connection>
    <username>admin</username>
    <password>S3cRedAdminParola</password>
  </admin>

  <listen-socket>
    <port>8000</port>
    <bind-address>0.0.0.0</bind-address>
  </listen-socket>

  <limits>
    <clients>500</clients>
    <sources>3</sources>
    <queue-size>1024</queue-size>
    <clients-per-source>100</clients-per-source>
  </limits>

  <authentication>
    <source-password>GENEL_SOURCE_PAROLA</source-password>
  </authentication>

  <mounts>
    <mount>
      <mount-name>/canli</mount-name>
      <stream-type>audio</stream-type>
      <max-listeners>200</max-listeners>
      <authentication>
        <source-password>GENEL_SOURCE_PAROLA</source-password>
      </authentication>
    </mount>

    <mount>
      <mount-name>/playlist</mount-name>
      <stream-type>audio</stream-type>
      <max-listeners>100</max-listeners>
      <authentication>
        <source-password>GENEL_SOURCE_PAROLA</source-password>
      </authentication>
    </mount>
  </mounts>
</icecast>

Örnek mount tanımları (stream adı, kaynak izinleri, fallback yoksa tasarım)

Mount tasarımında amaç “dinleyici her zaman doğru akışa gitsin” yaklaşımıdır. Fallback/redirect gibi ekstra mekanizmaları kullanmıyorsanız, her yayın senaryosu için ayrı mount açmak daha temiz olur. Örneğin DJ mikrofonu ile canlı yayın için /canli, arşiv playlisti için /playlist gibi.

Birden fazla encoder kullanacaksanız (ör. stüdyo canlısı + yedek), mounts’ları ayırın ve aynı mount’a farklı encoderları aynı anda bağlamayın. Limits bölümündeki sources ve mount başına izinleri de buna göre planlayın; aksi halde kaynak sayısı sınırlarına takılabilir veya dinleyici akışında kesilmeler görebilirsiniz.

Ağ ve güvenlik: firewall, portlar, admin panel erişimi kısıtlama

Icecast’i açık internette kullanacaksanız güvenlik sadece “şifre koydum” demek değildir. Firewall kuralları, admin panel portunun kısıtlanması ve kaynak push yetkilerinin doğru verilmesi gerekir. Böylece hem yetkisiz kaynakların mount’a bağlanması engellenir hem de admin panel korunur.

Port/firewall örneği: kullanılan portların liste planı

Aşağıdaki örnek plan, dinleyici erişimi ile admin erişimini ayırmaya odaklanır (kurulumunuza göre portlar değişebilir):

• 8000/tcp: Dinleyici akışı (HTTP)
• 8443/tcp: Dinleyici akışı (HTTPS, SSL kullanırsanız)
• 8001/tcp: Admin panel (yalnızca izinli IP/VPN)

Bölüm	Ne için kullanılır?	Önerilen erişim
8000	Dinleyicilerin mount üzerinden akışı alması	Dünya geneli (gerekli ise)
8001	Admin panel ve yönetim	Sadece kendi IP’niz/VPN subnet
8443	HTTPS dinleyici erişimi	Dünya geneli (sertifika doğruluğu şart)

Firewall kuralı oluştururken en pratik yaklaşım şudur: Dinleyici akışı (8000/8443) açık, admin panel (8001) kapalı/yalnızca izinli IP’ye açık. Ayrıca kaynak push encoder’ın çalıştığı sunucu veya VPN IP aralığına göre kısıtlama yapılabilir.

ffmpeg ile canlı yayın örnekleri (MP3 + AAC/OGG alternatifleri)

Encoder tarafında temel hedef, Icecast mount’unuzla uyumlu codec ve bitrate üretmektir. Birçok sorun, “encoder çalışıyor” zannedilip Icecast’in aldığı formatın beklendiği gibi olmamasından çıkar. Bu yüzden komutu kopyalayıp geçmeyin; mount adını ve codec parametrelerini config ile eşleştirin.

Aşağıdaki örneklerde ICECAST_HOST, SOURCE_USERNAME, SOURCE_PASSWORD ve /canli değerlerini kendi bilgilerinize uyarlayın. Özellikle kullanıcı adı ve mount path birleşimine dikkat etmek ileride çıkacak sürprizleri azaltır.

1) MP3 yayın (dosyadan loop örneği)

ffmpeg -re -stream_loop -1 -i /var/music/radio_tasla.mp3 \
  -f mp3 -content_type audio/mpeg \
  -ac 2 -ar 44100 -b:a 128k \
  -metadata artist="Canli Radyo" -metadata title="Loop Yayini" \
  -loglevel warning \
  -f mp3 -icecast_metadata 1 \
  "icecast://SOURCE_USERNAME:SOURCE_PASSWORD@ICECAST_HOST:8000//canli"

2) AAC alternatif örnek

ffmpeg -re -stream_loop -1 -i /var/music/radio_tasla.wav \
  -vn -ac 2 -ar 48000 \
  -c:a aac -b:a 128k \
  -f adts \
  -metadata title="AAC Canli Yayın" \
  -loglevel warning \
  "icecast://SOURCE_USERNAME:SOURCE_PASSWORD@ICECAST_HOST:8000//canli"

3) OGG/Vorbis alternatif örnek

ffmpeg -re -stream_loop -1 -i /var/music/radio_tasla.wav \
  -vn -ac 2 -ar 44100 \
  -c:a libvorbis -b:a 128k \
  -content_type audio/ogg \
  -f ogg \
  -metadata title="OGG Canli Yayın" \
  -loglevel warning \
  "icecast://SOURCE_USERNAME:SOURCE_PASSWORD@ICECAST_HOST:8000//canli"

Mikrofon/line-in kullanacağınız durumlarda giriş formatını değiştirirsiniz. Örneğin ALSA ile -f alsa -i hw:0,0 gibi; ancak yine temel kural aynı: encoder çıkış codec/bitrate’i mount’un akışıyla uyumlu olmalı. Böylece hem dinleyici tarafı daha stabil çalışır hem de “ses yok” gibi sorunlar azalır.

Uyumluluk ve performans: bitrate/codec/örnekleme eşleşmesi, gecikme yönetimi

Uyumluluk; codec, örnekleme oranı ve bit hızı üçlüsünde saklıdır. Dinleyici tarafında bazı player’lar belirli codec profillerini daha iyi destekler. Bu yüzden encoder ayarlarını mount’un “stream-type audio” mantığıyla uyumlu tutun ve bitrate’i gereksiz yükseltmeyin; hem bant hem de gecikme tarafında etkisini görürsünüz.

Gecikme (latency) hedefliyorsanız buffer’ların birikmesine izin vermeyin. Ağ kalitesi düşerse gecikme artar; bunun yanında encoder tarafında yüksek değerler gecikmeyi büyütebilir. Düşük gecikme hedefiyle çalışırken “stabiliteyi” feda etmeyin; kısa aralıklarla yeniden deneme ve düzgün reconnect stratejisi çoğu zaman daha değerlidir.

Canlı yayın testleri: stream URL doğrulama, player ile kontrol, adım adım doğrulama

Icecast kurulumunuzu doğrularken “nasıl kontrol edilir” yaklaşımını izleyin. Aşağıdaki adımlar zinciri tek tek kanıtlar: Sunucu dinliyor mu, mount’ta akış var mı, dinleyici ses alıyor mu ve gecikme nedir. Bu düzen, hatayı hızlıca bulmanızı sağlar.

1. Sunucu portu dinliyor mu? VPS’te 8000/8443’e dışarıdan erişim mümkün mü kontrol edin.
2. Mount’ta kaynak bağlantısı var mı? Icecast error/access loglarında encoder’ın bağlandığını doğrulayın.
3. Stream URL doğru mu? VLC veya tarayıcı player ile mount URL’yi açın; ses geliyor mu bakın.
4. Gecikmeyi ölçün: kısa bir ses/işaret verip dinleyicide ne kadar sonra geldiğini zamanlayın.

Stream URL örneği ve dinleyici test adımları (VLC / HTML5 player mantığıyla)

Mount adınız /canli ise dinleyici URL örneği çoğu kurulumda şu mantıktadır: http://ICECAST_DOMAIN:8000/canli. (Bazı durumlarda biçim değişebilir; ama mount-name ile birebir uyum ana kuraldır.)

• VLC: “Medya > Ağ akışı” alanına http://ICECAST_DOMAIN:8000/canli yazıp oynatın.
• Tarayıcı/HTML5: Stream URL’yi player bileşenine besleyin (ör. yerleşik oynatıcı veya özel HTML player mantığı).
• Doğrulama: Ses başlıyor mu, düzenli akış var mı, birkaç dakika sonra kopuyor mu gözlemleyin.

Yayını yayına alma kontrol listesi (checklist)

Aşağıdaki checklist, “yayımlar başladı” demeden önce son kez bakmanızı sağlar. Bu liste, hataları son dakika tahminleri yerine veriyle yakalamaya odaklanır.

• Icecast servisi ayağa kalktı: listen-socket portu dinliyor.
• Mount tanımı mevcut: config’teki mount-name ile encoder URL aynı.
• Kaynak şifreleri doğru: source-password veya mount authentication uyuşuyor.
• Codec/bitrate uyumlu: encoder çıkışı ile hedef format uyumlu.
• Dinleyici test edildi: VLC veya player ile stream URL açılıyor ve ses geliyor.
• Gecikme ölçüldü: hedefinizle uyumlu seviyede mi?
• Admin erişimi kısıtlı: admin panel portu yalnızca izinli IP/VPN.

Loglar ve sorun giderme: error.log / access.log yorumlama

Icecast’te sorun yaşadığınızda loglar, “nerede koptuğunu” söyler. Bu yüzden önce loglardan ipucu alıp sonra komut/konfigürasyon denemesi yapın. Rastgele denemelerle zaman kaybetmek yerine, logların işaret ettiği yöne gitmek çok daha hızlı sonuç verir.

error.log hata kök nedenlerini; access.log ise bağlantı kayıtlarını gösterir. Encoder bağlanmıyor ise error.log’da authentication veya mount hataları görülebilir. Dinleyici bağlanıyor ama ses yoksa mount’ta veri akışı sorunu veya codec uyumsuzluğu olabilir.

Yaygın hatalar

Aşağıdaki hatalar, Icecast kurulumu sırasında en sık karşılaşılan “kurulum doğru gibi görünüyor ama yayın çalışmıyor” türündendir.

• Mount adında karakter farkı: Config’te /canli var ama encoder //live push ediyor. Belirti: Dinleyicide boş akış, loglarda mount ile ilgili mesajlar.
• Codec/bitrate eşleşmiyor: Encoder MP3 çıkarırken mount/stream-type beklenen biçimde değildir ya da player desteklemez. Belirti: URL açılır ama ses başlamaz ya da kopar.
• Firewall/port yanlış: 8000/8443 açık değil; admin panel açık olduğu halde dinleyici erişemez. Belirti: Encoder içeriden bağlanır, dışarıdan kimse duyamaz.
• Admin panel erişimi aşırı açık: Admin portu internete açık bırakılır. Belirti: Güvenlik riski; deneme/istismar ile servis etkilenebilir.

Kaçınılması gerekenler

“Hızlı kurulum” amacıyla config’i kopyalayıp doğrudan kullanmak cazip olabilir ama risklidir. Özellikle mount isimlerini ve şifreleri güncellemeden bırakmak, bir sonraki gün herkesin aynı mount’a bağlandığı karmaşaya dönüşebilir.

Ayrıca SSL/redirect işini HTTP testleri bitmeden devreye almayın. Önce dinleyici URL’yi HTTP ile doğrulayın; ardından HTTPS’i ekleyin. Bu yaklaşım hata ayıklamayı dramatik şekilde kolaylaştırır ve süreci kontrollü tutar.

Devam etmek için

Ek okuma ve benzer kurulum fikirleri

Icecast kurulumunu sağlamlaştırmak için, farklı streaming altyapılarının mantığını da görmek faydalıdır. Örneğin karar aşamasında Shoutcast/Icecast karşılaştırması işinizi hızlandırır.

Konuyla yakın, pratik bir rehber için şu içeriğe göz atabilirsiniz: Shoutcast mı Icecast mi? Yayın Altyapısı Seçimini Yapmak İçin Karar Rehberi.

Özellikle “kurulum + ayarlar + test + sorun giderme” akışı arıyorsanız; Icecast’in uçtan uca kurgusunu bir örnek senaryoda görmek için de şu yazı yardımcı olabilir: Icecast Streaming Sunucusu Nasıl Kurulur? (Adım Adım Kurulum, Ayarlar, Test ve Sorun Giderme).

Sık Sorulan Sorular (FAQ)

Icecast yerine Shoutcast/RadyoScript gibi alternatifler var mı? Ne zaman Icecast seçilmeli?

Evet, alternatifler var. Icecast; mount tabanlı esneklik, log/istatistik yaklaşımı ve özellikle Linux/VM/VPS üzerinde kontrol ihtiyacınız olduğunda iyi bir seçimdir. İhtiyacınız basitse veya hazır bir platform kullanmak istiyorsanız Shoutcast/radyo çözümleri hızlı başlangıç sağlayabilir; ancak mount/stream yönetimi ve ince kontrol istiyorsanız Icecast daha uygun olur.

Icecast’ın admin paneline kimler erişmeli, güvenlik nasıl güçlendirilmeli?

Admin paneline yalnızca yönetim ekibinin kullandığı sabit IP’ler veya VPN subnet’i erişmelidir. Ek olarak admin şifresini güçlü seçin, admin portunu internetten kapatın ve mümkünse reverse proxy/WAF ile ek katman oluşturun.

Hangi codec/format daha sorunsuz (MP3 vs AAC vs OGG)?

MP3 genelde en yaygın destekle başlar. AAC modern ve verimli olabilir ama hedef kitlenizin player desteğini kontrol etmek gerekir. OGG/Vorbis bazı ortamlar için iyidir, ancak “en sorunsuz başlangıç” hedefliyorsanız MP3 ile başlayıp sonra ölçerek geçiş yapın.

Mount adımında en sık yapılan hata nedir ve nasıl anlaşılır?

En sık hata mount adının yanlış yazılmasıdır. Icecast loglarında “mount not found” veya bağlantının kabul edilmediğine dair mesajlar görebilirsiniz. Çözüm için config’teki mount-name ile encoder URL’deki mount bölümünü birebir aynı yaptığınızdan emin olun.

Yayın bağlanıyor ama dinleyici tarafı neden çalmıyor?

En yaygın nedenler: codec/format uyumsuzluğu, dinleyici URL’nin yanlış olması ve encoder’ın fiilen veri üretmemesi (sessiz/yanlış giriş). İlk doğrulama adımı olarak Icecast loglarında kaynak bağlantısı ve veri akışını kontrol edin, ardından dinleyici URL’yi VLC ile birebir test edin.

SSL ile mi, HTTP ile mi çalışmalı? Redirect nasıl yapılır?

Başlangıçta HTTP ile test edip “akış doğrulandı”ktan sonra SSL eklemek en güvenlisidir. SSL kullanacaksanız sertifika doğrulamasını düzgün yapın ve redirect sırasında mount path’in bozulmadığını test edin. Yanlış redirect mount path’i etkileyebilir ve ses başlamaz.

VPS’te bant genişliği/limitler nasıl belirlenir?

Bitrate × dinleyici sayısı yaklaşımı pratik bir başlangıçtır. Sonra overhead ekleyerek gerçekçi bir pay bırakın. Sunucu limits’iyle Icecast limits uyumlu olmalı; aksi halde çok sayıda dinleyicide kopmalar ve buffer problemleri artabilir.

Gecikmeyi düşürmek için encoder tarafında neler ayarlanır?

Öncelikle aşırı yüksek bitrate ve gereksiz buffer’lardan kaçının. Encoder reconnect ayarlarını makul tutun, canlı hız simülasyonu için -re gibi parametreleri doğru kullanın ve codec profilini mümkün olduğunca stabil seçin. Gecikme hedefi varsa önce kısa bir test senaryosuyla ölçüm yapın, sonra ölçekleyin.

Kapanış: Son doğrulama ve yayını kalıcı hale getirme

Kurulum bitince “encoder çalışıyor” demek yerine üç şeyi doğrulayın: (1) Icecast dinliyor, (2) mount’ta akış var, (3) dinleyici oynatıyor. Bu üçlü tamamlanmadan yayını ilan etmek çoğu zaman gecikme, kopma veya boş akış sorunlarını saklar; sonradan geri dönüp bulmak zorunda kalırsınız.

Son olarak config’i dokümante edin: mount isimleri, encoder komutları, port planı ve log konumları. Böylece bir gün sorun çıktığında rastgele deneme yapmak yerine hızlı kök neden analizi yaparsınız; süreç kontrol sizde olur.