Repolode
akazwz

akazwz/hostc

Uma CLI que dá ao seu servidor de desenvolvimento local uma URL HTTPS pública, com suporte a WebSockets e hot reload, de graça e sem precisar de conta.

Alternativa open source a:ngrok

Estrelas
628
Forks
69
Issues abertas
5
Último commit
há 14 horas

O que é?

hostc é um túnel de linha de comando para compartilhar um servidor de desenvolvimento local. Ao executar `npx hostc@latest 3000`, você recebe uma URL HTTPS pública que encaminha as requisições para localhost:3000. Assim, dá para abrir o app no celular, enviá-lo para um colega ou receber webhooks de serviços como Stripe e GitHub.

A CLI precisa apenas do Node.js 22 ou posterior, sem cadastro, token de autenticação ou binário para instalar. Ela abre uma única conexão WebSocket de saída com um servidor executado no Cloudflare Workers e no Durable Objects, então sua máquina não precisa estar acessível pela internet. O tráfego de WebSocket e Server-Sent Events é encaminhado, mantendo o hot reload funcionando em ferramentas como Vite e Next.js.

Os servidores de desenvolvimento aceitam requisições destinadas a localhost, e os redirecionamentos apontam de volta para a URL pública, então não é preciso alterar nenhuma configuração de allowed-hosts. Se a conexão cair, a CLI se reconecta e mantém a mesma URL por até 10 minutos. Também é possível hospedar o servidor no seu próprio domínio da Cloudflare.

Recursos principais

  • 01Disponibiliza uma URL HTTPS pública para uma porta local com um único comando.
  • 02Encaminha WebSockets e Server-Sent Events para manter o hot reload funcionando.
  • 03Não precisa de conta, token de autenticação nem instalação global.
  • 04Mantém a mesma URL durante breves quedas de rede ou reinicializações do servidor.
  • 05Pode exibir um QR code para abrir a URL no celular.
  • 06Pode ser hospedado nos seus próprios domínios da Cloudflare.

Casos de uso

  • Visualizar um site em um celular de verdade com hot reload.
  • Testar webhooks do Stripe, GitHub ou Slack usando código local.
  • Compartilhar o trabalho em andamento com um colega ou cliente antes de fazer o deploy.
  • Permitir que um agente de programação com IA compartilhe o app que criou.

Início rápido

  1. 1

    Inicie o app e, em seguida, configure o hostc para apontar para a porta dele

    npx hostc@latest 3000

Antes de usar

  • Qualquer pessoa com a URL pública pode acessá-la, então exponha apenas o que você pretende compartilhar.
  • É necessário ter Node.js 22 ou posterior.
  • O servidor é um serviço baseado na Cloudflare; ao reiniciar o hostc, você recebe uma nova URL.

Em coleções

Tópicos

Perguntas frequentes

O que é hostc?
Uma CLI que dá ao seu servidor de desenvolvimento local uma URL HTTPS pública, com suporte a WebSockets e hot reload, de graça e sem precisar de conta. hostc é um túnel de linha de comando para compartilhar um servidor de desenvolvimento local. Ao executar `npx hostc@latest 3000`, você recebe uma URL HTTPS pública que encaminha as requisições para localhost:3000. Assim, dá para abrir o app no celular, enviá-lo para um colega ou receber webhooks de serviços como Stripe e GitHub.
hostc é gratuito? Qual é a licença?
hostc é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
hostc ainda é mantido?
Manutenção ativa. O último commit de hostc foi em 5 de nov. de 2026.
Para que posso usar hostc?
Visualizar um site em um celular de verdade com hot reload. Testar webhooks do Stripe, GitHub ou Slack usando código local. Compartilhar o trabalho em andamento com um colega ou cliente antes de fazer o deploy. Permitir que um agente de programação com IA compartilhe o app que criou.
Como instalar hostc?
Inicie o app e, em seguida, configure o hostc para apontar para a porta dele: npx hostc@latest 3000
Onde consigo hostc?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/akazwz/hostc

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados