Synapse-admin Service

Diese Seite ist auch verfügbar in: English, Русский

Synapse-admin ist ein Werkzeug zum Administrieren ihrees (Matrix) Synapse Homeservers - Hier können sie Benutzer Accounts verwalten, oder Medien und Chatverläufe löschen um Speicher freizugeben, etc. Auf dieser Seite finden sie eine Anleitung zur verwendung dieses Werkzeugs.

Die Benutzerverwaltungsübersicht von Synapse-admin

Einloggen

Standardmäßig erreichen Sie die Administrationsoberfläche unter https://matrix.your-server.com/synapse-admin und sie präsentiert Ihnen die folgenden Felder:

Ein initial verstecktes “Label” zeigt Ihnen unterhalb der Eingabemaske die Homeserver Version an (z.B. Synapse version 1.62.0 wie im Bild unten zu erkennen). Dieses Label wird erst Angezeigt werden wenn Sie die korrekte URL ins Homeserver URL Feld eingetragen haben.

synapse-admin login page

Bekannte Probleme

Ungültige oder Leere Homeserver URL

Üblicherweise heißt dass das Sie nur den lokalen teil ihrer MXID in das Username Feld eingetragen haben. Sie müssen die ganze MXID (@username:your-server.com) eintragen müssen, nicht nur username oder @username. In ganz besonderen Fällen, wie z.B. bei Verwendung eines CDNs ohne CORS Header, schlägt das automatische Setzen des Feldes fehl und sie müssen es manuell korrigieren.

Es erscheint kein Label mit der Homeserver Version

Wenn Sie keine Versionsangabe wie Synapse version x.xx.x unter dem Homeserver URL Feld sehen, haben Sie wahrscheinlich im Feld Homeserver URL eine falsche Adresse eingegeben oder Ihr Homeserver ist heruntergefahren (in 99% der Fälle ist die Homeserver URLnur falsch angegeben).

Netzwerk Fehler

You may see different error messages, but all of them can be split into the following groups: Sie könnten verschiedene Fehlermeldungen sehen, aber alle von ihnen fallen in eine der folgenden Gruppen:

Ungültige Homeserver URL

Yes, if your Homeserver URL field doesn’t contain a value like https://matrix.your-server.com, that’s usually the problem Wenn Ihr Homeserver URL Feld keinen Wert im Format wie https://matrix.your-server.com enthält, ist dies üblicherweise das Problem

Benutzername anstatt der MXID

Wenn Sie ihren Benutzernamen in das Username feld eingeben (der lokale Teil Ihrer MXID), wird es nicht funktionieren. Sie müssen die Vollständige MXID eingeben (@username:your-server.com), nicht nur username oder @username.

Der Benutzer besitzt keine Homeserver Administrationsprivilegien

Um sich in den synapse-admin oder der synapse-admin API (dies verschiedene dinge) einzuloggen, benötigen sie einen matrix Benutzer der Homeserver Administrationsprivilegien hat.

Massen Registrierung

Um viele Benutzer auf einmal zu registrieren, können Sie die CSV-Importfunktion von synapse-admin verwenden.

Zunächst müssen Sie eine “csv”-Datei mit den zu importierenden Benutzerdaten mit folgendem Inhalt erstellen:

id,displayname,password,is_guest,admin,deactivated
jane.doe,Jane Doe,secretpassword,false,false,false

HINWEIS: die zweite Zeile ist ein Beispiel

Als nächstes müssen Sie die Seite CSV-Import öffnen (klicken Sie auf die Schaltfläche “CSV IMPORT” in der rechten Ecke über der Benutzertabelle).

synapse-admin Benutzer Seite hervorgehoben CSV Import

Standardmäßig ist es auf https://matrix.your-server.com/synapse-admin/#/import_users gehostet.

synapse-admin Benutzer CSV-Import

Auf dieser Seite müssen Sie die folgenden Optionen auswählen:

Nachdem Sie all diese Optionen ausgewählt haben, klicken Sie auf IMPORT.

Löschen alter Medien

Um etwas Speicherplatz freizugeben, müssen Sie gelegentlich alte Medien (hochgeladene Dateien) von Ihrem Homeserver löschen.

Sie müssen sich dafür einloggen :

synapse-admin Medien Seite des Benutzers

Es wird sich daraufhin ein neues Fenster mit 2 verfügbaren Filtern öffnen:

synapse-admin Fenster zum Löschen von Medien