Die Tabellen ordnen die Einstellungen nach ihrer Aufgabe. Sie beziehen sich auf die Konfiguration, das Handbuch und den Quellcode von Icecast 2.5.0. Hinweise auf ältere Schreibweisen sind gekennzeichnet. Prüfen Sie Ihre installierte Version, bevor Sie Einstellungen übernehmen.
Vor dem Kopieren den Geltungsbereich lesen
Das äußere Element ist <icecast>. Schrägstriche in Tabellenzeilen zeigen die Verschachtelung und sind keine wörtlichen XML-Elementnamen. Manche Namen treten mehrfach auf. Das Hörerlimit eines Mounts ist keine instanzweite Clientgrenze. Der entfernte Relay-Mount ist nicht sein lokaler öffentlicher Pfad. Prüfen Sie Typen und Vorgaben anhand der konkreten Version. Beispielwerte sind keine Standardwerte.
Sichern Sie die funktionierende Datei. Ändern Sie nur die für die Aufgabe nötige Einstellung, prüfen Sie das XML und lesen Sie Start-/Reloadmeldungen. Die verlinkten Anleitungen erläutern Voraussetzungen und die Prüfung des tatsächlichen Verhaltens.
Serveridentität
Parameter
Aufgabe und Grenze
hostname
Hostname für erzeugte URLs und Veröffentlichung, keine Bind-Adresse.
location
Anzeigetext der Instanz; nur bewusst vorgesehene Angaben hinterlegen.
admin
Technische Kontaktangabe; eine Verzeichnismeldung kann echte Kontaktdaten verlangen.
fileserve
Aktiviert Webroot-Dateien; Ressourcen der Statusseite können davon abhängen.
server-id
Überschreibt die Kennung; den versionsbezogenen Standard normalerweise erhalten.
Globale Grenzen und Puffer
Parameter
Aufgabe und Grenze
limits/clients
Gleichzeitige Clients einschließlich Hörern und anderer HTTP-Zugriffe.
limits/sources
Aktive Quellen einschließlich aktiver Relays im dokumentierten Modell.
queue-size
Grenze der Streamwarteschlange in Bytes; auch mountbezogen möglich.
burst-size
Anfangsmenge für neue Hörer in Bytes; kleiner als die Queue halten.
header-timeout
Erlaubte Sekunden für den Eingang des Anfrageheaders.
source-timeout
Sekunden ohne Quelldaten bis zur Trennung der Quelle.
client-timeout
Im mitgelieferten Handbuch als unbenutzt beschrieben; nicht blind abstimmen.
burst-on-connect
Veraltete Steuerung; stattdessen den dokumentierten burst-size-Wert nutzen.
threadpool
Historische Einstellung aus 2.0.2, keine heutige Tuning-Empfehlung.
Zugangsdaten und Rollen
Parameter
Aufgabe und Grenze
source-password
Globales Source-Geheimnis der Kompatibilitätsform; Mount-Regeln können es ersetzen.
relay-user / relay-password
Zugangsdaten für die berechtigte Ermittlung von Relays.
admin-user / admin-password
Getrennte Administratoridentität und zugehöriges Geheimnis.
authentication/role
Rollenbezogene Auswahl, Authentifizierung und Zugriffsregel in 2.5.
role/match-method
Filtert die vom Authentifizierer berücksichtigten HTTP-Methoden.
role/allow-method / deny-method
Berechtigungen sind von der Auswahl passender Anfragen zu trennen.
role/allow-web / deny-web
Steuert den Webressourcenzugriff dieser Rolle.
role/allow-admin / deny-admin
Steuert den Zugriff der Rolle auf Verwaltungsbefehle.
role/connections-per-user
Verbindungsregel pro Benutzer; nicht das alte Duplicate-User-Flag.
role/option
Authentifiziererspezifische Werte wie filename oder client_add.
Sockets und Antwortheader
Parameter
Aufgabe und Grenze
listen-socket/port
Lokaler TCP-Port; Konflikte mit anderen Instanzen oder Diensten prüfen.
listen-socket/bind-address
Lokale Schnittstelle; ohne Angabe können alle passenden Interfaces betroffen sein.
listen-socket/tls
TLS-Regel; das Beispiel von 2.5 nutzt auto_no_plain für TLS-Zugriff.
listen-socket/shoutcast-mount
Source-Pfad der Kompatibilität; belegt Basisport und Folgeport.
http-headers/header
Eigener Antwortheader mit name/value; globale und Mount-Wirkung prüfen.
header/type="cors"
Das Beispiel von 2.5 erzeugt CORS-Header über den vorgesehenen Headertyp.
Mount-Regeln
Parameter
Aufgabe und Grenze
mount/type
normal betrifft einen expliziten Mount; default besitzt eigene Vorgabesemantik.
mount-name
Exakter Streampfad; startet keine Quelle.
username / password
Mountbezogener Source-Zugang in der Kompatibilitätsform.
max-listeners
Erlaubte gleichzeitige Hörer dieses Mounts.
max-listener-duration
Hörerdauer in Sekunden unter Berücksichtigung der Authentifizierungsregel.
dump-file
Optionaler Mitschnitt eingehender Daten; Speicher und Rechte planen.
intro
Intro-Medien relativ zum Webroot; Format muss zum Stream passen.
fallback-mount
Ziel bei fehlendem Stream; kein Backup-Encoder.
fallback-override
Erlaubt der zurückkehrenden Originalquelle die Hörer-Rücknahme.
fallback-when-full
Leitet neue Hörer beim vollen Mountlimit an den Fallback.
charset
Erwartete Kodierung der Quellmetadaten passender Legacy-Streams.
public
Übersteuerung der Verzeichnisveröffentlichung; schützt keinen Hörerzugriff.
hidden
Blendet den Mount in bestimmten Ansichten aus; keine Authentifizierung.
stream-name / stream-description
Anzeige- und Verzeichnismetadaten anstelle quellenseitiger Werte.
stream-url / genre
Beschreibende Programm-URL und Genre, keine Socket-Adresse.
bitrate / type / subtype
Veröffentlichte Medienangaben; führen keine Umkodierung durch.
icy-metadata-interval
Bytes zwischen ICY-Metadatenblöcken für passende neue Hörer.
event-bindings
Quellenereignisse in 2.5; Programm- und URL-Aktionen begrenzen.
on-connect / on-disconnect
Ältere Lebenszyklusform; vor Migration mit event-bindings vergleichen.
Relay- und Upstream-Konfiguration
Parameter
Aufgabe und Grenze
relay/local-mount
Vom empfangenden Server bereitgestellter Pfad.
relay/on-demand
Ruft nach Hörerbedarf statt durchgehend ab.
upstream/type
normal beschreibt eine Zuführung; default liefert gemeinsame Upstream-Werte.
upstream/uri
Vollständige Upstream-URI laut mitgeliefertem Beispiel von 2.5.
upstream/server / port / mount
Alternative getrennte Quellangaben; local-mount davon unterscheiden.
upstream/username / password
Vom abgerufenen Upstream benötigte Zugangsdaten.
relay-shoutcast-metadata
Fordert eingebettete ICY-Metadaten an, sofern die Quelle sie unterstützt.
master-server / master-server-port
Entfernter Server und Port für die Master-Relay-Ermittlung.
master-username / master-password
Zugangsdaten der Relay-Ermittlung am entfernten Server.
master-update-interval
Sekunden zwischen Ermittlungsabfragen im dokumentierten Master-Modell.
relays-on-demand
Globale On-Demand-Vorgabe für betroffene Relays.
Pfade, Protokolle und Sicherheit
Parameter
Aufgabe und Grenze
paths/basedir
Basis für chroot; kein universeller Präfix sämtlicher Pfade.
paths/logdir
Beschreibbares Basisverzeichnis der eingerichteten Logs.
TLS-Kontext von 2.5 für Zertifikat, Schlüssel und optionale TLS-Regeln.
tls-certificate / tls-key
PEM-Zertifikatskette und geschützter privater Schlüssel im Kontext.
security/prng-seed
Optionale Entropiequelle; passend zum Zielbetriebssystem wählen.
Verhalten und nicht nur den Parser prüfen
Die Anleitungen zu Mountpoints, TLS, Rollen und Relays beschreiben konkrete Abläufe. Halten Sie aktive Version und Änderungen fest. Ein wohlgeformtes XML kann weiterhin eine falsche Verschachtelung oder veraltete Option enthalten. Entscheidend ist das gewünschte Verhalten von Quelle, Hörern und Fehlerfällen.