Esta página é uma tradução automática da página em inglês, que é a versão de referência. Ler a página em inglês
Relays de federação
Um relay é um servidor que repassa as publicações públicas dos servidores que entram nele para os demais servidores participantes. Até uma instância pequena, com poucos seguidos, passa a ter uma linha do tempo federada e linhas do tempo de hashtags cheias, e as publicações públicas dela chegam mais longe. Uma instância que não entra em nenhum relay não ganha linhas nem jobs.
Entrar em um relay
Seção intitulada “Entrar em um relay”Use “Relays” na área de administração (/admin/relays). Ele exige a permissão manage_settings, que o papel admin embutido tem.
“Entrar em um relay” abre o formulário que registra um. A lista mostra o estado de cada relay e o que ele trouxe nas últimas 24
horas; escolher um relay abre a página dele, com os endereços e o botão que sai dele ou, depois que o servidor saiu ou ele rejeitou
o servidor, os botões que entram de novo e o excluem. Sair e excluir pedem confirmação antes.
A 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- Registre a URL do relay. Há dois protocolos:
- Mastodon: a URL da caixa de entrada (inbox) do relay (como
https://relay.example/inbox). Muitos relays, incluindo o pub-relay e o Activity-Relay, a aceitam. - LitePub: a URL do ator (actor) do relay (como
https://relay.example/relay). Esse é o protocolo dos relays do Pleroma e do Akkoma. Se você não escolher um protocolo (“Detectar automaticamente”), o servidor usa LitePub quando a URL serve um documento de ator, e Mastodon caso contrário.
- Mastodon: a URL da caixa de entrada (inbox) do relay (como
- Depois de você registrá-lo, o ator da instância envia ao relay um
Follow, e o estado é “Aguardando a resposta do relay” (pending). Quando o relay aceita, o estado passa a “Participando” (accepted); quando ele recusa, “Rejeitado pelo relay” (rejected). Alguns relays demoram porque um operador aprova cada pedido manualmente. - Se você desativar “Receber publicações do relay” ao registrar, o servidor apenas envia. Para mudar isso, saia do relay e registre-o de novo.
Você não pode registrar o relay de um servidor sob uma ação de domínio (suspend). Se o servidor de um relay em que você participa for suspenso depois, o estado não muda,
mas nada é enviado a esse relay nem recebido dele, e a área de administração informa isso no estado do relay.
O que o servidor envia
Seção intitulada “O que o servidor envia”- Apenas a criação, a edição e a exclusão de publicações locais públicas (
public) são enviadas. Publicaçõesunlisted, somente para seguidores, diretas ou para vizinhos (local), e impulsos, nunca são enviadas. Para manter uma publicação fora dos relays, publique-a comounlistedoulocal. Não há desativação por usuário. - Os documentos das publicações públicas trazem uma Linked Data Signature (
RsaSignature2017), para que o Mastodon e o Misskey possam aceitar publicações que um relay repassa sem alterações. - O número de entregas cresce com o número de relays em que você participa vezes o número de publicações públicas (as entregas a um relay são combinadas em uma).
O que o servidor recebe
Seção intitulada “O que o servidor recebe”- Uma publicação pública trazida por um relay do qual você participa é buscada de novo na origem e verificada antes de ser ingerida. Depois ela aparece na linha do tempo federada e nas linhas do tempo de hashtags, e nas linhas do tempo de início das pessoas que seguem uma de suas hashtags. Ela não aparece em nenhuma outra linha do tempo de início e não cria notificações.
- No máximo
relay_max_activities_per_hourpublicações por hora (padrão 1.000) são ingeridas por relay. O que passar do limite é descartado sem ser buscado. A página do relay na área de administração emy admin relay listmostram quantas foram ingeridas nas últimas 24 horas e quantas foram descartadas por passar do limite. Se muitas forem descartadas, aumente o limite ou reconsidere o relay. - Uma publicação não é ingerida quando seu domínio ou sua conta tem um
suspend(uma restrição de federação) ou umlimit(uma restrição que a retira dos espaços públicos). - Uma publicação que chegou somente por um relay sai da visualização pública depois da configuração da instância
relay_status_retention_days(padrão 7). Uma publicação que uma pessoa local respondeu, impulsionou, favoritou ou salvou, e as publicações de autores que uma pessoa local segue, recebem a mesma retenção das outras publicações remotas (remote_status_retention_days). - Ingerir custa uma busca na origem por publicação (mais uma busca do ator para um autor desconhecido). No limite de 1.000 por hora, isso dá no máximo 24.000 buscas por dia.
As configurações estão na referência de configuração. O resultado da ingestão também é exportado como a métrica my.relay.activities (veja Rodando o servidor).
Sair, entrar de novo e excluir
Seção intitulada “Sair, entrar de novo e excluir”- “Sair” envia um
UndodoFollowe define o estado como “Saiu” (left). Depois disso, nada é enviado nem recebido do relay. As publicações já ingeridas são removidas quando termina a retenção delas. - “Ingressar de novo” envia um novo
Followa um relay que recusou o servidor ou que o servidor deixou. - “Excluir” remove o registro de um relay que foi deixado ou que recusou o servidor. Edições e exclusões de publicações já enviadas ao relay continuam sendo entregues a ele mesmo depois que você o exclui.
Registrar, entrar, sair e excluir, bem como a aceitação ou a recusa do relay, ficam registrados no registro de auditoria com o tipo de alvo “Relay” (aceitação e recusa como ações remotas).
Para LLMs e agentes de programação:llms.txt,llms-full.txt, llms-small.txt