relay-agent multi-relay (npm / GHCR) · MIT · Open Source

Ecossistema · relay-agent · relay-api · relay-panel · relay-connect (SDK)

Gerir o teu relay Nostr sem usar o terminal

Painel visual para operadores — moderação, controlo de acesso, Lightning e multi-relay num só sítio.

Começar →Ver no GitHub

Documentação técnica completa — bitmacro.io através do relay-agent, com autenticação NIP-07 e NIP-46 (complementa o fluxo painel → relay-api → agente descrito no README).

BitMacro Relay Manager — Painel com tabela de relays, sidebar e estados

Operar um relay Nostr hoje significa…

Gerir listas brancas com scripts bash no terminal

Inspecionar eventos com CLI (strfry scan, nak req)

Apagar spam manualmente por ID de evento

Implementar relay pago com código personalizado por instalação

Não existe uma ferramenta visual para isto. Até agora.

Três componentes. Um fluxo.

relay-agent
MIT License

Node.js · strfry CLI

Corre no teu servidor

npx @bitmacro/relay-agent
relay-api
Open Protocol

REST · Hono · Vercel

Proxy autenticado Stateless por design

relay-panel
BSL 1.1

Next.js · Vercel

UI no browser

Tudo o que precisas para operar um relay

Painel visual

Eventos, tamanho da DB, uptime, atividade por kind

Controlo de acesso

Lista branca / bloqueados com um clique, sem SSH

Pagamentos Lightning

Acesso automático após pagamento, webhook LNbits

Multi-relay

Gerir N relays numa só instância agent

Relay-agnostic

Compatível com strfry (nostr-rs-relay brevemente)

GitHub Auth

NextAuth.js v5, sem passwords

A correr em 3 passos

Passo 1 — Instalar o agente
npx @bitmacro/relay-agent
# or
docker pull ghcr.io/bitmacro/relay-agent
Passo 2 — Configurar RELAY_INSTANCES
# RELAY_INSTANCES — JSON array, one entry per logical relay (e.g. public / private / paid).
# Each: id, token, strfryConfig, strfryDb, whitelistPath (see relay-agent README + compose).
# In strfry.conf use db = "./data/" and mount host nostr/<id>/data to match strfryDb.

[
  {"id":"public","token":"…","strfryConfig":"/app/nostr/public/strfry.conf","strfryDb":"/app/nostr/public/data","whitelistPath":"/app/nostr/public/whitelist.txt"},
  {"id":"private","token":"…","strfryConfig":"/app/nostr/private/strfry.conf","strfryDb":"/app/nostr/private/data","whitelistPath":"/app/nostr/private/whitelist.txt"},
  {"id":"paid","token":"…","strfryConfig":"/app/nostr/paid/strfry.conf","strfryDb":"/app/nostr/paid/data","whitelistPath":"/app/nostr/paid/whitelist.txt"}
]
Passo 3 — Inicia sessão em relay-panel.bitmacro.io e adiciona o endpoint do agente

Cria um relay no painel, pega na URL e token do agente. Pronto.

Aprofundar

Este caminho segue painel → relay-api → relay-agent (ver README do relay-panel). Para a documentação completa do Relay Manager — NIP-07 e NIP-46 — consulta a documentação técnica em bitmacro.io.

Open source no centro

relay-agent

MIT License
npx @bitmacro/relay-agent

CI · npm · Docker

GitHub →

relay-panel

BSL 1.1
relay-panel.bitmacro.io

CI · Next.js

GitHub →

@bitmacro/relay-connect

MIT License
npm install @bitmacro/relay-connect

SDK NIP-46 / NIP-07

GitHub →

Documentação

relay-agent e relay-connect são MIT — instala, bifurca, contribui. relay-panel está visível sob BSL 1.1.

Começa a gerir o teu relay hoje

Grátis para 1 relay. Sem cartão. Entra com GitHub.

Entrar com GitHub →