Opere seu próprio relay Nostr

Relays públicos podem desaparecer, mudar suas políticas ou apagar dados antigos. Um relay próprio dá a você controle sobre disponibilidade, retenção e acesso. Com o Blossom incluído, seus anexos criptografados também ficam na infraestrutura que você escolher.

Software recomendado

O nostrfy executa relay e Blossom com um único binário

O nostrfy é um relay Nostr leve com servidor de arquivos Blossom integrado. Os dois serviços usam um processo e uma porta, enquanto hostnames separados facilitam configurar o tráfego do relay e da mídia.

Antes de começar

Esta configuração segue o guia oficial de VPS do nostrfy em um servidor Debian ou Ubuntu atual. Revise o script antes de executá-lo, comece com um VPS limpo e adapte os limites e a política de acesso às suas necessidades.

  • Um VPS Debian ou Ubuntu limpo com endereço IP público.
  • Dois subdomínios: um para o relay e outro para a mídia Blossom.
  • Acesso SSH e as portas de entrada 80 e 443 abertas.
  • Espaço em disco suficiente para o banco do relay, mídia criptografada e backups.

1. Aponte os dois hostnames para o servidor

Crie registros A ou AAAA para o relay e o endpoint Blossom. Substitua os nomes de exemplo pelo seu domínio e aguarde até que ambos sejam resolvidos publicamente antes de o Caddy solicitar os certificados.

Registros DNS
relay.example.com  A/AAAA  YOUR_SERVER_IP
media.example.com  A/AAAA  YOUR_SERVER_IP

2. Instale o nostrfy e baixe a configuração

Baixe o instalador que verifica o checksum, revise exatamente o arquivo que será executado e instale o binário no sistema. Depois crie um usuário de serviço sem privilégios e baixe o modelo oficial de configuração: Revisar o código-fonte do instalador.

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. Configure o relay e o Blossom

Edite /etc/nostrfy/nostrfy.toml e incorpore estes valores ao modelo baixado. O exemplo deixa públicas as gravações no relay e os uploads Blossom; restrinja as duas políticas em um servidor privado:

  • Defina relay.public_url com o endereço wss:// final para que a autenticação NIP-42 use a origem correta.
  • Mantenha relay.require_auth como false em um relay aberto ou ative quando todos os clientes necessários suportarem NIP-42.
  • Defina blossom.host com o hostname de mídia e escolha armazenamento local ou compatível com S3 com limite adequado.
  • Em um serviço privado, ative as restrições do relay e do Blossom e adicione as pubkeys permitidas com a CLI do nostrfy.
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. Inicie o serviço e adicione HTTPS automático

Valide a configuração, instale a unidade systemd reforçada do nostrfy e coloque o Caddy à frente da porta local. O Caddy encaminha os dois hostnames ao nostrfy e obtém e renova automaticamente os certificados TLS.

  • Execute nostrfy check antes de iniciar o serviço e corrija todos os erros de configuração.
  • Execute o nostrfy com o usuário sem privilégios nostrfy, não como root.
  • Exponha publicamente as portas 80 e 443, mas mantenha a porta 8080 do nostrfy atrás do proxy.
  • Encaminhe relay.example.com e media.example.com para 127.0.0.1:8080 no Caddy.
  • Confirme que nostrfy e Caddy estão ativos e que os certificados foram emitidos.
/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

Verifique e conecte

A primeira requisição deve retornar o JSON NIP-11 do relay. A segunda deve retornar o documento de informações do servidor Blossom, confirmando DNS, HTTPS, roteamento por hostname e os dois serviços.

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

curl -sS https://media.example.com/
Endereço do relay
wss://relay.example.com
Endereço do Blossom
https://media.example.com

Adicione o endereço WebSocket seguro nas configurações de relay do seu cliente Nostr e confirme que ele conecta. Use o endereço do Blossom em clientes que aceitam um servidor de mídia personalizado.

Mantenha tudo saudável

Hospedar por conta própria também significa manter o serviço. Agende estas três tarefas desde o início:

  1. Faça backup de /etc/nostrfy/nostrfy.toml e /var/lib/nostrfy, incluindo o banco de dados e os arquivos Blossom.
  2. Leia as notas de versão e as instruções de atualização do nostrfy antes de substituir o binário.
  3. Monitore o espaço em disco, journalctl -u nostrfy, os logs do Caddy e a renovação dos certificados.