Visão Geral
O servidor relay conecta seu iPhone ao seu agente. Por padrão, ambos usam o relay público oficial em coding.btelo.com. Recomendamos manter o relay oficial — ele roda em 3 servidores distribuídos globalmente, então funciona onde você estiver, mesmo quando sair da sua rede doméstica. Você também pode executar seu próprio relay para máxima privacidade, na sua LAN ou em um servidor público.
Relay em LAN
Se você exige privacidade total e quer que seu tráfego permaneça inteiramente dentro da sua rede local, pode usar um relay em LAN. Observe que um relay em LAN só funciona quando seu iPhone e computador estão na mesma rede — o relay oficial é uma escolha melhor para o uso diário.
Pressione w (Switch Relay) na TUI e selecione Local Relay (LAN). O agente iniciará automaticamente um servidor relay local e se conectará a ele. Em seguida, pressione r para atualizar o QR code e escaneie-o novamente no iPhone para reconectar através do relay em LAN.
Relay Público Auto-Hospedado
Isso é essencialmente o mesmo que um relay em LAN, exceto que você o implanta em um servidor público para que funcione de qualquer rede.
Instale o Btelo Coding no seu VPS e execute-o como relay:
curl -fsSL https://coding.btelo.com/install.sh | sh
vibe-remote relay
O relay escuta na porta 24384 (TCP).
HTTPS com Proxy Reverso
Para produção, coloque o relay atrás de um proxy reverso com TLS:
server {
listen 443 ssl;
server_name relay.example.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
location / {
proxy_pass http://127.0.0.1:24384;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Depois, configure o agente e o app iOS para usar https://relay.example.com.
Limitações do Relay Auto-Hospedado
Apple Push Notifications não estão disponíveis em relays auto-hospedados. As notificações push exigem credenciais APNs (chaves do Apple Developer) vinculadas ao app oficial Btelo Coding. Relays auto-hospedados não podem obter essas credenciais. Como resultado, quando o app iOS está em segundo plano, você não receberá notificações push para tarefas concluídas — o app só será atualizado quando você o abrir.
Todos os outros recursos funcionam normalmente em relays auto-hospedados.