Oxaa
  1. Seu localhost online. Sem abrir sua rede.
  2. Guias de frameworks e runtimes
  3. Como expor uma aplicação React + Vite no localhost com HTTPS

Endpoints públicos seguros para desenvolvimento local

Como expor uma aplicação React + Vite no localhost com HTTPS

Exponha um app React + Vite local por um endpoint HTTPS gerenciado, teste o comportamento de proxy do stack e receba uma requisição externa real.

Resposta rápida

Execute uma fixture testada de React + Vite localmente, publique somente a porta selecionada e comprove uma requisição externa real. A página deve resolver comportamento específico do stack - comportamento de Host, proxy, cookie e realtime - e não repetir o quickstart genérico.

Passo a passo

  1. Use versões compatíveis de React + Vite e Oxaa e abra o commit fixado do exemplo.
  2. Inicie o aplicativo com npm run dev ou com o comando de desenvolvimento documentado no repositório.
  3. Valide uma rota de health local determinística no loopback.
  4. Execute oxaa login e oxaa http <port>; aguarde a prontidão da borda.
  5. Abra a URL pública por uma segunda rede ou sandbox do provedor.
  6. Teste Host, proxy, cookie, redirect, raw body e realtime específicos do stack quando aplicáveis.
  7. Confirme log local, resposta esperada e estado do Inspector.
  8. Pare a rota, remova configuração temporária e arquive a versão testada.

Pontos específicos de React + Vite

  • Versões testadas do framework e do Oxaa
  • Repositório funcional de exemplo e comando local de inicialização
  • Comando do Oxaa e saída de prontidão da borda
  • Comportamento específico de Host, proxy, cookie ou realtime
  • Requisição externa real, saída esperada e erros comuns
  • Limpeza e links para o provedor ou caso de uso exato

Como o tráfego e os dados do Inspector são tratados

A borda pública do Oxaa termina o TLS público para resolver o hostname exato, identificar a rota autenticada atual e encaminhar a requisição. A sessão entre o dispositivo cadastrado e o Oxaa é criptografada; por ela, a requisição chega somente ao serviço local selecionado.

O Oxaa mantém metadados limitados de conta, rota, uso, segurança, cobrança, suporte e diagnóstico necessários para operar e proteger o serviço. A captura de body no Inspector é uma ação de depuração separada e explícita: a cópia limitada do body da requisição ou da resposta exibida no Inspector local permanece no dispositivo do desenvolvedor e pode ser redigida, excluída imediatamente ou expirar automaticamente. O tráfego público ainda precisa ser processado na borda; portanto, a afirmação correta é “cópias locais no Inspector”, e não “o Oxaa não consegue ver o tráfego”.

Solução de problemas

Comece pelo processo local, porta e esquema. Depois verifique autenticação e relógio, DNS, UDP/443, fallback TCP/443, proxy corporativo ou interceptação TLS, propriedade da rota e prontidão da borda. Use oxaa routes list, oxaa diagnose --network e IDs de erro estáveis; revise e remova segredos, bodies e caminhos privados antes de compartilhar o diagnóstico.

Limpeza e passagem para produção

Remova o callback externo, a URL de preview ou o vínculo DNS; rotacione credenciais de teste; exclua capturas locais; pare a rota; e revogue o dispositivo ou a sessão quando necessário. Direcione o tráfego de produção para o aplicativo implantado, o ingress de produção ou a plataforma de entrega de eventos adequada.

O que o Oxaa é - e o que não é

O Oxaa fornece conectividade de desenvolvimento para um serviço HTTP ou HTTPS local selecionado enquanto o dispositivo cadastrado e a rota autenticada estão ativos. Não é hospedagem, VPN genérica, forward proxy, implantação permanente de produção, túnel raw TCP/UDP, passthrough TLS arbitrário, substituto de CDN/WAF nem plataforma de entrega de webhooks de produção.