Pular para o conteúdo

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

A página em inglês mudou desde que estas seções foram traduzidas:

Configurações da instância

As configurações que definem como sua instância é operada: modo de cadastro, tamanho das publicações, idioma padrão, quem pode ver as timelines, o nome da instância, a descrição, os termos, as regras, o tema e os emojis personalizados.

Configuração Configurações da instância
O que é Como a implantação é montada: funções, adaptadores, endpoints, nomes de host, segredos Como a instância é operada: modo de cadastro, limite de tamanho das publicações, idioma padrão, quem pode ver as timelines, o nome da instância, a descrição e os termos
Onde fica Variáveis de ambiente MY_* e o arquivo de configuração (referência de configuração) O banco de dados. Cada alteração é mantida como uma revisão
Alteração Tem efeito quando o processo reinicia Tem efeito imediatamente com my instance set, as telas de administração do cliente web ou a API de cliente (telas de administração e a API de cliente)
Quando não definida O padrão do esquema (o servidor não inicia se a chave for obrigatória) O padrão definido no código
  • Nenhuma chave está nas duas. Nenhuma sobrescreve a outra. Você não pode fornecer uma configuração da instância por uma variável de ambiente ou pelo arquivo de configuração, e não pode armazenar um valor de configuração no banco de dados.
  • Um valor fixo por implantação e que muda a estrutura do processo é configuração; um valor que muda enquanto a instância está em execução é uma configuração da instância.
Chave Tipo Padrão Descrição
registration_mode open / approval / invite / closed approval O modo de cadastro (cadastro). Enquanto o encerramento do serviço está anunciado e depois que ele ocorre, e em um servidor de uma pessoa, o valor efetivo é closed. O valor armazenado não muda, e cancelar o anúncio ou desativar single_user o restaura. GET /instance e o NodeInfo mostram o valor efetivo
max_status_length inteiro 1-100000 500 O tamanho máximo de uma publicação, em caracteres
default_locale tag de idioma BCP 47 en O idioma padrão. É o idioma inicial da interface dos novos usuários e o recurso usado quando nenhum catálogo corresponde à preferência de um usuário
local_timeline_visibility off / signed_in / everyone everyone Quem pode ver a timeline local (GET /api/v1/timelines/local): ninguém, usuários que entraram ou todos. off responde 404 e signed_in responde 401 aos visitantes que não entraram; nos dois casos a navegação a oculta. A menos que o valor seja everyone, a página inicial não mostra publicações de exemplo. Em um servidor de uma pessoa ela é lida como off
federated_timeline_visibility off / signed_in / everyone signed_in Quem pode ver a timeline federada (GET /api/v1/timelines/federated). Os valores significam o mesmo que na timeline local, e ela também é lida como off em um servidor de uma pessoa
preview_image ID de mídia (vazio = não definido) vazio A imagem de prévia de link (og:image) para as páginas sem uma imagem própria, em “Pré-visualizações de links” em Configurações → Geral. Quando não definida, usa-se a miniatura, depois o logotipo e depois a imagem padrão incluída (prévias de link)
contact_account nome de usuário de uma conta local (vazio = não definido) vazio A conta para contatar os operadores. Veja contato e miniatura
contact_email endereço de e-mail (vazio = não definido) vazio O endereço de e-mail para contatar os operadores. Também é o Reply-To e a assinatura dos e-mails que o servidor envia
thumbnail ID de mídia (vazio = não definido) vazio Uma imagem que representa a instância (miniatura), nas páginas sobre e de entrada e, nas prévias de link, quando preview_image não está definida
remote_media_policy none / avatars / all none Se devem ser mantidas cópias da mídia remota. none: o proxy de mídia repassa cada requisição. avatars: avatares, cabeçalhos e emojis personalizados ficam em cache no armazenamento de blobs por remote_media_cache_ttl_seconds. all: toda a mídia remota fica. O tamanho total do cache é limitado pela configuração remote_media_cache_max_bytes
remote_media_cache_ttl_seconds inteiro 60-31536000 (segundos) 86400 Por quanto tempo a mídia remota buscada pode ser mantida. É também o Cache-Control: max-age das respostas do proxy de mídia, então CDNs e navegadores guardam em cache por esse tempo
remote_media_cache_max_bytes inteiro a partir de 1 (bytes) 1073741824 O limite de tamanho das cópias de mídia remota que o proxy de mídia mantém. A limpeza por hora exclui as cópias expiradas e depois as menos acessadas recentemente acima desse limite
authorized_fetch true / false false Authorized Fetch (modo seguro). Quando true, um GET do ActivityPub sem uma assinatura HTTP verificável é respondido com 401 para objetos e coleções, e com um documento mínimo que traz a chave para o actor de um usuário. O actor da instância sempre retorna seu documento completo, para que qualquer servidor possa buscar a chave e verificar uma assinatura
federation_mode off / inbound / outbound / both both A direção da federação. off: nenhuma federação. inbound: você segue e lê contas remotas, mas publicações locais, perfis e reações não são enviados, e seguidores de fora são recusados (Reject). outbound: você aceita seguidores de fora e entrega publicações locais, mas publicações e reações remotas não são recebidas. both: enviar e receber. Uma alteração tem efeito na hora e exige a permissão manage_settings
federation_scope open / allowlist open Com quais servidores este servidor federa. open: todos os servidores que nenhuma ação de domínio suspende. allowlist: somente os domínios da lista de permitidos e seus subdomínios; todos os outros servidores são tratados como suspensos, e os GETs de ActivityPub exigem uma assinatura de um servidor permitido, seja qual for o valor de authorized_fetch. Mudar para allowlist encerra de vez os seguimentos com os servidores que ele corta; veja federar somente com servidores permitidos. Uma alteração tem efeito na hora e exige a permissão manage_settings
dynamic_client_registration true / false true Registro dinâmico de clientes (RFC 7591). Enquanto true, POST /oauth/register aceita o registro de clientes públicos sem autenticação. Quando false, o endpoint recusa toda requisição com 403 (access_denied); os clientes já registrados continuam funcionando. Um job periódico exclui os clientes registrados dinamicamente que não são usados, seguindo a configuração dynamic_client_unredeemed_retention e dynamic_client_idle_retention. Uma alteração tem efeito na hora e exige manage_settings
domain_actions_visibility off / signed_in / everyone off Quem pode ver a lista de domínios sobre os quais houve ações (GET /api/v1/instance/domain_actions): ninguém, usuários que entraram ou todos (moderação)
domain_actions_rationale_visibility off / signed_in / everyone off Quem pode ver os comentários públicos dessa lista. Quem não pode ver a lista nunca os vê
appeal_window_days inteiro 20-365 (dias) 180 Quantos dias depois de uma ação a pessoa envolvida pode entrar com recurso (moderação). Alterá-lo também altera o prazo das ações já tomadas
session_origins_retention_days inteiro 90-3650 (dias) 180 Quantos dias depois de um login manter o endereço IP e o User-Agent do login (moderação)
registration_origins_retention_days inteiro 90-3650 (dias) 180 Quantos dias depois do cadastro manter o endereço IP do cadastro
reports_retention_days inteiro 180-3650 (dias) 365 Quantos dias depois da última resolução manter uma denúncia. Uma denúncia a que uma ação se refere é mantida pelo tempo da ação
moderation_actions_retention_days inteiro 180-3650 (dias) 365 Quantos dias depois do fim de uma ação (a revogação, a expiração ou a análise de um recurso, o que ocorrer por último) manter ações sobre contas e recursos
audit_log_retention_days inteiro 365-3650 (dias) 730 Quantos dias depois de registrada manter uma linha do registro de auditoria
remote_status_retention_days inteiro 1-3650 (dias) 90 Quantos dias uma publicação remota é mantida depois de publicada quando nada nesta instância se refere a ela (uma resposta local, impulso, favorito, item salvo, notificação ou uma conversa com uma publicação local)
remote_status_max_retention_days inteiro 0-3650 (dias) 0 O máximo de dias que qualquer publicação remota é mantida depois de publicada, mesmo quando esta instância se refere a ela. Respostas, impulsos, favoritos e itens salvos locais permanecem e a mostram como excluída. 0 não define limite
relay_status_retention_days inteiro 1-3650 (dias) 7 Quantos dias uma publicação remota trazida apenas por um relay é mantida, quando nada nesta instância se refere a ela e nenhuma conta local segue seu autor
oauth_client_rate_limits pares client_id=requests separados por vírgula vazio Limites para as requisições da API de cliente dos clientes OAuth, para conter um cliente que sobrecarrega o servidor: as requisições que todos os usuários dele juntos podem fazer em 5 minutos. Uma alteração leva até um minuto para ser aplicada
search_indexing allow / deny deny Se os mecanismos de busca podem indexar a instância. Mesmo com allow, apenas os perfis de contas indexable e as publicações public são indexados (mecanismos de busca e crawlers de IA)
ai_usage allow / deny_training / deny deny A declaração aos serviços de IA. deny_training recusa o treinamento; deny recusa o treinamento e o uso por IA (busca por IA, assistentes, agentes)
indexable_default true / false false O padrão de indexable para contas novas. Alterá-lo não muda as contas existentes
auto_delete_default_enabled true / false false Se as contas novas começam com a exclusão automática de suas publicações antigas ativada. Junto com as outras chaves auto_delete_default_*, é a política que uma conta nova recebe (exclusão automática de publicações antigas)
auto_delete_default_min_age_days inteiro 1-3650 (dias) 30 Quantos dias depois de publicada a política de uma conta nova exclui uma publicação
auto_delete_default_keep_pinned, auto_delete_default_keep_bookmarked, auto_delete_default_keep_favourited true / false true Se a política de uma conta nova mantém as publicações que o autor fixou, salvou ou favoritou
auto_delete_default_keep_media, auto_delete_default_keep_polls true / false false Se a política de uma conta nova mantém as publicações com mídia ou enquete
auto_delete_default_keep_articles true / false true Se a política de uma conta nova mantém artigos
auto_delete_default_keep_public, auto_delete_default_keep_local, auto_delete_default_keep_unlisted, auto_delete_default_keep_private true / false false Se a política de uma conta nova mantém as publicações dessa visibilidade
auto_delete_default_keep_direct true / false true Se a política de uma conta nova mantém as publicações diretas
auto_delete_default_keep_min_boosts, auto_delete_default_keep_min_favourites inteiro 0-1000000 0 A política de uma conta nova mantém uma publicação impulsionada ou favoritada pelo menos essa quantidade de vezes. 0 não define limite mínimo
auto_delete_max_age_days inteiro 0-3650 (dias) 0 O máximo de dias depois de publicada que qualquer publicação local é mantida (máximo). 0 não define máximo
auto_delete_max_allow_pinned true / false true Se as publicações fixadas ainda podem ser mantidas sob o máximo
auto_delete_max_kept_pins inteiro 1-5 5 Quantas fixações mantêm publicações sob o máximo, começando pela fixada mais recentemente. 5, o máximo de fixações de uma conta, mantém todas as publicações fixadas
auto_delete_max_allow_bookmarked, auto_delete_max_allow_favourited, auto_delete_max_allow_media, auto_delete_max_allow_polls true / false false Se as publicações que o autor salvou ou favoritou, ou que têm mídia ou enquete, ainda podem ser mantidas sob o máximo
auto_delete_max_allow_articles true / false true Se os artigos ainda podem ser mantidos sob o máximo
auto_delete_max_allow_visibilities true / false false Se as publicações ainda podem ser mantidas por sua visibilidade sob o máximo
auto_delete_max_allow_thresholds true / false false Se as publicações ainda podem ser mantidas por seus impulsos e favoritos sob o máximo
auto_delete_grace_days inteiro 0-365 (dias) 30 Quantos dias uma conta a que o máximo passa a se aplicar mantém suas próprias configurações depois de ser avisada. Uma alteração não move as datas das contas já avisadas
search_visibilities public / local / public,local public Quais publicações a busca de texto completo de um servidor com backend de busca abrange. As publicações unlisted, private e direct nunca são abrangidas, e apenas as contas com indexable são. Deixar uma visibilidade de fora remove suas publicações do índice. Adicionar uma encontra apenas as publicações novas dela, até você reconstruir o índice. Não faz nada com search = none
security_contact URI https: ou mailto: (vazio = não definido) vazio Onde relatar problemas de segurança deste servidor: como ele é configurado e operado, e suas contas e dados. Quando definido, o servidor serve /.well-known/security.txt (RFC 9116). Este é o seu contato, não o do software: encaminhe um relato de vulnerabilidade no próprio software ao projeto como descreve sua política de segurança
require_media_description true / false false Se todo arquivo de mídia (imagem, vídeo ou áudio) anexado a uma publicação local precisa de uma descrição. Quando true, uma publicação ou edição com um arquivo cuja descrição está ausente ou só tem espaços é rejeitada com 422. Ela é publicada como limits.require_media_description em GET /api/v1/instance, e o cliente web torna o campo de descrição obrigatório. É separada da configuração por usuário require_media_description, que só verifica antes de enviar
link_cards true / false true Se devem ser exibidos cartões para os links nas publicações. Quando true, o servidor busca a página do link para montar um cartão. Quando false, ele para de buscar e também oculta os cartões já montados. Para parar apenas em alguns domínios, veja domínios de cartões de link
link_cards_ignore_robots_txt true / false false Se as buscas de cartões de link ignoram o robots.txt. Quando false, o servidor obedece ao robots.txt dos sites linkados, então um site que proíbe my-linkcard ou * não recebe cartão (prévias de link). /about/crawler informa aos sites linkados qual é ele. Quando true, o servidor não busca nem usa o robots.txt, e um site linkado não pode mais recusar essas buscas por ele; o servidor ainda se identifica como my-linkcard. Ative apenas quando faltarem cartões demais. Os cartões montados enquanto estava ativado são verificados na próxima nova busca depois que for desativado. As diretivas de uma página e os domínios de cartões de link valem nos dois casos
ux_measurement true / false false Se o cliente web envia amostras de quão rápido responde e este servidor as guarda (medições de UX). As amostras não levam conta, endereço nem URL. Com false, o servidor não coleta nenhuma, e ux_measurement em GET /api/v1/instance diz ao cliente para não enviá-las
ux_measurement_share inteiro 1-100 (porcentagem) 10 A parcela das sessões de navegador cujo cliente web envia amostras enquanto ux_measurement é true. Cada sessão é sorteada uma vez, quando o cliente web inicia; um servidor pequeno pode medir todas as sessões com 100
oauth_metadata_document_clients true / false true Se devem ser aceitos clientes com Client ID Metadata Document. Quando true, para uma requisição de autorização cujo client_id é uma URL https, o servidor busca os metadados nessa URL e os trata como o cliente (sem registro prévio). A busca não segue redirecionamentos, lê no máximo 5 KB e reutiliza a resposta por no máximo 24 horas, seguindo suas diretivas de cache. Quando false, ele para de buscar e recusa requisições de autorização, trocas de token e renovações desses clientes
finance_visibility private / totals / breakdown private Quanto dos custos de operação (registrados em /admin/finance/costs e definidos em /admin/finance/publication) publicar. private: nada é publicado (GET /api/v1/instance/cost_totals é 404). totals: apenas o total por período e moeda. breakdown: os totais e uma divisão por provedor e categoria, mostrados a todos nas páginas de informação (/about e /about/costs) e na API. breakdown revela em qual provedor (por exemplo, qual nuvem) você opera. Em todos os níveis, os nomes dos itens, as anotações e os pagamentos individuais permanecem privados. Os períodos até o que contém hoje (UTC), inclusive, são publicados
finance_viewer_item_names true / false false Se os usuários com a permissão view_finance veem os nomes dos itens de custo e os nomes dos serviços dos custos importados na tela de finanças (/finance, GET /api/v1/finance/cost_totals). Os totais e a divisão por provedor e categoria sempre são mostrados, qualquer que seja esta configuração
finance_viewer_item_memos true / false false Se os usuários com view_finance veem as anotações dos itens de custo na tela de finanças. Se a configuração de nome ou a de anotação for true, cada período mostra linhas de itens (provedor, categoria e o valor desse período, mais o nome e a anotação quando habilitados). Quem tem manage_finance vê tudo, independentemente
finance_viewer_income totals / plans totals Se os usuários com view_finance veem apenas os totais de receita (totals) ou também o número de assinantes por plano (plans). O valor por plano e quem pagou nunca são mostrados. Se income_visibility for plans, as contagens publicadas são mostradas qualquer que seja este valor. A receita é lida na tela de finanças do cliente web (/finance) e em GET /api/v1/finance/income_totals
income_visibility private / totals / plans private Quanto da receita dos apoiadores (o valor depois das taxas do provedor de pagamento) publicar. É escolhida separadamente de finance_visibility. private: nada é publicado (GET /api/v1/instance/income_totals é 404). totals: apenas o total de receita por período e moeda. plans: também o número atual de assinantes por plano, mostrado a todos. Em um plano com poucos assinantes, a contagem pode permitir adivinhar quem assina. O saldo (receita menos custos) só é mostrado quando nem este valor nem finance_visibility é private; caso contrário, o saldo revelaria o lado que você ocultou. Em todos os níveis, os pagamentos individuais, os assinantes, o valor por plano e os valores brutos e taxas permanecem privados. Os períodos até o que contém hoje (UTC), inclusive, são publicados
funding_meter_visibility off / percent / amounts off O que o medidor de financiamento publica: até onde a receita deste mês (depois das taxas do provedor de pagamento) chega em direção à meta mensal, mostrada na página sobre, na lista de apoiadores (/about/supporters) e em GET /api/v1/instance (funding_meter). É definido junto com a meta em /admin/finance/publication, que oferece apenas as opções que as visibilidades atuais permitem e explica o motivo. off: nada. percent: somente a porcentagem, arredondada para baixo a 1%, se o mês está coberto e se os custos estimados estão na meta. Só pode ser escolhido enquanto finance_visibility e income_visibility são ambos private. amounts: também a receita e a meta. Só pode ser escolhido enquanto nenhum dos dois é private. Enquanto apenas um deles é publicado, o medidor não pode ser mostrado: os valores publicados e a porcentagem revelariam o lado oculto. Mudar qualquer uma das visibilidades de modo que o valor escolhido deixe de ser permitido coloca o medidor em off, e essa mudança é registrada e auditada como qualquer outra. O mês é o mês de calendário que contém hoje (UTC), e só conta a receita na moeda da meta
funding_meter_target_amount decimal maior que zero, ou vazio vazio A meta mensal do medidor de financiamento, na unidade principal de funding_meter_target_currency (1650 ienes, 12.50 dólares), sem mais casas decimais do que a moeda tem. Vazio: a meta são os custos deste mês, o que exige que estejam em uma única moeda; em um mês cujos custos estão em várias moedas, ou são zero, o medidor não é mostrado
funding_meter_target_currency código ISO 4217, ou vazio vazio A moeda de funding_meter_target_amount, como JPY. Vazio: a moeda dos custos deste mês
funding_meter_rail true / false false Se o cliente web também mostra o medidor de financiamento na coluna da direita do layout largo, além da página sobre, enquanto funding_meter_visibility não é off
supporter_list_visibility off / signed_in / everyone off Quem pode ver a lista de apoiadores (GET /api/v1/instance/supporters e /about/supporters). off: ninguém (a API responde 404 e /about não tem link). signed_in: apenas quem entrou neste servidor (caso contrário, a API responde 401). everyone: todos. A lista mostra apenas as contas e os planos dos assinantes ativos que escolheram aparecer; valores, cobrança mensal ou anual, datas e contagens nunca são mostrados. A página da lista e a resposta da API são sempre noindex, noarchive, qualquer que seja search_indexing
user_app_registration true / false true Se os usuários que entraram podem registrar seus próprios apps OAuth (públicos ou confidenciais) na API de cliente (POST /api/v1/oauth_apps). Quando false, o registro responde 403. Listar, alterar e excluir apps registrados, reemitir segredos, emitir um token para si mesmo e a autorização por outros usuários continuam funcionando
voice_room_starters everyone / permitted permitted Quem pode abrir salas de chat de voz, enquanto a configuração voice não for off (configuração). everyone: todo usuário local que entrou e não está suspenso nem limitado. permitted: apenas quem tem a permissão start_voice_rooms, que por padrão só a função integrada admin tem e que uma função de um plano de apoiador pode ter
voice_public_summary true / false false Se a página de uma sala de chat de voz cuja visibilidade é local mostra seu nome, descrição, anfitrião e se ainda está aberta aos visitantes que não entraram neste servidor e aos usuários remotos, e em sua prévia de link. Os participantes nunca são mostrados. Quando false, esses visitantes veem apenas que a sala é para os usuários locais deste servidor
event_creators everyone / permitted everyone Quem pode criar eventos (eventos). everyone: todo usuário local com sessão iniciada que não está suspenso nem limitado. permitted: somente quem tem a permissão create_events, que por padrão apenas a função integrada admin tem e que uma função de um plano de apoiador pode ter
public_counts true / false true Se a página inicial (/, sem login) e GET /api/v1/instance/overview mostram quantos membros o servidor tem, quantas publicações públicas seus usuários fizeram em cada um dos últimos 7 dias e quando o servidor iniciou. Contam apenas as publicações públicas dos usuários deste servidor; os números são atualizados a cada poucos minutos. Quando false, a API os omite
landing_fediverse_explanation true / false true Se a página inicial (/, sem login) explica como o fediverso funciona: que uma conta aqui segue e é seguida por pessoas de outros servidores
landing_features true / false true Se a página inicial mostra o que o software faz neste servidor, com uma amostra de cada recurso que está ativado (salas de voz, eventos, artigos, busca, tradução, apoiadores)
featured_accounts nomes de usuário de até 20 contas locais, separados por espaços ou vírgulas (vazio = nenhuma) vazio As contas que as sugestões de pessoas para seguir mostram primeiro, nesta ordem, antes das pessoas deste servidor que publicaram recentemente. Uma conta cujo dono desativou “Sugerir minha conta e permitir encontrá-la por parte do nome” não é sugerida. Veja sugestões
login_providers_only true / false false Se o cadastro e a entrada ficam limitados aos provedores de login enquanto pelo menos um estiver habilitado: senhas e passkeys deixam de dar acesso, e usuários sem um provedor vinculado não conseguem entrar de novo depois que suas sessões terminarem. Sem nenhum provedor habilitado, não se aplica. my instance set mostra quantos usuários ativos não têm vínculo com um provedor habilitado. Veja limitar a entrada aos provedores de login.
invite_creators everyone / permitted permitted Quem pode criar convites próprios além da equipe com manage_invites (convites de membros). everyone: todo usuário local que entrou e não está suspenso nem limitado. permitted: apenas quem tem a permissão create_invites, que por padrão só a função integrada admin tem e que uma função de um plano de apoiador pode ter. No modo approval, um convite utilizável aprova o novo usuário na hora, então everyone permite que todo usuário pule a análise
member_invite_max_active inteiro 0-100 5 Quantos convites utilizáveis (não revogados, expirados nem esgotados) um membro pode manter ao mesmo tempo; 0 não permite que os membros criem nenhum. Os convites da equipe não contam
member_invite_max_uses inteiro 1-1000 10 Quantas pessoas podem se cadastrar com um convite criado por um membro
member_invite_max_lifetime_seconds inteiro 3600-31536000 (segundos) 2592000 (30 dias) Por quanto tempo, no máximo, um convite criado por um membro pode funcionar. Reduzi-lo não encurta os convites existentes
translation_providers IDs de provedores separados por vírgula vazio Os provedores de tradução no servidor que estão habilitados, o primeiro sendo o primeiro a ser tentado. Quando vazio, nada é enviado a nenhum provedor. Um ID para o qual este servidor não tem provedor não faz nada. Os provedores de tradução integrados têm os IDs libretranslate, deepl, google e aws, e um plugin tradutor o ID plugin
translation_provider_visibilities pares provider=visibility|visibility separados por vírgula vazio O que cada provedor pode receber. Um provedor não citado recebe publicações public, local e unlisted; provider= sem nada depois não recebe nenhuma. private e direct vão apenas a um provedor citado com elas, então permitir um provedor não permite o seguinte
translation_browser booleano false Se os leitores podem usar a tradução integrada ao navegador, que não envia nada a este servidor nem a um provedor. Com um provedor no servidor também habilitado, o provedor vem primeiro, e o navegador traduz o que o servidor recusa: uma publicação ou um idioma que nenhum provedor aceita, um limite mensal ou um provedor que falha
translation_user_monthly_characters inteiro 0-1000000000000 50000 Quantos caracteres as requisições de um usuário podem enviar a provedores de tradução em um mês UTC. Com 0, nada é enviado. Não há valor ilimitado: defina um número grande
translation_server_monthly_characters inteiro 0-1000000000000 500000 Quantos caracteres o servidor inteiro pode enviar a provedores de tradução em um mês UTC. Com 0, nada é enviado. Não há valor ilimitado: defina um número grande
translation_retention_days inteiro 1-3650 (dias) 30 Quantos dias uma tradução é mantida depois de feita. Lê-la não estende esse prazo, e ela vai embora com a publicação
translation_reports_to_server booleano false Se os moderadores podem enviar o texto de uma denúncia, as publicações denunciadas e o comentário de quem denunciou, aos provedores no servidor. Cada provedor ainda recebe apenas as visibilidades que translation_provider_visibilities permite a ele, seja quem for que peça: uma publicação direta denunciada vai apenas a um provedor autorizado para direct, e o comentário conta como private. A tradução do comentário nunca é mantida, nem a de uma publicação excluída, e os caracteres contam apenas para translation_server_monthly_characters. Quando false, nada de uma denúncia chega a um provedor
event_records_retention_days inteiro 30-3650 (dias) 90 Por quantos dias depois que um evento terminou ou foi cancelado manter quem o respondeu, quem foi aprovado, quem foi convidado e quem votou nas datas candidatas dele. Um evento cuja data nunca foi fixada termina com a última data candidata. O evento em si (suas configurações, lugares, data e datas candidatas, e o cancelamento) é mantido. Os registros de um evento denunciado são mantidos enquanto durar a denúncia, e as retenções valem como para os outros registros (retenção de registros)
voice_participants_retention_days inteiro 30-3650 (dias) 90 Quantos dias depois do fim de uma sala de chat de voz manter os registros de quem participou: as participações, os oradores e ouvintes, as mãos levantadas, os convites e as remoções. A sala em si (nome, descrição, anfitriões e como terminou) é mantida. Os registros de uma sala denunciada são mantidos pelo tempo da denúncia, e as retenções se aplicam como aos outros registros
hook_inbound_status_mode, hook_inbound_follow_mode, hook_signup_check_mode, hook_media_check_mode, hook_local_status_mode, hook_inbound_actor_mode, hook_local_profile_mode off, observe, enforce observe Até onde cada hook de decisão age enquanto tem um plugin. off só chega a enforce passando por observe.
hook_inbound_status_on_failure, hook_inbound_follow_on_failure, hook_media_check_on_failure, hook_inbound_actor_on_failure pass, retry pass O que o hook faz quando aplica a decisão e seu plugin falha (detalhes).
hook_inbound_status_unfollowed_direct booleano false Se inbound.status também envia as publicações diretas de autores que nenhuma conta local segue (detalhes). A página de informações (/about) informa isso enquanto o hook está em uso.
hook_signup_check_on_failure pass, require_approval pass O que signup.check faz quando aplica a decisão e seu plugin falha.
hook_signup_check_reject booleano false Se um reject de signup.check recusa o cadastro enquanto ele aplica a decisão. Quando desativado, a resposta é apenas registrada, como em observe.
hook_local_status_account_age_days inteiro 0-3650 (dias) 7 local.status analisa as publicações e suas edições de contas mais novas que isso; 0 analisa todas as contas. A página de informações (/about) informa isso enquanto o hook está em uso.
hook_local_profile_account_age_days inteiro 0-3650 (dias) 7 local.profile analisa as alterações de perfil de contas mais novas que isso; 0 analisa todas as contas. A página de informações (/about) informa isso enquanto o hook está em uso.
hook_decisions_retention_days inteiro 30-3650 (dias) 90 Quantos dias manter as decisões dos hooks.
single_user booleano false Se o servidor é um servidor de uma pessoa. Só pode ser ativado enquanto o servidor tem exatamente uma conta local, e pode ser desativado a qualquer momento
max_drafts inteiro 1-10000 100 Quantos rascunhos não agendados um usuário pode manter no servidor. Reduzi-lo não exclui nenhum rascunho: um usuário acima do limite não salva um novo
max_scheduled_posts inteiro 1-10000 300 Quantas publicações agendadas de um usuário podem aguardar. Reduzi-lo não cancela nenhum agendamento
max_scheduled_posts_per_day inteiro 1-10000 25 Quantas publicações agendadas de um usuário podem aguardar por um dia UTC
scheduled_post_min_lead_minutes inteiro 1-1440 (minutos) 5 Com quantos minutos de antecedência, no mínimo, uma publicação pode ser agendada
scheduled_post_max_lead_days inteiro 1-3660 (dias) 366 Com quantos dias de antecedência, no máximo, uma publicação pode ser agendada
article_authoring everyone / permission everyone Quem pode escrever novos artigos: todo usuário local, ou somente os usuários cujas funções têm a permissão create_articles
max_article_bytes inteiro 1000-100000 (bytes) 100000 O máximo de bytes do HTML que o corpo de um artigo gera
max_article_images inteiro 0-100 20 O máximo de imagens de envios do próprio autor no corpo de um artigo, além da capa
  • Os valores são normalizados antes de serem armazenados (TRUE vira true, 0750 vira 750, ja_jp vira ja-JP, os IDs de mídia são convertidos para minúsculas). Um valor inválido é rejeitado e nada é gravado.
  • preview_image e thumbnail aceitam apenas a mídia de uma imagem que existe (inclusive uma ainda em processamento). Até o processamento terminar, e no lugar de uma imagem cujo processamento falhou, preview_image recorre à imagem padrão. Depois que uma mídia foi definida em qualquer revisão, a limpeza de envios não anexados não a exclui.
  • contact_account aceita apenas o nome de usuário de um usuário local que não foi excluído (armazenado em minúsculas). contact_email aceita apenas um endereço na forma alice@example.com.
  • featured_accounts aceita apenas os nomes de usuário de usuários locais que não foram excluídos; um @ inicial é descartado, os nomes são convertidos para minúsculas, um nome repetido é mantido uma vez e eles são armazenados separados por espaços simples.

Os usuários que entraram veem sugestões de pessoas para seguir (na timeline inicial vazia depois do cadastro e com GET /api/v1/accounts/suggestions). As sugestões são as contas de featured_accounts na ordem delas, depois as contas deste servidor que publicaram uma publicação pública ou local nos últimos 30 dias, com a que publicou por último primeiro. A conta do próprio usuário, as contas que o usuário segue, bloqueia, silencia ou que o bloqueiam, e as contas suspensas ou desativadas ficam de fora.

As contas novas são sugeridas e podem ser encontradas por parte do nome na busca de contas. Um usuário que desativa “Sugerir minha conta e permitir encontrá-la por parte do nome” nas configurações do perfil sai das duas: a busca então encontra a conta apenas pelo nome de usuário completo, ou para as pessoas que a seguem.

Os usuários podem fazer suas próprias publicações serem excluídas automaticamente alguns dias depois de publicá-las (Configurações, “Excluir publicações antigas”). A política de cada usuário é só dele: se está ativada, depois de quantos dias e quais publicações ela mantém (publicações fixadas, salvas e favoritadas, publicações com mídia ou enquete, artigos, publicações de visibilidades escolhidas e publicações com pelo menos certa quantidade de impulsos ou favoritos). Excluir uma publicação dessa forma é o mesmo que o autor excluí-la: os servidores para onde ela foi recebem um Delete. Apenas as publicações de contas locais são excluídas dessa forma, nunca os impulsos.

As chaves auto_delete_default_* são a política com que cada nova conta local começa, seja qual for a forma como ela é criada (o formulário de cadastro, um provedor de login externo, um convite ou my admin). A conta a recebe quando é criada e depois passa a ser dona dela: alterar as chaves mais tarde não muda nem as contas que existem nem as que receberam um valor anterior. A tela de configurações mostra os valores como do próprio usuário. Com as chaves não definidas, uma conta nova começa com a exclusão automática desativada, após 30 dias, mantendo as publicações fixadas, salvas e favoritadas, os artigos e as publicações diretas. O padrão não é mostrado a quem está fora da instância. Quando um máximo está definido, uma conta nova recebe o padrão reduzido ao máximo, como descrito abaixo, de modo que começa dentro dele.

Com auto_delete_max_age_days acima de 0, nenhuma publicação local é mantida por mais do que essa quantidade de dias depois de publicada. Para toda conta local sem a permissão keep_posts_longer:

  • A exclusão automática está sempre ativada: o usuário não pode desativá-la nem escolher mais dias do que o máximo (menos é permitido). A tela de configurações e PUT /api/v1/preferences/auto_delete recusam as duas coisas.
  • Apenas as exceções que as chaves auto_delete_max_allow_* permitem mantêm publicações. Por padrão, apenas as publicações fixadas mantêm, todas elas; com auto_delete_max_kept_pins abaixo de 5, apenas essa quantidade das fixações mais recentes mantém suas publicações.
  • Os usuários que desativaram a exclusão automática, ou nunca a definiram, também ficam sujeitos ao máximo.

Ativar o máximo, reduzi-lo ou alterar as exceções não reescreve as configurações de ninguém. Em vez disso, a cada hora o job content.auto_delete_statuses encontra as contas cujas próprias configurações mantêm publicações que o máximo não mantém (porque o máximo foi ativado ou reduzido, ou a conta perdeu keep_posts_longer). Ele avisa cada uma delas uma vez, com uma notificação e um e-mail que vêm ativados por padrão, e informa a partir de quando o máximo se aplica: auto_delete_grace_days depois do aviso. Até lá, as configurações da própria conta continuam valendo; a partir de então, suas publicações seguem o máximo. Uma conta que volta a ficar dentro do máximo (seu usuário altera as configurações, ela recebe keep_posts_longer, ou o máximo some ou aumenta) deixa de ser sujeita a ele, e uma alteração posterior a avisa de novo com um novo prazo de carência.

Ativar o máximo avisa, dentro de uma hora, todas as contas que ele atinge. As exclusões mantêm seu ritmo: no máximo 100 publicações de uma conta por hora, cada uma enviada como um Delete aos servidores para onde a publicação foi, então uma conta com muitas publicações antigas leva horas ou dias para esvaziar. Um usuário que altera suas configurações nesse meio-tempo interrompe o restante.

keep_posts_longer é uma permissão de membro: dê-a a uma função para que quem a tem mantenha suas publicações pelo tempo que escolher e desative a exclusão automática. A função integrada admin a tem. Um plano de apoiador pode incluí-la, de modo que manter as publicações por mais tempo pode ser um benefício do plano; quando a assinatura termina, o máximo volta a se aplicar depois do período de carência.

O máximo é público: GET /api/v1/instance o retorna em auto_delete_limit, e a página sobre o exibe, para que as pessoas o conheçam antes de se cadastrar. Alterações dessas chaves exigem manage_settings e são registradas no registro de auditoria como qualquer outra configuração. No cliente web, elas ficam na página “Exclusão de publicações” de “Configurações do servidor”, que pergunta antes de salvar um máximo que está sendo ativado ou tornado mais rígido.

Os usuários salvam rascunhos de publicações no servidor, continuam a escrevê-los em outro dispositivo e os publicam na hora ou em um horário escolhido. Somente o autor lê um rascunho; os rascunhos nunca são federados, não estão na exportação dos dados de uma conta e somem com a conta quando ela é apagada. As cinco configurações max_drafts e scheduled_post_* acima os limitam; um salvamento ou agendamento além de um limite é recusado com uma mensagem que o nomeia.

  • Uma publicação agendada é publicada pelo job content.publish_scheduled_draft no horário dela ou logo depois, também quando o horário está mais distante que o limite de atraso do serviço de fila: o job volta e espera de novo. Defina-as com my instance set, por exemplo my instance set max_scheduled_posts 100.
  • A publicação é verificada quando é publicada, não apenas quando é agendada: um usuário que uma ação de moderação impede de publicar até lá, ou cuja publicação responde a uma publicação que sumiu ou a cita, não recebe publicação nenhuma. O rascunho permanece, e o usuário recebe uma notificação que diz o motivo (scheduled_status_failed, que os usuários podem desativar nas configurações de notificação e que nunca é enviada por e-mail). A análise automática das publicações locais, enquanto está em uso, analisa a publicação quando ela é publicada.
  • Uma publicação recebe a marca do horário em que é publicada, e a exclusão automática de publicações antigas conta a partir daí.
  • Os arquivos de mídia que um rascunho anexa são mantidos enquanto o rascunho existir; excluir o rascunho os deixa sem vínculo, e eles somem com a limpeza de envios sem vínculo. A capa do rascunho de um artigo e os envios que o corpo dele mostra são mantidos do mesmo modo.
  • Os rascunhos e as publicações agendadas incluem artigos, que são agendados e contados como publicações. O rascunho de um artigo pode ficar sem título enquanto o autor escreve; ele é verificado como um novo artigo quando é publicado, e um usuário que não pode mais escrever novos artigos até lá não recebe artigo nenhum.

Um artigo é uma publicação longa com título, resumo e imagem de capa, cujo corpo o autor escreve em Markdown. Os artigos são publicações em todos os outros aspectos: têm visibilidade, podem ser editados com o histórico mantido, impulsionados, favoritados, citados, respondidos, denunciados e excluídos, e a moderação age sobre eles como sobre as publicações. O servidor renderiza o corpo uma única vez, quando ele é escrito: o HTML bruto nele não é renderizado, e somente as imagens de envios do próprio autor aparecem como imagens; qualquer outra imagem se torna um link, para que os leitores nunca carreguem imagens de outros sites. As linhas do tempo, as notificações e a busca mostram o título, o resumo e a capa; o corpo aparece onde o artigo é aberto.

  • Por padrão, todo usuário local pode escrever artigos. Com article_authoring definido como permission, somente os usuários cujas funções têm a permissão create_articles podem escrever novos; os artigos já escritos permanecem, e os autores deles ainda podem editá-los. Uma ação de moderação que impede uma conta de publicar a impede também de escrever e editar artigos. Um plano de apoiador pode conceder create_articles como benefício.
  • max_article_bytes limita o HTML de um corpo, não o Markdown: os servidores que recebem artigos contam o HTML, e 100.000 bytes, o máximo que ele pode ter, é o que eles guardam por inteiro. Um corpo em japonês de cerca de 30.000 caracteres cabe. max_article_images limita as imagens em um corpo. O editor mostra os dois antes de o artigo ser publicado.
  • Um artigo nunca é uma publicação direta e não tem enquete, nem anexos além das suas imagens, nem aviso de conteúdo: um artigo sensível mostra o título e o resumo e recolhe o corpo e a capa.
  • A exclusão automática de publicações antigas mantém os artigos, a menos que o usuário desative isso (auto_delete_default_keep_articles para contas novas, auto_delete_max_allow_articles sob um máximo).
  • GET /api/v1/instance retorna os limites em limits.articles e a configuração de autoria em article_authoring. Defina-os com my instance set, por exemplo my instance set article_authoring permission.

Os usuários locais planejam eventos com uma data, um fuso horário e até três lugares: uma sala de chat de voz deste servidor, um lugar para encontro presencial e um link. Em vez de uma data, um organizador pode oferecer até 20 datas candidatas: os usuários que veem o evento respondem a cada uma com sim, talvez ou não, e o organizador ou um coorganizador então confirma uma, o que fixa a data. Até lá, ninguém responde se vai. Os eventos são apenas para os usuários deste servidor: eles nunca são federados, e usuários remotos e visitantes sem sessão iniciada não veem nenhum.

  • Quem pode criar um é event_creators. Um organizador também precisa poder abrir salas de chat de voz (voice_room_starters e a configuração voice) para realizar um evento em uma.
  • A sala de chat de voz de um evento abre no início dele, com o organizador como anfitrião, e espera até 30 minutos pelo primeiro participante. Ela recebe o título do evento e a visibilidade do evento (todo usuário local, seguidores, as pessoas que o organizador segue, seguimentos mútuos ou as pessoas convidadas). Os coorganizadores, quem respondeu que vai ou talvez vá e os convidados que ainda não responderam são convidados para a sala, para que continuem a vê-la quando um coanfitrião assume. A sala não cria publicação de início, e a notificação de início do evento é a única notificação dela.
  • Uma sala que não pode abrir (o chat de voz está desativado, o organizador não pode mais abrir salas ou está hospedando outra, ou já há tantas salas abertas quanto a configuração voice_max_open_rooms permite) deixa o evento como está: o organizador é notificado, e a página do evento diz que a sala não pôde abrir. O servidor verifica isso quando a data é definida ou alterada e também um dia antes do início, e notifica o organizador do que manteria a sala fechada. O organizador também é notificado quando ninguém foi à sala. Cancelar o evento, ou remover a sala de chat de voz dele, encerra a sala e mantém o evento.
  • O organizador escolhe quem vê o evento: todo usuário local, os seguidores do organizador, as pessoas que o organizador segue, seguimentos mútuos ou somente as pessoas convidadas. As pessoas convidadas e as que responderam a ele ou às datas candidatas sempre o veem, e um bloqueio entre um usuário e o organizador ou um coorganizador o oculta desse usuário.
  • O endereço e o link de um evento são mostrados apenas aos participantes que o organizador ou um coorganizador aprovou, a menos que o organizador os mostre a todos que veem o evento. Os links devem ser http ou https, e o servidor nunca os abre.
  • Um usuário que vê um evento pode salvá-lo como um arquivo iCalendar (.ics) para adicionar ao próprio calendário. O arquivo nomeia apenas os lugares que esse usuário vê, então um endereço mantido para os participantes aprovados nunca aparece nele. Não há endereço de assinatura de calendário.
  • Um usuário cria no máximo 10 eventos por hora, e um evento envia no máximo 100 convites por hora.
  • Os usuários podem denunciar um evento, e os moderadores podem cancelar um; suspender ou excluir um organizador cancela os eventos dele que não começaram (moderação). Quem respondeu e quem foi convidado é mantido por event_records_retention_days depois do evento, assim como os votos nas datas candidatas dele.
Chave Limite Descrição
name 100 caracteres, uma linha (apenas espaços em branco não é permitido) O nome da instância (nome de exibição). Veja nome e domínio
short_description 500 caracteres Uma descrição curta
description 20000 caracteres A descrição
terms 100000 caracteres Os termos de serviço (Markdown)
privacy_policy 100000 caracteres A política de privacidade (Markdown)
commerce_disclosure 100000 caracteres A divulgação do vendedor para planos pagos, como o aviso que a lei japonesa exige (Markdown; apoiadores)
preview_image_alt 1500 caracteres O texto alternativo da imagem preview_image (og:image:alt). Quando não definido, usa-se “Imagem de {nome da instância}”
thumbnail_alt 1500 caracteres O texto alternativo da imagem thumbnail
  • Cada texto tem um valor. Um administrador o escreve uma vez no idioma que quiser, e os leitores de todos os idiomas veem o mesmo valor; os leitores de outros idiomas recorrem à tradução automática ou algo parecido. Os rótulos e as descrições dos campos de administração são traduzidos para o idioma de quem os vê como qualquer outro texto de tela; apenas o valor que um administrador escreve não é.
  • O servidor não sabe o idioma de um texto, então o cliente web e as telas renderizadas pelo servidor exibem os textos com dir="auto" e lang="" (o valor HTML para um idioma desconhecido) em vez de herdar o idioma da tela.
  • Definir um texto vazio o exclui.
  • Além da CLI, os textos podem ser alterados nas telas de administração do cliente web (nome, descrição curta e descrição na página Geral de “Configurações do servidor”, /admin/settings/general; os termos em /admin/documents/terms, a política de privacidade em /admin/documents/privacy-policy e a divulgação comercial em /admin/documents/commerce-disclosure, cada uma uma página de “Termos e políticas”, /admin/documents) e com a API de cliente (GET /api/v1/admin/instance_texts, PUT /api/v1/admin/instance_texts/{key}). Ambos exigem a permissão de função manage_settings, e as alterações são registradas no registro de auditoria (text_changed).
  • Escreva terms, privacy_policy e commerce_disclosure em Markdown (CommonMark mais as tabelas, o tachado e os autolinks do GitHub Flavored Markdown). Uma quebra de linha dentro de um parágrafo continua sendo uma quebra de linha, e os títulos com # começam um nível abaixo do título da página (h2).
  • O servidor os converte em HTML e o higieniza (GET /api/v1/instance/documents/{kind} anônimo), e as páginas do cliente web /about/terms, /about/privacy e /about/commerce os exibem. HTML bruto, imagens e links que não sejam http, https e mailto são removidos. As páginas não exigem login (são páginas do cliente web, então exigem JavaScript). /about/commerce é a URL a fornecer ao provedor de pagamento.
  • Um documento que você escreve recebe um link na tela de cadastro, no rodapé de toda tela que o servidor renderiza e no cliente web (a terceira coluna, o menu, as configurações e a tela de entrada). Um documento que não foi escrito não recebe link, e sua API responde 404.
  • Enquanto os termos de serviço ou a política de privacidade estiver escrito, a tela de cadastro lista os documentos antes do botão de criar com uma caixa de seleção obrigatória, “Li e concordo com os documentos acima”. O servidor recusa um cadastro sem ela, inclusive um feito por um provedor de login. Sem nenhum dos dois documentos, a tela não pede concordância.

Uma instância tem um domínio e um nome, separadamente.

  • O domínio é a configuração host (e account_domain, o domínio dos handles). Ele não pode ser alterado enquanto a instância está em execução. Handles (@alice@example.com), URLs, IDs do ActivityPub e domain em GET /api/v1/instance continuam sendo o domínio mesmo quando há um nome.
  • O nome é o texto name. Ele aparece onde quer que a instância seja citada às pessoas: a barra lateral e “Sobre este servidor” do cliente web, o título da aba do navegador, as telas de entrada, cadastro, confirmação de e-mail, status da conta e consentimento de autorização renderizadas pelo servidor, os e-mails (confirmação do endereço de e-mail e notificações de moderadores), og:site_name das prévias de link, name / short_name do Web App Manifest, metadata.nodeName do NodeInfo e name em GET /api/v1/instance.
  • O nome é o mesmo em todos os idiomas. Quando não há nome, o domínio (host) é exibido no lugar.
  • Uma alteração tem efeito a partir da próxima requisição, sem reiniciar. O título da aba e a barra lateral de um cliente web aberto são atualizados quando você salva na tela de administração.

O contato para os operadores (contact_account, contact_email) e a imagem que representa a instância (thumbnail e o texto thumbnail_alt) aparecem nos lugares abaixo. O que não estiver definido não aparece.

  • “Sobre este servidor” do cliente web (/about). A miniatura e a conta de contato também aparecem na primeira tela (/) para as pessoas que não entraram.
  • contact (account e email) e thumbnail (url, width, height, alt) em GET /api/v1/instance.
  • metadata no NodeInfo: maintainer pela convenção do Misskey (name é o nome de exibição da conta de contato, ou seu nome de usuário quando ela não tem um; email é contact_email), staffAccounts pela convenção do Pleroma e do Akkoma (o ID do actor da conta de contato), thumbnail (url e alt) e nodeDescription a partir da descrição curta short_description.

Quando a conta de contato está suspensa ou excluída, a conta não é exibida e apenas o endereço de e-mail é. Altere-os na página Geral da tela de administração do cliente web (“Configurações do servidor”, /admin/settings/general), ou com a CLI ou a API de cliente.

Um servidor só do seu operador, o lar do próprio operador no fediverso, é um servidor de uma só pessoa: ative single_user. No cliente web, um administrador o ativa e desativa com Servidor de uma só pessoa na página Cadastro de Configurações do servidor, que diz por que o servidor recusou quando há mais de uma conta local.

Janela do terminal
my instance set single_user true
my instance set single_user false # back to a community server
  • Ele só pode ser ativado quando exatamente uma conta local conta. Toda conta local que não foi excluída conta, inclusive as que aguardam aprovação, desativadas, agendadas para exclusão, suspensas ou limitadas, já que cada uma poderia voltar como uma segunda pessoa. Uma conta cujo cadastro foi rejeitado não conta. Com qualquer outro número, my instance set falha com a contagem, e a API de administração responde 422 com o tipo /api/v1/problems/single-user-requires-one-account. O ator da instância do servidor não é uma conta e nunca conta.
  • Ele pode ser desativado a qualquer momento. Ativá-lo ou desativá-lo não exclui nada e não altera o valor guardado de nenhuma outra configuração: o que ele retém volta a valer como era assim que ele é desativado. Como toda configuração, a mudança vai para o log de auditoria.

Enquanto ele está ativado:

  • O cadastro está fechado. registration_mode é lido como closed, seja qual for o valor guardado, então a página de cadastro, o cadastro por um provedor de login e my admin create não criam nenhuma conta. Entrar com um provedor de login continua funcionando.
  • Apenas a linha do tempo inicial. local_timeline_visibility e federated_timeline_visibility são lidas como off. As linhas do tempo de hashtags e de listas continuam.
  • O que uma comunidade precisa fica oculto. As linhas do tempo local e federada e os fluxos delas, as sugestões de contas, os convites de usuários e de administradores, a análise de cadastros e os bloqueios de cadastro respondem 404 com o tipo /api/v1/problems/single-user-mode.
  • Sem novas publicações locais. Em um servidor de uma só pessoa, uma publicação para “Vizinhos” não alcança ninguém além dos seguidores, então uma nova publicação não pode ser local: a API do cliente responde 422 e a deixa de fora do que uma conta pode publicar. Uma visibilidade padrão “Vizinhos” é lida como “Somente seguidores” e não pode ser salva, e uma sala de chat de voz para as pessoas deste servidor se anuncia em uma publicação para os seguidores. As publicações que já são locais continuam locais.
  • O servidor diz o que é. single_user em GET /api/v1/instance é true, com o modo de cadastro e as linhas do tempo efetivos e a conta do operador como single_user_account, e o NodeInfo responde openRegistrations: false com metadata.singleUser: true.
  • A página inicial é o perfil do operador. Quem não está conectado e abre o endereço do servidor vê o perfil da única conta dele, com o caminho para entrar e links para a página sobre, os termos de serviço e a política de privacidade que o servidor publica. O cliente web oculta o que o servidor não oferece, da navegação, dos menus e das telas de administração: as linhas do tempo local e federada, o cadastro, as contas sugeridas, os convites, a análise de cadastros, os bloqueios de cadastro, a visibilidade “Vizinhos” e as configurações de cadastro, convites, linhas do tempo públicas, página inicial e contas sugeridas.

Federação, moderação, a busca de texto completo, o programa de apoiadores, os documentos e as telas de administração funcionam como em qualquer servidor.

Janela do terminal
my instance list # all settings (and whether each is the default) and texts
my instance get registration_mode
my instance set registration_mode open
my instance set name "Example Social" # the same name in every locale
my instance set description - < description.txt # the value "-" reads standard input
my instance get name
my instance set name "" # delete the name
my instance history registration_mode # revision history (newest first, -limit sets the count)
my instance history description
my instance set -owner admin preview_image ./preview.png # upload the image as media of admin and use it as the preview image
my instance set preview_image 0192f3a4-7b1c-7d2e-9f00-1a2b3c4d5e6f # give the ID of media that is already uploaded
my instance set preview_image_alt "A blue bird mascot"
my instance set preview_image "" # back to the bundled default image
my instance set contact_account admin # the contact account
my instance set contact_email admin@example.com
my instance set -owner admin thumbnail ./thumbnail.png # the thumbnail
my instance set thumbnail_alt "A town by the sea"
  • Escreva as flags antes da chave e do valor.
  • Com -owner <username>, o valor de preview_image ou thumbnail é lido como o caminho de um arquivo de imagem e enviado como mídia dessa conta local. O worker processa a imagem antes de ela ser usada. Recomenda-se uma imagem horizontal de 1200x630.
  • Uma alteração registra uma revisão (instance_*_revisions) e atualiza o valor atual (instance_settings / instance_texts) em uma única transação. Uma alteração feita pela CLI é registrada sem um autor (BY é cli no histórico).
  • Definir o mesmo valor de novo ainda adiciona uma revisão.
  • Códigos de saída: 0 para sucesso, 1 para um valor rejeitado ou um erro do banco de dados (nada muda), 2 para argumentos incorretos.
  • Restringi-la mantém os relacionamentos de seguidores, as publicações importadas e os registros de entrega, e não envia Undo nem Reject. O fluxo apenas para, e voltar para both (ou outro modo) o retoma como estava.
  • As publicações e reações feitas enquanto restrita não são entregues retroativamente depois que você a amplia de novo.
  • Do lado remoto, os seguidores dos usuários locais não recebem nada enquanto o modo é inbound, e os seguimentos dos usuários locais não são atualizados enquanto o modo é outbound ou off.
  • As exclusões (de publicações ou de contas) feitas enquanto o modo é off não são enviadas. Em inbound e outbound, a retratação do que já foi enviado (Delete e similares) vai aos destinatários originais e aos seguidores da época.
  • As alterações são registradas em instance_setting_revisions e no registro de auditoria (target_kind = setting).

Para cortar também os relacionamentos, use a CLI my admin federation sever.

Janela do terminal
my admin federation sever -direction in # end follows of local users by remote accounts
my admin federation sever -direction out # end follows of remote accounts by local users
my admin federation sever -direction both
  • Ele encerra os seguimentos pendentes e ativos entre contas locais e remotas como encerramentos por moderação (follow_terminations, reason = moderation). Uma mudança de modo nunca o chama automaticamente.
  • Reject (in) ou Undo (out) só é enviado ao lado remoto quando o modo atual envia essa direção. Em um modo que não envia (como off), o seguimento termina apenas no lado local e o lado remoto não é avisado.
  • É seguro executá-lo repetidamente. Ele imprime na saída padrão o número de seguimentos que encerrou.

Toda configuração que a CLI pode alterar também pode ser alterada nas telas de administração do cliente web e com a API de cliente. Ambos exigem a permissão de função manage_settings (apenas a função integrada admin a tem). Como na CLI, uma alteração é mantida como uma revisão e registrada por chave no registro de auditoria (setting_changed, o alvo é a configuração e o autor é esse usuário). Consulte o registro de auditoria na tela de moderação (“Registro de auditoria”, /moderation/audit-log).

  • Cliente web (“Configurações do servidor”, /admin/settings): a tela lista uma página por tópico, em grupos. Cada página tem um formulário e um botão de salvar, e salvar envia apenas o que você alterou nessa página; as configurações das outras páginas permanecem como estão. Uma escolha cujas opções mudam muita coisa diz, abaixo dela e antes de você salvar, o que cada uma faz, e um número informa seus limites quando é recusado.

    Página Seções e configurações
    Geral (/admin/settings/general) Nome e descrições (name, short_description, description); Idioma (default_locale, escolhido entre os idiomas que o app tem); Contato (contact_account, contact_email); Imagens (thumbnail e o texto thumbnail_alt, preview_image e o texto preview_image_alt)
    Ícone e logo (/admin/settings/branding) O ícone, o logotipo e o logotipo para fundos escuros (Logotipo e ícone)
    Cadastro (/admin/settings/registration) Quem pode se cadastrar (registration_mode, cada modo com o que ele faz); Servidor de uma pessoa (single_user); Convites de membros (invite_creators, member_invite_max_active, member_invite_max_uses, member_invite_max_lifetime_seconds em horas); Somente provedores de login (login_providers_only, que pergunta antes, com quantos usuários ativos não poderiam mais entrar e se você é um deles); Apps (user_app_registration, dynamic_client_registration, oauth_metadata_document_clients, oauth_client_rate_limits). Em um servidor de uma pessoa, as seções de cadastro e de convites de membros dizem que ninguém mais se cadastra
    Publicações e recursos (/admin/settings/content) Publicações (max_status_length, require_media_description); Timelines (local_timeline_visibility, federated_timeline_visibility); Cartões de link (link_cards, link_cards_ignore_robots_txt); Rascunhos e publicações agendadas (max_drafts, max_scheduled_posts, max_scheduled_posts_per_day, scheduled_post_min_lead_minutes, scheduled_post_max_lead_days); Artigos (article_authoring, max_article_bytes, max_article_images); Eventos (event_creators, event_records_retention_days); Página inicial e sugestões (public_counts, landing_fediverse_explanation, landing_features, featured_accounts)
    Chat de voz (/admin/settings/voice) Quem pode abrir salas (voice_room_starters); Salas (voice_public_summary, voice_participants_retention_days)
    Exclusão de publicações (/admin/settings/auto-delete) Padrão para contas novas (as configurações auto_delete_default_*); Máximo para todos (auto_delete_max_age_days, auto_delete_grace_days, as configurações auto_delete_max_allow_*, auto_delete_max_kept_pins). Salvar um máximo que está sendo ativado ou encurtado pergunta antes (Um máximo para manter publicações)
    Federação (/admin/settings/federation) Direção (federation_mode); Servidores (federation_scope: salvar allowlist primeiro mostra os seguimentos que a mudança encerraria e pede confirmação, veja federar somente com servidores permitidos); Buscas assinadas (authorized_fetch); Mídia de outros servidores (remote_media_policy, remote_media_cache_ttl_seconds em minutos, remote_media_cache_max_bytes em MiB); Publicações de outros servidores (remote_status_retention_days, remote_status_max_retention_days, relay_status_retention_days); Servidores moderados (domain_actions_visibility, domain_actions_rationale_visibility)
    Busca e rastreadores (/admin/settings/discovery) Mecanismos de busca (search_indexing, indexable_default); Contato de segurança (security_contact); IA (ai_usage); Busca de texto completo (search_visibilities)
    Revisão externa (/admin/settings/hooks) Uma seção para cada hook de decisão: seu modo (enforce só é oferecido quando não está off), o que ele faz quando seu plugin falha e suas outras configurações; Registros de decisões (hook_decisions_retention_days). Veja Hooks de decisão
    Recursos e registros (/admin/settings/records) Recursos (appeal_window_days); Manutenção de registros (session_origins_retention_days, registration_origins_retention_days, reports_retention_days, moderation_actions_retention_days, audit_log_retention_days)

    Na página Geral, uma imagem é enviada quando você salva e então se torna a miniatura ou a imagem de prévia de link. Quem pode ver os custos de operação, a receita e a lista de apoiadores é definido nas telas “Custos e receita” e “Apoiadores”. As configurações de tradução têm uma tela própria, abaixo.

  • Cliente web (“Tradução”, /admin/translation): os provedores que este servidor tem, sua ordem e o que cada um pode receber, a tradução do navegador, os limites mensais e por quanto tempo as traduções são mantidas, com os caracteres enviados neste mês e a taxa de acertos do cache. Cada processo do servidor soma sua contagem de acertos do cache à taxa no máximo uma vez por minuto, então as requisições mais recentes podem levar um minuto para aparecer, e um processo que para pode deixar seu último minuto sem contagem. Atualize sua política de privacidade (modelo) antes de habilitar um provedor no servidor: o texto enviado a um provedor não pode ser recolhido. As chaves de API dos provedores e o endereço de um plugin tradutor ficam na configuração da implantação; nenhuma configuração e nenhuma resposta da API de cliente as contém.

  • Limites de tradução. O que conta são os caracteres enviados, em code points: os marcadores que representam menções, links e similares não contam, nem uma tradução que o servidor já mantém, uma publicação que já está no idioma do leitor ou a tradução do navegador. Cada chamada a um provedor conta, inclusive uma que falha, já que o provedor pode ter recebido o texto, então o número pode diferir do que um provedor cobra. Acima de um limite, a requisição é recusada com um 429 e nenhum provedor é chamado; o cliente web então usa a tradução do navegador do leitor, quando você a permite e o navegador consegue traduzir a publicação. Os meses são em UTC.

  • API de cliente: GET /api/v1/admin/settings retorna todas as configurações com seu valor atual, seu padrão, se está definida e seu tipo e valores aceitos (opções ou intervalo). PATCH /api/v1/admin/settings altera configurações em conjunto com {"values": {"<key>": "<value>", ...}}. Todos os valores são strings, normalizadas e armazenadas como na CLI. Se uma única chave for desconhecida ou um valor for inválido, a resposta é um 422 que cita a chave e nada muda. As chaves alteradas são registradas como revisões e no registro de auditoria na mesma transação.

  • Os convites, que funcionam nos modos open, approval e invite, são criados na tela de moderação (“Convites”, /moderation/invites, permissão manage_invites; veja códigos de convite), e pelos membros conforme invite_creators permite (convites de membros).

As regras da instância aparecem em rules de GET /api/v1/instance, e as denúncias as citam por ID.

  • Uma regra tem uma frase de uma linha (até 300 caracteres) e um complemento opcional (até 1.000 caracteres). Como nos textos, o administrador as escreve no idioma que quiser e todos os idiomas veem o mesmo valor (dir="auto" e lang=""). Pode haver no máximo 100 regras ativas.
  • Toda alteração (uma frase revisada, uma reordenação) é mantida como uma revisão (instance_rule_revisions), e o ID de uma regra não muda.
  • Uma regra retirada desaparece da lista de regras ativas. Ela não pode ser trazida de volta, mas as denúncias ainda podem se referir a ela.
Janela do terminal
my instance rule create -hint "No harassment" "Be kind" # add at the end of the active rules
my instance rule edit <rule> "Always be kind" # change the sentence; the supplement changes only with -hint
my instance rule move <rule> 1 # move to position 1 and renumber the active rules 1, 2, ...
my instance rule retire <rule> # retire it
my instance rule list # active rules (-all includes retired ones)
  • A API de administração é /api/v1/admin/rules (listar, adicionar, obter, revisar, mover, retirar) e exige a permissão de função manage_rules.
  • Na tela de administração do cliente web (“Regras”, /admin/rules, manage_rules), a lista mostra as regras em vigor na ordem, e “Mover para cima” e “Mover para baixo” as reordenam; o filtro acima da lista mostra as regras retiradas no lugar. “Adicionar uma regra” abre uma página com uma frase e um complemento. Escolha a frase de uma regra para abrir sua página, onde você a edita e a retira (depois de uma caixa de diálogo de confirmação). Toda alteração é registrada no registro de auditoria (rule_added, rule_revised, rule_moved, rule_retired).
  • Os códigos de saída são os mesmos das configurações (0 para sucesso, 1 para um valor rejeitado ou um erro do banco de dados, 2 para argumentos incorretos).

Os cartões de link das publicações (link_cards) vêm de um crawler: o servidor busca a página linkada e sua imagem. Uma regra para esse crawler em um domínio e seus subdomínios, e não mexe em mais nada sobre o domínio. Ela tem um de dois modos. Uma regra é escolha do operador e se aplica além do que os próprios sites linkados recusam (prévias de link).

Modo O que busca Cartões que já existem
Parar de buscar (no_fetch) Nada do domínio, nem páginas nem imagens, inclusive quando um redirecionamento leva até lá Ocultos
Parar apenas as imagens (no_images) Páginas, mas nenhuma imagem do domínio Mostrados sem a imagem
  • Uma regra afeta apenas os cartões de link. O domínio continua federado, e a mídia de suas publicações é buscada como de costume: para isolar um servidor, use uma ação de domínio, que também interrompe seus cartões de link. Uma regra não é listada junto com as ações de domínio nem exportada com elas.
  • Uma regra cobre o domínio e seus subdomínios, e uma imagem é verificada em relação aos hosts da página e da imagem. Toda regra que cobre um host se aplica, então uma regra em um subdomínio não afrouxa a regra do domínio pai. Um domínio é escrito e normalizado como em uma ação de domínio: um nome de host sem esquema nem porta, em qualquer grafia de um domínio internacionalizado.
  • Uma alteração tem efeito na hora, inclusive sobre os cartões que o servidor já tem, e as imagens com proxy desses cartões deixam de ser servidas enquanto as imagens estiverem paradas.
  • Remover uma regra traz de volta os cartões que o servidor já tem como estavam. Um link que foi ignorado recebe seu cartão da próxima vez que uma publicação precisar dele; nada é buscado de novo em massa. Um cartão buscado de novo enquanto as imagens estavam paradas continua sem imagem até sua próxima nova busca.
  • Na tela de administração do cliente web (“Domínios de cartões de link”, /admin/link-card-domains, manage_settings), “Adicionar uma regra” define uma regra com seu modo e uma anotação, e recusa um domínio que já tem uma regra, com um link para essa regra. A lista mostra as regras por domínio, 40 por vez com “Mostrar mais”; escolher um domínio abre a página da regra, onde você altera o modo e a anotação, e a remove (depois de uma caixa de diálogo de confirmação).
  • A API de administração é /api/v1/admin/link_card_domains (listar, definir; um DELETE com o domínio o remove) e exige a permissão de função manage_settings. Um servidor mantém no máximo 1.000 regras, cada uma com uma anotação de até 5.000 caracteres.
  • Toda alteração é registrada no registro de auditoria (link_card_domain_fetch_stopped, link_card_domain_images_stopped, link_card_domain_rule_removed).

O tema do servidor inteiro é um conjunto de substituições dos design tokens do cliente web, com um valor claro e um escuro para cada cor. Ele se aplica ao cliente web de todo visitante e às telas que o servidor renderiza (login, cadastro, termos e assim por diante). Não há CSS personalizado.

  • Você pode substituir estes design tokens; o espaçamento, os tamanhos dos componentes, os pesos da tipografia, as sombras e as cores dos gráficos de dados permanecem fixos:

    Tokens Tipo Substituição
    color-surface, color-surface-raised, color-surface-raised-hover, color-surface-raised-pressed, color-surface-hover, color-surface-pressed, color-text, color-muted-text, color-accent, color-on-accent, color-accent-text, color-quote-bar cor #rrggbb para claro e para escuro
    font-sans-override, font-mono-override família de fonte Nomes de famílias, separados por vírgula (no máximo 30), sem família genérica como sans-serif; coloque entre aspas um nome com uma palavra que começa com dígito, como "M PLUS 1p"
    text-tagline, text-headline, text-heading, text-title, text-reading, text-body, text-caption comprimento 0 ou rem / px, de 0.625rem a 3rem
    text-*--line-height dos mesmos sete número 1 a 2.5
    radius-control, radius-overlay comprimento 0 a 2rem
    duration-spin duração ms / s, de 0 a 1000ms
  • O cliente web desenha o texto com as próprias fontes: Noto Color Emoji para emoji, Noto Sans para latim, grego e cirílico, e Noto Sans CJK nos glifos do idioma do texto para o restante. As fontes de font-sans-override (texto) e font-mono-override (código) vêm logo depois da fonte de emoji, e as fontes do cliente web desenham os caracteres que as suas não têm. Um tema não pode substituir essas fontes.

  • Você salva um conjunto como rascunho, o pré-visualiza e depois o publica; o tema em vigor não muda até você publicar. Cada salvamento substitui o rascunho inteiro, e cada publicação é uma nova revisão. Restaurar publica de novo o conjunto que estava em vigor antes do atual e deixa o rascunho como está.

  • No cliente web, Administração > Tema mostra o rascunho e o tema em vigor. Editar o rascunho mostra cada cor para claro e escuro com o contraste de cada par que ela forma, e não salva um par abaixo do mínimo. Pré-visualizar mostra o rascunho em todas as telas da aba do seu navegador até você pressioná-lo de novo; ninguém mais o vê. Publicar e Restaurar o tema anterior estão na mesma tela. O ícone e o logotipo ficam em Configurações do servidor > Ícone e logotipo.

  • Ao salvar e ao publicar, o servidor verifica a forma e a faixa dos valores e o contraste de cada par de tokens de cor (os tokens que você não substitui usam os padrões; WCAG 2.2 AA em claro e em escuro). Se qualquer verificação falhar, nada é salvo nem publicado.

  • Uma substituição de um token que uma nova versão renomeia ou aposenta, ou cujo valor deixa de servir ao token, nunca faz uma atualização falhar. Ela continua no conjunto salvo, mas deixa de se aplicar: a API de administração a lista em stale_tokens, my instance theme get a nomeia, e o próximo salvamento do rascunho a descarta.

  • A folha de estilo da revisão publicada é servida em /theme/{revision ID}.css (immutable, em cache por muito tempo). O shell HTML tem um cache compartilhado (60 segundos mais 300 segundos de revalidação), então leva alguns minutos depois que você publica para todos a receberem. Uma página que já está aberta mantém a aparência antiga até ser recarregada.

  • <meta name="theme-color"> (claro e escuro) no shell e theme_color / background_color (claro) do Web App Manifest assumem o valor de color-surface do tema. A versão HTML de todo e-mail que o servidor envia a partir de então usa as cores do tema publicado, claras e escuras; um rascunho nunca chega ao e-mail.

  • Publicar um conjunto sem tokens redefine o tema para o padrão, e a folha de estilo deixa de ser carregada.

  • Você pode alterá-lo pela API do cliente e pela CLI. A API do cliente exige a permissão de papel manage_settings: GET /api/v1/admin/theme lê o rascunho e o conjunto em vigor, PUT /api/v1/admin/theme/draft salva o rascunho, GET /api/v1/admin/theme/draft/stylesheet retorna a folha de estilo do rascunho para pré-visualizar, e POST /api/v1/admin/theme/publish e POST /api/v1/admin/theme/restore publicam. As publicações são registradas no log de auditoria (setting_changed, alvo theme).

Janela do terminal
my instance theme get > theme.json # print the draft as the same JSON as the admin API (-published: the set in effect)
my instance theme set < theme.json # save the whole draft (if a check fails, it prints why and changes nothing)
my instance theme publish # publish the draft
my instance theme restore # publish again the set in effect before the current one
echo '{"tokens":[]}' | my instance theme set && my instance theme publish # back to the default
{
"tokens": [
{ "token": "color-accent", "light": "#ff8a80", "dark": "#ff8a80" },
{ "token": "radius-control", "value": "0.25rem" }
]
}

Além da miniatura e da imagem de prévia, a instância pode ter seu próprio ícone, logotipo e logotipo escuro, cada um enviado como um único SVG. Enquanto nenhum for definido, as imagens integradas do mycroblog são usadas, e limpar um traz de volta a imagem integrada.

Imagem Formato Onde aparece
icon Quadrado (dentro de 1%) O favicon, o ícone da tela inicial do iOS (apple-touch-icon), os ícones do app instalado (Web App Manifest), o cartão do servidor na página inicial e ao lado de seu nome no painel lateral do cliente web, e onde quer que um cliente mostre o servidor como uma imagem quadrada
logo De 1 a 8 vezes mais largo que alto O cabeçalho do cliente web e o topo das páginas de entrada, cadastro e consentimento no lugar do wordmark integrado e do nome do servidor (o logotipo deve conter o nome, que é seu texto alternativo), a versão HTML de todo e-mail e a imagem de prévia de link quando preview_image não está definida
logo_dark Como logo Fundos escuros; sem ele, logo é usado também ali
  • O servidor higieniza o SVG. Ele o lê como XML e escreve um novo documento apenas com os elementos permitidos (formas, grupos, defs, symbol, use, gradientes, clipPath, mask, pattern, style, title, desc) e atributos (geometria, transformações, atributos de apresentação, id, class, style). Scripts, foreignObject, imagens incorporadas, links, animações, filtros (sombras e desfoques), manipuladores de eventos, referências a qualquer coisa fora do arquivo e URLs data: são removidos, e a resposta lista o que foi removido. Apenas o SVG higienizado é armazenado.
  • Um SVG é recusado (nada é salvo) quando não é XML bem formado em UTF-8, tem um DOCTYPE ou declarações de entidades, não tem viewBox, tem mais de 256 KiB (128 KiB depois de higienizado), tem mais de 5.000 elementos, tem aninhamento acima de 32 níveis, tem mais de 200 elementos use, tem o formato errado para o seu tipo, contém text (converta o texto em contornos no seu editor antes), ou tem CSS que poderia carregar algo (@import, @font-face, url() que não seja url(#id), escapes). @media (prefers-color-scheme: dark) em um <style> é permitido, de modo que um ícone pode mudar no modo escuro.
  • Alguns lugares não aceitam SVG (a tela inicial do iOS, favicons do Safari mais antigo, prévias de link, e-mail). Para eles, o cliente que envia o SVG também desenha versões PNG a partir do SVG higienizado e as envia junto: 32, 48, 180, 192 e 512 px e um ícone maskable de 512 px para icon; um logotipo de e-mail com 96 px de altura e uma imagem de prévia de link de 1200 × 630 para logo; um logotipo de e-mail com 96 px de altura para logo_dark. O servidor verifica se cada uma é um PNG do tamanho certo (no máximo 1 MiB; o ícone de 180 px, o ícone maskable e a prévia de link precisam ser opacos) e a grava de novo sem metadados. Se qualquer arquivo estiver errado, nada é salvo. As versões opacas do ícone são desenhadas sobre uma cor de fundo, #rrggbb, que por padrão é o color-surface claro do tema. O servidor não verifica se as versões PNG mostram a mesma imagem que o SVG.
  • Os arquivos são armazenados no armazenamento de blobs em instance/brand/<revision>/ e servidos em https://<host>/brand/<revision>/<version>.svg|.png com Cache-Control: public, max-age=31536000, immutable, já que o conteúdo de uma revisão nunca muda. Um SVG é servido com Content-Security-Policy: default-src 'none'; style-src 'unsafe-inline'; sandbox e X-Content-Type-Options: nosniff, de modo que, mesmo aberto sozinho, não executa nada nem carrega nada. Os arquivos de revisões anteriores permanecem, então os e-mails já enviados mantêm seu logotipo.
  • Com um ícone definido, o shell HTML aponta para seus favicons PNG, seu SVG e seu apple-touch-icon de 180 px, o Web App Manifest lista seus ícones de 512 px, 192 px, maskable e SVG nessa ordem (outros servidores do fediverso usam o primeiro como o ícone deste servidor), e /apple-touch-icon.png retorna a versão de 180 px. O ETag do shell muda com as imagens, e o cache compartilhado do shell dura alguns minutos, como com o tema. Um app instalado recebe um novo ícone no Android quando o Chrome verifica o manifesto da próxima vez; em computadores, o app mantém o ícone antigo até ser instalado de novo.
  • GET /api/v1/instance retorna icon, logo e logo_dark com a URL do SVG, a URL e o tamanho de cada versão PNG e a revisão; cada um é omitido enquanto a imagem integrada está em uso.
  • Defina-os no cliente web em Configurações do servidor > Ícone e logo (/admin/settings/branding, permissão de função manage_settings). Escolha um arquivo SVG para o ícone, o logotipo ou o logotipo para fundos escuros: o servidor o verifica na hora, e o formulário o mostra como o servidor o manteria, com a lista do que o servidor removeu. Se o servidor recusar o arquivo, o motivo aparece sob ele com como corrigir. Para o ícone, defina ali também a cor de fundo de suas versões opacas. Salvar desenha as versões PNG no navegador e envia cada imagem escolhida com elas; Usar a imagem padrão devolve uma imagem à integrada quando você salva. O cliente web guarda as imagens que mostrou para uso offline.
  • A API de cliente faz o mesmo, com a permissão de função manage_settings: POST /api/v1/admin/instance/brand/sanitize verifica um SVG e retorna o SVG higienizado com as versões PNG a desenhar (não salva nada), PUT /api/v1/admin/instance/brand/{icon|logo|logo_dark} salva o SVG com todas as versões PNG (multipart/form-data, uma parte por versão), DELETE no mesmo caminho limpa uma, e GET /api/v1/admin/instance/brand retorna as imagens atuais com a cor de fundo do ícone. Toda alteração é mantida como uma revisão (instance_brand_revisions) e registrada no registro de auditoria (setting_changed, alvo brand_icon, brand_logo ou brand_logo_dark).
  • A CLI não consegue defini-las, já que as versões PNG são desenhadas pelo cliente, mas pode exibi-las e limpar uma que esteja com defeito:
Janela do terminal
my instance brand show # each image with its revision, when and by whom it was set, and the URL of its SVG
my instance brand clear icon # back to the built-in icon (also logo, logo_dark)

Os emojis personalizados locais são mostrados como imagens quando alguém escreve :shortcode: no corpo ou no aviso de conteúdo de uma publicação, ou no nome de exibição, na bio ou nos campos do perfil. Eles também chegam ao Mastodon, ao Misskey, ao GoToSocial e ao Akkoma por meio da tag Emoji das Notes e dos actors que você envia.

  • Um shortcode tem de 2 a 30 letras, dígitos ou _. Diferencia maiúsculas de minúsculas e não pode ser alterado depois que o emoji é registrado. Os aliases (até 10) e uma categoria (até 64 caracteres) são usados para buscar e agrupar no seletor de emojis.
  • A imagem é PNG, GIF ou WebP, de no máximo custom_emoji_max_bytes (padrão 256 KiB) e de no máximo 1.024 px em cada lado. O servidor cria derivadas que cabem em caixas de 64, 128 e 256 px e não guarda o original. Um APNG vira uma imagem estática do seu primeiro quadro. O GoToSocial, por padrão, não busca emojis maiores que 100 KiB, então imagens pequenas são recomendadas.
  • Um emoji desativado não aparece em lugar nenhum (publicações, perfis, federação, o seletor), e :shortcode: volta a ser exibido como texto. Um emoji definido para ficar oculto do seletor só deixa de aparecer no seletor e ainda pode ser usado escrevendo-o. Um emoji que veio de outro servidor só pode ser desativado ou copiado como um emoji deste servidor.
  • Copiar busca a imagem do emoji de outro servidor sob os mesmos limites do proxy de mídia (as imagens de domínios com reject_media não são buscadas), executa as mesmas verificações acima e a registra como um novo emoji local. O shortcode é o do original ou o que você indicar. A imagem é reduzida à caixa de 256 px, e uma imagem que não pode ser buscada ou não passa nas verificações não deixa nada para trás.
  • A exclusão não pode ser desfeita. Os emojis em publicações antigas também voltam a ser texto, e registrar o mesmo shortcode de novo cria um emoji diferente. As imagens que os servidores federados copiaram não podem ser excluídas.
  • A tela de administração (“Emoji personalizado”, /admin/custom-emojis), a API de cliente (/api/v1/admin/custom_emojis) e a CLI fazem as mesmas coisas. Na tela, “Registrar um emoji” abre o formulário de registro (/admin/custom-emojis/new), que avisa sobre uma imagem acima de 100 KiB, e escolher um emoji na lista abre sua página (/admin/custom-emojis/{id}), onde você ativa ou desativa, substitui a imagem, altera a categoria, os aliases e a visibilidade no seletor, exclui digitando o shortcode ou copia um de outro servidor. A tela de administração e a API de cliente exigem a permissão de função manage_custom_emojis (apenas a função integrada admin a tem). Registrar, copiar, substituir a imagem, alterar configurações e aliases, ativar e desativar, e excluir são registrados no registro de auditoria (alvo custom_emoji) seja qual for a forma como são feitos (uma operação da CLI é registrada como uma operação da CLI).
Janela do terminal
my admin emoji create -shortcode blobcat -category Cats -alias neko blobcat.png # register one
my admin emoji list -local # list local emoji, newest first
my admin emoji update -category Animals -alias cat -alias neko <emoji id> # change the category and aliases (aliases are replaced; -no-aliases removes them)
my admin emoji update -hidden <emoji id> # hide it from the picker (-hidden=false restores it)
my admin emoji replace-image <emoji id> blobcat2.png # replace the image
my admin emoji disable <emoji id> # disable it (remote emoji too)
my admin emoji enable <emoji id> # enable it again
my admin emoji list -remote -domain mastodon.example # list emoji of another server
my admin emoji copy [-shortcode <name>] <emoji id> # copy a remote emoji to local
my admin emoji delete <emoji id> # delete it
my admin emoji requests list [-state pending|approved|rejected|withdrawn|lapsed|all] # list creation requests (pending by default)
my admin emoji requests approve <request id> # approve a request
my admin emoji requests reject [-reason <text>] <request id> # reject a request (the requester sees the reason)
  • Um usuário com a permissão de função create_custom_emojis (um recurso de usuário) pode solicitar a criação de um emoji em “Emoji personalizado” nas configurações (/settings/custom-emojis), alterar os aliases, a categoria e a visibilidade no seletor dos emojis que criou, e excluí-los; a página mostra quantas solicitações lhes restam neste mês. Substituir uma imagem também é uma solicitação, feita com a API de cliente (POST /api/v1/custom_emoji_requests, kind image); a página de configurações não a oferece. Uma solicitação não aparece em lugar nenhum (seletor, publicações, reações, federação) até que alguém com manage_custom_emojis a aprove. Aprove ou rejeite na página “Solicitações” de “Emoji personalizado” na tela de administração (/admin/custom-emojis/requests), com a API de cliente (/api/v1/admin/custom_emoji_requests) ou com a CLI acima. As pessoas com manage_custom_emojis são notificadas de uma solicitação (admin_custom_emoji_request), e quem solicitou é notificado da aprovação ou da rejeição. Solicitar, retirar, aprovar e rejeitar são registrados no registro de auditoria (alvo custom_emoji_request).
  • Uma solicitação de criação pendente reserva seu shortcode. Uma solicitação ou um registro com o mesmo shortcode não é possível até que a pendente seja rejeitada ou retirada. A imagem de um emoji aprovado é copiada como um envio do actor da instância, de modo que ela permanece mesmo que a conta de quem solicitou seja excluída.
  • Um criador pode alterar seus emojis apenas enquanto tem create_custom_emojis. Os emojis permanecem se a função for removida. Os administradores podem alterar e excluir todos os emojis, independentemente do criador.
  • Quando a função vem de um plano de apoiador, o número de emojis que um usuário pode criar por mês é limitado pelo limite mensal de emojis do plano. Ele conta as solicitações de criação que o usuário enviou no mês-calendário atual (UTC) que estão aprovadas ou pendentes; solicitações rejeitadas e retiradas não contam, e excluir um emoji não libera uma vaga. Uma solicitação conta no mês em que foi enviada, mesmo que seja aprovada no seguinte. A contagem é zerada às 00:00 UTC do primeiro dia de cada mês, e a página de configurações mostra ao usuário quando, no fuso horário dele. Substituir a imagem de um emoji e os emojis que os administradores registram não contam. Uma função que um administrador atribuiu manualmente, e um servidor em que os apoiadores estão desativados, não têm limite.

Para LLMs e agentes de programação:llms.txt,llms-full.txt, llms-small.txt

Análise de acesso deste site