Enviar um arquivo para alguém entre redes com a CLI do Relayium

Última atualização: 2026-07-12

Às vezes a outra máquina não é sua e você não consegue entrar por SSH: um arquivo para um colega em outro escritório, um build para um cliente, um arquivo compactado para um amigo do outro lado do país. relayium send e receive o movem diretamente entre as duas partes, entre redes, usando apenas um código de emparelhamento curto que a sua CLI gera na hora de enviar.

A conexão é ponto a ponto e com criptografia de ponta a ponta. Apenas um pequeníssimo handshake de encontro passa pelo Relayium para apresentar as duas pontas; os bytes do arquivo nunca passam.

Antes de começar

Tudo abaixo é a CLI do relayium, então instale-a primeiro se ainda não tiver. No macOS ou Linux, um comando coloca um binário pré-compilado no seu PATH:

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

Prefere escolher o arquivo você mesmo, ou está no Windows? Pegue um binário na página de releases — relayium.com/cli lista todas as opções de instalação (ou go build -o relayium ./cmd/relayium se você tiver Go).
relayium --version confirma que está instalada. Pule isso e os comandos abaixo só imprimirão “command not found”.

Envie e depois repasse o código que aparece

Faça login uma vez com relayium login e depois é só enviar. A CLI gera um código de emparelhamento, exibe-o junto com o comando exato que a outra ponta executa, e fica aguardando. Repasse esse código fora de banda: diga em uma chamada, coloque em um chat:

# quem envia (uma vez por máquina: relayium login)
relayium send ./release.zip
# imprime:  Code: K7M4XR   (valid 5 minutes)
#          On the other machine:  relayium receive K7M4XR

# quem recebe (na pasta onde os arquivos devem chegar) — sem conta
relayium receive K7M4XR

O código tem 6 caracteres de um alfabeto restrito — sem 0 nem 1, e sem nada que se confunda ao ser lido em voz alta — e expira 5 minutos depois de gerado.
Só quem envia faz login. Quem recebe precisa da CLI e do código, e de conta nenhuma.
O código é apenas um segredo compartilhado para se encontrar; não é enviado a ninguém além do ponto de encontro, e serve apenas para apresentar as duas pontas.
O receptor pode indicar um diretório de destino: relayium receive K7M4XR ./downloads
As duas pontas precisam ser a CLI — um navegador não consegue entrar em um código de emparelhamento da CLI. Vai enviar para alguém que só tem navegador? Use relayium up, que devolve um link de download.

Verificar com o código SAS

Quando as duas pontas se conectam, os dois terminais exibem o mesmo SAS (short authentication string) de 6 dígitos derivado das chaves de sessão. Compare-os — leia em voz alta durante a chamada — para ter certeza de que as duas pontas estão conectadas uma à outra e não a alguém no meio.

Para uma garantia firme, adicione --verify: a transferência então espera que você confirme que os códigos coincidem antes que um único byte se mova.

relayium send --verify ./release.zip

Somente direto: gratuito, ou falha

A transferência disputa o estabelecimento de uma conexão direta entre as duas pontas. Quando ela pode ser estabelecida — o caso comum quando pelo menos um lado tem um endereço alcançável — o arquivo flui direto, criptografado, na velocidade máxima e sem custo.

Se ambas as pontas estiverem atrás de um NAT estrito e nenhum caminho direto puder ser encontrado, a transferência falha de forma limpa em vez de rotear seu arquivo por um retransmissor. Isso mantém a CLI completamente gratuita e mantém os bytes do seu arquivo fora dos nossos servidores. Se você se deparar com isso, a resposta confiável é daemon direto entre dois servidores alcançáveis, ou push por SSH.

A conexão direta é bem-sucedida → gratuita, na velocidade máxima, com criptografia de ponta a ponta.
Sem caminho direto → a transferência falha; a CLI nunca faz proxy do arquivo por você.
Ambas as pontas podem estar em qualquer lugar geograficamente — quem envia só roda send, e quem recebe roda receive com o código que apareceu.

Perguntas frequentes

De onde vem o código de emparelhamento?

Quem gera é o Relayium. Rode `relayium send ./release.zip` (depois de `relayium login`) e a CLI exibe um código de 6 caracteres válido por cinco minutos, junto com o comando exato que a outra ponta executa. Você não pode escolhê-lo — o servidor só aceita os códigos que ele mesmo emitiu.

O arquivo é enviado para algum lugar?

Não. O arquivo flui diretamente entre as duas partes, com criptografia de ponta a ponta. Apenas um pequeno handshake de encontro passa pelo Relayium para apresentar as pontas — nunca o arquivo.

E se não conseguirmos conectar?

Se ambas as pontas estiverem atrás de um NAT estrito sem endereço alcançável, a conexão direta não pode ser feita e a transferência falha — a CLI não tem retorno por retransmissor, por decisão de projeto. Use daemon direto entre dois servidores alcançáveis, ou push por SSH, quando não houver um caminho direto disponível.

Como sei que é mesmo a pessoa certa do outro lado?

Os dois terminais exibem um código SAS idêntico de 6 dígitos a partir das chaves de sessão. Compare-os fora de banda; se coincidirem, não há ninguém no meio. Adicione --verify para exigir essa confirmação antes que qualquer byte se mova.

Envie seu próximo arquivo diretamente para alguém em outra rede — com criptografia de ponta a ponta e gratuito.

Obter a CLI