Konfigurationsreferenz für Icecast KH

Die Tabellen ordnen die KH-Einstellungen nach ihrem Einsatzbereich. Sie beruhen auf der mitgelieferten Dokumentation und dem festgelegten Quellcode. Ein Schrägstrich zeigt den Pfad zu einer Einstellung, @ kennzeichnet ein Attribut. Schreiben Sie diese Zeichen nicht in XML-Elementnamen.

Eine Einstellung am richtigen Ort anwenden

Behalten Sie ein äußeres <icecast>-Wurzelelement. Instanzweite Grenze, Mount-Regel und Relay-Quelle sind unterschiedliche Kontexte, auch wenn Namen ähnlich aussehen. Die vollständige Beispielkonfiguration enthält keine universellen Vorgaben. Ersetzen Sie vor Verwendung Zugänge und Pfade.

Prüfen Sie erst XML-Syntax, dann Parserannahme und tatsächliche Anfragen mit der konkreten Binärdatei. Ein wohlgeformtes Dokument kann eine falsch geschriebene Option enthalten. Einige Abweichungen zwischen Handbuch und Implementierung sind unten markiert.

Instanz und Netzwerk

Parameter	Aufgabe und Grenze
`hostname`	Öffentlicher Name für erzeugte URLs; keine Bind-Adresse.
`location / admin`	Bewusst öffentliche Beschreibungs- und Kontaktangaben.
`listen-socket/port / bind-address`	Lokaler Port und Schnittstelle; externe Erreichbarkeit getrennt prüfen.
`listen-socket/ssl`	Socket-TLS einschalten, soweit im Build verfügbar.
`listen-socket/shoutcast-mount`	Source-Mount der Kompatibilität mit zugehöriger Portbehandlung.
`http-headers/header`	Antwortfelder mit Name/Wert; CORS und Informationsfreigabe prüfen.

Grenzen und Puffer

Parameter	Aufgabe und Grenze
`limits/clients / sources`	Instanzweite Grenzen gleichzeitiger Clients und Sources.
`limits/queue-size`	Maximale Medienqueue mit den dokumentierten KH-Größenformen.
`limits/burst-size / min-queue-size`	Anfangsburst und gehaltenes Minimum; mit dem Maximum abstimmen.
`limits/header-timeout / source-timeout`	Zeitgrenzen für Header beziehungsweise fehlende Quelldaten in Sekunden.
`limits/client-timeout`	Historischer Parameter; daraus keine heutige Leerlaufregel ableiten.
`limits/workers`	Anzahl der KH-Worker; nur nach Messung ändern.

Exakte und gemusterte Mounts

Parameter	Aufgabe und Grenze
`mount/mount-name`	Exakter Pfad oder unterstütztes Platzhaltermuster.
`mount/priority`	Kleinerer Zahlenwert gewinnt unter Mustern; exakter Treffer zuerst.
`username / password`	Mountbezogene Source-Zugangsdaten.
`max-listeners`	Grenze gleichzeitiger Hörer des ausgewählten Mounts.
`max-listener-duration`	Dauer einer Hörersitzung in Sekunden.
`queue-size / burst-size / min-queue-size`	Mount-Pufferregeln; Byte- und Zeitformen benötigen den Ratenbezug.
`source-timeout`	Mountbezogene Sekunden ohne Quelldaten.
`fallback-mount`	Ersatzziel; optionales rate-Attribut für unterstützten Dateifallback.
`fallback-override / fallback-when-full`	Rücknahmeregel und Weiterleitung bei vollem Mount.
`hijack`	Ausdrückliche Erlaubnis zur Source-Übernahme; Zugänge schützen.
`linger-for`	Sekunden zum Halten des Quellzustands nach Trennung im unterstützten Ablauf.
`intro / dump-file`	Intro und optionaler Mitschnitt; Format und Speicherrechte planen.
`public / hidden`	Verzeichnis-/Listensichtbarkeit, keine Hörerprüfung.
`stream-name / stream-description / stream-url / genre`	Veröffentlichte Beschreibung; ändert keine Medienkodierung.
`metadata-interval / mp3-metadata-interval`	KH-Namen für den ICY-Metadatenabstand in Bytes.
`allow-url-ogg-metadata`	Parsername mit Bindestrichen statt Unterstrichfehler im Handbuch.
`skip-accesslog`	Unterdrückt diesen Mount im Zugriffslog und reduziert Diagnosebelege.

Authentifizierung

Parameter	Aufgabe und Grenze
`authentication/source-password`	Globales Source-Geheimnis; Mount-Regeln können es ersetzen.
`authentication/admin-user / admin-password`	Getrennte Verwaltungszugänge.
`authentication/relay-user / relay-password`	Zugang für erlaubte Relay-Ermittlung.
`mount/authentication/@type`	Klassisches htpasswd- oder URL-Verfahren; kein Rollen-XML von 2.5.
`option filename / allow_duplicate_users`	Private Benutzerdatei und Schalter gegen doppelte Kontonutzung.
`option listener_add / listener_remove`	KH-Callback-URLs für Zulassung und Abmeldung.
`option stream_auth / mount_add / mount_remove`	Source-Zulassung und Mount-Lebenszykluscallbacks.
`option auth_header / timelimit_header`	Vertrag der Antwortheader statt beliebiger erfolgreicher Statuscodes.
`option headers / header_prefix`	Ausgewählte Anfragefelder weitergeben; implementiert ist header_prefix.

Relay-Quellen und Ermittlung

Parameter	Aufgabe und Grenze
`relay/local-mount`	Stabiler lokaler Hörerpfad unabhängig vom Quellpfad.
`relay/host/server / port / mount`	Quellangaben innerhalb jedes Hostkandidaten.
`relay/host/priority`	Reihenfolge; niedrigere konfigurierte Werte haben höheren Vorrang.
`relay/username / password`	Benötigte Zugangsdaten der entfernten Quelle.
`relay/on-demand`	Nach Bedarf abrufen; Startwartezeit des ersten Hörers prüfen.
`relay/retry-delay`	Sekunden zwischen erneuten Relay-Versuchen.
`relay/relay-shoutcast-metadata`	ICY-Metadaten einer passenden Quelle anfordern.
`master-server / master-server-port / master-password`	Globale Master-Adresse, Port und Zugang zur Ermittlung.
`master-update-interval / relays-on-demand`	Ermittlungsintervall in Sekunden und globale Bedarfsregel.
`master-redirect / max-redirect-slaves`	Optionale Redirect-Regel; kein Verschieben bestehender TCP-Streams.

Dateien, TLS, Verzeichnisse und Logs

Parameter	Aufgabe und Grenze
`paths/basedir / webroot / adminroot / logdir`	Basis, öffentliche Dateien, Verwaltungsstylesheets und Logs trennen.
`paths/pidfile / mime-types`	Prozesskennungsdatei und Medientypzuordnung.
`paths/alias @source / @dest`	KH-Aliasattribute; destination von 2.5 ist ein anderer Vertrag.
`paths/ssl-certificate / ssl-private-key`	Zertifikatskette und privater Schlüssel in der klassischen KH-Form.
`logging/accesslog / errorlog / playlistlog`	Zugriffs-, Diagnose- und Metadatenprotokolle.
`logging/loglevel`	Klassische numerische Stufe; 3 Information, 4 Debug.
`logging/logsize / logarchive`	Klassische Rotationsgröße in Kilobyte und Archivverhalten.
`directory/yp-url / yp-url-timeout`	Verzeichnisendpunkt und Zeitgrenze in Sekunden.
`security/chroot / changeowner`	Dateisystemisolation und unterstützter Benutzer-/Gruppenwechsel.

Den passenden Betriebsablauf verwenden

Die Anleitungen zu Mount-Vorrang, mehreren Quellen, URL-Zulassung und TLS erläutern Voraussetzungen, Ausschnitte und Fehlerfälle. Konfigurationsprüfung ersetzt weder Source-/Hörertest noch Rückkehrprobe.