Todos os guias
#relay#self-host#nip-29#web-of-trust#moderation

Rode seu próprio relay: admissão é uma escada, não um interruptor

O Obelisk Relay é um relay NIP-29 que decide sozinho quem pode conectar: uma lista escrita à mão, as contas que suas referências seguem, e o grafo de follows além delas, cada uma com uma fatia menor do orçamento. Dois comandos para rodar um.

8 min de leitura
A admissão é uma escada, não um interruptorUm relay Nostr próprio com três tiers cada vez mais largos de chaves admitidas ao redor (adicionadas à mão, a dois saltos, a três saltos), cada um com uma fatia menor do orçamento de taxa, e uma lista de bloqueio que atravessa os três.relayseuTIER 1adicionadas à mão6.000/minTIER 2dois saltos3.000/minTIER 3três saltos1.500/minBLOQUEADOSvem primeiro, anula todos os tiersnadaA distância das suas contas de referênciaé quanta evidência você tem.

Um relay comum é um depósito burro

Ele pega o que você manda e devolve. Esse é todo o contrato, e para a maior parte do Nostr é o contrato certo.

Só que um relay assim não tem opinião sobre associação. Qualquer um que tenha o id de um grupo pode escrever nele, e "quem está neste grupo" é o que cada cliente decidir acreditar. Um grupo privado é privado exatamente enquanto todos os clientes concordarem em fingir que ele é, e isso não é uma propriedade de segurança, é etiqueta.

Um relay NIP-29 decide

Símbolo do obelisk-relay: uma torre emitindo arcos de sinal concêntricos, representando o relay Nostr auto-hospedável com lista de permissão embutida e interface de administração. obelisk-relay aplica papéis, associação e visibilidade onde os dados realmente vivem, e filtra na leitura. Quem não é membro e pede as mensagens de um grupo privado não recebe um botão desabilitado. Não recebe nada, porque não há nada para mandar.

Isso é uma melhoria real e um fardo real. Decidir quem pode conectar passa a ser um trabalho que alguém precisa fazer, num disco que alguém precisa pagar. Quase todo este artigo é sobre as ferramentas para esse trabalho.

Dois comandos

A instalação inteira.32 s, sem som
git clone https://github.com/obelisk-app/obelisk-relay.git
cd obelisk-relay

./setup.sh     # um relay funcionando em localhost:8080
./expose.sh    # publique em wss://seu.dominio, quando estiver pronto

A divisão é deliberada: cada script faz uma coisa só. O setup.sh verifica Docker, a porta 8080 e o disco, pede o npub que vai administrar o relay, escreve uma configuração nova e sobe o contêiner. O expose.sh conduz você pela criação de um Cloudflare Tunnel, escreve um sidecar cloudflared, atualiza o endereço anunciado e reinicia os dois juntos depois de um reboot.

Parar depois do primeiro deixa você com um relay no seu notebook. É um lugar perfeitamente legítimo para parar.

A primeira inicialização

Sem uma relay_secret_key configurada, o relay gera o próprio par de chaves ao subir e o escreve em config/settings.local.yml, logando a pubkey uma vez. Mantenha config/ num volume persistente: a identidade do relay é a âncora do estado dos seus grupos, então um relay que mudasse de pubkey a cada boot invalidaria esse estado toda vez.

Sem pubkeys de admin configuradas ele sobe em modo de setup, e /admin mostra um assistente em vez de uma tela de login. Três passos, todos no navegador.

O cartão de login do admin do Obelisk Relay oferecendo três identidades Nostr: uma extensão de navegador NIP-07, um assinante remoto NIP-46, ou uma chave privada colada, marcada como arriscada em navegadores.
Você prova posse assinando; não existe campo de npub para preencher.

A chave que assina aqui é a que vira o primeiro admin. Vale ler duas vezes: você não indica um npub, você demonstra que controla um. Extensão de navegador, assinador remoto, ou uma chave colada se você insistir. Depois você escolhe se o relay é aberto ou restrito, e ele escreve a configuração e reinicia direto no console.

A saúde do relay

A tela Overview do console do Obelisk Relay: gráficos por hora de conexões ativas e disco usado, contadores ao vivo de conexões, uptime e último evento recebido, e um resumo da configuração com a retenção, o tamanho do banco de dados e o modo de acesso.
Overview: conexões e disco do último dia, e uma linha para quem está realmente ali.

Conexões e tamanho do banco são desenhados por hora e estendidos ao vivo enquanto a tela está aberta. A linha que vale entender é Disk used, porque ela não se comporta como um arquivo comum: o relay guarda eventos em LMDB, que reaproveita internamente as páginas liberadas e nunca as devolve ao sistema de arquivos. Apagar eventos achata essa linha em vez de baixá-la. Uma contagem de eventos estável ao lado de uma linha subindo significa que o banco quer compactação, não pruning.

Admissão é uma escada, não um interruptor

Esta é a ideia sobre a qual o produto inteiro foi construído, então vale enunciá-la antes de olhar qualquer tela.

Três tiers e uma lista de bloqueio, decididos nessa ordem.32 s, sem som

Alguém que você adicionou à mão. Alguém que suas contas de referência seguem. Ou alguém perto o bastante no grafo de follows para merecer o benefício da dúvida. Decidido nessa ordem, e uma lista de bloqueio que anula as três, consultada primeiro.

A tela Access do console do Obelisk Relay: um campo para verificar se uma conta é permitida, cinco abas contando Tier 1, Tier 2, Tier 3, Blocked e Policies, e as contas de referência a partir das quais cada tier é medido.
Uma tela, cinco abas, cada uma com sua contagem ao vivo.

As contas de referência no topo dessa tela são a raiz de toda a estrutura. São as contas a partir das quais cada tier é medido: todo mundo que elas seguem cai no Tier 1, e o grafo de follows é percorrido para fora a partir dali para preencher Tier 2 e Tier 3. Adicionar uma conta de referência alarga os três tiers de uma vez, e é o controle de maior alavancagem do relay, o que mais vale pensar com calma.

Duas contas de referência, medidas em public.obelisk.ar em 22 de setembro de 2026.32 s, sem som

Tier 2 fica a dois saltos. Tier 3 a três, e o console diz pelo menos em vez de imprimir um total, porque o salto mais externo é justamente onde o grafo fica sem orçamento para terminar. Honesto ganha de arrumado: um número apresentado como completo quando não é fica pior que um piso sobre o qual você consegue raciocinar.

O que cada tier custa

Confiança não é binária, então o orçamento também não é.

O orçamento de taxa no console do Obelisk Relay: barras mostrando quanto cada tier pode publicar: 6.000 eventos por minuto para o Tier 1, 3.000 para o Tier 2, 1.500 para o Tier 3 e 600 para quem não tem tier.
Cada tier publica sobre uma fatia do orçamento por pubkey.

O Tier 1 publica a 6.000 eventos por minuto. O Tier 2 recebe metade, o Tier 3 um quarto, e quem entra enquanto a admissão não está sendo aplicada recebe 600. O raciocínio é o mesmo que ordena a escada: quanto mais longe alguém está das suas contas de referência, menos evidência existe de que essa pessoa deva receber confiança sobre o seu disco.

Há outros dois limites acima do limite por pubkey, e os dois importam mais do que parecem. O de por conexão deveria ficar acima do orçamento por pubkey: ele limita um socket, e colocá-lo mais baixo torna o número por pubkey inalcançável. O de relay inteiro é a rede de segurança contra uma enxurrada de todo mundo ao mesmo tempo, e é o que salva você quando os dois primeiros foram ajustados com otimismo.

Cole uma chave e obtenha uma resposta

Consultando uma conta no console do Obelisk Relay: um npub colado, respondido com "Allowed", admitido por web of trust a dois saltos de uma conta de referência, com um botão Block ao lado do veredito.
Um npub, consultado: permitido, admitido por web of trust, a dois saltos.

A maior parte das perguntas de acesso chega como "por que esta pessoa não consegue conectar?", e esta é a caixa que responde. Ela aceita um npub, uma chave hex ou um endereço NIP-05, e responde com o tier que admite a pessoa e a que distância ela está, ou por que foi recusada. O botão de Block fica ao lado do veredito, porque a resposta e a ação pertencem ao mesmo lugar.

Moderação que sobrevive ao contato com a realidade

Dez pessoas reportando uma mensagem é uma decisão, não dez. A fila agrupa pelo que foi reportado, uma linha por coisa, contando denunciantes distintos em vez de volume.

A mensagem reportada, ainda legível depois que o autor a apagou.32 s, sem som

A parte que mais importa é a menos visível: o relay tira uma cópia da mensagem reportada quando o report chega. Sem isso, uma conta reportada apaga a própria mensagem e a denúncia fica irrevisável: apagar como defesa em vez de como remédio.

A tela Reports do console do Obelisk Relay: denúncias de moderação agrupadas em uma linha por item denunciado, cada uma marcada como nudez ou spam com o número de denunciantes, um campo de nota e botões para descartar ou bloquear a conta denunciada.
Uma linha por coisa reportada, com a decisão que você tomou.

Os reports só podem ser lidos pelos admins do relay, e isso é uma escolha deliberada, não um descuido. Num relay onde a admissão é um grafo social, uma fila de reports pública é um canal de retaliação.

Nada expira se você não armar

A tela Storage do console do Obelisk Relay: 227,1 MB em disco com 12.831 eventos, nada apagado, e um aviso de que a poda impede o arquivo do banco de dados de crescer, mas não o encolhe.
Storage: o que está em disco, e se alguma coisa está sendo apagada.

O pruning automático fica desligado até você ligá-lo, e a retenção é configurada por kind de evento, então o tráfego efêmero pode expirar sem tocar nas conversas. Os kinds de gestão e estado de grupo nunca são apagados, e nada substituível ou endereçável também: o relay guarda só um desses por usuário, então apagá-los destruiria estado vivo sem liberar espaço que valha a pena.

Conte antes de armar uma política. O overview amostra em vez de escanear, e a amostra super-representa os gift wraps.

Colocando atrás de um domínio

O relay serve HTTP, WebSocket e o próprio frontend numa porta só. Prenda-o ao loopback e termine o TLS na frente:

relay.exemplo.com {
    reverse_proxy 127.0.0.1:8080
}

O Caddy não precisa de nada especial para upgrades de WebSocket; o nginx precisa que você repasse Upgrade e Connection.

Apontando o Obelisk para ele

O cartão de conexão na página inicial de um Obelisk Relay: contadores mostrando 28 grupos e 9 NIPs suportados, acima do endereço do relay wss://public.obelisk.ar com um botão de copiar.
Seu relay serve a própria página inicial, com o endereço pronto para copiar.

Nada no seu relay é específico do Obelisk: ele fala NIP-29, e qualquer cliente que também fale vai funcionar. Mas se você quiser o cliente de chat:

https://obelisk.ar/app?relay=relay.exemplo.com

Para algo que você possa entregar a uma pessoa em vez de colar numa configuração, o Obelisk codifica um relay num link curto em obelisk.ar/r/<código>. Visitá-lo adiciona o relay à lista do leitor e muda para ele, e visitar de novo não faz nada, então é seguro colocar numa mensagem fixada ou numa bio.

O relay é AGPL-3.0 no GitHub, e há um rodando agora mesmo em wss://public.obelisk.ar se você preferir olhar antes de instalar.

Grafo de Web of TrustUm grafo de confiança com o seu nó no centro, nós conectados em verde-limão para alta confiança e nós de spam com contorno vermelho na periferia.VOCÊ!!!follow diretoamigo de amigofiltrado (spam)

Traga o seu relay

o grafo de follows que estes tiers percorrem

Troque tudo, confie em nadaO ecossistema Obelisk: um relay auto-hospedável no topo, ligado a um cliente de chat, um SFU de voz e um motor de bots, cada peça substituível de forma independente.obelisk-relayRelay Nostr auto-hospedável · lista de permissão · painel de adminobelisk-dexCliente de chat webnavegador · NIP-07obelisk-sfuServidor de mixagem de vozWebRTC · chamadas grandesobelisk-botsMotor de botsmoderação · jogos · opsquatro projetos · um protocolo · sem servidor central

Troque tudo, confie em nada: a stack de quatro peças do Obelisk

onde o relay se encaixa na stack de quatro peças

Ferramentas de admin no appAs configurações do servidor do operador do relay e as configurações de canal de um admin, lado a lado. As duas publicam eventos assinados num relay NIP-29, que confere e faz valer cada um.NIP-78NIP-29Configurações do servidorsó o operador do relayPerfil do servidorEmojis e figurinhasCanais e categoriasCargos e níveisMembros e moderaçãoConfigurações do canal#general ACESSOpúblicosomente leituraprivadoTIPOtextovoz e vídeopublicaçõesMEMBROSaliceadminrebaixarbobmembroremover+ adicionar por npubrelay NIP-29confere e aplicaoperador: o relay inteiroadmins de canal: o próprio canalcada clique é um evento assinado

Admins, membros e moderação no NIP-29

moderar um grupo sem abrir o console