Relayium

Transfiere archivos y texto desde la terminal con la CLI de Relayium

Última actualización: 2026-09-01

La CLI de Relayium es un pequeño binario para transferir archivos y texto efímero desde la terminal — cifrado de extremo a extremo, autoalojable y gratis. Copia archivos a un servidor, envía una compilación o pasa URL, comandos y código sin guardarlos antes como archivo.

En daemon directo — relayium serve con push o sync —, los bytes de los archivos viajan directamente entre tus dos máquinas y nunca pasan por los servidores de Relayium, así que no se contabiliza nada. Las sesiones con código de emparejamiento (send / receive, text y pair) están cifradas de extremo a extremo, pero siempre que el servidor emite un retransmisor para el código, cada byte pasa por ese retransmisor cifrado y cuenta para la cuota mensual de tráfico de la cuenta que generó el código. up no es directo: guarda una copia cifrada en tu cuenta. Esta guía te deja instalado y con tu primera transferencia hecha, y luego te dirige a los tutoriales más detallados de cada modo.

Instala con un solo comando

Lo que necesitas

  • Un ordenador con terminal en macOS, Linux o Windows. Hay binarios precompilados para los tres, tanto en x86-64 como en arm64.
  • curl, para la instalación de una línea en macOS y Linux: curl --version imprime una versión. En Windows, descarga en su lugar el .zip de la página de releases.
  • Un directorio de instalación con permiso de escritura. El script usa /usr/local/bin cuando puede escribir ahí y ~/.local/bin en caso contrario, y sus últimas líneas dicen cuál eligió.
  • Nada más para push o sync con daemon directo. Solo generar un código de emparejamiento con send, text o pair, subir con up y usar la Device Inbox necesitan una cuenta gratuita de Relayium.

En macOS o Linux, un comando descarga un binario precompilado para tu sistema operativo y lo coloca en tu PATH:

curl -fsSL https://relayium.com/install.sh | sh
  • ¿Prefieres elegir el archivo tú mismo? Descarga un binario desde la página de releases.
  • ¿Tienes Go instalado? Clona el repositorio y ejecuta: go build ./cmd/relayium (desde el directorio server).
  • Luego ejecuta relayium --help para ver todos los comandos, y relayium version para comprobar la compilación.

Las tres formas en que mueve archivos

Relayium mueve archivos de tres maneras. Eliges según dónde esté el otro extremo, no aprendiendo tres herramientas distintas — todas comparten un mismo motor de transferencia, que verifica cada archivo que mueve con un hash SHA-256. Lo que no comparten es la reanudación: sync es el modo que continúa un archivo parcial en una ejecución posterior, y push, send y receive no reanudan en absoluto.

  • up / down (nube) — el otro extremo puede estar desconectado. up cifra en esta máquina, sube solo el texto cifrado a tu cuenta e imprime un enlace; down lo descarga y descifra en otra máquina con ese enlace. El push / pull por SSH que figuraba aquí está retirado.
  • send / receive — a otra persona entre redes, usando un código de emparejamiento corto que genera la CLI de quien envía (inicia sesión una vez con relayium login; quien recibe, nunca). Un código emitido vale cinco minutos, así que lanza el comando en la máquina receptora dentro de ese margen.
  • Las sesiones con código de emparejamiento del CLI de Relayium (send / receive, text y pair) envían cada byte a través de un retransmisor TURN cifrado siempre que el servidor emite uno para el código —aunque los dos extremos pudieran conectarse directamente—, y esos bytes retransmitidos cuentan para la cuota mensual de tráfico de la cuenta que generó el código; el retransmisor solo transporta texto cifrado que no puede leer. Solo cuando no se emite ningún retransmisor (no hay ninguno configurado o esa cuota está agotada) los dos extremos se conectan de igual a igual (P2P), y entonces la sesión falla si no existe una ruta directa.
  • serve + push relayium:// (daemon directo) — directamente entre dos servidores que posees, sobre TLS con anclaje. Sin retransmisor, sin SSH, sin código.

Enviar texto efímero

Ejecuta relayium text en una máquina para generar un código de emparejamiento y únete desde la otra con el código impreso:

relayium text
relayium text 483920
  • Generar el código requiere relayium login; unirse con un código no requiere iniciar sesión.
  • Ambas máquinas deben seguir conectadas. Los mensajes están cifrados de extremo a extremo y los servidores de Relayium no almacenan su contenido.
  • Las sesiones con código de emparejamiento del CLI de Relayium (send / receive, text y pair) envían cada byte a través de un retransmisor TURN cifrado siempre que el servidor emite uno para el código —aunque los dos extremos pudieran conectarse directamente—, y esos bytes retransmitidos cuentan para la cuota mensual de tráfico de la cuenta que generó el código; el retransmisor solo transporta texto cifrado que no puede leer. Solo cuando no se emite ningún retransmisor (no hay ninguno configurado o esa cuota está agotada) los dos extremos se conectan de igual a igual (P2P), y entonces la sesión falla si no existe una ruta directa.
  • Cualquiera de los extremos puede copiar o conservar el texto recibido.
  • Cada mensaje admite hasta 65.536 bytes UTF-8. Usa relayium send para contenido mayor.

Tu primera transferencia

Lo más rápido para probar es copiar una carpeta a una máquina que administres. Ejecuta allí un receptor de Relayium, autoriza a este remitente y transfiere directamente, sin cuenta:

  1. Comprueba que la CLI está en tu PATH. Imprime una versión, no «command not found».

    relayium version
  2. En el receptor, crea el directorio, autoriza la huella del remitente e inicia el receptor. authorize y serve deben usar el mismo --config-dir.

    mkdir -p ~/inbox && relayium authorize <sender-fingerprint> && relayium serve --dir ~/inbox
  3. Haz push de la carpeta a la dirección relayium:// del receptor.

    relayium push ./photos relayium://receiver.example
  4. En la máquina receptora, confirma que photos/ apareció bajo el --dir del receptor.

    find ~/inbox/photos -maxdepth 1 -type f

Cómo se ve una ejecución correcta

push imprime una línea por cada archivo completado y termina con 0 después de que el receptor verifica e instala el lote.

relayium push ./photos relayium://receiver.example
  photos/IMG_0413.jpg (2314518 bytes)
  photos/IMG_0414.jpg (1998233 bytes)
echo $?
# 0
  • push comprueba las colisiones del lote antes de enviar, verifica cada archivo por SHA-256 y lo coloca en un área temporal antes de instalarlo. No reanuda; usa relayium sync cuando una ejecución pueda interrumpirse.
  • El receptor debe ser alcanzable y haber autorizado ya la huella de este remitente.
  • Los destinos SSH, relayium pull, -i y -p están retirados. Para transferir en sentido contrario, ejecuta serve en esta máquina e inicia un nuevo push con daemon directo desde la otra.

Cuando el primer comando no funciona

Cuatro cosas salen mal en un primer intento más a menudo que todo lo demás junto. Ninguna exige adivinar: cada una tiene un comando cuya salida zanja la cuestión.

Síntoma, comprobación, solución

«relayium: command not found», justo después de que el script de instalación dijera que había terminado bien.
command -v relayium
# (no imprime nada)

El binario está instalado, pero su directorio no está en tu PATH. Las últimas líneas del script nombran el directorio que usó e imprimen la línea export PATH exacta que hay que añadir; ejecútala, abre un shell nuevo y prueba otra vez relayium version.

push muestra «SSH transfers are currently disabled».
relayium push ./photos <retired-ssh-destination>
# SSH transfers are currently disabled

El comando usa la forma de destino SSH retirada. Inicia relayium serve en el receptor y usa relayium://receiver en su lugar.

El receptor rechaza al remitente por no estar autorizado.
relayium id
# sha256:...

Ejecuta relayium authorize <sender-fingerprint> en el receptor con el mismo --config-dir que usa serve. Un receptor en marcha lee la nueva autorización en la siguiente conexión.

Dos máquinas entran en el mismo código y una imprime «the other side is running `relayium text`, not `relayium send`/`relayium receive`».
# sesión de mensajes: AMBOS extremos ejecutan text
relayium text
relayium text 483920

Los dos extremos ejecutaron comandos distintos. Para mensajes, relayium text en las dos máquinas; para archivos, relayium send en una y relayium receive en la otra. El desajuste se rechaza antes de intentar ninguna conexión, así que no se envió nada.

Gratis, y privado por diseño

No hay cargo por transferencia. push/sync con daemon directo mueve el contenido directamente entre tus dos máquinas, nunca por los servidores de Relayium, y no necesita cuenta. Con send / receive solo inicia sesión el lado que genera el código (el up en la nube también usa tu cuenta, para guardar el archivo). Siempre que el servidor emite un retransmisor para el código, cada byte pasa por ese retransmisor cifrado, como texto cifrado que no puede leer, y cuenta para la cuota mensual de tráfico de la cuenta que generó el código. Consumir una cuota es contabilizar el uso, no un cargo por transferencia.

Cada transferencia está cifrada de extremo a extremo, y cada archivo que transfiere una ejecución se verifica con un hash SHA-256 al llegar. La reanudación es más estrecha que el resto: relayium sync continúa un archivo parcial en una ejecución posterior, relayium down se reconecta y continúa dentro de la ejecución que lo inició, y push, send y receive no reanudan en absoluto. Funciona en macOS, Linux y Windows, y todo el proyecto es de código abierto y autoalojable.

Preguntas frecuentes

¿La CLI cuesta algo?

La CLI en sí es gratis y de código abierto, y push/sync con daemon directo no cuesta nada: esos bytes nunca pasan por los servidores de Relayium, así que no hay nada que medir. send / receive y text se contabilizan cuando se retransmiten: siempre que el servidor emite un retransmisor para el código, los bytes retransmitidos cuentan para la cuota mensual de tráfico de la cuenta que generó el código. También consumen tu plan up y down, que escriben y vuelven a leer una copia cifrada guardada en tu cuenta. up cuenta para cuatro límites distintos — tu franquicia mensual de tráfico, el límite de almacenamiento de lo que guardas a la vez, el periodo de retención máximo de tu plan y un límite de subida diario — y down cuenta para la franquicia de tráfico al leer la copia. Los planes de pago los amplían todos.

¿Necesito una cuenta de Relayium?

Para generar un código de emparejamiento con send, text o pair, para el up en la nube y para la Device Inbox. push/sync con daemon directo no requiere cuenta. El servidor solo genera códigos para una cuenta con sesión iniciada, así que quien lo crea ejecuta relayium login una vez. Unirse con un código recibido y usar receive no requiere iniciar sesión.

¿Qué sistemas operativos son compatibles?

Se publican binarios precompilados para macOS, Linux y Windows, tanto en x86-64 como en arm64. El script de instalación cubre macOS y Linux; en Windows, descarga el .zip desde la página de releases.

¿Mis archivos pasan por los servidores de Relayium?

No con push/sync con daemon directo: los bytes de los archivos viajan directamente entre tus dos máquinas. send / receive y text contactan con nuestros servidores para un pequeño handshake con el punto de encuentro, y siempre que el servidor emite un retransmisor TURN para el código, cada byte de la sesión pasa por ese retransmisor — como texto cifrado de extremo a extremo que no puede leer, contabilizado en la cuota mensual de tráfico de la cuenta que generó el código, y nunca guardado. up es distinto: sube una copia cifrada al almacenamiento de tu cuenta, que el servidor guarda pero no puede leer.

Instala la CLI de Relayium, gratis y de código abierto, y haz tu primera transferencia directa.

Obtener la CLI

Sigue leyendo