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.

Sea cual sea la forma en que la uses, los bytes de los archivos viajan directamente entre los dos extremos y nunca pasan por los servidores de Relayium. 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, pull o daemon directo. Solo generar un código de emparejamiento con send o text, y subir con up, 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 -o relayium ./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, pull, send y receive no reanudan en absoluto.

push / pull — a un servidor al que ya puedes entrar por SSH. Los bytes viajan por tu conexión SSH; sin cuenta de Relayium.
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.
send/receive y text del CLI de Relayium son P2P y direct-only: nunca retransmiten bytes de archivos o mensajes mediante TURN ni ningún otro servidor de Relayium. Si los dos extremos no pueden establecer una conexión directa, la sesión falla en vez de recurrir a un retransmisor.
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.
send/receive y text del CLI de Relayium son P2P y direct-only: nunca retransmiten bytes de archivos o mensajes mediante TURN ni ningún otro servidor de Relayium. Si los dos extremos no pueden establecer una conexión directa, la sesión falla en vez de recurrir a un retransmisor.
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 un servidor al que puedas entrar por SSH. Relayium usa tu acceso SSH existente, así que no hay nada que configurar en el remoto ni cuenta que crear:

Comprueba que la CLI está en tu PATH. Imprime una versión, no «command not found».
```
relayium version
```
Comprueba que ya llegas al servidor por la vía de siempre. push reutiliza exactamente ese acceso, así que un ssh correcto cumple el requisito de conexión y autenticación. No es una promesa sobre la transferencia en sí: push todavía necesita permiso de escritura y espacio libre en user@your-server:backups/.
```
ssh user@your-server true
```
Empuja la carpeta. El último argumento es host:path, y son los dos puntos lo que lo marca como remoto. La barra final significa «dentro de este directorio».
```
relayium push ./photos user@your-server:backups/
```
Comprueba que los archivos llegaron donde esperabas. push ./photos recrea photos/ bajo el destino, así que el nombre de la carpeta viaja con ellos.
```
ssh user@your-server ls backups/photos
```

Cómo se ve una ejecución correcta

Con relayium en el otro extremo, push imprime una línea por archivo terminado y sale con 0. Contra un servidor sin nada instalado imprime en su lugar el resumen del flujo tar: ambos son éxito.

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

Si relayium también está instalado en el remoto, push usa el protocolo nativo: se comprueba el lote en busca de colisiones antes de enviar un solo byte, y cada archivo se verifica por SHA-256 y se coloca en un área temporal antes de instalarlo. Aun así no reanuda: volver a lanzarlo tras una interrupción se rechaza, porque los archivos que llegaron ya existen. Usa relayium sync donde necesites eso.
push recurre a un simple flujo tar cuando relayium no está en el remoto, así que funciona incluso contra un servidor sin nada instalado — esa alternativa es solo para push.
Recupera los mismos archivos con: relayium pull user@your-server:backups/ ./restore — pull siempre necesita relayium en el remoto (no tiene alternativa con tar), así que instálalo allí primero.

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 termina de inmediato con «push destination must be remote (host:path)».

relayium push ./photos user@your-server backups/
# push destination must be remote (host:path)

Al destino le faltan los dos puntos, así que relayium lo leyó como una ruta local. Escríbelo al estilo de scp, sin espacio entre el host y la ruta: user@your-server:backups/

pull falla contra un servidor con el que push funcionaba sin problemas.

ssh user@your-server command -v relayium
# (no imprime nada)

pull no tiene alternativa con tar, porque en ese sentido el remoto es quien envía: necesita relayium instalado allí. Instálalo en el servidor con el mismo comando de una línea y repite el pull.

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 nada que pagar. De las tres formas de arriba, el único inicio de sesión es el de quien envía en modo send / receive, para que su CLI pueda generar un código de emparejamiento (el up en la nube también usa tu cuenta, para guardar el archivo). La CLI conecta los dos extremos directamente, así que tus archivos nunca se suben a un servidor intermedio — lo único que toca a Relayium en algún momento es un diminuto handshake con el punto de encuentro en el modo send / receive, usado para presentar a los dos extremos, nunca el archivo en sí.

Cada transferencia está cifrada de extremo a extremo, y en el protocolo nativo cada archivo que transfiere una ejecución se verifica con un hash SHA-256 al llegar — la excepción es la alternativa con tar sin dependencias, que no verifica nada archivo por archivo. 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, pull, 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?

No. La CLI es completamente gratis. Los bytes de archivos y texto transferidos directamente nunca pasan por un retransmisor de Relayium, así que no hay nada que medir ni pagar.

¿Necesito una cuenta de Relayium?

Para generar un código de emparejamiento con send o text, y para el up en la nube. push / pull y daemon directo no requieren 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. En todos los modos, los bytes de los archivos viajan directamente entre los dos extremos. Solo send / receive contacta con nuestros servidores, y únicamente para un pequeño handshake con el punto de encuentro — nunca el contenido del archivo.

Instala la CLI de Relayium y haz tu primera transferencia — completamente gratis.

Obtener la CLI