Guia de Configuração do Serviço de Proxy Reverso Pinggy no ServBay

O Pinggy é uma ferramenta de tunneling leve e fácil de usar, desenhada para ajudá-lo a expor rapidamente serviços web locais de forma segura para a internet pública. O ServBay, ao integrar o Pinggy, oferece aos desenvolvedores no macOS uma maneira prática de criar túneis de acesso público, ideal para demonstrações de código, testes de APIs ou para compartilhar resultados do desenvolvimento local com colaboradores externos. Este guia irá conduzi-lo passo a passo na configuração e utilização do Pinggy no ServBay.

Visão Geral

O ServBay possui suporte nativo ao Pinggy, tornando simples a sua instalação e gerenciamento. Você pode controlar os túneis do Pinggy diretamente pela interface gráfica do ServBay, mapeando os sites locais hospedados no ServBay para uma URL pública acessível externamente.

Cenários de Uso

• Demonstração Rápida: Apresente instantaneamente sites ou aplicações em desenvolvimento no seu macOS para clientes ou colegas.
• Testes de API e Webhook: Crie endpoints públicos temporários para serviços de terceiros que exigem callbacks públicos (ex: login social, filas de mensagens).
• Depuração Remota: Facilite o acesso e a depuração do seu ambiente de desenvolvimento local para membros da equipe remota.
• Testes em Dispositivos Móveis: Permita que dispositivos móveis acessem serviços backend locais via URL pública.

Pré-requisitos

1. ServBay instalado: Certifique-se de que a versão mais recente do ServBay está instalada e em funcionamento no seu sistema macOS.
2. Conta no Pinggy: Você vai precisar de uma conta Pinggy. Acesse o site oficial do Pinggy para registrar-se. O Pinggy oferece planos gratuitos e pagos.
3. Site local: Ao menos um site local deve estar configurado e rodando no ServBay, como servbay.demo ou kirby.test.

Passos de Configuração

1. Instalar o pacote Pinggy no ServBay

Se esta é a sua primeira vez usando o Pinggy pelo ServBay, instale o pacote seguindo os passos abaixo:

1. Abra o aplicativo ServBay.

2. No menu lateral esquerdo, clique em Pacotes (Packages).

3. Localize ou procure por Pinggy na lista de pacotes disponíveis.

4. Clique no botão de instalação ao lado de Pinggy.

5. Após a instalação, tente iniciar o serviço clicando na chave de ligar ao lado do Pinggy. Caso o serviço falhe ao iniciar ou o status apresente algum erro, isso é esperado por enquanto, pois a configuração do Pinggy ainda não foi feita. Vamos completar esse processo nos próximos passos.

   

2. Obtenha seu Access token do Pinggy

O Pinggy utiliza um Access Token para autenticar sua conta e habilitar o serviço de túneis.

1. Acesse o Dashboard do Pinggy e faça login com suas credenciais.

2. Após o login, o seu Access Token pessoal ficará disponível normalmente na página inicial do dashboard, em "Access token".

3. Copie este Access Token. Ele é uma sequência de caracteres; mantenha-o em local seguro.

   

3. Configure o Pinggy no ServBay

Com o Access Token em mãos, retorne ao ServBay para a configuração:

1. No menu lateral esquerdo do ServBay, selecione Tunnel.

2. Na lista de serviços Tunnel, clique em Pinggy.

   

3. Auth Token (Token de Autorização):

   • Cole com precisão o Access Token copiado do dashboard do Pinggy no campo Auth Token.

4. Configuração do Túnel (Local Domain e External Domain): O ServBay permite que você crie túneis Pinggy para múltiplos sites locais hospedados nele.

   • Local Domain (Site Local):
     • Clique no menu suspenso e selecione o site local que deseja expor ao público via Pinggy. Por exemplo, escolha thinkphp.test ou servbay.demo.
   • External Domain (Domínio Externo):
     • Para usuários gratuitos do Pinggy: Deixe este campo em branco. O Pinggy irá gerar automaticamente uma URL pública aleatória para o seu túnel (normalmente terminando com .a.free.pinggy.link ou .pinggy.link). O ServBay irá exibir essa URL assim que o túnel for estabelecido.
     • Para usuários pagos do Pinggy: Caso sua conta Pinggy permita domínios personalizados ou reservados, insira aqui o domínio externo desejado.

5. Adicionar mais túneis:

   • Para criar outros túneis para diferentes sites locais, clique no botão + (mais) ao lado da entrada de túnel existente e repita o passo 4 para cada novo túnel.

6. Salvar Configuração:

   • Após configurar todos os túneis, clique em Salvar (Save) no canto inferior direito da interface.

4. Inicie e Verifique o Serviço Pinggy

1. Com a configuração salva, o ServBay tentará iniciar o serviço Pinggy com as novas definições.
2. Observe o indicador ao lado da linha Pinggy na lista de túneis. Se tudo estiver correto e o Pinggy conectar-se com sucesso, o indicador deve ficar verde, mostrando que o serviço está ativo.
3. Para cada túnel iniciado com sucesso, o campo External Domain (caso estivesse vazio) será preenchido com a URL pública gerada pelo Pinggy, como por exemplo https://random-string.a.free.pinggy.link.
4. Verifique o Acesso:
   • Clique no ícone de copiar ao lado do domínio externo para copiar a URL pública.
   • Ou, clique no ícone do navegador (geralmente um compasso ou globo) para abrir a URL diretamente no seu navegador padrão.
   • Se tudo está configurado corretamente, seu site local estará disponível através da URL Pinggy fornecida.

5. Gerenciando Túneis do Pinggy

Na interface de configuração do Pinggy no ServBay, você pode gerenciar facilmente seus túneis:

• Copiar domínio externo: Clique no ícone de copiar para compartilhar rapidamente a URL pública.
• Abrir no navegador: Clique no ícone do navegador para testar o acesso diretamente.
• Adicionar túnel: Clique em + para configurar novos túneis.
• Remover túnel: Clique em - (menos) para excluir uma configuração de túnel que não seja mais necessária.
• Parar/Iniciar serviço: Use o botão ao lado da entrada do Pinggy para habilitar ou desabilitar globalmente o serviço de túneis Pinggy.

Observações Importantes

• Recursos da versão gratuita do Pinggy: Os domínios externos fornecidos no plano gratuito do Pinggy são dinâmicos e podem mudar a cada reinicialização do serviço ou do túnel. Limitações como conexões simultâneas, largura de banda e duração de uso também podem existir. Para um domínio fixo, desempenho superior ou recursos avançados, considere um plano pago do Pinggy.
• Dependências do serviço local: Certifique-se de que o site selecionado em Local Domain esteja corretamente configurado e em execução no ServBay (ex: versão correta do PHP, servidor web como Caddy/Nginx ativo, configuração do site sem erros). O Pinggy apenas faz o redirecionamento do tráfego.
• Firewall e rede: Verifique se o firewall do macOS ou softwares de segurança de terceiros não estão bloqueando as conexões do ServBay ou do cliente Pinggy.
• Segurança HTTPS: O Pinggy geralmente fornece suporte HTTPS para os túneis gerados, garantindo criptografia dos dados — essencial para a segurança de aplicações web modernas.

Perguntas Frequentes (FAQ)

• P: O serviço Pinggy falhou ao iniciar e o indicador não está verde. O que devo fazer?
  • R: Primeiro, verifique cuidadosamente se o Access Token do Pinggy foi inserido corretamente. Depois, confirme que sua conexão com a internet está estável. Consulte o log do cliente Pinggy (ícone de log ao lado do serviço) para mensagens de erro específicas.
• P: Sou usuário gratuito do Pinggy. Por que o campo External Domain deve ser deixado em branco?
  • R: Este é o funcionamento padrão do serviço gratuito do Pinggy. Não é necessário definir um domínio externo manualmente. Após o túnel ser conectado, o ServBay automaticamente exibirá a URL pública temporária fornecida pelo Pinggy.
• P: Qual a diferença entre Pinggy e outros serviços de túnel como Ngrok? Qual devo escolher?
  • R: Pinggy e Ngrok são excelentes ferramentas de tunneling, mas diferem nas funcionalidades, limitações gratuitas, preço dos planos, complexidade de configuração e distribuição dos servidores. O Pinggy destaca-se por ser leve e de fácil uso. Sua escolha pode ser orientada por necessidades específicas (como suporte a determinados protocolos, domínios personalizados, orçamento etc.) e preferência pessoal. O ServBay suporta diversas ferramentas do gênero, oferecendo flexibilidade.

Resumo

A integração do Pinggy no ServBay oferece uma solução muito prática para desenvolvedores web no macOS que precisam compartilhar sites locais. Com alguns passos simples, você expõe com segurança seu ambiente de desenvolvimento para a internet pública, facilitando demonstrações, testes e colaboração. Não se esqueça de configurar corretamente conforme o tipo da sua conta Pinggy e de manter o serviço web local sempre funcional para aproveitar ao máximo os benefícios do Pinggy.