Todas las guías
#relay#self-host#nip-29#web-of-trust#moderacion

Corré tu propio relay: la admisión es una escalera, no un interruptor

Obelisk Relay es un relay NIP-29 que decide por sí mismo quién puede conectarse: una lista escrita a mano, las cuentas que siguen tus referencias, y el grafo de follows más allá, cada una con una porción menor del presupuesto. Dos comandos para levantarlo.

8 min de lectura
La admisión es una escalera, no un interruptorUn relay Nostr propio con tres tiers cada vez más amplios de claves admitidas a su alrededor (agregadas a mano, a dos saltos, a tres saltos), cada uno con una porción más chica del presupuesto de tasa, y una lista de bloqueo que atraviesa a los tres.relaytuyoTIER 1agregadas a mano6000/minTIER 2dos saltos3000/minTIER 3tres saltos1500/minBLOQUEADOSva primero, anula todos los tiersnadaLa distancia a tus cuentas de referenciaes cuánta evidencia tenés.

Un relay común es un depósito tonto

Toma lo que le mandás y te lo devuelve. Ese es todo el contrato, y para la mayor parte de Nostr es el correcto.

Eso sí: un relay así no tiene opinión sobre la membresía. Cualquiera que tenga el id de un grupo puede escribir ahí, y "quién está en este grupo" es lo que cada cliente decida creer. Un grupo privado es privado exactamente mientras todos los clientes acuerden fingir que lo es. Y eso no es una propiedad de seguridad, es una cuestión de modales.

Un relay NIP-29 decide

Isotipo de obelisk-relay: una torre que emite arcos de señal concéntricos, que representa el relay Nostr que podés alojar vos mismo, con whitelisting incorporado y una interfaz de administración. obelisk-relay aplica roles, membresía y visibilidad donde viven los datos, y filtra en la lectura. Alguien que no es miembro y pide los mensajes de un grupo privado no recibe un botón gris. No recibe nada, porque no hay nada que mandarle.

Eso es una mejora real y una carga real. Decidir quién puede conectarse pasa a ser un trabajo que alguien tiene que hacer, sobre un disco que alguien tiene que pagar. Casi todo este artículo es sobre las herramientas para ese trabajo.

Dos comandos

La instalación completa.32 s, sin sonido
git clone https://github.com/obelisk-app/obelisk-relay.git
cd obelisk-relay

./setup.sh     # un relay funcionando en localhost:8080
./expose.sh    # publicalo en wss://tu.dominio, cuando estés listo

La división es deliberada: cada script hace una sola cosa. setup.sh verifica Docker, el puerto 8080 y el disco, pide el npub que va a administrar el relay, escribe una configuración nueva y levanta el contenedor. expose.sh te guía para crear un Cloudflare Tunnel, escribe un sidecar de cloudflared, actualiza la dirección publicada y reinicia ambos juntos después de un reboot.

Si parás después del primero, tenés un relay en tu notebook. Es un lugar perfectamente válido donde parar.

El primer arranque

Sin relay_secret_key configurada, el relay genera su propio par de claves al arrancar y lo escribe en config/settings.local.yml, logueando la pubkey una vez. Mantené config/ en un volumen persistente: la identidad del relay es el ancla del estado de sus grupos, así que un relay que cambiara de pubkey en cada arranque invalidaría ese estado cada vez.

Sin pubkeys de admin configuradas arranca en modo setup, y /admin muestra un asistente en vez de una pantalla de login. Tres pasos, todos en el navegador.

La tarjeta de ingreso al admin de Obelisk Relay con tres identidades Nostr: una extensión de navegador NIP-07, un firmante remoto NIP-46, o una clave privada pegada, marcada como riesgosa en navegadores.
Demostrás propiedad firmando: no hay ningún campo de npub para completar.

La clave que firma acá es la que queda como primer admin. Vale leerlo dos veces: no nominás un npub, demostrás que controlás uno. Extensión del navegador, firmante remoto, o una clave pegada si insistís. Después elegís si el relay es abierto o restringido, y escribe su configuración y reinicia hacia la consola.

La salud del relay

La pantalla Overview de la consola de Obelisk Relay: gráficos por hora de conexiones activas y disco usado, contadores en vivo de conexiones, uptime y último evento recibido, y un resumen de la configuración con la retención, el tamaño de la base de datos y el modo de acceso.
Overview: conexiones y disco del último día, y una línea para quién está realmente acá.

Las conexiones y el tamaño de la base se dibujan por hora y se extienden en vivo mientras la pantalla está abierta. La línea que conviene entender es Disk used, porque no se comporta como un archivo común: el relay guarda los eventos en LMDB, que reutiliza internamente las páginas liberadas y nunca se las devuelve al filesystem. Borrar eventos aplana esa línea en vez de bajarla. Un conteo de eventos plano junto a una línea que sube significa que la base necesita compactación, no pruning.

La admisión es una escalera, no un interruptor

Esta es la idea sobre la que está construido todo el producto, así que conviene enunciarla antes de mirar cualquier pantalla.

Tres tiers y una lista de bloqueo, decididos en ese orden.32 s, sin sonido

Alguien que agregaste a mano. Alguien que siguen tus cuentas de referencia. O alguien lo bastante cerca en el grafo de follows como para merecer el beneficio de la duda. Decidido en ese orden. Y una lista de bloqueo que anula las tres, consultada primero.

La pantalla Access de la consola de Obelisk Relay: un campo para chequear si una cuenta está permitida, cinco solapas que cuentan Tier 1, Tier 2, Tier 3, Blocked y Policies, y las cuentas de referencia desde las que se mide cada tier.
Una pantalla, cinco solapas, cada una con su conteo en vivo.

Las cuentas de referencia arriba de esa pantalla son la raíz de toda la estructura. Son las cuentas desde las que se mide cada tier: todos los que ellas siguen caen en Tier 1, y el grafo de follows se recorre hacia afuera desde ahí para llenar Tier 2 y Tier 3. Agregar una cuenta de referencia ensancha los tres tiers a la vez, y es el control de mayor apalancamiento del relay, el que más vale pensar.

Dos cuentas de referencia, medidas en public.obelisk.ar el 22 de septiembre de 2026.32 s, sin sonido

Tier 2 está a dos saltos. Tier 3 a tres, y la consola dice al menos en vez de imprimir un total, porque el salto más externo es justamente donde al grafo se le acaba el presupuesto. Honesto le gana a prolijo: un número presentado como completo cuando no lo es es peor que un piso sobre el que podés razonar.

Lo que cuesta cada tier

La confianza no es binaria, así que el presupuesto tampoco.

El presupuesto de tasa en la consola de Obelisk Relay: barras que muestran cuánto puede publicar cada tier: 6.000 eventos por minuto para Tier 1, 3.000 para Tier 2, 1.500 para Tier 3 y 600 para quien no tiene tier.
Cada tier publica sobre una porción del presupuesto por pubkey.

Tier 1 publica a 6.000 eventos por minuto. Tier 2 recibe la mitad, Tier 3 un cuarto, y quien entre mientras la admisión no se aplica recibe 600. El razonamiento es el mismo que ordena la escalera: cuanto más lejos esté alguien de tus cuentas de referencia, menos evidencia hay de que deba confiársele tu disco.

Hay otros dos límites por encima del de pubkey, y los dos importan más de lo que parecen. El de por conexión debería estar por encima del presupuesto por pubkey: limita un socket, y ponerlo más bajo vuelve inalcanzable el número por pubkey. El de relay entero es el respaldo contra una avalancha de todos a la vez, y es el que te salva cuando los dos primeros quedaron optimistas.

Pegá una clave y obtené una respuesta

Consultando una cuenta en la consola de Obelisk Relay: un npub pegado, respondido con "Allowed", admitido por web of trust a dos saltos de una cuenta de referencia, con un botón Block al lado del veredicto.
Un npub, consultado: permitido, admitido por web of trust, a dos saltos.

La mayoría de las preguntas de acceso llegan como "¿por qué esta persona no puede conectarse?", y esta es la caja que las responde. Acepta un npub, una clave hex o una dirección NIP-05, y contesta con el tier que lo admite y a qué distancia está, o por qué fue rechazado. El botón de Block está al lado del veredicto, porque la respuesta y la acción van en el mismo lugar.

Moderación que sobrevive al contacto con la realidad

Diez personas reportando un mensaje es una decisión, no diez. La cola agrupa por lo que fue reportado, una fila por cosa, contando reportantes distintos en vez de volumen.

El mensaje reportado, todavía legible después de que su autor lo borró.32 s, sin sonido

La parte que más importa es la menos visible: el relay saca una copia del mensaje reportado cuando llega el reporte. Sin eso, una cuenta reportada borra su propio mensaje y la denuncia se vuelve irrevisable: el borrado como defensa en vez de como remedio.

La pantalla Reports de la consola de Obelisk Relay: reportes de moderación agrupados en una fila por cosa reportada, cada uno marcado como desnudez o spam con su cantidad de reportantes, un campo de nota y botones para descartar o bloquear la cuenta reportada.
Una fila por cosa reportada, con la decisión que tomaste.

Los reportes solo los pueden leer los admins del relay, y eso es una decisión deliberada, no un descuido. En un relay donde la admisión es un grafo social, una cola de reportes pública es un canal de represalia.

Nada expira si no lo armás

La pantalla Storage de la consola de Obelisk Relay: 227,1 MB en disco con 12.831 eventos, nada borrado, y un aviso de que podar evita que el archivo de la base de datos siga creciendo pero no lo achica.
Storage: qué hay en disco, y si se está borrando algo.

El pruning automático está apagado hasta que lo prendas, y la retención se configura por kind de evento, así que el tráfico efímero puede expirar sin tocar las conversaciones. Los kinds de gestión y estado de grupo nunca se borran, y tampoco nada reemplazable o direccionable: el relay guarda uno solo de esos por usuario, así que borrarlos destruiría estado vivo sin liberar espacio que valga la pena.

Contá antes de armar una política. El overview muestrea en vez de escanear, y la muestra sobrerrepresenta los gift wraps.

Ponerlo detrás de un dominio

El relay sirve HTTP, WebSocket y su propio frontend en un solo puerto. Atalo a loopback y terminá TLS adelante:

relay.ejemplo.com {
    reverse_proxy 127.0.0.1:8080
}

Caddy no necesita nada especial para los upgrades de WebSocket; nginx necesita que pases Upgrade y Connection.

Apuntar Obelisk hacia él

La tarjeta de conexión en la portada de un Obelisk Relay: contadores que marcan 28 grupos y 9 NIPs soportados, sobre la dirección del relay wss://public.obelisk.ar con un botón para copiarla.
Tu relay sirve su propia portada, con la dirección lista para copiar.

Nada de tu relay es específico de Obelisk: habla NIP-29, y cualquier cliente que también lo hable va a funcionar. Pero si querés el cliente de chat:

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

Para algo que puedas pasarle a una persona en vez de pegarlo en una configuración, Obelisk codifica un relay en un link corto en obelisk.ar/r/<código>. Visitarlo agrega el relay a la lista del lector y cambia a él, y volver a visitarlo no hace nada, así que es seguro ponerlo en un mensaje fijado o en una bio.

El relay es AGPL-3.0 en GitHub, y hay uno corriendo ahora mismo en wss://public.obelisk.ar si preferís mirar antes de instalar.

Grafo de Web of TrustUn grafo de confianza con tu nodo en el centro, nodos conectados en verde lima para la confianza alta y nodos de spam con borde rojo en la periferia.VOS!!!follow directoamigo de amigofiltrado (spam)

Traé tu propio relay

el grafo de follows que recorren estos tiers

Cambiá cualquier pieza, no confíes en ningunaEl ecosistema Obelisk: un relay que podés alojar vos mismo, arriba, conectado a un cliente de chat, un SFU de voz y un motor de bots, cada pieza reemplazable por separado.obelisk-relayRelay Nostr autoalojable · whitelist · panel de adminobelisk-dexCliente de chat webnavegador · NIP-07obelisk-sfuServidor de mezcla de vozWebRTC · llamadas grandesobelisk-botsMotor de botsmoderación · juegos · opscuatro proyectos · un protocolo · sin servidor central

Cambiá cualquier pieza, no confíes en ninguna: el stack de Obelisk

dónde encaja el relay en el stack de cuatro piezas

Herramientas de admin en la appLos ajustes del servidor del operador del relay y los ajustes de canal de un admin, lado a lado. Los dos publican eventos firmados en un relay NIP-29, que los revisa y los hace cumplir.NIP-78NIP-29Ajustes del servidorsolo el operador del relayPerfil del servidorEmojis y stickersCanales y categoríasRoles y rangosMiembros y moderaciónAjustes del canal#general ACCESOpúblicosolo lecturaprivadoTIPOtextovoz y videopublicacionesMIEMBROSaliceadminbajarbobmiembrosacar+ agregar por npubrelay NIP-29revisa y aplicaoperador: todo el relayadmins de canal: su canalcada click es un evento firmado

Admins, miembros y moderación NIP-29

moderar un grupo sin abrir la consola