Recibir archivos desde la línea de comandos

Tres formas de recibir, y cuándo aplica cada una

Qué comando ejecutas depende de quién inicia la transferencia y de cómo se conocen las dos máquinas:

• relayium receive <code> [destdir] — alguien te envía entre redes usando un código de emparejamiento que generó (con la CLI, una app de Relayium o la página web) y te comunicó fuera de banda. Cifrado de extremo a extremo, retransmitido siempre que el servidor emite un retransmisor para el código, con un código SAS que puedes comparar.
• relayium serve [--dir D] [--port N] [--once] [--allow-delete] — esta máquina escucha envíos en daemon directo por relayium://, en el puerto 9031 por defecto.
• relayium down <link> [destdir] — descargar y descifrar un enlace almacenado; no hace falta cuenta para descargar (el antiguo relayium pull por SSH está retirado).

receive: alguien te envía un archivo entre redes

Esta es la mitad receptora de relayium send. La otra persona ejecuta relayium send <path> en su extremo (tras relayium login); su CLI genera un código de 6 dígitos, válido 5 minutos, y lo imprime. Te dice cuál es por cualquier canal en el que ambos confíen — una llamada, un mensaje de chat. Tú ejecutas receive con ese código:

relayium receive 483920

# o dentro de un directorio concreto
relayium receive 483920 ./downloads

1. Acuerda con el emisor cuándo va a ejecutar send. El código empieza a caducar en cuanto se acuña, no cuando te llega.

2. Recibe los seis dígitos por un canal en el que ambos confiéis: una llamada, una ventana de chat, la habitación en la que estáis.

3. Ejecuta receive desde el directorio donde deban caer los archivos, o nombra uno explícitamente.

   relayium receive 483920

   relayium receive 483920 ./downloads

4. Cuando ambos terminales impriman un código de verificación, lee el tuyo en voz alta y comprueba que coincide con el suyo. No es el código de emparejamiento, y es lo único que descarta un extremo suplantado.

5. No toques el terminal hasta que vuelva al prompt. Es una sola sesión en vivo: cerrar cualquiera de los dos extremos detiene la transferencia.

$ relayium receive 483920
verification code (SAS): 271044 — not the pairing code; compare it on both ends to rule out a substituted endpoint
path: direct

• La conexión está cifrada de extremo a extremo; una vez conectados, ambos extremos muestran el mismo SAS (short authentication string). Compáralo fuera de banda con el remitente para confirmar que las huellas de los certificados TLS fijados no fueron sustituidas y que el servicio de encuentro no suplantó a ninguno. El SAS autentica los extremos; no prueba cada salto de la ruta de red.
• Sin destino indicado: los archivos caen en el directorio actual.
• La misma regla de retransmisión que send: 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 —la del remitente, nunca la tuya—. Solo sin retransmisor los dos extremos se conectan de igual a igual, y entonces la transferencia falla si no existe una ruta directa.
• El código es el mismo código de emparejamiento que usan las apps y la página web: alguien que envía desde relayium.com o una app de Relayium puede leerte un código que recibes aquí, y a un código generado por relayium send se puede unir desde la página web en lugar de la CLI.
• El receptor nunca necesita una cuenta, en ninguna red. Solo el remitente inicia sesión, para que su CLI pueda generar el código.

serve: convierte esta máquina en un buzón a la escucha

serve funciona al revés: en lugar de que seas tú quien va a buscar, otras máquinas te envían directamente por relayium:// — pensado para máquinas en las que ya confías, como tu propio portátil enviando a un NAS, o un servidor de compilación dejando artefactos en una máquina que es tuya — por una conexión TLS 1.3 con anclaje, sin SSH, sin punto de encuentro.

relayium serve

# un directorio y un puerto concretos, permitiendo peticiones de borrado
relayium serve --dir ~/incoming --port 9031 --allow-delete

1. Arranca el receptor nombrando el directorio donde deben caer los envíos.

   relayium serve --dir ~/incoming

2. Cuando una máquina nueva empuja por primera vez, serve muestra su dirección y su huella y te pregunta. Apruébala una vez y los envíos posteriores de esa huella pasan en silencio.

3. Si este receptor va a funcionar sin terminal, no cuentes con esa pregunta: no hay nadie para responderla y un emisor desconocido se rechaza sin más. Usa la autorización previa de la sección siguiente.

• La primera vez que una máquina nueva te envía algo, serve (ejecutándose en un terminal) muestra su dirección y su huella y te pide que la apruebes una vez; después, los envíos de la misma huella pasan en silencio.
• Sin terminal — un servicio systemd, un script sin TTY — no hay a quién preguntar, así que un emisor no reconocido se rechaza de plano. En su lugar, autorízalo por adelantado usando la huella que el emisor imprime con relayium id:

Autorizar por adelantado para un serve desatendido

Para un serve que corre desatendido (systemd, un script en segundo plano), haz que el emisor ejecute relayium id para imprimir su huella, y luego apruébala de antemano desde el lado receptor:

relayium authorize <fingerprint>

• --dir fija dónde caen los archivos (por defecto el directorio actual); --once acepta una única transferencia y sale; --allow-delete deja que una petición --delete (espejo) entrante realmente elimine archivos aquí, y está desactivado por defecto.
• --config-dir (por defecto ~/.config/relayium) es donde viven la identidad de este host y su lista de huellas autorizadas — anúlalo si ejecutas serve como un servicio dedicado.

pull (SSH): retirado

Nota histórica: esta sección describía las transferencias SSH de Relayium: push o sync a un destino user@host:path, relayium pull y las opciones -i y -p. El CLI actual las ha retirado y las rechaza con «SSH transfers are currently disabled», así que los comandos que había aquí ya no funcionan y no se muestran. Entre dos máquinas que administres, usa relayium serve con push o sync a relayium://host; las versiones mantenidas en inglés y en chino simplificado de esta página, enlazadas arriba, describen los pasos actuales.

Para traer algo de un servidor que administras, súbelo desde el servidor con relayium up y ejecuta aquí relayium down con el enlace, o ejecuta relayium serve en esta máquina y haz que el servidor haga push a relayium://este-host.

relayium down '<complete-link-with-#k-fragment>' ./local-dest

Cuando no funciona

Cinco fallos cubren casi todas las recepciones fallidas. Qué orden estabas ejecutando decide cuál aplica, y cada uno se zanja con una línea que leer o una orden que ejecutar.