Domande frequenti

nostrfy è un motore di server relay Nostr tutto-in-uno scritto in Rust. Memorizza gli eventi dei client Nostr e li distribuisce in risposta alle sottoscrizioni, implementando tutti i NIP lato relay, più un server multimediale Blossom opzionale, un’API REST in sola lettura e un’API di gestione NIP-86 — tutto in un unico binario.

Sì. nostrfy è software libero, con doppia licenza MIT o Apache-2.0, a tua scelta. Il codice sorgente è su GitHub e non ci sono livelli a pagamento, telemetria o lock-in.

Un unico binario statico gira su Linux (x86_64 e aarch64) e FreeBSD (x86_64). È stato verificato su un VPS da 0,25 vCPU / 512 MB. L’archiviazione è un database LMDB locale — nessun server di database esterno è richiesto.

Una riga: curl -fsSL https://raw.githubusercontent.com/iqbqioza/nostrfy/main/install.sh | sh. Lo script rileva il sistema operativo e l’architettura, scarica il binario precompilato corrispondente, ne verifica il checksum e lo colloca nel PATH. Puoi anche compilare dai sorgenti con Cargo o copiare un modello di configurazione pronto.

Tutto risiede in un unico nostrfy.toml completamente commentato — identità del relay, limiti, archiviazione, controllo degli accessi, Blossom e RPC. nostrfy check lo convalida prima dell’avvio e la maggior parte delle impostazioni si ricarica a caldo con SIGHUP senza riavvio.

nostrfy implementa 36 NIP, tra cui NIP-01, eliminazione NIP-09, gruppi NIP-29, autenticazione NIP-42, ricerca NIP-50, zap NIP-57, gift wrap NIP-59, liste di relay NIP-65, negentropy NIP-77, gestione NIP-86 e autenticazione HTTP NIP-98. La lista supported_nips di NIP-11 è dinamica: un NIP scompare quando i kind necessari vengono bloccati o disattivati.

Sì. Il file server Blossom integrato ospita upload indirizzati per contenuto su un hostname dedicato — disco locale o bucket compatibile S3 come AWS S3 o Cloudflare R2. Gli upload sono autorizzati con eventi kind-24242 firmati e possono essere limitati a una allowlist.

Sì. nostrfy migrate-strfry importa direttamente un database strfry o un export JSONL, applicando la semantica degli eventi sostituibili/indirizzabili, le eliminazioni NIP-09 e gli effetti collaterali di moderazione NIP-29, e può unire le impostazioni strfry equivalenti in nostrfy.toml. La migrazione è offline, supporta il dry-run ed è sicura da ripetere.

Sì. Configura server.trusted_proxies con gli indirizzi del proxy (loopback per nginx o Caddy sullo stesso host, l’intervallo del load balancer nel cloud) così i limiti per IP, blockip e i log vedono l’indirizzo reale del client. Il TLS è terminato dal proxy o dal tunnel; nostrfy serve dietro HTTP e WebSocket normali.

Sì — un’API /api/v1 in sola lettura sulla stessa porta del relay WebSocket, in un thread di lettura dedicato, quindi il traffico REST non blocca mai gli abbonati. Interroga gli eventi per npub, nevent o naddr e offre conteggi, statistiche autore, ripartizioni per giorno/mese e ricerca full-text.

Protezione dal sovraccarico, thread di lettura dedicati, isolamento dei panic e limiti rigorosi delle risorse. Le code limitate falliscono rapidamente invece di esaurire la memoria; i limiti di connessioni per IP fermano i flood di socket, e un disco bloccato non blocca le letture. I sottosistemi sono isolati e il relay continua a servire.

Tramite l’API di gestione JSON-RPC NIP-86 con un token Bearer o una chiave admin NIP-98: bannare chiavi, bloccare IP, gestire allowlist dei kind, ruoli e codici di invito. Le concessioni dei metodi permettono di delegare la moderazione ad altre chiavi senza concedere pieni permessi di amministratore.