Instalar Icecast 2.3.3 en CentOS 6.3

Esta guía explica cómo crear un servidor de audio en streaming propio usando Icecast (OGG/MP3) en CentOS 6.3 x86_64. Icecast transmite audio siempre que exista un cliente de streaming compatible. Para OGG/Vorbis se usa ices y para MP3 icegenerator. Aquí tienes un tutorial detallado para configurar Icecast y los clientes ices e icegenerator.

Índice rápido:

Prerrequisitos y resumen de pasos
Instalación y compilación de Icecast 2.3.3
Configuración del servidor (icecast.xml)
Crear usuario, logs y pid
Configuración y puesta en marcha de ices (OGG/Vorbis)
Configuración y puesta en marcha de icegenerator (MP3)
Comprobaciones, comprobantes y pruebas
Seguridad, endurecimiento y buenas prácticas
Solución de problemas comunes
Listas de verificación para roles y pruebas de aceptación
Glosario, recursos y enlaces

Prerrequisitos y resumen de pasos

Resumen de alto nivel (mini-metodología):

Preparar el sistema con herramientas de desarrollo y dependencias.
Descargar y compilar libshout (necesario para clientes que envían al servidor).
Descargar, compilar e instalar Icecast 2.3.3.
Crear usuario y grupo dedicados para Icecast y preparar directorios para logs y pid.
Configurar /opt/icecast/latest/etc/icecast.xml y arrancar el servidor.
Compilar e instalar ices y/o icegenerator y crear las configuraciones y listas de reproducción.
Probar con un cliente de audio y ajustar límites, seguridad y monitoreo.

Prerrequisitos técnicos (qué esperar):

Sistema: CentOS 6.3 x86_64 con acceso root.
Espacio: suficiente para compilar fuentes y almacenar las bibliotecas (/usr/src y /opt). No se requieren cifras exactas aquí.
Puertos: el ejemplo usa el puerto 8000; asegúrate de que el cortafuegos (firewall) y SELinux permitan la comunicación.

Importante: CentOS 6 usa SysV init por defecto. Si trabajas en una distribución moderna con systemd, adapta los scripts de inicio.

Pasos detallados: instalar y compilar Icecast 2.3.3

Primero, instala las herramientas y dependencias de compilación y bibliotecas necesarias:

Descarga los paquetes fuente en /usr/src/icecast y el tarball de Icecast 2.3.3:

Extrae las fuentes y entra al directorio:

Configura la compilación con un prefijo de instalación en /opt/icecast/2.3.3:

Compila e instala:

Tras la instalación tendrás el binario en /opt/icecast/2.3.3/latest/bin (se creará un enlace “latest” más adelante):

icecast*

Vincula la versión 2.3.3 a “latest” para facilidades posteriores:

Configuración del servidor: icecast.xml

Copia o mueve el archivo de configuración de ejemplo y edítalo:

Contenido de ejemplo (traducido y explicado):


   


    
      100
      10
      5
      524288
      30
      15
      10
      1
      65535
    
   


    
      password
      admin
      password
    
    MyHost/IP
    
      8000
    
    1
   


    
      /opt/icecast/latest/share/icecast
      /opt/icecast/latest/share/icecast/web
      /opt/icecast/latest/share/icecast/admin
      /var/log/icecast
      /var/run/icecast/icecast.pid
      
    
   


    
      access.log
      error.log
      playlist.log
      1
      10000
      1
    
   


    
      0
      
        icecast
        icecast

Notas clave del archivo de configuración:

Sección LIMITS: controla el número máximo de clientes y fuentes simultáneas. Ajusta según la capacidad de tu ancho de banda y CPU.
Sección GENERIC: define credenciales de administración y del “source” (fuente). Protege estas contraseñas.
PATHES: puntos a recursos web y directorios de logs y pid.
LOG: nivel y rotación de logs.
SECURITY: indica con qué usuario/grupo debe ejecutarse Icecast.

Consejo: cambia los valores de password y admin-password por contraseñas seguras antes de exponer el servicio.

Crear usuario, grupo, directorios de logs y pid

Crea el grupo y usuario icecast con uid/gid 200 (como en el ejemplo):

Crea el directorio para el pid y fija permisos:

Arrancar Icecast y comprobar funcionamiento

Inicia Icecast en segundo plano usando el archivo de configuración:

# /opt/icecast/latest/bin/icecast -c /opt/icecast/latest/etc/icecast.xml -b

Salida típica:

Starting icecast2 Detaching from the console Changed groupid to 200. Changed userid to 200.

Comprueba los ficheros de log:

access.log error.log playlist.log

Comprueba el proceso:

Salida ejemplo:

4434 /opt/icecast/latest/bin/icecast -c /opt/icecast/latest/etc/icecast.xml -b

Abre el webgui para verificar (reemplaza MyHost/IP):

http://MyHost/IP:8000/

Usuario admin: admin (según el ejemplo) Contraseña: password (cámbiala)

Configurar el cliente OGG/Vorbis: ices

Antes de compilar ices necesitas libshout:

Descarga ices y compílalo:

Antes de configurar exporta PKG_CONFIG_PATH para que encuentre libshout:

Verifica la instalación:

icecast ices

Configuración de ejemplo para ices (OGG):


   


    1
    /var/run/icecast/ices1.pid
   


    /var/log/icecast
    ices1.log
    2048
    3
    0
   


    
      
        RadioStation 1: OGG
        Varios
        Test Radio 1
        http://MyHost/IP:8000/
      
      
        basic
        /opt/icecast/latest/etc/playlist1.txt
        1
        0
        1
      
      
        MyHost/IP
        8000
        password
        /radiostation1

Explicación breve:

background: ejecutar en segundo plano.
pidfile: ubicación del archivo pid.
logpath/logfile: registros específicos de ices.
stream: metadatos, entrada (playlist) y parámetros de conexión (hostname, port, password, mount).

Playlist OGG (archivo de texto con rutas absolutas):

/music/artist/album/song1.ogg
/music/artist/album/song2.ogg

Puedes crear la lista con find:

Arranca ices como usuario icecast:

Revisa el log:

Entrada típica:

[2011-12-16 12:17:05] INFO signals/signal_usr1_handler Metadata update requested [2011-12-16 12:17:05] INFO playlist-basic/playlist_basic_get_next_filename Loading playlist from file “/opt/icecast/latest/etc/playlist1.txt” [2011-12-16 12:17:05] INFO playlist-builtin/playlist_read Currently playing “/music/artist/album/song2.ogg” [2011-12-16 12:17:05] INFO stream/ices_instance_stream Connected to server: MyHost/IP:8000/radiostation1

La emisora OGG estará disponible en:

http://MyHost/IP:8000/radiostation1

Cada emisora necesita su propio archivo de configuración ices y su playlist.

Configurar el cliente MP3: icegenerator

Para MP3 también necesitas libshout (si no la compilaste antes):

Descarga y compila icegenerator (ejemplo con versión 0.5.5-pre2):

Comprueba binarios:

Ejemplo de configuración para icegenerator (/usr/local/etc/icegen1.cfg):

IP=192.168.1.100
PORT=8000
SERVER=2
MOUNT=/radiostation2
PASSWORD=password
FORMAT=1
MP3PATH=m3u:/usr/local/etc/playlist2.m3u
LOOP=1
SHUFFLE=1
NAME=RadioStation 2: MP3
DESCRIPTION=Test Radio
GENRE=Varios
URL=http://MyHost/IP:8000/
LOG=2
LOGPATH=/var/log/icecast/icegen1.log
BITRATE=48000
SOURCE=source

Notas sobre opciones principales:

SERVER: indica protocolo icy/http (en el ejemplo http).
FORMAT: 1 = MP3, 0 = OGG.
MP3PATH: archivo .m3u con rutas de MP3 o m3u playlist.
BITRATE: frecuencia de muestreo o flujo; ajusta según tu ancho de banda.

Crea la playlist m3u:

/music/artist/album/song1.mp3
/music/artist/album/song2.mp3

O automatiza:

Arranca icegenerator con las bibliotecas necesarias en LD_LIBRARY_PATH:

Comprueba proceso y logs:

La emisora MP3 estará disponible en:

http://MyHost/IP:8000/radiostation2

Comprobaciones, pruebas y criterios de aceptación

Criterios de aceptación (verificación mínima para considerar la instalación correcta):

Icecast se ejecuta como usuario “icecast” y tiene su pid en /var/run/icecast/icecast.pid.
La interfaz web en http://MyHost/IP:8000/ responde y muestra la lista de mounts cuando hay fuentes conectadas.
ices y/o icegenerator se conectan correctamente al servidor y aparecen como “source” en la interfaz.
Se puede reproducir audio desde un cliente (VLC, Winamp, mpv, navegador con plugin) conectándose al mount correspondiente.
Los logs (access.log, error.log, playlist.log, ices1.log, icegen1.log) reflejan actividad sin errores críticos.

Pruebas simples (test cases):

Arrancar icecast y verificar puerto 8000 abierto: netstat -lntp | grep 8000
Conectar ices y comprobar que el mount /radiostation1 aparece en la web.
Reproducir http://MyHost/IP:8000/radiostation1 en VLC desde otra máquina y confirmar audio.
Revisar logs por entradas de errores y uso de CPU/memoria durante la reproducción.

Seguridad y endurecimiento (recomendaciones)

Cambia todas las contraseñas por contraseñas seguras y únicas. Nunca uses “password” en producción.
Ejecuta Icecast con un usuario no privilegiado (ya cubierto con el usuario icecast).
Limita acceso al puerto de administración desde IPs de confianza (firewall iptables o reglas de red).
Considera activar HTTPS si vas a exponer credenciales o metadatos sensibles (configurar un proxy inverso con stunnel o nginx con SSL frente a Icecast, ya que versiones antiguas pueden no soportar TLS directamente).
Revisa y rota logs con logrotate. Asegúrate de permisos correctos para /var/log/icecast.
Si no necesitas que fileserve esté activo, desactívalo en icecast.xml para reducir superficie de ataque.
Mantén el sistema actualizado. Dado que CentOS 6 está EOL, valora migrar a una versión soportada para parches de seguridad.

Notas de privacidad / GDPR (si transmites contenido con datos personales):

No recolectes ni publiques datos personales de oyentes sin consentimiento.
Si guardas logs con IPs, ten política de retención y acceso limitada.

Solución de problemas comunes

Problema: Icecast no arranca o se detiene inmediatamente.

Verifica permisos y que el usuario icecast pueda escribir en /var/run/icecast y /var/log/icecast.
Revisa /var/log/icecast/error.log para errores específicos.
Asegúrate de que el puerto configurado no esté ocupado (netstat -lntp).

Problema: ices/icegenerator no se conectan al servidor.

Comprueba que el password en la configuración del cliente coincide con en icecast.xml.
Verifica hostname/puerto/mount en la configuración del cliente.
Revisa logs del cliente y de Icecast para códigos de autorización o rechazo.

Problema: Reproducción entrecortada o fallos de calidad.

Revisa límite de y ancho de banda del servidor. Streaming consume ancho de subida por cada oyente.
Ajusta bitrate y parámetros de buffer (queue-size, burst-size) según latencia de red.
Si hay CPU alta, reduce número de fuentes o bitrate.

Problema: Player muestra metadatos incorrectos.

Asegúrate de que el cliente (ices/icegenerator) envíe metadata apropiada y que el mount permita metadata.

Alternativas y cuándo no usar esta guía

Si prefieres instalar paquetes precompilados, busca Icecast en repositorios EPEL o paquetes RPM construidos para CentOS. Compilar desde fuente da control total pero añade complejidad.
Para entornos modernos, considera soluciones con soporte activo o servicios gestionados de streaming si no quieres mantener infraestructura.
No uses esta versión (2.3.3) en nuevos despliegues sin evaluar compatibilidad y parches: el tutorial está orientado a entornos que requieren específicamente 2.3.3 en CentOS 6.

Migración y compatibilidad

Al migrar a distros con systemd (CentOS 7+ o RHEL 7+), debes crear un unit file systemd para Icecast y para los clientes en lugar de los comandos de arranque manuales o init scripts.
Valida rutas de instalación (/opt/icecast/latest vs /usr/local) y actualiza LD_LIBRARY_PATH y PKG_CONFIG_PATH según corresponda.

Ejemplo de script init simple (SysV) para CentOS 6

Guarda como /etc/init.d/icecast-custom y marca ejecutable. Ajusta rutas si las tuyas difieren.

#!/bin/sh
# chkconfig: 345 90 10
# description: Inicia Icecast desde /opt/icecast/latest

ICECAST_BIN=/opt/icecast/latest/bin/icecast
ICECAST_CONF=/opt/icecast/latest/etc/icecast.xml
PIDFILE=/var/run/icecast/icecast.pid

case "$1" in
 start)
  echo "Iniciando Icecast..."
  su -s /bin/bash -c "$ICECAST_BIN -c $ICECAST_CONF -b" icecast
  ;;
 stop)
  echo "Parando Icecast..."
  if [ -f "$PIDFILE" ]; then
    kill `cat $PIDFILE`
  fi
  ;;
 restart)
  $0 stop
  sleep 1
  $0 start
  ;;
 *)
  echo "Uso: $0 {start|stop|restart}"
  exit 1
  ;;
esac

exit 0

Habilita en runlevels: chkconfig –add icecast-custom

Listas de verificación por rol

Administrador de sistemas:

Verificar dependencias y compilar libshout
Crear usuario/grupo icecast y directorios
Configurar firewall y SELinux según política
Implementar rotación de logs

Operaciones / Emisión:

Configurar playlists absolutas
Probar subida de capas (sources) y reproducción
Establecer credenciales seguras para fuentes

Desarrollador / Integrador:

Validar formatos admitidos (OGG vs MP3)
Construir herramientas de automatización para generar playlists
Monitorizar uso de ancho de banda y replicar según demanda

Cuadro de hechos y recomendaciones (fact box)

Software principal: Icecast 2.3.3
Clientes recomendados: ices (OGG), icegenerator (MP3)
Rutas por defecto del tutorial: /opt/icecast/latest, /usr/src/icecast
Usuario ejemplo: icecast (uid/gid 200)
Puerto por defecto en guía: 8000

Glosario rápido (1 línea cada término)

Icecast: servidor de streaming de audio que soporta OGG y MP3.
ices: cliente para transmitir OGG/Vorbis hacia Icecast.
icegenerator: cliente para transmitir MP3 hacia Icecast.
libshout: biblioteca necesaria para enviar streams a Icecast.
mount: punto de montaje en Icecast donde se sirve un stream.

Resumen final

Esta guía cubre desde la compilación de Icecast 2.3.3 en CentOS 6.3 hasta la configuración de clientes ices e icegenerator para transmitir OGG y MP3. Incluye archivos de configuración de ejemplo, comandos de compilación, comprobaciones, listas de verificación, sugerencias de seguridad y soluciones a problemas frecuentes. Sigue los pasos en orden, cambia contraseñas ejemplo y adapta rutas y puertos a tu entorno. Si necesitas soporte a largo plazo o un entorno con actualizaciones de seguridad, considera migrar a una distribución y versiones de software con soporte activo.

Enlaces y recursos:

Icecast, libshout y ices: http://www.icecast.org
Descripción de icegenerator: http://www.becrux.com/index.php?page=projects&name=icegenerator#Configuration

Cómo instalar un servidor de audio en streaming con Icecast 2.3.3 en CentOS 6.3 x86_64 Linux