Icecast’te Source (Kaynak) Ekleme Adımları: Adım Adım Kurulum, Doğrulama ve Yayın Hatası Çözümü

Icecast üzerinde yayın yapmak isteyenler genellikle “source ekleme” kavramını duyunca ikiye ayrılır: Birincisi icecast.conf dosyasında mount/source tanımlamak, ikincisi de bir encoder (yayın istemcisi) ile Icecast’e bağlanıp source oluşturmak. Bu yazıda, “Icecast kaynak (source) ekleme adımları nasıl yapılır?” sorusuna pratik ve denetlenebilir bir akışla yanıt vereceğim; ayrıca yayının gerçekten geldiğini log ve web kontrolleriyle nasıl doğrulayacağınızı da adım adım göstereceğim.

Doğru mount/kimlik doğrulama/şifre/port eşleşmesi yapılmadığında Icecast çoğu zaman sessiz kalabilir ya da hatayı sadece loglarda belli eder. Bu yüzden sadece konfigürasyona değil, “neye bakacağım?” kısmına da özellikle odaklanıyoruz: kontrol URL’leri, log satırları ve beklenen çıktı örnekleriyle ilerleyeceğiz.

Icecast’te Source ne demek? Mount bağlantısı nasıl çalışır?

Icecast’te source (kaynak), bir encoder’ın (ör. ffmpeg) Icecast’e bağlanıp belirli bir mount noktasına stream göndermesi anlamına gelir. Yani source’u “Icecast’in içine statik olarak yazdığınız bir kayıt” gibi düşünseniz de pratikte en sık kullanılan model şöyledir: Encoder bağlanır, Icecast mount’u üzerinden stream’i kabul eder ve o anda bir source akışı oluşur.

Mount ise stream’in URL karşılığıdır. Örneğin mount “live” ise dinleyiciler genelde http://SUNUCU:PORT/live ya da Icecast’in tanımladığı varyant URL’leri üzerinden dinler. Icecast gelen bağlantıyı “hangi mount’a akıtıyorsun?” sorusuna göre sınıflandırır; bu nedenle mount uyumsuzluğu en sık hatalardan biridir.

Ön koşullar: icecast.conf nerede, erişim ve servis durumu

Kaynak ekleme adımlarına başlamadan önce Icecast servisinin çalıştığından ve konfigürasyona erişebildiğinizden emin olmalısınız. Dağıtıma göre icecast.conf farklı klasörde olabilir (çoğu sistemde /etc/icecast2/icecast.conf veya /etc/icecast/icecast.conf gibi).

Önce şu kontrolleri yapın: (1) Icecast servisinin aktif olup olmadığı, (2) konfigürasyon dosyasının doğru kullanıcı tarafından okunup okunmadığı, (3) firewall/port erişiminin encoder tarafına açık olup olmadığı. Bunlar yoksa “source ekledim ama bağlanmıyor” problemi teknik olarak hâlâ devam eder.

1. Icecast servis durumunu kontrol edin: systemctl status icecast (veya dağıtımınıza uygun isim).
2. Konfig dosyasının yolunu doğrulayın: grep -n "source" /etc/icecast*/icecast.conf benzeri aramalar.
3. Port erişimini test edin: encoder makinesinden Icecast host’unuzun dinlediği portu (çoğunlukla 8000 ve/veya 8443) doğrulayın.

Kaynak ekleme yöntemi seçenekleri (konfig ile mount oluşturma vs. kaynak istemci mantığı)

Icecast’te “source ekleme” fiilini iki farklı yöntemle ele alabilirsiniz. Birinci yöntem: icecast.conf içinde önceden mount tanımlamak. Bu yaklaşım, yönetmek istediğiniz yayınları “kontrol altında” tutar; web arayüzünde mount listesi daha düzenli görünür, izin/şifre mantığı daha net olur.

İkinci yöntem: encoder’ın Icecast’e bağlanmasıyla mount/source akışının fiilen başlaması. Birçok durumda mount, encoder bağlandığında “tanınan” bir isimle eşleşir; ancak Icecast ayarlarına göre önceden tanımlama zorunluluğu olabilir. Dolayısıyla “hangi durumda hangisi?” sorusunun kısa cevabı: Mount’larınızı yönetmek, erişimi kontrol etmek ve hata olasılığını azaltmak için konfig üzerinden mount oluşturmayı tercih edin; hızlı testler için encoder bağlama yaklaşımı yeterli olabilir.

Ek olarak, birden fazla encoder ile farklı yayınları aynı Icecast üzerinde sürdürecekseniz mount bazlı düzen en sağlıklısıdır. Böylece şifreler, stream adları ve kota/limit davranışları daha anlaşılır hale gelir.

Adım adım: icecast.conf düzenleme (örnek mount/source tanımı şablonu)

Konfigürasyonda genellikle <mount> blokları kullanılır. Aşağıdaki örnek, yayını “yönetilebilir” hale getirirken aynı zamanda doğrulama için de yeterince bilgi taşır. Değerleri sunucunuza göre uyarlayın: gerçek şifre, doğru host, doğru kullanıcı mantığı ve portlar mutlaka eşleşmelidir.

Örnek mount tanımı (jenerik ama gerçekçi):

<icecast>
  <!-- Bazı sürümlerde global ayarlar burada olur -->
</icecast>

<mount type="normal">
  <!-- Örnek: live/news mount’u -->
  mount="live/news"
  description="Haber Bülteni - Canlı";
  <!-- encoder bağlanırken kullanacağı streamer kimliği -->
  username="streamer_news";
  password="S0nDereceGizliParola";

  <!-- dinleyici erişimi için (bazı ayarlarda) izin/ACL yaklaşımı -->
  <!-- client ports/allow rules sürüme göre değişebilir -->

  <!-- Kimi kurulumlarda codec/bitrate kısıtları opsiyoneldir -->
  <!-- Eğer tanımlarsanız encoder tarafının birebir uyması gerekir -->
</mount>

<mount type="normal">
  mount="live/music"
  description="Müzik Yayını";
  username="streamer_music";
  password="BaskaGizliParola";
</mount>

Bu şablonda kritik nokta: mount adı ile encoder’ın hedeflediği mount’un aynı olmasıdır. Ayrıca Icecast’in beklediği username/password eşleşmezse encoder bağlanırken 401/403 gibi hatalar görmeniz çok olasıdır.

İsterseniz mount isimlerini hiyerarşik yapıda kullanabilirsiniz (örn. live/news). Bu, özellikle birden fazla kanal barındıran yapıların yönetimini kolaylaştırır.

Kullanılacak kimlik doğrulama: admin/password/source (streamer user) mantığı

Icecast’te üç ayrı “kimlik/şifre” karışıklığı sık görülür: (1) admin paneli/konsol erişimi için kullanılan yönetici kimlik bilgileri, (2) source/encoder tarafının kullanacağı streamer user ve şifre, (3) dinleyicilerin (read) tarafında kullanılabilen erişim kısıtları. Source ekleme işleminde asıl belirleyici, encoder’ın Icecast’e gönderirken kullandığı username/password eşleşmesidir.

Örneğin yukarıdaki örnekte mount="live/news" için username="streamer_news" ve şifre belirlediniz. Encoder bağlanırken bu değerleri göndermeden bağlanamazsınız. Aşağıdaki akış bunun mantığını netleştirir:

Icecast: 
  mount live/news:
    streamer_username = streamer_news
    streamer_password = S0nDereceGizliParola

Encoder:
  - Bağlanacağı mount: live/news
  - HTTP Authorization / stream auth: streamer_news + S0nDereceGizliParola

Sonuç:
  - Eşleşirse: source aktif olur
  - Eşleşmezse: 401/403 benzeri hata

Buradaki en pratik test yaklaşımı şudur: önce Icecast tarafında mount bloklarını doğrulayın, sonra encoder komutunuzdaki mount ve auth değerlerini birebir aynı yazdığınızdan emin olun. Küçük karakter farkları bile başarısızlığa yol açabilir.

Port/stream ayarları: client IP/host, bağlantı noktası, stream adı

Icecast bağlantısı kuran encoder tarafında mutlaka doğru host ve port kullanılmalıdır. Sunucunuz Icecast’i 8000 portunda dinliyorsa encoder komutunda http://ICECAST_IP:8000 adresiyle bağlanmanız gerekir. Bazı kurulumlarda yönetim için ayrı portlar, HTTPS için ayrı dinleme noktaları bulunabilir; fakat source göndermek için genellikle ana streaming portu kullanılır.

Bir diğer kritik alan stream adı veya mount’a gönderilen stream ident değeridir. Icecast mount adını bir “yol” gibi yorumlar; bu nedenle encoder’da yanlış mount yazarsanız Icecast “mount bulunamadı” durumuna düşebilir. Ayrıca client IP/host kısıtları varsa (örn. sadece belirli IP’lerin kabul edilmesi), encoder’ın bulunduğu ağdan gelen IP engellenmiş olabilir.

Bu noktada sadece “port açık mı?” diye sormak yetmez; Icecast’in konfigürasyonunda erişim listeleri, allow/deny mantığı veya ağ düzeyinde NAT kuralları da kontrol edilmelidir. Aksi halde firewall sorunu da 403 gibi görünebilir.

Değişiklik sonrası servis yönetimi (reload/restart) ve kesintiyi azaltma notları

icecast.conf içinde mount eklemek veya auth bilgilerini değiştirmek genellikle Icecast sürecinin yeniden yüklenmesini gerektirir. Bazı dağıtımlarda reload yeterli olabilir; bazı sürümlerde ise sadece restart tüm değişiklikleri garanti eder. En doğru yaklaşım, kurulumunuzun servis yönetimi dokümantasyonunu referans almaktır.

Kesintiyi azaltmak için hedefiniz şudur: mümkünse reload ile dene; hata olursa restart’a geç. Ancak kritik bir noktayı unutmayın: Eğer encoder zaten aktif bir source akışı başlattıysa, konfig değişikliği esnasında bağlantı kesilip yeniden bağlanması gerekebilir. Bu yüzden güncelleme penceresi planlamak iyi olur.

Pratik kural: test ortamında önce reload dene, beklenen davranışı log üzerinden doğrula; prod ortamda aynı yöntemi benzer riskle uygula.

Doğrulama: web arayüzü/stream listeleri ve loglardan teyit

Source ekleme işinin “bitti” sayılması için iki tür doğrulama gerekir: (1) web arayüzünde mount/stream görünmesi, (2) Icecast loglarında encoder’ın bağlandığının net bir izinin olması.

Aşağıda “adım adım doğrulama” için uygulanabilir bir akış göreceksiniz. Bu akışı izleyerek sorunun konfig mi yoksa encoder mı kaynaklı olduğunu hızlı ayırabilirsiniz:

1. Web arayüzünden mount listelerini kontrol edin: mount adınızın (örn. live/news) listede görünüp görünmediğine bakın.
2. Encoder’ı çalıştırın ve beklenen source’un aktif olup olmadığını webde gözleyin.
3. Logları izleyin (tail -f gibi) ve bağlandı mesajını yakalayın; ardından dinleyici testini yapın (stream URL üzerinden).

İşte bağlanmanın loglarda nasıl görünebileceğine dair gerçekçi bir örnek (sürüme göre format değişebilir):

2026-05-21 12:34:56 [source] yp: Connected (client=192.0.2.10) to mount live/news
2026-05-21 12:34:57 [source] yp: Auth OK (user=streamer_news)
2026-05-21 12:34:58 [source] yp: Source connected; now serving live/news

“Auth OK” ve “Source connected” benzeri ifadeler, encoder’ın gerçekten Icecast’e kabul edildiğini gösterir. Webde görünmüyorsa logda bağlantı yoktur; logda bağlantı var ama webde görünmüyorsa ikinci katman devreye girmiş olabilir (UI listeleme, yanlış display ayarı, mount tipi gibi).

Yaygın hatalar: bağlantı yok, 401/403, mount bulunamadı, zaman aşımı

Source ekleme sürecinde en sık karşılaşılan sorunlar genellikle birbirine çok benzer; bu yüzden hızlı teşhis için belirtileri ve olası nedeni eşleştirmek işinizi kolaylaştırır. Aşağıda hem hataları hem de ilk kontrol noktalarını özetliyorum.

• 401 Unauthorized / 403 Forbidden: username/password eşleşmiyor olabilir. Mount’un içindeki credential ile encoder komutunu birebir karşılaştırın.
• Mount not found / mount bulunamadı: encoder yanlış mount’a bağlanıyor veya icecast.conf içinde mount adı beklediğiniz gibi kaydedilmemiştir.
• Bağlantı yok / zaman aşımı: yanlış port, firewall/NAT sorunu veya Icecast’in ilgili dinleme noktasının kapalı olması söz konusu olabilir.
• Codec/bitrate uyumsuzluğu: Encoder’ın gönderdiği format, Icecast’in o mount için beklediği parametrelerle uyuşmaz. Bu durumda bazen kaynak bağlanır ama stream oynatılmaz ya da hata logları oluşur.

Bu hatalarda “ben source ekledim neden çalışmıyor?” hissi yaygındır; ancak Icecast tarafı source’u ancak bağlantı geldiğinde “gerçekten aktif” hale getirir. O yüzden her zaman log ve mount URL kontrolleriyle ilerleyin.

Güvenlik notları: parola saklama, yetki sınırlama, IP kısıtları

Stream parolalarını konfigürasyon dosyasına düz metin yazmanız gerekebilir; fakat bu dosyanın izinlerini (file permission) sıkı tutmalısınız. Icecast’i çalıştıran kullanıcı dışında kimse bu parolaları okuyamamalı. Ayrıca mümkünse aynı şifreyi birden fazla mount’ta tekrar etmeyin.

Yetki sınırlama konusunda da dikkatli olun: Eğer Icecast’inizde IP kısıtları veya ACL mantığı varsa, encoder’ın bulunduğu ağ değiştiğinde yayın aniden düşebilir. Özellikle mobil/otel/kurumsal NAT değişimlerinde bu durum daha sık görülür.

Son olarak, admin panel erişim şifrelerinizi de ayrı düşünün: Encoder şifresi ile admin şifresi aynı olmak zorunda değildir. Bu ayrımı korumak hem güvenlik hem hata ayıklama açısından kolaylık sağlar.

Örnek senaryolar: tek mount, birden fazla mount ve farklı encoderlar

Tek mount senaryosu, başlangıç için en temiz yoldur. Örneğin sadece live/news üzerinde haber bülteni yayınlayacaksanız, önce bu mount için credential ve codec uyumunu doğrulayın. Daha sonra ikinci mount ekleyin. Böylece hata kaynağını ayırmanız kolaylaşır.

Birden fazla mount senaryosunda, her mount için ayrı username/password kullanarak yayınlar arası karışmayı engelleyin. Aksi halde bir encoder yanlış mount’a bağlanırsa “başkasının yayınına” yanlış kimlikle giriş denemesi yapmış olursunuz; bu da 401/403 ve log karmaşası yaratır.

Encoder tarafında da farklılıklar olabilir. Aşağıda ffmpeg ile Icecast’e bağlanma örneği veriyorum; burada mount adının doğru kullanımı özellikle vurgulanır.

Encoder’dan Icecast’e bağlanma örneği (ffmpeg) ve mount kullanımı

Encoder örneği olarak ffmpeg kullanırsak amaç şudur: ffmpeg, Icecast’e HTTP üzerinden bağlanır, doğru mount’a akış gönderir ve doğru kullanıcı kimlik doğrulamasını uygular. Önemli olan: URL’deki mount ismi ile icecast.conf içindeki mount birebir aynı olmalıdır.

Örnek komut şablonu:

ffmpeg -re -i input.mp3 \
  -c:a libmp3lame -b:a 128k -ar 44100 \
  -f mp3 \
  http://STREAMER_USER:STREAMER_PASSWORD@ICECAST_HOST:8000/live/news

Burada dikkat edeceğiniz noktalar: (1) http://.../live/news kısmı, doğrudan mount yoludur; (2) STREAMER_USER ve STREAMER_PASSWORD değerleri, ilgili mount bloğunda belirttiğiniz username/password ile eşleşmelidir; (3) ICECAST_HOST ve port numarası doğru olmalıdır.

Eğer bağlantı kurulup stream akmıyorsa, önce loglardan “Auth OK / connected” satırlarını arayın. Sonra dinleyici testini yapın: mount URL’sini tarayıcıda açmayı deneyin (format izinlerine göre). Bu adım “encoder gerçekten akıtıyor mu?” sorusunu cevaplar.

Kontrol listesi: neye bakarak ilerlerim?

Source ekleme sürecini hızlandıran en iyi yöntem, küçük bir kontrol listesiyle ilerlemektir. Çünkü sorun ya konfig tarafında (mount/auth), ya bağlantı tarafında (host/port/firewall), ya da içerik/codec tarafında (format) ortaya çıkar.

Önerilen kontrol listesi:

• Mount eşleşmesi: Encoder komutundaki mount ile icecast.conf içindeki mount aynı mı?
• Kimlik doğrulama eşleşmesi: Kullanıcı adı/şifre birebir aynı mı? Büyük-küçük harf farkı var mı?
• Port ve erişim: Icecast doğru portta mı dinliyor, firewall/NAT engelliyor mu?
• Log doğrulaması: “Connected/Source connected/Auth OK” satırı geliyor mu?
• Codec ve bitrate: Encoder çıktısı ile beklenen format uyuşuyor mu?

Bu kontrol listesiyle çalıştığınızda, “her şeyi kontrol ettim ama yine de çalışmıyor” türü döngü azalır.

icecast.conf ile encoder arasında mutlaka eşleşmesi gerekenler (tablo)

“Hangi ayarlar mutlaka eşleşmeli?” sorusuna en pratik cevap eşleştirme tablosudur. Bu tabloyu yanlışlıkla atlamamak, çoğu yayında saatler kazandırır.

Konfig/Değer	Encoder Komutu / Beklenti	Yanlışsa Karşılaşacağınız Belirti
mount (örn. live/news)	URL yolunda aynı mount (örn. .../live/news)	Mount not found veya stream aktif görünmeme
username (örn. streamer_news)	Encoder içinde auth user (URL veya header)	401/403 hatası
password (örn. S0nDereceGizliParola)	Encoder içinde auth password	401/403 veya Auth OK satırı gelmemesi
Icecast host/port	Encoder’da doğru ICECAST_HOST:PORT	Zaman aşımı, bağlantı kurulmadan düşme

İlgili okumalar (mount ve yayın doğrulama odağında)

Mount noktasını doğru kurgulamak, source ekleme başarısının yarısıdır. Eğer mount mantığına daha derin girmek isterseniz şu rehber iyi bir başlangıç sağlar: Icecast Mount Point Nedir? Konfigürasyonda Nasıl Tanımlanır ve Kullanılır (Örneklerle).

Aynı şekilde canlı yayın kurulumunda encoder testlerinden sorun giderme adımlarına kadar uçtan uca akış görmek isterseniz: Icecast ile Ücretsiz Canlı Yayın Nasıl Yapılır? (Adım Adım Kurulum, Encoder, Ayarlar ve Sorun Giderme). Bu iki içerik, bu yazıda anlattığımız doğrulama mantığını pratik senaryolara bağlamaya yardımcı olur.

SSS (Sık sorulan sorular): Source ile mount farkı, eşleşmeler, reload/restart ve görünmeyen stream

Source (kaynak) eklemek ile mount oluşturmak arasındaki fark nedir? Mount, stream’in URL karşılığıdır. Source ise encoder’ın o mount’a bağlanıp gerçek akışı başlatmasıyla oluşur. Konfig ile mount tanımlayabilir, encoder ile source’u aktif edebilirsiniz.

icecast.conf’da hangi ayarlar mutlaka eşleşmeli (mount/username/password/port)? Encoder’ın hedeflediği mount, ilgili mount bloğundaki mount ile; kullanılan kimlik bilgileri de mount bloğundaki username/password ile; bağlantı yapılan host/port da Icecast’in dinlediği değerlerle eşleşmelidir. Bu dörtlü eşleşmezse genelde kaynak hiç bağlanmaz.

Yeni mount ekledikten sonra Icecast’i restart mi etmek gerekir, reload yeterli mi? Dağıtımınıza ve Icecast sürümüne göre değişir. Önce reload deneyin; loglarda değişikliğin etkisinin geldiğini görün. Emin değilseniz restart en güvenli yöntemdir.

Kaynak bağlanıyor ama stream webde görünmüyor; ne kontrol etmeliyim? Önce loglarda “Source connected” benzeri satırların geldiğini teyit edin. Sonra web arayüzünde mount listesi/stream listesi görünümünün doğru URL üzerinden kontrol edilip edilmediğini kontrol edin. Ayrıca mount tipinin (normal/source) webde listelenme davranışını etkileyip etkilemediğine bakın.

401/403 hatası alıyorum; şifre/kimlik doğrulama nasıl doğrulanır? Encoder komutundaki username/password ile icecast.conf içindeki mount bloğundaki değerleri birebir karşılaştırın. Ek olarak, boşluk/özel karakter kaçışları veya büyük-küçük harf farklarını kontrol edin.

Mount bulunamadı hatası alıyorum; neden olur? Encoder yanlış mount adını kullanıyor olabilir ya da icecast.conf değişikliği servis tarafından yansıtılmamıştır (reload/restart yapılmadı gibi). Ayrıca mount adında eğik çizgi/ek segment farklılığı (örn. live/news vs live-news) sık görülür.

Birden fazla source’u aynı mount’a bağlamak mümkün mü? Genelde mount başına tek aktif source beklenir. Aynı mount’a birden fazla encoder bağlandığında çakışma/overwrite ya da kabul edilmeme görülebilir. Çoklu kanallar için farklı mount kullanmak en sağlıklısıdır.

Codec/bitrate uyumsuzluğu nasıl anlaşılır ve nasıl çözülür? Loglarda codec/format uyumsuzluğu ile ilgili mesajlar görebilirsiniz ya da webde stream görünse bile çalınmaz. Çözüm olarak encoder tarafında codec (ör. mp3/aac), örnekleme frekansı ve bitrate değerlerini mount beklentisiyle uyumlu hale getirin.

Bu makalede anlattığım yaklaşımın özü şudur: Mount ve kimlik bilgileri eşleşsin, encoder doğru port/host’a bağlansın ve siz de log + web kontrolleriyle “bağlandı mı, değil mi?” sorusunu somut verilerle cevaplayın. Böylece source ekleme süreci yönetilebilir ve tekrarlanabilir hale gelir.