Icecast 2.3.3 sur CentOS 6.3 — guide d'installation

Ce guide explique pas à pas comment installer Icecast 2.3.3, configurer des sources OGG/Vorbis (ices) et MP3 (icegenerator) sur CentOS 6.3 x86_64. Il couvre les paquets requis, la compilation, la configuration des fichiers XML/CFG, la création des utilisateurs, le démarrage des services et le dépannage basique. À la fin vous pourrez diffuser plusieurs stations simultanément et sécuriser l’accès.

Important: ce guide compile depuis les sources et cible CentOS 6.3. Si vous utilisez une autre distribution ou une version récente (systemd), adaptez les commandes de démarrage et d’init.

Objectifs principaux

Installer Icecast 2.3.3 sous /opt/icecast/2.3.3
Configurer et lancer Icecast en tant qu’utilisateur non privilégié
Mettre en place ices (OGG/Vorbis) et icegenerator (MP3)
Fournir conseils de sécurité, dépannage et checklist opérationnelle

Variantes de recherche (intention principale et variantes liées)

installer icecast
icecast centos
serveur audio streaming ogg mp3
configurer ices icegenerator
icecast 2.3.3 compilation

Pré-requis

Accès root sur un serveur CentOS 6.3 x86_64
Réseau ouvert sur le port choisi (par défaut 8000)
Bibliothèques de développement (build tools) et espace disque suffisant
Collections de fichiers audio (OGG/MP3) pour les playlists

Notes:

CentOS 6.3 utilise SysV init. Pour systemd (CentOS 7+), adaptez les scripts d’init.
Ce guide compile depuis les sources officielles des projets Xiph et SourceForge.

1. Installer et compiler Icecast

Récupérez et installez les outils de compilation et dépendances (exemples fournis pour CentOS 6):

Maintenant extrayez les sources et compilez:

Le binaire devrait se trouver sous /opt/icecast/2.3.3/latest/bin :

icecast*

Créez un lien “latest” pour simplifier les chemins :

1.1 Modifier la configuration d’Icecast

Déplacez le fichier d’exemple original et éditez icecast.xml :


   


     
       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

Explications rapides:

LIMITS: nombre maximal de clients et de sources (stations). Ajustez selon la charge prévue.
authentication: mots de passe d’administration et de source. Changez-les par défauts faibles.
listen-socket: port par défaut 8000.
paths: chemins pour webroot, logs et pid.
security: exécuter Icecast comme l’utilisateur “icecast” (non root).

1.2 Créer l’utilisateur et les répertoires

Créer le groupe et l’utilisateur icecast (UID/GID 200 pour cet exemple), puis les répertoires de logs/pid :

1.3 Démarrer Icecast

Démarrez Icecast en mode détaché avec la configuration :

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

Sorties typiques :

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

Vérifiez les logs et le processus :

access.log error.log playlist.log

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

Accédez à l’interface web : http://MyHost/IP:8000/

2. Configurer le client OGG/Vorbis (ices)

2.1 Installer libshout

Avant ices, installez libshout :

2.2 Compiler et installer ices

Exportez PKG_CONFIG_PATH afin que ices trouve libshout :

Vérifiez l’installation :

icecast ices

2.3 Configurer une station OGG

Créez le fichier de configuration ices (ex. ices1.xml) :


   


     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

Points importants:

doit correspondre au “source-password” dans icecast.xml.
playlist1.txt doit contenir des chemins absolus vers des fichiers .ogg.

Créer la playlist (exemple):

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

Générer avec find :

Démarrer ices en tant qu’utilisateur icecast :

Consultez le log :

Extraits typiques de log indiquant la lecture et la connexion au serveur :

[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 station OGG est alors disponible sous: http://MyHost/IP:8000/radiostation1

3. Configurer le client MP3 (icegenerator)

3.1 Installer libshout (si non déjà fait)

3.2 Compiler icegenerator

Vérifiez le binaire :

-rwxr-xr-x 1 root root 55K 2011-12-16 12:41 /usr/local/bin/icegenerator*

3.3 Configurer une station MP3

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

Explications rapides:

SERVER: 2 indique un protocole icy/http (valeur depend du client).
FORMAT: 1 = MP3, 0 = OGG
MP3PATH: m3u: suivi du fichier .m3u
BITRATE: valeur ici indiquée comme example (ajustez selon la qualité souhaitée)

Créer la playlist MP3 :

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

Générer avec find :

Démarrer icegenerator (en exportant LD_LIBRARY_PATH si nécessaire) :

Vérifiez le processus :

31255 icegenerator -f /usr/local/etc/icegen1.cfg

Consultez le log :

Extraits typiques :

Fri Dec 16 13:44:38 2011: Connected to stream server Fri Dec 16 13:44:38 2011: Now playing song1.mp3 Fri Dec 16 13:48:41 2011: Wait for all child process to terminate……

La station MP3 est disponible sous: http://MyHost/IP:8000/radiostation2

4. Bonnes pratiques de sécurité et opérationnelles

Important: protégez toujours vos mots de passe de source et d’administration. Voici des conseils pratiques:

Changez immédiatement les mots de passe par défaut (admin, source).
Limitez l’accès au port d’administration via firewall (ex: iptables) ou VPN.
Exécutez Icecast/ices/icegenerator avec un utilisateur non privilégié (ici “icecast”).
Réglez les permissions des répertoires /var/log/icecast et /var/run/icecast pour éviter les accès non autorisés.
Sauvegardez la configuration (/opt/icecast/latest/etc) régulièrement.
Sur un serveur public, considérez l’utilisation d’un reverse proxy (nginx) pour gérer TLS/HTTPS et header hardening.

Notes sur TLS/HTTPS:

Icecast 2.3.3 peut être configuré pour TLS en utilisant stunnel ou une configuration frontale (nginx) terminant TLS, car configurer TLS natif peut demander des modules et un support spécifique.

5. Dépannage courant

Symptômes et vérifications:

Pas de connexion des clients:
- Vérifiez qu’Icecast écoute sur le port: netstat -ltnp | grep 8000
- Vérifiez que le firewall/iptables autorise le port 8000
- Consultez /var/log/icecast/error.log
Source ne peut pas se connecter:
- Assurez-vous que password dans la config du client correspond au “source-password” d’icecast.xml
- Vérifiez les logs du client (ices1.log, icegen1.log)
Fichiers audio non lus:
- Vérifiez que les chemins dans la playlist sont absolus et lisibles par l’utilisateur icecast
- Vérifiez les permissions (chown/chmod) sur les fichiers multimédia
Trop de clients / charge trop élevée:
- Augmentez et dans icecast.xml si les ressources (CPU/RAM/bande passante) le permettent
- Pensez à limiter la bande passante ou utiliser plusieurs serveurs de relais

6. Checklist avant mise en production

Mots de passe d’admin et source changés
Ports réseau ouverts/fermés selon la politique
Logrotate configuré pour /var/log/icecast
Sauvegarde des fichiers de configuration
Monitorage (process, uptime, bande passante)
Tests de charge et nombres max de clients acceptés

7. Méthodologie rapide (mini-playbook)

Préparer le système et installer dépendances.
Compiler et installer Icecast.
Configurer icecast.xml et sécuriser mots de passe.
Créer utilisateur/groupe icecast et répertoires.
Installer/libshout puis ices et icegenerator.
Créer playlists et fichiers de config clients.
Lancer Icecast, puis chaque client source.
Vérifier via webgui et logs.
Mettre en place supervision et sauvegarde.

8. Critères d’acceptation

Icecast démarre sans erreur et crée son pid dans /var/run/icecast/icecast.pid
Les fichiers de log sont écrits sous /var/log/icecast/
Les sources (ices/icegenerator) se connectent et les flux sont disponibles via HTTP
Les lecteurs externes (VLC, Winamp, clients web) peuvent lire les montages /radiostation*

9. Alternatives et points de comparaison

Solutions packagées: utiliser des paquets natifs (yum/apt) si disponibles pour éviter compilation manuelle.
Autres serveurs: Icecast vs Shoutcast (propriétaire) — Icecast gère nativement OGG et MP3, open source.
Reverse proxy: placer nginx devant Icecast pour TLS, compression, mise en cache et gestion des connexions.

10. Migration et versions

Ce guide cible Icecast 2.3.3 et CentOS 6.3. Pour CentOS 7+, adaptez l’init (systemd unit) et vérifiez les chemins (/usr/local vs /opt).
Tester toute migration en environnement miroir avant production.

11. Exemples de scripts d’init (SysV) pour CentOS 6

Exemple minimal d’un script d’init pour Icecast (à adapter avant utilisation):

#!/bin/sh
# chkconfig: 345 99 10
# description: Icecast server

DAEMON=/opt/icecast/latest/bin/icecast
CONFIG=/opt/icecast/latest/etc/icecast.xml
PIDFILE=/var/run/icecast/icecast.pid
USER=icecast

case "$1" in
 start)
   echo "Starting Icecast"
   su - $USER -c "$DAEMON -c $CONFIG -b"
   ;;
 stop)
   echo "Stopping Icecast"
   if [ -f $PIDFILE ]; then
     kill `cat $PIDFILE`
   fi
   ;;
 restart)
   $0 stop
   sleep 1
   $0 start
   ;;
 *)
   echo "Usage: $0 {start|stop|restart}"
   exit 1
esac

exit 0

Important: vérifiez et adaptez le script avant production. Ajoutez gestion des erreurs et checks supplémentaires.

12. Liste de vérification rôle par rôle

Administrateur système:

Sauvegarder /etc et /opt/icecast/latest/etc
Configurer firewall et SELinux (ou le désactiver explicitement)
Mettre en place logrotate pour /var/log/icecast

Opérateur radio / contenu:

Préparer playlists avec chemins absolus
Vérifier licences et métadonnées des fichiers
Tester la lecture sur différents clients

Développeur / intégration:

Intégrer un reverse proxy si nécessaire
Automatiser le déploiement (scripts, Ansible)

13. Glossaire (une ligne)

Icecast: serveur de streaming audio open source.
ices: client/source pour OGG/Vorbis.
icegenerator: client/source pour MP3.
libshout: bibliothèque client pour envoyer des flux à Icecast.
mount: point de montage du flux (/radiostation1).

14. Foire aux problèmes et solutions rapides

Si ices ne démarre pas: vérifier PKG_CONFIG_PATH et dépendances de libshout.
Si icegenerator signale des erreurs de bibliothèque: exportez LD_LIBRARY_PATH vers /opt/icecast/latest/lib.
Si les lecteurs ne reçoivent pas le son: tester avec curl http://MyHost/IP:8000/radiostation1 pour voir si des octets arrivent.

15. Résumé

Ce tutoriel vous guide depuis la compilation d’Icecast 2.3.3 jusqu’à la mise en place de stations OGG et MP3 avec ices et icegenerator sur CentOS 6.3. Changez les mots de passe par défaut, surveillez les logs et adaptez la configuration aux besoins de charge. Pour un déploiement public, ajoutez une couche TLS via un reverse proxy et assurez-vous d’automatiser les sauvegardes et la surveillance.

Liens utiles

Icecast, libshout et ices: http://www.icecast.org Description pour icegenerator: http://www.becrux.com/index.php?page=projects&name=icegenerator#Configuration

Installer un serveur audio en streaming avec Icecast 2.3.3 sur CentOS 6.3 x86_64 Linux