Pular para o conteúdo principal

Hospedar no seu computador

Assim, o servidor roda no seu próprio computador, com um endereço público temporário na frente dele, para que pessoas de fora da sua rede possam entrar. Serve bem para uma noite avulsa.

Para algo frequente, hospedar no Render dá menos trabalho: o endereço nunca muda, ninguém precisa deixar um notebook aberto, e também é de graça.

Duas coisas para saber antes de começar. O endereço é diferente a cada vez, então todo mundo precisa digitá-lo de novo a cada sessão. E a sala vive no seu computador, então ela acaba se o notebook entrar em repouso, perder o Wi-Fi ou se você fechar o terminal.

O que você precisa​

  • Node 22.6 ou mais recente, ou Docker. Nada mais é instalado.
  • cloudflared, que cria o endereço temporário. No macOS: brew install cloudflared.

1. Inicie o servidor​

Baixe gather-and-join-server-<version>.mjs da versão mais recente e rode:

node gather-and-join-server-0.3.1.mjs

Ou, se você preferir usar Docker:

docker run -d --name gather-and-join -p 8080:8080 \
ghcr.io/thatjoaoguy/gather-and-join-server:latest

De um jeito ou de outro, ele escuta na porta 8080. Confira abrindo http://localhost:8080/ — um servidor rodando responde com todas as letras.

2. Abra o túnel​

Em um segundo terminal:

cloudflared tunnel --protocol http2 --url http://localhost:8080

Ele imprime um endereço como https://some-random-words.trycloudflare.com.

3. Compartilhe o endereço​

Troque https:// por wss:// e envie isso para todo mundo:

wss://some-random-words.trycloudflare.com

Cada pessoa cola o endereço na página de configuração da extensão. Elas vão ter que fazer isso de novo na próxima vez — este endereço é novo a cada execução.

Durante a sessão​

Mantenha o servidor e o túnel rodando, e mantenha o computador acordado — em um Mac, caffeinate -d em outro terminal resolve. Tudo para quando você pressiona Ctrl-C.

Se o túnel cair e você o reiniciar, o endereço muda e todo mundo precisa colar o novo.

Se você já tem o código-fonte​

Você não precisa dele — os passos acima são o trabalho todo. Mas, se você já tem o repositório clonado, um único comando substitui os dois:

pnpm host

Ele inicia o servidor, abre o túnel e imprime o endereço pronto:

Server URL for everyone's setup page: wss://some-random-words.trycloudflare.com

Ctrl-C para as duas metades juntas.

Por que um túnel​

O endereço precisa começar com wss://, o que significa que ele precisa de um certificado. A Cloudflare fornece um para o endereço temporário que ela te dá. Sem um túnel, outras pessoas não conseguem chegar ao seu computador de jeito nenhum, a não ser que você abra portas no roteador — e, mesmo assim, a conexão não seria criptografada.

Se todo mundo estiver no mesmo Wi-Fi que você, nada disso se aplica: veja hospedar na sua rede local.