Diese Seite ist eine maschinelle Übersetzung der englischen Seite, die maßgeblich ist. Englische Seite lesen
Den Dienst schließen
Was du der Reihe nach tust, wenn du den Server nicht mehr betreibst: Nutzern erlauben, ihre Daten mitzunehmen, die Konten löschen, die auf anderen Servern übrig bleiben,
dann den Server anhalten und auf eine statische Abschlussseite umschalten.
Jeder Befehl ist ausführlicher unter Administratoren und Rollen beschrieben.
Im Web-Client erledigt Administration > Server schließen dasselbe für alle mit manage_service_closure: Es kündigt die
Schließung an, ändert ihre Termine oder zieht sie zurück; sobald das Schließdatum verstrichen ist, zeigt Prüfen und schließen, was check zeigt,
und schließt den Server, nachdem du seine Domain eingetippt hast; danach zeigt es den Zustellfortschritt, den status zeigt.
Der Ablauf
Abschnitt betitelt „Der Ablauf“Die Tabelle folgt dem Diagramm von oben nach unten; die Spalte „Server“ beginnt mit dem Zustand, den my admin closure status zeigt.
Das Abschlussdatum (-closes-at) beendet die Ankündigungsfrist, und die Export-Frist (-export-until, 30 Tage nach dem Abschlussdatum,
sofern nicht gesetzt) beendet Phase 5.
| Phase | Server | Was der Betreiber tut |
|---|---|---|
| 1. Ankündigen | announced. Läuft wie gewohnt. Registrierungen, Einladungen und neue Unterstützer-Abos enden |
my admin closure announce, eine Mitteilung auf der Statusseite veröffentlichen |
| 2. Ankündigungsfrist | announced. Läuft wie gewohnt. Nutzer können ihre Daten exportieren und zu einem anderen Server umziehen |
Jahresunterstützern das Geld erstatten, Umzüge und Aufbewahrungssperren prüfen |
| 3. Schließen (nach dem Abschlussdatum) | closed. Nutzer können sich nur anmelden und exportieren. Der Server stellt für jedes Konto ein Delete zu |
my admin closure check und close |
| 4. Zustellung abgeschlossen | Hält delivery_completed fest; lokale Actors geben außerdem 410 zurück |
Mit my admin closure status bestätigen. Die Worker nicht stoppen |
| 5. Bis zur Export-Frist | delivery_completed. Bleibt geschlossen und bietet weiter den Export an |
Die Datensätze unter Aufbewahrungssperren exportieren |
| 6. Statische Seite | Gestoppt. Das Front-End liefert die statische Seite und 410 für die Föderation |
my admin closure export-html, das Front-End umstellen, my serve stoppen |
| 7. Verwerfen | Keiner. Liefere die statische Seite und 410 noch etwa ein Jahr weiter aus |
Die DB, Blobs und Backups verwerfen. Die Domain etwa ein Jahr behalten |
Du kannst jede Phase mit dem Wartungsmodus kombinieren (Wartung). Während der Wartung stoppen Exporte und die Zustellung von Delete-Aktivitäten.
1. Ankündigen
Abschnitt betitelt „1. Ankündigen“Lege das Abschlussdatum (-closes-at) und die Frist fürs Mitnehmen der Daten (-export-until, 30 Tage nach dem Abschlussdatum, wenn weggelassen) fest und kündige sie dann an.
my admin closure announce -closes-at 2027-01-31T15:00:00Z -message "Thank you for being here."my admin closure status- Das Abschlussdatum hat keine untere Grenze, aber eine Warnung erscheint, wenn die Zeit von der Ankündigung bis zum Abschlussdatum kürzer als 30 Tage ist. Gib den Nutzern Zeit zum Exportieren und Umziehen.
- Um das Datum zu ändern, führe
announceerneut aus; um abzusagen, führemy admin closure withdrawaus. Beides sendet jedem Nutzer eine Benachrichtigungservice_closure. - Nach der Ankündigung wird der wirksame Registrierungsmodus
closed, ausstehende Anträge werden abgelehnt, und jedes laufende Unterstützer-Abo wird zum Ende seines Zeitraums gekündigt (Abonnenten erhalten eine Benachrichtigung und eine E-Mail). Das Zurückziehen der Ankündigung macht die Ablehnungen und Kündigungen nicht rückgängig. - Benachrichtigungen werden von Jobs erzeugt, stoppe die Worker also nicht.
- Veröffentliche auf der Statusseite (Überwachung und Statusseite) das Abschlussdatum, die Export-Frist und wie man exportiert und umzieht. Die Statusseite überlebt den Server, sie führt also auch Menschen, die nach der Einstellung vorbeikommen.
2. Ankündigungsfrist
Abschnitt betitelt „2. Ankündigungsfrist“- Nutzer können auf dem Einstellungsbildschirm ihre Daten exportieren (den Datenexport und die CSV-Dateien) und zu einem anderen Server umziehen (
Move). Ein Banner auf jedem Bildschirm und eine Benachrichtigung zeigen das Abschlussdatum, die Export-Frist und den Weg zu diesem Bildschirm. - Jahresunterstützer: Die Ankündigung kündigt Abos zum Ende des Zeitraums, aber bei einem Abo, dessen Zeitraum nach dem Abschlussdatum endet, ist die Zeit, in der es nicht genutzt werden kann, bereits bezahlt. Der Server erstattet nichts, erstatte also jedem Abonnenten im Bildschirm des Zahlungsanbieters das Geld (in Stripe im Zahlungsbildschirm des Dashboards, in PAY.JP im Zahlungsbildschirm der Admin-Konsole) (Unterstützer-Zahlungen (Stripe), Unterstützer-Zahlungen (PAY.JP)).
- Nachdem das Abschlussdatum verstrichen ist, erhalten Personen mit
manage_service_closureeine Benachrichtigungadmin_service_closure_due. Der Server schließt nicht von selbst.
3. Schließen
Abschnitt betitelt „3. Schließen“Sobald das Abschlussdatum verstrichen ist, führe vor dem Schließen die Prüfungen aus.
my admin closure check-
Unfertige Umzüge erzeugen eine Warnung. Warte, bis sie abgeschlossen sind, bevor du schließt, denn nach dem Schließen kann niemand mehr einen
Movestarten. -
Aufbewahrungssperren (
retention_holds) auf einem Konto erzeugen eine Warnung. Die Pflicht hinter einer Sperre endet nicht, wenn du den Server schließt, exportiere also die Datensätze unter einer Sperre und bewahre sie außerhalb des Servers auf (liste die Sperren mitmy admin retention listauf).Terminal-Fenster my admin account export-moderation @alice > alice-moderation.json
Wenn die Prüfungen abgeschlossen sind, schließe. Das lässt sich nicht rückgängig machen. Bestätige durch Eingabe von y und dem Domainnamen (verwende in der Automatisierung -confirm-domain).
my admin closure closeNach dem Schließen können Nutzer sich nur anmelden und ihre Daten exportieren. Die verbleibenden Unterstützer-Abos werden sofort gekündigt,
und ein Delete (Actor) für jedes lokale Konto wird an andere Server zugestellt (auch wenn federation_mode off oder inbound ist).
Die Inbox und GET-Anfragen auf Beiträge und Sammlungen geben 410 Gone zurück.
4. Bestätigen, dass die Zustellung abgeschlossen ist
Abschnitt betitelt „4. Bestätigen, dass die Zustellung abgeschlossen ist“Stoppe my serve und die Worker (Prozesse, deren role all oder worker ist; bei einer Push-Queue die Cloud-Tasks-Queue) nicht, bevor der Zustand delivery_completed ist.
Die Worker stellen die Delete-Aktivitäten zu, und solange sie das tun, liefert der Server weiter das Dokument und den Schlüssel des lokalen Actors aus, damit Empfänger die Signatur des Delete prüfen können.
Wenn du zu früh stoppst, bleiben die Konten auf anderen Servern bestehen.
my admin closure statusaccounts with a Deleteist die Zahl der Konten, für die einDeletefestgehalten wurde,fan-outs pendingist die verbleibende Fan-out-Arbeit, unddeliveries <state>ist die Zahl der Zustellungen pro Zustand.- Zustellungen werden nach der üblichen Richtlinie wiederholt (bis zu 9 Mal über etwa 4 Tage). Wenn alle abgeschlossen sind, hält die Prüfung, die alle 10 Minuten läuft,
delivery_completedfest (state: delivery_completed). Von da an geben auch die lokalen Actors und der Server-Actor410zurück. - Eine Zustellung, die
deadwurde, wird nicht automatisch wiederholt. Um sie zu wiederholen, verwendemy job retry.
5. Bis zur Export-Frist
Abschnitt betitelt „5. Bis zur Export-Frist“Auch nach Abschluss der Zustellung läuft der Server geschlossen bis export_until weiter und bedient weiter die Exporte der Nutzer.
Der Server löscht nie von selbst Daten, er läuft also über die Frist hinaus weiter, bis du ihn stoppst.
Wenn du die Datensätze unter Aufbewahrungssperren (§3) noch nicht exportiert hast, tu es jetzt.
6. Auf die statische Seite umschalten
Abschnitt betitelt „6. Auf die statische Seite umschalten“Exportiere nach Ablauf der Export-Frist die Abschlussseite. Das liest die Datenbank, führe es also aus, bevor du my serve anhältst und die Datenbank verwirfst.
my admin closure export-html -out ./closure # all locales; index.html starts from the instance's default localemy admin closure export-html -out ./closure -lang ja,en # set the locales and the order in index.html- Was er schreibt:
<dir>/<locale>.htmlund<dir>/index.html, die alle Sprachen der Reihe nach auflistet. Sie verwenden dieselbe Vorlage und dasselbe CSS wie die Wartungsseite (my maintenance export) und zeigen den Servernamen (maintenance_server_name, sonst den Instanznamen, sonst den Hostnamen), das Schließdatum, die Nachricht des Betreibers aus der Ankündigung und einen Link zur Statusseite (status_page_url). Das CSS ist nur inline, es gibt keine Skripte oder externen Ressourcen, und die CSP steht in einem<meta>-Tag. Die Farbüberschreibungen des veröffentlichten Designs sind eingebaut.- Konfigurationsbeispiele für das Frontend:
nginx.conf,Caddyfileundcloudfront-function.js. Jedes liefert410ohne Body für die Föderations- und Discovery-Pfade (/ap/*,/inbox,/.well-known/webfinger,/.well-known/host-meta,/.well-known/host-meta.json,/.well-known/nodeinfo,/nodeinfo/*) und für Profile (/@*), und für jeden anderen Pfad die Seite der ersten Sprache inAccept-Language(oderindex.html, wenn es keine gibt). Eine Sprache erreicht die Seite der Locale, in der die App sie anzeigen würde:zh,zh-SGundzh-Hanserhaltenzh-CN.html, undzh-Hant,zh-HKundzh-MOerhaltenzh-TW.html.
- Der Befehl verweigert, wenn der Server nicht geschlossen ist (Exit-Code 1). Vor
delivery_completedwarnt er, dass Zustellungen weiterlaufen (und schreibt die Dateien trotzdem).
Schalte das Frontend um. Lege nur die Seiten (*.html) an den öffentlichen Ort und passe Hostname, Verzeichnis und Zertifikatspfade im Beispiel an deine Umgebung an.
| Frontend | So richtest du es ein |
|---|---|
| nginx | Lege die Seiten in /srv/closure und binde nginx.conf aus dem http-Block ein. Die Seiten werden ebenfalls mit 410 ausgeliefert |
| Caddy | Lege die Seiten in /srv/closure und verwende das Caddyfile. Caddy besorgt das Zertifikat, und die Seiten werden ebenfalls mit 410 ausgeliefert |
| CloudFront | Lege die Seiten direkt unter einen S3-Bucket, mache diesen Bucket zum Origin des Standard-Cache-Behaviors und verknüpfe cloudfront-function.js als CloudFront Function für Viewer-Requests (cloudfront-js-2.0). Nimm Accept-Language in den Cache-Key der Cache-Policy auf. Die Seiten werden mit 200 ausgeliefert (eine Viewer-Request-Funktion kann den Status der Antwort des Origins nicht ändern) |
Prüfe nach dem Umschalten, dass curl -i https://social.example/.well-known/webfinger?resource=acct:alice@social.example 410 zurückgibt und
dass curl -i https://social.example/ die Abschlussseite liefert. Halte dann my serve und die Worker an.
Beende für die Verfügbarkeitsüberwachung entweder die Health-Check-Monitore oder richte sie auf die Abschlussseite.
7. DB, Blobs und Backups verwerfen
Abschnitt betitelt „7. DB, Blobs und Backups verwerfen“Verwirf nach dem Stoppen die DB, die Blobs (Medien und Exportdateien), den KV-Store und die Queues samt ihren Backups und Snapshots. Mit einer Suchmaschine verwirfst du auch deren Index und Snapshots: Sie enthalten den Text von Beiträgen. Bestätige, bevor du irgendetwas verwirfst, noch einmal, dass du die Datensätze unter Aufbewahrungssperren exportiert und aufbewahrt hast. Das Verwerfen lässt sich nicht rückgängig machen.
Behalte die Domain und liefere die statische Seite und 410 noch etwa ein Jahr weiter aus. Andere Server sehen das 410, hören auf abzurufen und zuzustellen und leeren ihre Caches.
Föderierte URIs verwenden UUIDs, es besteht also wenig Risiko, dass ein Actor mit derselben id erneut erstellt wird,
aber wenn jemand anderes die Domain übernimmt, gehören das Handle (acct:alice@social.example) und die Profil-URLs ihm und können dazu dienen, deine Nutzer zu imitieren.
Verlängere die Domain und das Zertifikat weiter, und überlege es dir noch einmal, bevor du die Domain aufgibst, auch nach Ablauf des Jahres.
Für LLMs und Coding-Agenten:llms.txt,llms-full.txt, llms-small.txt