Transfira arquivos e texto pelo terminal com a CLI do Relayium

Instale com um único comando

No macOS ou no Linux, um comando baixa um binário pré-compilado para o seu sistema operacional e o coloca no seu PATH:

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

• Prefere escolher o arquivo você mesmo? Baixe um binário na página de releases.
• Tem o Go instalado? Clone o repositório e execute: go build ./cmd/relayium (a partir do diretório server).
• Depois execute relayium --help para ver todos os comandos, e relayium version para conferir o build.

As três formas de mover arquivos

O Relayium move arquivos de três formas. Você escolhe pela localização da outra ponta, não aprendendo três ferramentas diferentes — todas compartilham um único motor de transferência, que verifica cada arquivo que move com um hash SHA-256. O que elas não compartilham é a retomada: o sync é o modo que continua um arquivo parcial em uma execução posterior, e push, send e receive não retomam nada.

• up / down (nuvem) — a outra ponta pode estar offline. O up criptografa nesta máquina, envia só o texto cifrado para a sua conta e mostra um link; o down busca e descriptografa em outra máquina com esse link. O push / pull por SSH que aparecia aqui foi descontinuado.
• send / receive — para outra pessoa entre redes, usando um código de emparelhamento curto que a CLI de quem envia gera (faça login uma vez com relayium login; quem recebe, nunca). Um código emitido vale cinco minutos, então rode o comando na máquina que recebe dentro desse prazo.
• As sessões com código de pareamento da CLI do Relayium (send / receive, text e pair) enviam cada byte por um retransmissor TURN criptografado sempre que o servidor emite um para o código — mesmo quando as duas pontas poderiam se conectar diretamente —, e esses bytes retransmitidos contam para a cota mensal de tráfego da conta que gerou o código; o retransmissor só transporta texto cifrado que não consegue ler. Só quando nenhum retransmissor é emitido (nenhum está configurado ou essa cota se esgotou) as duas pontas se conectam ponto a ponto (P2P), e então a sessão falha se não houver um caminho direto.
• serve + push relayium:// (daemon direto) — direto entre dois servidores que você possui, sobre TLS com fixação. Sem retransmissor, sem SSH, sem código.

Enviar texto efêmero

Execute relayium text em uma máquina para gerar um código de emparelhamento e entre na outra com o código exibido:

relayium text

relayium text 483920

• Gerar o código requer relayium login; entrar com um código não requer login.
• As duas máquinas precisam ficar online. As mensagens têm criptografia de ponta a ponta, e os servidores da Relayium não armazenam seu conteúdo.
• As sessões com código de pareamento da CLI do Relayium (send / receive, text e pair) enviam cada byte por um retransmissor TURN criptografado sempre que o servidor emite um para o código — mesmo quando as duas pontas poderiam se conectar diretamente —, e esses bytes retransmitidos contam para a cota mensal de tráfego da conta que gerou o código; o retransmissor só transporta texto cifrado que não consegue ler. Só quando nenhum retransmissor é emitido (nenhum está configurado ou essa cota se esgotou) as duas pontas se conectam ponto a ponto (P2P), e então a sessão falha se não houver um caminho direto.
• Qualquer ponta ainda pode copiar ou guardar o texto recebido.
• Cada mensagem pode ter até 65.536 bytes UTF-8. Use relayium send para conteúdo maior.

Sua primeira transferência

O mais rápido para experimentar é copiar uma pasta para uma máquina que você administra. Rode lá um receptor do Relayium, autorize este remetente e transfira diretamente, sem conta:

1. Confira se a CLI está no seu PATH. Ela imprime uma versão, não “command not found”.

   relayium version

2. No destino, crie o diretório, autorize a impressão digital do remetente e inicie o receptor. authorize e serve precisam usar o mesmo --config-dir.

   mkdir -p ~/inbox && relayium authorize <sender-fingerprint> && relayium serve --dir ~/inbox

3. Faça push da pasta para o endereço relayium:// do receptor.

   relayium push ./photos relayium://receiver.example

4. Na máquina de destino, confirme que photos/ apareceu sob o --dir do receptor.

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

relayium push ./photos relayium://receiver.example
  photos/IMG_0413.jpg (2314518 bytes)
  photos/IMG_0414.jpg (1998233 bytes)
echo $?
# 0

• O push checa colisões no lote antes de enviar, verifica cada arquivo por SHA-256 e o prepara em área temporária antes de instalá-lo. Ele não retoma; use o relayium sync quando uma execução puder ser interrompida.
• O receptor precisa estar acessível e já ter autorizado a impressão digital deste remetente.
• Destinos SSH, relayium pull, -i e -p foram descontinuados. Para transferir no sentido contrário, rode serve nesta máquina e inicie um novo push com daemon direto a partir da outra.

Quando o primeiro comando não passa

Quatro coisas dão errado numa primeira tentativa mais do que todo o resto somado. Nenhuma exige adivinhação: cada uma tem um comando cuja saída resolve a questão.

Gratuito, e privado por decisão de projeto

Não há cobrança por transferência. O push/sync com daemon direto move o conteúdo diretamente entre as suas duas máquinas, nunca pelos servidores do Relayium, e não precisa de conta. No send / receive, só o lado que gera o código faz login (o up na nuvem também usa a sua conta, para guardar o arquivo). Sempre que o servidor emite um retransmissor para o código, cada byte passa por esse retransmissor criptografado, como texto cifrado que ele não consegue ler, e conta para a cota mensal de tráfego da conta que gerou o código. Consumir uma cota é contabilizar o uso, não uma cobrança por transferência.

Cada transferência é criptografada de ponta a ponta, e cada arquivo que uma execução transfere é verificado com um hash SHA-256 na chegada. A retomada é mais estreita que o resto: o relayium sync continua um arquivo parcial em uma execução posterior, o relayium down reconecta e continua dentro da execução que o iniciou, e push, send e receive não retomam nada. Ela roda no macOS, no Linux e no Windows, e o projeto inteiro é de código aberto e auto-hospedável.