Receber arquivos pela linha de comando

Três formas de receber, e quando cada uma se aplica

Qual comando você executa depende de quem inicia a transferência e de como as duas máquinas se conhecem:

• relayium receive <code> [destdir] — alguém envia para você entre redes usando um código de pareamento que gerou (com a CLI, um app do Relayium ou a página web) e repassou a você fora de banda. Com criptografia de ponta a ponta, retransmitido sempre que o servidor emite um retransmissor para o código, com um código SAS que você pode comparar.
• relayium serve [--dir D] [--port N] [--once] [--allow-delete] — esta máquina fica à escuta de envios em daemon direto por relayium://, na porta 9031 por padrão.
• relayium down <link> [destdir] — buscar e descriptografar um link armazenado; não é preciso conta para baixar (o antigo relayium pull por SSH foi descontinuado).

receive: alguém envia um arquivo para você entre redes

Esta é a metade receptora do relayium send. A outra pessoa executa relayium send <path> do lado dela (depois de relayium login); a CLI dela gera um código de 6 dígitos, válido por 5 minutos, e o exibe. Ela te diz qual é por qualquer canal em que ambos confiem — uma ligação, uma mensagem de chat. Você executa receive com esse código:

relayium receive 483920

# ou para um diretório específico
relayium receive 483920 ./downloads

1. Combine com o remetente quando ele vai rodar o send. O código começa a expirar assim que é gerado, não quando chega até você.

2. Receba os seis dígitos por um canal em que os dois lados confiem — uma ligação, uma janela de conversa, a sala em que estão.

3. Rode o receive no diretório onde os arquivos devem cair, ou nomeie um explicitamente.

   relayium receive 483920

   relayium receive 483920 ./downloads

4. Quando os dois terminais imprimirem um código de verificação, leia o seu em voz alta e confirme que bate com o dele. Ele não é o código de emparelhamento, e é a única coisa que descarta uma ponta trocada.

5. Não mexa no terminal até ele voltar ao prompt. É uma única sessão ao vivo: fechar qualquer uma das pontas interrompe a transferência.

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

• A conexão tem criptografia de ponta a ponta; depois de conectadas, as duas pontas mostram o mesmo SAS (short authentication string). Compare-o fora de banda com quem enviou para confirmar que as impressões digitais dos certificados TLS fixados não foram substituídas e que o serviço de encontro não se passou por nenhuma delas. O SAS autentica as pontas; não prova cada salto da rota de rede.
• Sem destino indicado: os arquivos caem no diretório atual.
• A mesma regra de retransmissão do send: sempre que o servidor emite um retransmissor para o código, cada byte passa por esse retransmissor criptografado e conta para a cota mensal de tráfego da conta que gerou o código — a de quem enviou, nunca a sua. Só sem retransmissor as duas pontas se conectam ponto a ponto, e então a transferência falha se não houver um caminho direto.
• O código é o mesmo código de pareamento que os apps e a página web usam: alguém enviando pelo relayium.com ou por um app do Relayium pode ler para você um código que você recebe aqui, e um código gerado pelo relayium send pode ser acessado pela página web em vez da CLI.
• O receptor nunca precisa de conta, em nenhuma rede. Só quem envia faz login, para que a CLI dele possa gerar o código.

serve: transforme esta máquina em uma caixa de entrada à escuta

serve funciona ao contrário: em vez de você ir buscar, outras máquinas enviam diretamente para você por relayium:// — feito para máquinas em que você já confia, como seu próprio notebook enviando para um NAS, ou um servidor de compilação despejando artefatos em uma máquina que é sua — por uma conexão TLS 1.3 com fixação, sem SSH, sem encontro.

relayium serve

# um diretório e uma porta específicos, permitindo requisições de exclusão
relayium serve --dir ~/incoming --port 9031 --allow-delete

1. Inicie o receptor nomeando o diretório onde os envios devem cair.

   relayium serve --dir ~/incoming

2. Quando uma máquina nova empurra pela primeira vez, o serve mostra o endereço e a impressão digital dela e pergunta. Aprove uma vez e os envios seguintes daquela impressão passam em silêncio.

3. Se este receptor for rodar sem terminal, não conte com essa pergunta: não há ninguém para responder, e um remetente desconhecido é recusado de cara. Use a autorização prévia descrita na próxima seção.

• Na primeira vez que uma máquina nova envia para você, o serve (rodando em um terminal) mostra o endereço e a impressão digital dela e pede que você a aprove uma vez; depois disso, os envios da mesma impressão digital passam silenciosamente.
• Sem terminal — um serviço systemd, um script sem TTY — não há a quem perguntar, então um emissor não reconhecido é rejeitado de imediato. Em vez disso, autorize-o com antecedência usando a impressão digital que o emissor imprime com relayium id:

Autorizar com antecedência para um serve desassistido

Para um serve que roda desassistido (systemd, um script em segundo plano), faça o emissor executar relayium id para imprimir sua impressão digital, e então aprove-a de antemão do lado receptor:

relayium authorize <fingerprint>

• --dir define onde os arquivos caem (padrão o diretório atual); --once aceita uma única transferência e sai; --allow-delete permite que uma requisição --delete (espelho) recebida realmente remova arquivos aqui, e está desligado por padrão.
• --config-dir (padrão ~/.config/relayium) é onde ficam a identidade deste host e sua lista de impressões digitais autorizadas — substitua-o se você executa serve como um serviço dedicado.

pull (SSH): descontinuado

Nota histórica: esta seção descrevia as transferências por SSH do Relayium — push ou sync para um destino user@host:path, relayium pull e as opções -i e -p. A CLI atual as descontinuou e as recusa com “SSH transfers are currently disabled”, então os comandos que estavam aqui não funcionam mais e não são mostrados. Entre duas máquinas que você administra, use relayium serve com push ou sync para relayium://host; as versões mantidas em inglês e chinês simplificado desta página, com links no topo, descrevem os passos atuais.

Para trazer algo de um servidor que você administra, envie-o do servidor com relayium up e rode aqui relayium down com o link — ou rode relayium serve nesta máquina e faça o servidor dar push para relayium://este-host.

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

Quando não funciona

Cinco falhas cobrem quase todo recebimento malsucedido. O comando que você estava rodando decide qual delas se aplica, e cada uma se resolve com uma linha para ler ou um comando para rodar.