本页由英文页面机器翻译而来。内容以英文页面为准。 阅读英文页面
联邦中继
中继是一种服务器,它把加入它的各个服务器的公开帖子转交给其他加入的服务器。即使是关注不多的小实例,联邦时间线和话题标签时间线也能有内容,自己的公开帖子也能传得更远。不加入中继的实例不会因此增加任何数据行或任务。
使用管理区域中的“中继”(/admin/relays)。它需要权限 manage_settings,内置角色 admin 拥有该权限。“加入中继”会打开登记中继的表单。列表显示每个中继的状态,以及它在最近 24 小时内带来的内容;选择一个中继会打开它的页面,显示它的地址和退出它的按钮;中继已被退出或已拒绝本服务器后,则显示重新加入它和删除它的按钮。退出和删除都会先要求确认。对应的 CLI 是 my admin relay(my admin relay -help):
my admin relay list # every relay, its state, and what it brought in during the last 24 hoursmy admin relay create [-protocol mastodon|litepub] [-send-only] <url> # register a relay and send it the Followmy admin relay unfollow <relay id> # leave a pending or joined relaymy admin relay follow <relay id> # join again a relay that the instance left or that rejected itmy admin relay delete <relay id> # delete a relay that the instance left or that rejected it- 登记中继的 URL。有两种协议:
- Mastodon:中继的 inbox URL(例如
https://relay.example/inbox)。包括 pub-relay 和 Activity-Relay 在内的许多中继都接受这种方式。 - LitePub:中继的 actor URL(例如
https://relay.example/relay)。这是 Pleroma 和 Akkoma 中继使用的协议。如果不选择协议(“自动检测”),当该 URL 提供 actor 文档时,服务器使用 LitePub,否则使用 Mastodon。
- Mastodon:中继的 inbox URL(例如
- 登记之后,实例 actor 会向中继发送
Follow,状态为“等待中继回应”(pending)。中继接受后,状态变为“已加入”(accepted);中继拒绝时,状态变为“已被中继拒绝”(rejected)。有些中继由运营者逐一手动批准请求,因此需要一段时间。 - 如果登记时关闭“接收来自中继的帖子”,服务器只发送而不接收。要更改这一点,需要退出该中继后重新登记。
受到域名处置(suspend)的服务器,不能登记它的中继。如果已加入的中继所在的服务器后来被暂停,状态不会改变,但不再向该中继发送任何内容,也不再从它接收任何内容,管理区域会在该中继的状态中说明这一点。
服务器发送的内容
Section titled “服务器发送的内容”- 只发送本站公开(
public)帖子的创建、编辑和删除。设为unlisted、仅关注者、私信或邻里(local)的帖子,以及转发,都不会发送。要让某条帖子不进入中继,请将它发布为unlisted或local。没有按用户退出的选项。 - 公开帖子的文档带有 Linked Data Signature(
RsaSignature2017),因此 Mastodon 和 Misskey 能接受中继原样转交的帖子。 - 投递次数会增加“已加入的中继数 × 公开帖子数”(发往同一中继的投递会合并为一次)。
服务器会接收什么
Section titled “服务器会接收什么”- 已加入的中继所携带的公开帖子,会先从它的源处重新获取并检查,然后才被收录。之后它会显示在联邦时间线和话题标签时间线中,以及关注了其中某个话题标签的人的主页时间线中。它不会显示在任何其他主页时间线中,也不会产生通知。
- 每个中继每小时最多收录
relay_max_activities_per_hour条帖子(默认 1,000)。超出限制的内容会被直接丢弃,不会被获取。管理区域中该中继的页面和my admin relay list会显示最近 24 小时收录了多少条,以及因超出限制而丢弃了多少条。如果丢弃了很多,请提高限制,或者重新考虑这个中继。 - 当帖子的域名或账号被设为
suspend(联邦限制)或limit(使其从公开位置移除的限制)时,该帖子不会被收录。 - 仅通过中继到达的帖子,会在实例设置
relay_status_retention_days(默认 7)之后从公开视图中移除。本站用户回复、转发、喜欢或加了书签的帖子,以及本站用户所关注作者的帖子,与其他远程帖子的保留时间相同(remote_status_retention_days)。 - 每收录一条帖子,就要从源处获取一次(对于未知的作者,还要再获取一次 actor)。在每小时 1,000 条的限制下,每天最多获取 24,000 次。
这些设置在配置参考中。收录的结果也会作为指标 my.relay.activities 导出(请参阅运行服务器)。
退出、重新加入和删除
Section titled “退出、重新加入和删除”- “退出”会发送对
Follow的Undo,并将状态设为“已退出”(left)。此后不再向该中继发送任何内容,也不再从它接收任何内容。已经收录的帖子会在保留期结束时移除。 - “重新加入”会向拒绝了本服务器或本服务器已退出的中继发送新的
Follow。 - “删除”会移除已退出或被拒绝的中继的登记。删除之后,已经发送给该中继的帖子的编辑和删除仍会投递给它。
登记、加入、退出和删除,以及中继的接受或拒绝,都会记录在审计日志中,目标类型为“中继”(接受和拒绝记录为远程操作)。
供 LLM 和编程智能体使用:llms.txt,llms-full.txt, llms-small.txt