Transférer fichiers et texte depuis le terminal avec la CLI Relayium

Installation en une commande

Sous macOS ou Linux, une commande télécharge un binaire précompilé pour votre OS et l'ajoute à votre PATH :

curl -fsSL https://relayium.com/install.sh | sh

• Vous préférez choisir le fichier vous-même ? Téléchargez un binaire depuis la page des releases.
• Go est installé ? Clonez le dépôt et lancez : go build ./cmd/relayium (depuis le répertoire server).
• Lancez ensuite relayium --help pour voir toutes les commandes, et relayium version pour vérifier le build.

Les trois façons de déplacer des fichiers

Relayium déplace les fichiers de trois façons. Vous choisissez selon où se trouve l'autre bout, sans avoir à apprendre trois outils différents — ils partagent un seul moteur de transfert, qui vérifie chaque fichier déplacé par une empreinte SHA-256. Ce qu'ils ne partagent pas, c'est la reprise : sync est le mode qui poursuit un fichier partiel lors d'une exécution ultérieure, et push, pull, send et receive ne reprennent pas du tout.

• push / pull — vers un serveur où vous pouvez déjà vous connecter en SSH. Les octets transitent par votre connexion SSH ; aucun compte Relayium requis.
• send / receive — vers une autre personne entre réseaux différents, avec un court code d'appairage que la CLI de l'expéditeur génère (connectez-vous une fois avec relayium login ; le destinataire, jamais). Un code émis est valable cinq minutes : lancez la commande sur la machine réceptrice dans ce délai.
• Les commandes send/receive et text du CLI Relayium sont P2P et direct-only : aucun octet de fichier ou de message ne transite par TURN ni par un autre serveur Relayium. Si les deux extrémités ne peuvent pas établir de connexion directe, la session échoue au lieu de se rabattre sur un relais.
• serve + push relayium:// (daemon-direct) — directement entre deux serveurs qui vous appartiennent, via TLS avec épinglage. Pas de relais, pas de SSH, pas de code.

Envoyer du texte éphémère

Lancez relayium text sur une machine pour créer un code d'appairage, puis rejoignez depuis l'autre avec le code affiché :

relayium text

relayium text 483920

• Créer le code nécessite relayium login ; le rejoindre ne nécessite aucune connexion.
• Les deux machines doivent rester en ligne. Les messages sont chiffrés de bout en bout et les serveurs Relayium ne stockent pas leur corps.
• Les commandes send/receive et text du CLI Relayium sont P2P et direct-only : aucun octet de fichier ou de message ne transite par TURN ni par un autre serveur Relayium. Si les deux extrémités ne peuvent pas établir de connexion directe, la session échoue au lieu de se rabattre sur un relais.
• Chaque extrémité peut néanmoins copier ou conserver le texte reçu.
• Un message fait au plus 65 536 octets UTF-8. Utilisez relayium send pour un contenu plus grand.

Votre premier transfert

Le plus rapide à essayer est de copier un dossier vers un serveur où vous pouvez vous connecter en SSH. Relayium utilise votre accès SSH existant, il n'y a donc rien à configurer côté distant et aucun compte à créer :

1. Vérifiez que la CLI est dans votre PATH. Elle affiche un numéro de version, et non « command not found ».

   relayium version

2. Vérifiez que vous atteignez déjà le serveur par la voie habituelle. push réutilise exactement cet accès, donc un ssh qui passe remplit le prérequis de connexion et d'authentification — ce n'est pas une promesse sur le transfert lui-même, qui exige encore le droit d'écriture et de la place libre sur user@your-server:backups/.

   ssh user@your-server true

3. Poussez le dossier. Le dernier argument est host:path, et c'est le deux-points qui le marque comme distant. Une barre oblique finale signifie « à l'intérieur de ce répertoire ».

   relayium push ./photos user@your-server:backups/

4. Vérifiez que les fichiers sont arrivés là où vous les attendiez. push ./photos recrée photos/ sous la destination, le nom du dossier suit donc.

   ssh user@your-server ls backups/photos

relayium push ./photos user@your-server:backups/
  photos/IMG_0413.jpg (2314518 bytes)
  photos/IMG_0414.jpg (1998233 bytes)
echo $?
# 0

• Si relayium est aussi installé sur la machine distante, push utilise le protocole natif : le lot est contrôlé pour les collisions avant le moindre octet, et chaque fichier est vérifié par SHA-256 et mis en zone d'attente avant d'être installé. Il ne reprend toujours pas — relancer après une coupure est refusé, car les fichiers arrivés existent désormais. Utilisez relayium sync là où vous en avez besoin.
• Sinon, push bascule sur un simple flux tar, ce qui fonctionne donc même sur un serveur nu — ce repli n'existe que pour push.
• Récupérez les mêmes fichiers avec : relayium pull user@your-server:backups/ ./restore — pull a toujours besoin de relayium sur la machine distante (aucun repli tar), installez-le donc là-bas au préalable.

Quand la première commande ne passe pas

Quatre choses tournent mal au premier essai plus souvent que tout le reste réuni. Aucune ne demande de deviner : chacune a une commande dont la sortie tranche la question.

Gratuit, et privé par conception

Il n'y a rien à payer. Parmi les trois méthodes ci-dessus, la seule connexion est celle de l'expéditeur en mode send / receive, pour que sa CLI puisse générer un code d'appairage (le up cloud utilise aussi votre compte, pour stocker le fichier). La CLI connecte les deux extrémités directement, si bien que vos fichiers ne sont jamais téléversés vers un serveur intermédiaire — la seule chose que Relayium touche jamais est une petite poignée de main de rendez-vous en mode send / receive, utilisée pour présenter les deux extrémités l'une à l'autre, jamais le fichier lui-même.

Chaque transfert est chiffré de bout en bout, et sur le protocole natif chaque fichier transféré par une exécution est vérifié par une empreinte SHA-256 à l'arrivée — le repli tar sans dépendance fait exception et ne vérifie rien fichier par fichier. La reprise est plus étroite que le reste : relayium sync poursuit un fichier partiel lors d'une exécution ultérieure, relayium down se reconnecte et poursuit à l'intérieur de l'exécution qui l'a lancé, et push, pull, send et receive ne reprennent pas du tout. Cela fonctionne sous macOS, Linux et Windows, et l'ensemble est open source et auto-hébergeable.