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

Endpoints públicos seguros para desenvolvimento local

Como expor uma aplicação FastAPI no localhost com HTTPS

Exponha um app FastAPI 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 FastAPI 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 FastAPI e Oxaa e abra o commit fixado do exemplo.
  2. Inicie o aplicativo com uvicorn app:app --reload 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 FastAPI

  • 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.