Faire tourner Relayium en service de réception permanent

Dernière mise à jour: 2026-07-09

relayium serve --once traite un seul transfert entrant puis s'arrête — parfait pour un pull occasionnel. Mais si vous voulez qu'une machine soit un point de dépôt permanent — un serveur domestique qui reçoit des sauvegardes chaque nuit, une machine de build vers laquelle la CI pousse des artefacts, un NAS auquel votre téléphone peut envoyer des photos à tout moment — vous voulez que serve tourne en continu, sans avoir à le démarrer à la main à chaque transfert.

Ce guide couvre le démarrage d'un écouteur longue durée, l'approbation de qui est autorisé à envoyer, l'autorisation préalable des pairs pour les cas où personne n'est devant le terminal, l'exécution sous systemd, et le fait de laisser un émetteur utilisant sync --delete répercuter les suppressions.

Démarrer l'écouteur

serve écoute les envois en daemon direct (relayium://host:port) via une connexion TLS 1.3 épinglée et écrit ce qu'il reçoit dans un répertoire. Rien n'a besoin d'être partagé au préalable pour le démarrer — aucune empreinte à copier, aucun serveur à enregistrer :

relayium serve --dir ~/inbox
relayium serve --dir /srv/drop --port 9040   # non-default port
relayium serve --dir ~/inbox --allow-delete  # let a sync --delete sender mirror deletions

--dir définit où les fichiers atterrissent (le répertoire courant par défaut).
--port définit le port d'écoute (9031 par défaut) ; ouvrez-le sur votre pare-feu si l'émetteur se trouve ailleurs.
Sans --once, serve continue de tourner et d'accepter des envois jusqu'à ce que vous l'arrêtiez ou qu'un gestionnaire de processus le redémarre — c'est ce qui en fait un service permanent.

Approuver qui est autorisé à envoyer

La première fois qu'un nouveau pair envoie quelque chose, serve — s'il tourne dans un terminal — vous montre d'où vient l'envoi et son empreinte, puis vous demande de l'approuver, de la même façon que SSH interroge sur un hôte inconnu à la première connexion :

Incoming push from 203.0.113.7:54021
  fingerprint: 74318e3b…
Accept and remember this peer? [y/N] y

Répondez y une fois et cette empreinte est écrite dans authorized_fingerprints ; chaque envoi ultérieur depuis la même machine passe alors sans invite.
Une empreinte identifie une machine, pas une adresse réseau, donc elle reste valable même si l'IP de l'émetteur change.
Cette étape est intrinsèquement interactive — il faut quelqu'un devant le clavier, ce qui ne sera plus vrai une fois que serve passera sous systemd (section suivante).

Autoriser des pairs à l'avance pour les configurations non interactives

Quand serve n'a pas de terminal où demander confirmation — un service systemd, un processus en arrière-plan, un pipe — il ne peut pas interroger et refuse donc toute empreinte qu'il ne reconnaît pas encore. Autorisez plutôt les pairs à l'avance. Sur la machine qui va envoyer, exécutez relayium id pour afficher son empreinte ; sur le récepteur, ajoutez-la avant que le premier envoi n'arrive :

# on the machine that will PUSH: print its fingerprint
relayium id

# on this always-on RECEIVER: authorize it in advance
relayium authorize 74318e3b...

authorize est idempotent — l'exécuter à nouveau pour une empreinte déjà approuvée ne fait rien.
Les fichiers d'identité et de confiance se trouvent dans le répertoire indiqué par --config-dir, ~/.config/relayium par défaut (id.key/id.crt sont l'identité de cet hôte, authorized_fingerprints est la liste d'autorisation des pairs).

Exécuter sous systemd

Pour un service qui survit aux redémarrages et aux plantages, confiez serve à systemd. Faites pointer --config-dir vers un chemin fixe pour que l'identité de l'hôte et sa liste de pairs autorisés restent stables d'un redémarrage à l'autre :

# /etc/systemd/system/relayium-serve.service
[Unit]
Description=Relayium always-on receiver
After=network-online.target

[Service]
ExecStart=/usr/local/bin/relayium serve --dir /srv/drop --port 9031 --config-dir /etc/relayium --allow-delete
Restart=always
User=relayium

[Install]
WantedBy=multi-user.target

Avant d'activer le service, exécutez relayium authorize <fingerprint> pour chaque pair qui doit pouvoir envoyer — le service lui-même ne peut pas demander confirmation.
systemctl enable --now relayium-serve le démarre et le fait redémarrer à chaque boot.
Gardez /etc/relayium/id.key lisible uniquement par l'utilisateur du service ; relayium refuse de charger une clé aux permissions trop permissives.

Laisser un émetteur utilisant sync --delete répercuter les suppressions

Par défaut, serve ne fait qu'ajouter ou mettre à jour des fichiers — un émetteur qui exécute sync --delete contre lui voit quand même ses fichiers nouveaux et modifiés copiés, mais les suppressions demandées sont ignorées, avec un avertissement consigné côté récepteur. Démarrez serve avec --allow-delete pour activer un vrai miroir, où les fichiers supprimés côté émetteur le sont aussi ici :

relayium serve --dir /srv/mirror --allow-delete

--allow-delete est une option activée côté récepteur ; l'émetteur doit tout de même la demander avec sync --delete.
Sans cette option, rien n'est jamais supprimé sur cette machine, quoi que demande un émetteur.

Questions fréquentes

Sur quel port serve écoute-t-il par défaut ?

9031. Changez-le avec --port aussi bien côté écouteur (serve --port N) que côté cible de l'émetteur (relayium://host:N).

Dois-je approuver chaque envoi à la main ?

Seulement le premier envoi d'une empreinte donnée, et uniquement quand serve tourne avec un terminal attaché. Ensuite, c'est mémorisé. Faire tourner serve de façon non interactive (systemd, un pipe) supprime totalement l'invite et rejette les pairs inconnus — autorisez-les plutôt à l'avance avec relayium authorize.

Un émetteur peut-il supprimer des fichiers sur mon récepteur permanent ?

Seulement si vous avez démarré serve avec --allow-delete et que l'émetteur exécute sync --delete. Sans --allow-delete, les suppressions sont silencieusement ignorées et tout le reste est transféré normalement.

Faire tourner un récepteur permanent est-il gratuit ?

Oui. relayium serve fait partie de la CLI gratuite et auto-hébergeable — aucun compte, aucun palier payant, des deux côtés de la connexion.

Où serve conserve-t-il son identité et sa liste de pairs ?

Par défaut dans ~/.config/relayium (id.key/id.crt pour l'identité de cet hôte, authorized_fingerprints pour la liste d'autorisation). Pour un service systemd, faites pointer --config-dir vers un emplacement fixe comme /etc/relayium.

Transformez n'importe laquelle de vos machines en récepteur permanent et gratuit — envois directs via TLS épinglé, sans aucun relais.

Obtenir la CLI