Enviar un archivo a alguien entre redes con la CLI de Relayium

Antes de empezar

Todo lo de abajo es la CLI de relayium, así que instálala primero si aún no la tienes. En macOS o Linux, un solo comando deja un binario precompilado en tu PATH:

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

• ¿Prefieres elegir el archivo tú mismo, o estás en Windows? Coge un binario de la página de releases — relayium.com/cli lista todas las opciones de instalación (o go build ./cmd/relayium si tienes Go).
• relayium --version confirma que está instalada. Sáltate esto y los comandos de abajo solo imprimirán « command not found ».

Envía y luego pasa el código que imprime

Inicia sesión una vez con relayium login y después solo envía. La CLI genera un código de emparejamiento, lo imprime junto con el comando exacto que ejecuta el otro extremo, y espera. Pasa ese código fuera de banda: dilo en una llamada, escríbelo en un chat:

1. En la máquina que envía, inicia sesión una sola vez. Sáltate este paso si relayium whoami ya imprime el correo de tu cuenta.

   relayium login

2. Desde el directorio donde está el archivo, lanza el envío. La CLI genera el código, imprime el comando para el otro extremo y luego espera.

   relayium send ./release.zip

3. Dicta fuera de banda los seis dígitos que ha impreso. Dejan de funcionar cinco minutos después de generarse.

4. En la máquina receptora, dentro del directorio donde deben llegar los archivos, ejecuta el comando que se le mostró al remitente. Añade un directorio para dejarlos en otro sitio.

   relayium receive 483920

   relayium receive 483920 ./downloads

5. Deja los dos terminales abiertos hasta que el shell receptor vuelva a su prompt. Es una única sesión en vivo: cerrar cualquiera de los extremos detiene la transferencia.

# en la máquina que ENVÍA
Code: 483920   (valid 5 minutes)
On the other machine:  relayium receive 483920
  not installed there?  curl -fsSL https://relayium.com/install.sh | sh
waiting for the receiver…
verification code (SAS): 271044 — not the pairing code; compare it on both ends to rule out a substituted endpoint
path: direct

• El código tiene 6 dígitos decimales —cualquiera de 0 a 9, ceros iniciales incluidos— y caduca 5 minutos después de generarse.
• El código es solo un secreto compartido para encontrarse; no se envía a nadie más que al punto de encuentro, y solo sirve para presentar los dos extremos.
• El otro extremo no tiene que ser la CLI: relayium receive, relayium pair, una app de Relayium o la página web pueden unirse al código. ¿La otra persona no está conectada ahora? Usa relayium up para obtener un enlace de descarga.

Verificar con el código SAS

Cuando los dos extremos se conectan, ambas terminales muestran el mismo SAS (short authentication string) de 6 dígitos derivado de las huellas de sus certificados TLS fijados. Compáralo fuera de banda —léelo en voz alta durante la llamada— para confirmar que las huellas no fueron sustituidas y que el servicio de encuentro no suplantó a ninguno de los extremos. El SAS autentica los extremos; no demuestra cada salto de la ruta de red.

Para obtener la protección más fuerte, añade --verify: la transferencia esperará a que confirmes que los códigos coinciden antes de que se mueva un solo byte.

relayium send --verify ./release.zip

Retransmisor o de igual a igual, y a qué cuenta

La línea path te dice por dónde fueron los bytes: relay, o direct / lan para de igual a igual. En ambos casos el archivo va cifrado de extremo a extremo y no hay cargo por transferencia: los bytes retransmitidos se contabilizan como uso en la cuota mensual de tráfico de la cuenta que generó el código.

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.

Si una transferencia no logra conectar, las respuestas fiables son un enlace almacenado creado con relayium up, o relayium serve con push / sync entre dos servidores alcanzables que administres; esa ruta es directa y no se contabiliza.

• Retransmisor emitido → cada byte pasa por el retransmisor cifrado y cuenta para la cuota mensual de tráfico de la cuenta que generó el código.
• Sin retransmisor → los dos extremos se conectan de igual a igual si existe una ruta directa; si no, la sesión falla.

Cuando no funciona

Cuatro fallos explican casi todos los intentos fallidos. Cada uno tiene una línea que leer o un comando que ejecutar que lo decide, así que nunca hay que adivinar qué extremo tiene el problema.