Draai je eigen Nostr-relay

Openbare relays kunnen verdwijnen, hun beleid wijzigen of oude gegevens verwijderen. Een zelf gehoste relay geeft je controle over beschikbaarheid, bewaartermijn en toegang. Met Blossom erbij blijven ook je versleutelde bijlagen op infrastructuur die jij kiest.

Aanbevolen software

nostrfy draait een relay en Blossom vanuit één binary

nostrfy is een lichte Nostr-relay met een geïntegreerde Blossom-bestandsserver. Beide diensten draaien in één proces op één poort, terwijl aparte hostnamen relay- en mediaverkeer eenvoudig configureerbaar houden.

Voordat je begint

Deze installatie volgt de officiële VPS-handleiding van nostrfy op een actuele Debian- of Ubuntu-server. Controleer het script voor uitvoering, begin met een schone VPS en pas limieten en toegangsbeleid aan je behoeften aan.

  • Een schone Debian- of Ubuntu-VPS met een openbaar IP-adres.
  • Twee subdomeinen: één voor de relay en één voor Blossom-media.
  • SSH-toegang en openstaande inkomende poorten 80 en 443.
  • Voldoende schijfruimte voor de relaydatabase, versleutelde media en back-ups.

1. Laat beide hostnamen naar de server wijzen

Maak A- of AAAA-records aan voor de relay en het Blossom-eindpunt. Vervang de voorbeeldnamen door je eigen domein en wacht tot beide openbaar worden opgelost voordat Caddy de certificaten aanvraagt.

DNS-records
relay.example.com  A/AAAA  YOUR_SERVER_IP
media.example.com  A/AAAA  YOUR_SERVER_IP

2. Installeer nostrfy en haal de configuratie op

Download het installatieprogramma dat de checksum controleert, bekijk precies het bestand dat je uitvoert en installeer de binary systeembreed. Maak daarna een servicegebruiker zonder privileges aan en haal het officiële configuratiesjabloon op: Bekijk de broncode van het installatieprogramma.

Terminal
curl -fsSLo nostrfy-install.sh \
  https://raw.githubusercontent.com/iqbqioza/nostrfy/main/install.sh
less nostrfy-install.sh
chmod +x nostrfy-install.sh
sudo env INSTALL_DIR=/usr/local/bin ./nostrfy-install.sh

sudo useradd --system --create-home --home-dir /var/lib/nostrfy nostrfy
sudo install -d -o nostrfy -g nostrfy -m 0750 /etc/nostrfy
sudo curl -fsSLo /etc/nostrfy/nostrfy.toml \
  https://raw.githubusercontent.com/iqbqioza/nostrfy/main/deploy/nostrfy.toml
sudo chown nostrfy:nostrfy /etc/nostrfy/nostrfy.toml
sudo chmod 600 /etc/nostrfy/nostrfy.toml
sudoedit /etc/nostrfy/nostrfy.toml

3. Configureer de relay en Blossom

Bewerk /etc/nostrfy/nostrfy.toml en voeg deze waarden samen met het gedownloade sjabloon. Het voorbeeld laat relay-schrijftoegang en Blossom-uploads openbaar; beperk beide voor een privéserver:

  • Stel relay.public_url in op het definitieve wss://-adres zodat NIP-42-authenticatie de juiste oorsprong gebruikt.
  • Laat relay.require_auth op false voor een open relay of schakel het in wanneer alle benodigde clients NIP-42 ondersteunen.
  • Stel blossom.host in op de mediahostnaam en kies lokale of S3-compatibele opslag met een passende uploadlimiet.
  • Schakel voor een privédienst de relay- en Blossom-beperkingen in en voeg toegestane pubkeys toe met de nostrfy-CLI.
nostrfy.toml
[relay]
name = "My Relay"
public_url = "wss://relay.example.com"
require_auth = false

[server]
host = "0.0.0.0"
port = 8080
trusted_proxies = ["127.0.0.1/32", "::1/128"]

[database]
path = "/var/lib/nostrfy"

[blossom]
host = "media.example.com"
storage = "local"
local_path = "/var/lib/nostrfy/images"
max_upload_bytes = 20971520
restrict_uploads = false

4. Start de service en voeg automatische HTTPS toe

Valideer de configuratie, installeer de geharde systemd-unit van nostrfy en plaats Caddy voor de lokale poort. Caddy stuurt beide hostnamen naar nostrfy en haalt en vernieuwt hun TLS-certificaten automatisch.

  • Voer nostrfy check uit voordat je de service start en verhelp elke configuratiefout.
  • Draai nostrfy als de gebruiker zonder privileges nostrfy en niet als root.
  • Stel poorten 80 en 443 openbaar beschikbaar, maar houd poort 8080 van nostrfy achter de proxy.
  • Stuur relay.example.com en media.example.com in Caddy naar 127.0.0.1:8080.
  • Controleer of nostrfy en Caddy actief zijn en de certificaten succesvol worden uitgegeven.
/etc/caddy/Caddyfile
relay.example.com, media.example.com {
  reverse_proxy 127.0.0.1:8080
}
Terminal
sudo -u nostrfy /usr/local/bin/nostrfy \
  --config /etc/nostrfy/nostrfy.toml check

sudo curl -fsSLo /etc/systemd/system/nostrfy.service \
  https://raw.githubusercontent.com/iqbqioza/nostrfy/main/deploy/nostrfy.service
sudo systemctl daemon-reload
sudo systemctl enable --now nostrfy

sudo apt update
sudo apt install -y caddy
sudoedit /etc/caddy/Caddyfile
sudo systemctl reload caddy
sudo systemctl status nostrfy caddy

Controleren en verbinden

Het eerste verzoek moet de NIP-11-JSON van de relay teruggeven. Het tweede moet het informatiedocument van de Blossom-server tonen en bevestigt DNS, HTTPS, hostroutering en beide diensten.

Terminal
curl -H 'Accept: application/nostr+json' \
  https://relay.example.com

curl -sS https://media.example.com/
Relay-adres
wss://relay.example.com
Blossom-adres
https://media.example.com

Voeg het beveiligde WebSocket-adres toe in de relay-instellingen van je Nostr-client en controleer of er verbinding wordt gemaakt. Gebruik het Blossom-adres in clients die een aangepaste mediaserver ondersteunen.

Houd het gezond

Zelf hosten betekent ook de dienst onderhouden. Plan deze drie taken vanaf het begin in:

  1. Maak een back-up van /etc/nostrfy/nostrfy.toml en /var/lib/nostrfy, inclusief de database en Blossom-bestanden.
  2. Lees de release notes en actuele upgrade-instructies van nostrfy voordat je de binary vervangt.
  3. Houd schijfruimte, journalctl -u nostrfy, Caddy-logs en certificaatvernieuwing in de gaten.

Officiële referenties

nostrfy blijft in ontwikkeling. Controleer de officiële VPS-, configuratie- en Blossom-referenties voordat je toegangsbeheer, bewaartermijnen, opslag of uploadbeleid wijzigt.