Zum Inhalt springen

Diese Seite ist eine maschinelle Übersetzung der englischen Seite, die maßgeblich ist. Englische Seite lesen

Föderations-Relays

Ein Relay ist ein Server, der die öffentlichen Beiträge der Server, die ihm beitreten, an die anderen beigetretenen Server weitergibt. Selbst ein kleiner Server mit wenigen Follows erhält eine gefüllte föderierte Timeline und Hashtag-Timelines, und seine eigenen öffentlichen Beiträge reichen weiter. Ein Server, der keinem Relay beitritt, gewinnt keine Zeilen und keine Jobs.

Verwende „Relays“ im Admin-Bereich (/admin/relays). Dafür ist die Berechtigung manage_settings nötig, die die eingebaute Rolle admin hat. „Einem Relay beitreten“ öffnet das Formular, das eines registriert. Die Liste zeigt den Zustand jedes Relays und was es in den letzten 24 Stunden eingebracht hat; wenn du ein Relay auswählst, öffnet sich seine Seite mit seinen Adressen und der Schaltfläche, die es verlässt, oder, sobald der Server es verlassen oder es den Server abgelehnt hat, den Schaltflächen, die ihm erneut beitreten und es löschen. Verlassen und Löschen fragen vorher nach. Die CLI ist my admin relay (my admin relay -help):

Terminal-Fenster
my admin relay list # every relay, its state, and what it brought in during the last 24 hours
my admin relay create [-protocol mastodon|litepub] [-send-only] <url> # register a relay and send it the Follow
my admin relay unfollow <relay id> # leave a pending or joined relay
my admin relay follow <relay id> # join again a relay that the instance left or that rejected it
my admin relay delete <relay id> # delete a relay that the instance left or that rejected it
  1. Registriere die URL des Relays. Es gibt zwei Protokolle:
    • Mastodon: die Inbox-URL des Relays (etwa https://relay.example/inbox). Viele Relays, darunter pub-relay und Activity-Relay, akzeptieren sie.
    • LitePub: die Actor-URL des Relays (etwa https://relay.example/relay). Das ist das Protokoll der Relays von Pleroma und Akkoma. Wählst du kein Protokoll („Automatisch erkennen“), verwendet der Server LitePub, wenn die URL ein Actor-Dokument ausliefert, und sonst Mastodon.
  2. Nach der Registrierung sendet der Instanz-Actor dem Relay ein Follow, und der Zustand lautet „Wartet auf die Antwort des Relays“ (pending). Nimmt das Relay an, wird der Zustand „Beigetreten“ (accepted); lehnt es ab, „Vom Relay abgelehnt“ (rejected). Manche Relays brauchen eine Weile, weil ein Betreiber jede Anfrage von Hand freigibt.
  3. Schaltest du bei der Registrierung „Beiträge vom Relay empfangen“ aus, sendet der Server nur. Um das zu ändern, verlasse das Relay und registriere es erneut.

Du kannst das Relay eines Servers nicht registrieren, auf den eine Domain-Aktion (suspend) angewendet wurde. Wird der Server eines beigetretenen Relays später gesperrt, ändert sich der Zustand nicht, aber an dieses Relay wird nichts gesendet und von ihm nichts empfangen, und der Admin-Bereich weist im Zustand des Relays darauf hin.

  • Nur das Erstellen, Bearbeiten und Löschen lokaler öffentlicher (public) Beiträge wird gesendet. Beiträge, die unlisted, nur für Follower, direkt oder für Nachbarn (local) sind, sowie Boosts werden nie gesendet. Um einen Beitrag von Relays fernzuhalten, poste ihn als unlisted oder local („Ruhig öffentlich“ oder „Nachbarn“). Es gibt kein Opt-out pro Nutzer.
  • Die Dokumente öffentlicher Beiträge tragen eine Linked Data Signature (RsaSignature2017), damit Mastodon und Misskey Beiträge akzeptieren können, die ein Relay unverändert weitergibt.
  • Die Zahl der Zustellungen wächst um die Zahl der beigetretenen Relays mal die Zahl der öffentlichen Beiträge (Zustellungen an ein Relay werden zu einer zusammengefasst).
  • Ein öffentlicher Beitrag, den ein beigetretenes Relay weiterreicht, wird von seinem Ursprung erneut abgerufen und geprüft, bevor er aufgenommen wird. Er erscheint dann in der föderierten Timeline und in Hashtag-Timelines sowie in den Home-Timelines der Leute, die einem seiner Hashtags folgen. Er erscheint in keiner anderen Home-Timeline und erzeugt keine Benachrichtigung.
  • Pro Relay werden höchstens relay_max_activities_per_hour Beiträge pro Stunde aufgenommen (Standard 1.000). Alles über dem Limit wird verworfen, ohne abgerufen zu werden. Die Seite des Relays im Admin-Bereich und my admin relay list zeigen, wie viele in den letzten 24 Stunden aufgenommen und wie viele über dem Limit verworfen wurden. Werden viele verworfen, erhöhe das Limit oder überdenke das Relay.
  • Ein Beitrag wird nicht aufgenommen, wenn seine Domain oder sein Konto ein suspend (eine Föderationsbeschränkung) oder ein limit (eine Beschränkung, die ihn von öffentlichen Orten entfernt) hat.
  • Ein Beitrag, der nur über ein Relay ankam, wird nach der Instanzeinstellung relay_status_retention_days (Standard 7) aus der öffentlichen Ansicht entfernt. Ein Beitrag, auf den eine lokale Person geantwortet, den sie geboostet, favorisiert oder mit einem Lesezeichen versehen hat, und die Beiträge von Autoren, denen eine lokale Person folgt, erhalten dieselbe Aufbewahrung wie andere entfernte Beiträge (remote_status_retention_days).
  • Das Aufnehmen kostet einen Abruf vom Ursprung pro Beitrag (plus einen Abruf des Akteurs bei einem unbekannten Autor). Beim Limit von 1.000 pro Stunde sind das höchstens 24.000 Abrufe am Tag.

Die Einstellungen stehen in der Konfigurationsreferenz. Das Ergebnis des Aufnehmens wird auch als Metrik my.relay.activities exportiert (siehe Den Server betreiben).

  • „Verlassen“ sendet ein Undo des Follow und setzt den Status auf „Verlassen“ (left). Danach wird nichts an das Relay gesendet oder von ihm empfangen. Bereits aufgenommene Beiträge werden entfernt, wenn ihre Aufbewahrung endet.
  • „Erneut beitreten“ sendet ein neues Follow an ein Relay, das den Server abgelehnt hat oder das der Server verlassen hat.
  • „Löschen“ entfernt die Registrierung eines Relays, das verlassen oder abgelehnt wurde. Bearbeitungen und Löschungen von Beiträgen, die bereits an das Relay gesendet wurden, werden ihm auch nach dem Löschen weiterhin zugestellt.

Das Registrieren, Beitreten, Verlassen und Löschen sowie die Annahme oder Ablehnung durch das Relay werden im Audit-Log mit dem Zieltyp „Relay“ festgehalten (Annahme und Ablehnung als entfernte Aktionen).

Für LLMs und Coding-Agenten:llms.txt,llms-full.txt, llms-small.txt

Analyse auf dieser Website