Suba arquivos para a nuvem e os pegue em outro computador

Última atualização: 2026-09-01

Às vezes os dois computadores nunca estão ligados ao mesmo tempo. Você quer soltar um arquivo do notebook do trabalho hoje à noite e pegá-lo no desktop de casa amanhã, sem ninguém esperando uma conexão ao vivo. relayium up e relayium down fazem exatamente isso: o up criptografa e envia para a sua conta, e o down o busca e o descriptografa depois em qualquer máquina — sem handshake ponto a ponto, sem um servidor no qual os dois entrem por ssh.

Esta é a principal parte da CLI que usa a sua conta do Relayium, ao lado do send, que precisa dela para gerar um código de emparelhamento. Para o resto a vinculação é opcional: push/pull, daemon direto e sync continuam funcionando sem login, e o receive também. Baixar não precisa de conta alguma, apenas do link.

Quando recorrer a isso

Escolha o modo conforme a outra ponta esteja online e como as duas máquinas se alcançam:

up / down (este guia) — as duas máquinas nunca estão online juntas. Você envia agora; você (ou outra máquina) baixa depois. Passa pela sua conta.
send / receive — as duas pontas estão online agora e querem uma transferência ponto a ponto direta com um código de uso único.
push / pull — você já consegue entrar por ssh na máquina remota.
Os que pedem relayium login são o up e o send — o up para guardar o arquivo sob a sua conta, o send apenas quando precisa gerar um código de emparelhamento (com um código que lhe deram, nenhum). O down, o receive, push/pull, daemon direto e sync não precisam de conta.

Antes de começar

O que você precisa

Instale a CLI para que o comando relayium exista. A linha abaixo coloca um binário pré-compilado no seu PATH (macOS e Linux; no Windows, pegue o .zip na página de releases); relayium --version confirma, e relayium.com/cli lista todas as opções de instalação. Pule isso e o relayium login só imprimirá “command not found”.
Tenha uma conta gratuita do Relayium. O passo do navegador aprova o login contra a sua conta, então você precisa de uma antes de poder aprovar — faça login em relayium.com primeiro, ou crie uma lá se ainda não tiver. Só o envio precisa da conta; baixar nunca.
Um jeito de levar um link até a outra máquina: um app de notas, uma janela de chat, um gerenciador de senhas. Qualquer um com o link consegue baixar o arquivo, então trate-o como uma senha.

Duas coisas para fazer uma vez só antes do seu primeiro up — instalar a CLI e ter uma conta. Já tem as duas? Pule adiante.

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

Vincule esta máquina à sua conta (uma vez)

O up precisa saber sob qual conta armazenar, então faça login uma vez por máquina. É um login de dispositivo aprovado no navegador — nada é digitado no terminal além do código que você confirma:

relayium login

A CLI imprime um código curto e uma URL (relayium.com/device). Abra-a no navegador em que você está logado no relayium.com (faça login lá primeiro se não estiver), digite o código e aprove — esta máquina está agora vinculada.
O login é salvo em ~/.config/relayium/, então você só faz isso uma vez por máquina. relayium whoami mostra a quem você está vinculado; relayium logout o apaga.
Para revogar uma máquina mais tarde, exclua o dispositivo dela na página de dispositivos da sua conta no navegador.

Envie a partir do primeiro computador

O up percorre os arquivos que você passa, criptografa-os localmente, envia o texto cifrado e imprime um link de retirada:

Confirme que esta máquina continua vinculada à sua conta. Ela imprime a conta e o servidor a que está vinculada; se disser que você não está logado, faça antes o passo de login acima.
```
relayium whoami
```
Envie o arquivo. O up o criptografa localmente, manda só texto cifrado e imprime o link de retirada na saída padrão.
```
relayium up ./report.pdf
```

Acrescente uma opção de retenção se o padrão de 24 horas não servir. O seu plano limita quanto tempo o servidor de fato vai guardar.

# escolha quanto tempo ele vive (padrão: 24 horas):
relayium up ./report.pdf --burn              # apagado após um download
relayium up ./report.pdf --ttl 7d            # guardado por 7 dias (seu plano define o teto)
relayium up ./report.pdf --max-downloads 5   # 5 downloads permitidos, depois some

Leve o link para onde a segunda máquina consiga lê-lo. Só o link vai para a saída padrão, então um pipe fica limpo.
```
relayium up ./report.pdf | pbcopy
```

Como é um envio bem-sucedido

Durante o envio corre uma barra de progresso na saída de erro, que depois some. O link aparece sozinho na saída padrão, e a dica para humanos — mais qualquer aviso de retenção — vem em seguida na saída de erro.

relayium up ./report.pdf
https://relayium.com/d/7fK2p…#k=Xr8s…
opens in a browser, or fetch it with `relayium down 'https://relayium.com/d/7fK2p…#k=Xr8s…'`

Retenção: --burn remove o arquivo após um único download; --ttl <duração> o mantém por um tempo fixo; --max-downloads <n> permite um número fixo de downloads. Não informe nenhum dos três e o link vive 24 horas — o padrão quando --ttl está ausente.
O --ttl aceita uma duração com unidade — 30m, 12h, 7d, 2w — ou um simples número de segundos, então --ttl 3600 e --ttl 1h são o mesmo pedido. O seu plano define o teto: 1 dia no Free, 3 dias no Plus, 7 dias no Pro, 14 dias no Max. Peça mais do que o seu teto e o servidor o guarda em silêncio apenas até o teto — o up imprime depois um aviso dizendo por quanto tempo ele realmente ficou guardado.

Baixe no segundo computador

Na outra máquina, passe o link para o down. Sem login, sem configuração — a chave que descriptografa o arquivo está dentro do link, então o down não precisa de nada da sua conta:

Seu link de compartilhamentoSalvar em (cole a saída do seu pwd)

relayium down '<seu link>' <diretório de destino>

Leve o link até a segunda máquina do jeito que preferir. Ali não é preciso instalar nem logar em nada além da própria CLI.
Passe-o para o down entre aspas simples, junto com o diretório onde os arquivos devem chegar.
```
relayium down 'https://relayium.com/d/7fK2p…#k=Xr8s…' ./downloads
```

Omita o diretório para cair no atual.

relayium down 'https://relayium.com/d/7fK2p…#k=Xr8s…'

Como é um download bem-sucedido

Cada arquivo escrito é listado na saída padrão, um por linha, e a contagem e o destino são confirmados na saída de erro.

relayium down 'https://relayium.com/d/7fK2p…#k=Xr8s…' ./downloads
downloads/report.pdf
✓ downloaded 1 file(s) to ./downloads

Se o arquivo foi definido para queima, atingiu seu limite de downloads ou expirou, o link está esgotado e o down informa que ele não existe mais.

Funciona com o site também

O link é o mesmo que o site usa, então a CLI e o navegador interoperam livremente:

Um link do relayium up abre em um navegador — passe-o para alguém que não tem a CLI e a pessoa baixa pela web.
Um link de compartilhamento criado no relayium.com pode ser buscado com relayium down em outra máquina.

O que o servidor pode e não pode ver

As transferências na nuvem permanecem criptografadas de ponta a ponta:

Seu arquivo é criptografado na sua máquina antes de ser enviado. A chave de descriptografia vive apenas no fragmento #k= do link e nunca é enviada ao servidor — o Relayium armazena texto cifrado que não consegue ler, incluindo os nomes dos arquivos.
Isso também significa que o link é o único caminho de volta ao arquivo: perca-o e o arquivo fica irrecuperável, por você ou por nós.

Quando um link não funciona

Quatro falhas cobrem quase todo up ou down malsucedido, e nenhuma exige adivinhação: o estado que decide é impresso por um comando ou está visível no comando que você digitou.

Sintoma, verificação, correção

O up recusa com “run relayium login first”.

relayium whoami
# not logged in (run `relayium login`)

Enviar guarda o arquivo sob a sua conta, então esta máquina precisa de credenciais. Rode relayium login e aprove no navegador em relayium.com/device; depois disso o whoami imprime sua conta e o servidor a que está vinculada.

O down não consegue ler o link, e a chave parece ter sumido.

echo relayium down https://relayium.com/d/7fK2p#k=Xr8s
# relayium down https://relayium.com/d/7fK2p

Um # sem aspas começa um comentário na maioria dos shells, então tudo a partir de #k= nunca chegou ao comando; o echo mostra exatamente o que sobrou. Coloque o link inteiro entre aspas simples e o fragmento, que é a chave de descriptografia, chega intacto.

O link morre antes do --ttl que você pediu.

relayium up ./report.pdf --ttl 7d
# note: your plan caps retention, so this link is kept 1d, not the 7d you asked for

O servidor corta em silêncio um pedido acima do teto do seu plano — 1 dia no Free, 3 no Plus, 7 no Pro, 14 no Max — e o up imprime depois esse aviso para dizer o que você realmente conseguiu. --burn e --max-downloads também encerram um link mais cedo. Envie de novo para obter um link novo.

Você está logado, mas o up diz que você está logado em outro lugar.

relayium whoami
# you@example.com (https://relayium.com)

Um --server que não emitiu o seu token é recusado em vez de receber suas credenciais, o que as vazaria e nem autenticaria ali. Ou você tira o --server para usar o servidor vinculado que o whoami acabou de imprimir, ou roda antes relayium login contra o outro host.

Perguntas frequentes

Preciso de uma conta?

Para enviar para a nuvem, e para o send quando um código precisa ser gerado. O relayium up sempre exige relayium login, para que o arquivo fique guardado sob a sua conta. O relayium send só exige quando o servidor precisa gerar um novo código de emparelhamento para você — se você executar send com um código que alguém lhe passou, nada é gerado, então nenhum login é necessário. O relayium down e o relayium receive não precisam de conta, e push/pull, daemon direto e sync funcionam sem uma.

Meu arquivo é criptografado?

Sim, de ponta a ponta. Ele é criptografado na sua máquina antes do envio; a chave vive apenas no fragmento #k= do link e nunca é enviada ao servidor. O Relayium armazena texto cifrado que não consegue ler, incluindo os nomes dos arquivos.

E se eu perder o link?

O link carrega a única cópia da chave de descriptografia, então um link perdido significa um arquivo irrecuperável — não há nada no servidor que possa recuperá-lo.

Posso limitar quem baixa?

Qualquer pessoa com o link pode baixar, então compartilhe-o de forma privada. Use --burn para permitir um único download, ou --max-downloads <n> para limitar o número, e --ttl <duração> para expirá-lo após um tempo definido.

Funciona com o site?

Sim. Um link do relayium up abre em um navegador, e um link de compartilhamento criado no relayium.com pode ser buscado com relayium down em outra máquina.

Pronto para mover um arquivo entre as suas próprias máquinas? Instale a CLI, execute relayium login e envie-o com up.

Obter a CLI