Pular para o conteúdo

Túneis

Um túnel é um link público para o seu OpenChamber, para que você possa acessá-lo de um navegador comum em outra rede. Use openchamber tunnel para criar um para uma instância em execução.

Conectar os seus próprios dispositivos (o app móvel, outro desktop) geralmente não precisa de túnel — pareie-os e deixe o Private Relay criptografado de ponta a ponta cuidar do acesso fora de casa, sem nenhuma configuração.

Pré-requisitos

O OpenChamber inicia o CLI do provedor de túnel na sua máquina. Instale primeiro o provedor que você quer usar:

Terminal window
brew install cloudflared
brew install ngrok

Os túneis rápidos da Cloudflare funcionam com cloudflared. O Ngrok exige uma conta ngrok e um authtoken do painel do ngrok:

Terminal window
ngrok config add-authtoken <your-ngrok-token>

Início rápido

  1. Inicie o OpenChamber:
Terminal window
openchamber

Se você pular esta etapa, openchamber tunnel start pode iniciar automaticamente um servidor CLI. Ao iniciar automaticamente, você pode passar opções do servidor como --port, --host, --lan, --ui-password e --api-only.

  1. Inicie um túnel da Cloudflare:
Terminal window
openchamber tunnel start --provider cloudflare --mode quick

Ou inicie um túnel do Ngrok:

Terminal window
openchamber tunnel start --provider ngrok --mode quick
  1. Verifique o status:
Terminal window
openchamber tunnel status

Quando o túnel estiver no ar, o status mostra uma URL pública. Abra-a, ou escaneie o QR code, para acessar o OpenChamber de qualquer lugar.

Por padrão, o OpenChamber imprime um QR code em sessões TTY interativas. Use --qr para forçar a saída do QR, ou --no-qr para desativá-la.

Provedores

  • cloudflare: modos quick, managed remote e managed local
  • ngrok: modo quick

Modos gerenciados

Gerenciado remoto

Use um token + nome de host gerenciados pela Cloudflare:

Terminal window
openchamber tunnel start --provider cloudflare --mode managed-remote --token-file ~/.secrets/cf-token --hostname app.example.com

Gerenciado local

Use uma configuração local do cloudflared:

Terminal window
openchamber tunnel start --provider cloudflare --mode managed-local --config ~/.cloudflared/config.yml

Perfis (managed-remote)

Salve um perfil reutilizável:

Terminal window
openchamber tunnel profile add --provider cloudflare --mode managed-remote --name prod-main --hostname app.example.com --token-file ~/.secrets/cf-token

Inicie usando o perfil salvo:

Terminal window
openchamber tunnel start --profile prod-main

Comandos úteis

Terminal window
openchamber tunnel providers
openchamber tunnel ready --provider cloudflare
openchamber tunnel ready --provider ngrok
openchamber tunnel doctor --provider cloudflare
openchamber tunnel doctor --provider ngrok
openchamber tunnel stop --port 3000

Notas de comportamento

  • um único túnel ativo por instância do OpenChamber (porta)
  • iniciar um novo modo/provedor na mesma instância substitui o túnel anterior
  • gerar um novo link de conexão revoga o anterior não utilizado
  • o auto-start do túnel preserva flags do servidor como --ui-password e --api-only nas configurações da instância usadas por reinícios e atualizações

Relacionado