Die Verwaltungsschnittstelle bietet Beobachtung und Eingriffe. Einige dokumentierte Operationen ändern den Zustand über eine GET-Anfrage. Solche URLs gehören nicht in öffentliche Seiten, Monitoring-Proben oder automatisch vorgeladene Links. GET bedeutet hier nicht automatisch schreibgeschützt.
Endpunktreferenz
| Pfad | Parameter | Wirkung |
|---|---|---|
/admin/stats | Optionale Filter hängen von Endpunkt und Version ab | Serverstatistik lesen |
/admin/listmounts | Keine für die einfache Liste | Verfügbare Mountpoints lesen |
/admin/listclients | mount | Hörer und ihre Kennungen lesen |
/admin/metadata | mount, mode=updinfo, song | Metadaten verändern |
/admin/fallbacks | mount, fallback | Fallback-Zuordnung verändern |
/admin/moveclients | mount, destination | Bestehende Hörer verschieben |
/admin/killclient | mount, id | Einen Hörer trennen |
/admin/killsource | mount | Die Streamquelle trennen |
Die Tabelle beschreibt die dokumentierten klassischen Endpunkte und nicht jeden internen Befehl von 2.5.0. Eine Hörerkennung ist eine Laufzeit-ID und kein dauerhaftes Benutzerkonto. Das Verschieben benötigt ein aktives geeignetes Ziel. Eine Quellentrennung kann den eingerichteten Fallback auslösen und betrifft echte Hörer.
Eine lesende Anfrage stellen
Der folgende lokale Abruf fragt ein Kennwort ab, statt es in eine URL einzubauen:
curl --fail --show-error --user admin --get --data-urlencode 'mount=/live.ogg' http://127.0.0.1:8000/admin/listclientsVerwenden Sie für Fernzugriffe TLS und Ihre eigene Serveradresse. Prüfen Sie HTTP-Status und XML-Ergebnis. Ein erfolgreicher Transport bedeutet nicht zwangsläufig, dass eine verändernde Operation erfolgreich war. Beschränken Sie den Zugriff auf Höreradressen und Sitzungsdetails.
Die Webverwaltung einordnen
/admin/stats.xsl stellt die lesbare Verwaltungsansicht bereit. Die mitgelieferten Transformationen zeigen Serverdaten an; ihre Anwesenheit erzeugt keine beliebigen neuen API-Befehle. Allgemeine Operationen benötigen Verwaltungszugangsdaten. Bestimmte Mount-Operationen können die zugehörige Source-Regel akzeptieren. Prüfen Sie Konto und Aktion konkret. Eine erfolgreiche Anmeldung belegt keine pauschale Berechtigung.
Verwenden Sie für regelmäßiges Monitoring nur lesende Endpunkte. Prüfen Sie trennende Aktionen ausschließlich an einem entbehrlichen Mount mit bekannten Testhörern. Halten Sie bei einer Integrationsprüfung Quellen- und Hörerzustand vor und nach dem Eingriff fest.