本页由英文页面机器翻译而来。内容以英文页面为准。 阅读英文页面
关闭服务
本文按顺序说明停止运营服务器时要做的事:先让用户把数据带走,再删除仍留在其他服务器上的账号,然后停止服务器,切换到静态的关闭页面。各条命令的详细说明见管理员与角色。在网页客户端中,拥有 manage_service_closure 的人可以在管理 > 服务关闭中完成同样的操作:宣布关闭、更改关闭日期或撤回;关闭日期过后,检查并关闭会显示 check 所显示的内容,并在你输入服务器域名后关闭服务器;此后它会显示 status 所显示的投递进度。
下表按图中从上到下的顺序排列;“服务器”一列以 my admin closure status 显示的状态开头。关闭日期(-closes-at)结束预告期,导出截止日期(-export-until,未设置时为关闭日期后 30 天)结束第 5 阶段。
| 阶段 | 服务器 | 运营者要做的事 |
|---|---|---|
| 1. 公告 | announced。照常运行。停止注册、邀请和新的支持者订阅 |
my admin closure announce,在状态页面上发布通知 |
| 2. 预告期 | announced。照常运行。用户可以导出数据并迁移到其他服务器 |
给年付支持者退款,检查迁移和保留义务冻结 |
| 3. 关闭(关闭日期之后) | closed。用户只能登录和导出。服务器为每个账号投递 Delete |
my admin closure check 和 close |
| 4. 投递完成 | 记录 delivery_completed;本站 Actor 也返回 410 |
用 my admin closure status 确认。不要停止 worker |
| 5. 导出截止日期之前 | delivery_completed。保持关闭状态,继续提供导出 |
导出保留义务冻结所涉及的记录 |
| 6. 静态页面 | 已停止。前端提供静态页面,对联邦请求返回 410 |
my admin closure export-html,切换前端,停止 my serve |
| 7. 销毁 | 无。继续提供静态页面和 410 约一年 |
销毁数据库、blob 和备份。保留域名约一年 |
任何阶段都可以与维护模式(维护)结合使用。维护期间,导出和 Delete 活动的投递会停止。
确定关闭日期(-closes-at)和带走数据的截止日期(-export-until,省略时为关闭日期后 30 天),然后发布公告。
my admin closure announce -closes-at 2027-01-31T15:00:00Z -message "Thank you for being here."my admin closure status- 关闭日期没有下限,但从公告到关闭日期不足 30 天时会显示警告。请给用户留出导出和迁移的时间。
- 要更改日期,再次运行
announce;要取消,运行my admin closure withdraw。两者都会向每位用户发送service_closure通知。 - 一旦发布公告,实际生效的注册模式变为
closed,待处理的申请会被拒绝,所有持续中的支持者订阅都会在当期结束时取消(订阅者会收到通知和邮件)。撤回公告不会撤销这些拒绝和取消。 - 通知由任务创建,所以不要停止 worker。
- 在状态页面(监控与状态页面)上发布关闭日期、导出截止日期,以及导出和迁移的方法。状态页面比服务器存在得更久,所以也能为关闭后来访的人提供指引。
2. 预告期
Section titled “2. 预告期”- 用户可以在设置界面导出数据(数据导出和 CSV 文件),并迁移到其他服务器(
Move)。每个界面上的横幅和一条通知会显示关闭日期、导出截止日期以及前往该界面的方法。 - 年付支持者:公告会在当期结束时取消订阅,但对于当期在关闭日期之后才结束的订阅,无法使用的那段时间已经付过费了。服务器不会退款,所以请在支付服务商的界面中逐一给订阅者退款(Stripe 在控制台的付款界面,PAY.JP 在管理控制台的付款界面)(支持者付款(Stripe)、支持者付款(PAY.JP))。
- 关闭日期过后,拥有
manage_service_closure的人会收到admin_service_closure_due通知。服务器不会自行关闭。
关闭日期过后,先运行检查,再关闭。
my admin closure check-
未完成的迁移会产生警告。请等它们完成后再关闭,因为关闭后任何人都无法发起
Move。 -
任何账号上存在保留义务冻结(
retention_holds)都会产生警告。冻结背后的义务不会因为关闭服务器而结束,所以请导出冻结所涉及的记录并保存在服务器之外(用my admin retention list列出冻结)。终端窗口 my admin account export-moderation @alice > alice-moderation.json
检查完成后执行关闭。此操作无法撤销。输入 y 和域名进行确认(自动化时使用 -confirm-domain)。
my admin closure close关闭后,用户只能登录和导出数据。剩余的支持者订阅会立即取消,并且会向其他服务器投递每个本站账号的 Delete(Actor)(即使 federation_mode 为 off 或 inbound 也是如此)。收件箱以及对帖子和集合的 GET 请求返回 410 Gone。
4. 确认投递完成
Section titled “4. 确认投递完成”在状态变为 delivery_completed 之前,不要停止 my serve 和 worker(role 为 all 或 worker 的进程;使用推送式队列时为 Cloud Tasks 队列)。
worker 负责投递 Delete 活动,在此期间服务器会继续返回本站 Actor 的文档和密钥,以便接收方验证 Delete 的签名。如果过早停止,这些账号就会留在其他服务器上。
my admin closure statusaccounts with a Delete是已记录Delete的账号数,fan-outs pending是剩余的扇出工作,deliveries <state>是各状态的投递数。- 投递按常规策略重试(约 4 天内最多 9 次)。全部结束后,每 10 分钟运行一次的检查会记录
delivery_completed(state: delivery_completed)。此后本站 Actor 和实例 Actor 也会返回410。 - 变为
dead的投递不会自动重试。要重试,请使用my job retry。
5. 导出截止日期之前
Section titled “5. 导出截止日期之前”即使投递已经完成,服务器也会以关闭状态继续运行到 export_until,并继续为用户提供导出。服务器从不自行删除数据,所以过了截止日期也会一直运行,直到你停止它。如果你还没有导出保留义务冻结所涉及的记录(§3),现在就导出。
6. 切换到静态页面
Section titled “6. 切换到静态页面”导出截止日期过后,导出关闭页面。这一步会读取数据库,因此请在停止 my serve 并丢弃数据库之前运行它。
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- 它会写出:
<dir>/<locale>.html和<dir>/index.html,后者按顺序列出所有语言。它们使用与维护页面(my maintenance export)相同的模板和 CSS,并显示服务器名称(maintenance_server_name,否则是实例名称,再否则是主机名)、关闭日期、公告中运营者的消息,以及指向状态页面的链接(status_page_url)。CSS 仅为内联,没有脚本或外部资源,CSP 位于一个<meta>标签中。已发布主题的颜色覆盖会被一并写入。- 前端配置示例
nginx.conf、Caddyfile和cloudfront-function.js。对于联邦和发现路径(/ap/*、/inbox、/.well-known/webfinger、/.well-known/host-meta、/.well-known/host-meta.json、/.well-known/nodeinfo、/nodeinfo/*)以及个人资料(/@*),它们各自返回不带正文的410;对于其他每个路径,则返回Accept-Language中第一种语言的页面(如果没有,则返回index.html)。某种语言会到达应用会为它显示的语言环境的页面:zh、zh-SG和zh-Hans得到zh-CN.html,而zh-Hant、zh-HK和zh-MO得到zh-TW.html。
- 如果服务器尚未关闭,该命令会拒绝执行(退出码 1)。在
delivery_completed之前,它会警告投递仍在继续(并且仍会写出这些文件)。
切换前端。只把页面(*.html)放在公开位置,并根据你的环境调整示例中的主机名、目录和证书路径。
| 前端 | 如何设置 |
|---|---|
| nginx | 把页面放在 /srv/closure,并从 http 块中引入 nginx.conf。这些页面也以 410 提供 |
| Caddy | 把页面放在 /srv/closure,并使用 Caddyfile。Caddy 会获取证书,这些页面也以 410 提供 |
| CloudFront | 把页面直接放在 S3 存储桶下,让该存储桶成为默认缓存行为的源,并把 cloudfront-function.js 关联为查看者请求(viewer-request)CloudFront Function(cloudfront-js-2.0)。把 Accept-Language 放入缓存策略的缓存键中。这些页面以 200 提供(查看者请求函数无法更改源响应的状态) |
切换之后,请检查 curl -i https://social.example/.well-known/webfinger?resource=acct:alice@social.example 是否返回 410,以及 curl -i https://social.example/ 是否返回关闭页面。然后停止 my serve 和各个 worker。对于可用性监控,请停止健康检查监控,或者让它们指向关闭页面。
7. 销毁数据库、blob 和备份
Section titled “7. 销毁数据库、blob 和备份”停止后,销毁数据库、blob(媒体和导出文件)、KV 存储和队列,以及它们的备份和快照。如果使用了搜索引擎,也要销毁它的索引和快照:其中保存着帖子的文本。在销毁任何东西之前,请再次确认你已经导出并保存了保留义务冻结所涉及的记录。销毁无法撤销。
保留域名,并继续提供静态页面和 410 约一年。 其他服务器看到 410 后会停止获取和投递,并清除缓存。联邦 URI 使用 UUID,所以再次创建出相同 id 的 Actor 的风险很小,但如果别人取得了这个域名,账号的用户名(acct:alice@social.example)和个人资料 URL 就归对方所有,可能被用来冒充你的用户。请持续续订域名和证书,即使一年过后,在放弃域名之前也请再三考虑。
供 LLM 和编程智能体使用:llms.txt,llms-full.txt, llms-small.txt