Adicionando o Seu Primeiro Site

No ServBay, adicionar um novo site para iniciar seu projeto de desenvolvimento local é simples e intuitivo. Este documento detalha como adicionar seu primeiro site no ServBay, incluindo as etapas operacionais, opções importantes de configuração e dicas úteis.

Seja você um desenvolvedor de PHP, Node.js, sites estáticos, ou precise configurar proxy reverso ou redirecionamento, o ServBay oferece suporte flexível para todas essas necessidades.

Visão Geral

O ServBay foi projetado para proporcionar aos desenvolvedores web um ambiente local poderoso e fácil de gerenciar. Sua interface gráfica amigável (GUI) permite adicionar, configurar e gerenciar múltiplos sites locais com facilidade. Seguindo os passos a seguir, você pode rapidamente criar seu primeiro site local no ServBay e ajustar as configurações conforme as necessidades do seu projeto.

Pré-requisitos

Antes de começar a adicionar um site, certifique-se de que:

• Você instalou e iniciou com sucesso o aplicativo ServBay no macOS.

Passos para Adicionar um Site

Veja abaixo o passo a passo detalhado para adicionar um novo site usando a interface gráfica do ServBay:

Passo 1: Abra o Aplicativo ServBay

Primeiramente, localize o ícone do ServBay na pasta de aplicativos do seu macOS e clique duas vezes para abrir o programa.

Passo 2: Navegue até a Área de Gerenciamento de Sites

Após iniciar o aplicativo ServBay, você verá a tela principal. No menu de navegação à esquerda, clique na opção marcada como Sites. Isso levará você à área de gerenciamento de sites do ServBay.

Passo 3: Comece a Adicionar um Novo Site

Na página de gerenciamento de sites, procure e clique no botão + no canto inferior esquerdo da tela. Ao clicar, aparecerá uma nova área de formulário à direita, para você inserir as informações de configuração do novo site.

Passo 4: Configure as Definições do Site

No formulário de configuração do site, você deverá preencher ou selecionar as seguintes informações-chave:

1. Nome: Escolha um nome facilmente identificável para o seu site local. Este nome serve apenas para o gerenciamento interno no ServBay, ajudando você a distinguir entre diferentes configurações de sites.
2. Domínio: Informe o domínio que você deseja usar para acessar o site localmente. Para evitar conflitos com domínios reais, recomenda-se fortemente usar o sufixo .demo ou outro TLD local configurado pelo ServBay, como servbay.demo ou meuprojeto.servbay.demo. O ServBay gerencia automaticamente o DNS local, permitindo acessar seu site pelo navegador usando esse domínio.
3. Protocolo: Selecione o protocolo suportado pelo site. Normalmente, a opção padrão é HTTP/HTTPS, e o ServBay cuidará da configuração do HTTPS local automaticamente.
4. Modo de solicitação do certificado SSL: Configure a criptografia SSL/TLS do site local.
   • ServBay CA: Recomendado para desenvolvimento local. O ServBay irá gerar e gerenciar automaticamente um certificado SSL assinado pela autoridade raiz integrada do ServBay. Você só precisa confiar no certificado raiz do ServBay (“ServBay User CA” ou “ServBay Public CA”) no seu sistema para garantir acesso HTTPS sem alertas no navegador.
   • ACME: Caso queira simular um ambiente de produção, é possível emitir um certificado público real para seu domínio local (caso o domínio aponte para sua instância do ServBay e seja acessível publicamente) usando o protocolo ACME (como Let's Encrypt, ZeroSSL, Google Trust Services etc.). O ServBay suporta solicitação e renovação automática de certificados via ACME.
5. Tipo de Site: Escolha o tipo conforme o stack tecnológico do seu projeto:
   • PHP: Para projetos baseados em PHP como WordPress, Laravel, Symfony etc. O ServBay configurará um servidor web (Nginx ou Apache) integrado ao PHP-FPM para processar requisições PHP.
   • Node.js: Para aplicações Node.js. O ServBay normalmente configura um proxy reverso para encaminhar as requisições web à porta em que sua aplicação Node.js está escutando.
   • Estático: Para sites compostos apenas de arquivos HTML, CSS, JavaScript etc. O servidor web fornecerá os arquivos diretamente.
   • Proxy reverso: Permite encaminhar solicitações de determinado domínio ou caminho para outro endereço e porta local ou remoto. Isto é útil para encaminhar para outros serviços ou aplicações.
   • Redirecionamento: Redireciona todas as requisições recebidas neste domínio para outra URL.
6. Versão do PHP: Se escolher o tipo PHP, selecione, na lista suspensa, uma versão do PHP já instalada e em execução para processar os scripts do site. Certifique-se de que a versão necessária já está instalada via o gerenciador de pacotes do ServBay.
7. Regras de Reescrita de URL (“URL amigável”): A maioria dos frameworks e CMS modernos (como Laravel, WordPress, Discuz! etc.) requer regras de reescrita de URL para gerar endereços amigáveis (por exemplo, /sobre ao invés de /index.php?page=sobre). O ServBay oferece opções de regras pré-definidas para sistemas populares, bastando selecionar e aplicar. Se sua aplicação não estiver listada, ou você tiver regras personalizadas, será necessário configurar manualmente o arquivo de configuração do servidor web (Nginx ou Apache).
8. Diretório Raiz: Informe o caminho físico dos arquivos do seu site. Este é o diretório onde o servidor web buscará e servirá os arquivos. Recomenda-se armazenar o projeto no diretório padrão www do ServBay, por exemplo /Applications/ServBay/www/servbay-demo. Verifique se este diretório existe e o processo do ServBay possui permissão de leitura.

WARNING

Para quem usa frameworks (como Laravel), atente-se para configurar o diretório raiz apontando para o diretório public (onde está o index.php), e não para a raiz do projeto.

Passo 5: Salve e Ative o Site

Após preencher e revisar todas as informações de configuração, clique no botão Adicionar na parte inferior do formulário. O ServBay irá gerar automaticamente as configurações necessárias e recarregar o site no servidor web (Nginx ou Apache), além de atualizar as definições do DNS local.

Se tudo for salvo com sucesso, seu novo site aparecerá na lista de sites. Você pode acessá-lo rapidamente clicando no ícone de navegador no canto superior direito da tela.

Passo 6: Gerencie o Site com Ações Rápidas

O ServBay oferece, para cada site listado, uma série de botões de ação rápida que facilitam o gerenciamento do fluxo de trabalho local:

1. Abrir com IDE: Abre rapidamente o diretório raiz do site no editor de código ou IDE padrão configurado.
2. Abrir no navegador: Abre imediatamente a URL do site no navegador web padrão.
3. Ver logs do site: Permite verificar facilmente os logs de acesso e erro do servidor web relacionado ao site, auxiliando na depuração.
4. Pausar/Iniciar site: Temporariamente desativa ou reativa o acesso ao site.
5. Excluir site: Remove o site da configuração do ServBay. Importante: isso não apaga os arquivos físicos do site do disco.

Exemplo Rápido: Criando um Site HTML Estático

Para validar se seu primeiro site foi configurado corretamente, você pode realizar este teste simples:

1. Siga os passos anteriores para adicionar um site, por exemplo usando o domínio servbay.demo, tipo de site Estático e diretório raiz /Applications/ServBay/www/servbay-demo-static.

2. No seu sistema de arquivos, crie o diretório /Applications/ServBay/www/servbay-demo-static caso ainda não exista.

3. Dentro deste diretório, crie um arquivo chamado index.html.

4. Abra o arquivo index.html em um editor de texto e insira o seguinte código HTML simples:

   <!DOCTYPE html>
   <html>
   <head>
       <title>ServBay Static Test</title>
   </head>
   <body>
       <h1>Parabéns! Seu primeiro site ServBay está rodando com sucesso!</h1>
       <p>Se você está vendo esta página, significa que o ServBay foi configurado corretamente e está servindo seu site estático.</p>
   </body>
   </html>

5. Salve o arquivo index.html.

6. Retorne à interface de gerenciamento de sites do ServBay, encontre o site servbay.demo recém-adicionado e clique no ícone do navegador em ações rápidas.

7. Seu navegador deverá abrir http://servbay.demo (ou https://servbay.demo, dependendo da configuração do SSL) e exibir o conteúdo da página index.html criada por você.

Observações Importantes

• Conflito de domínio: Evite utilizar domínios que possam conflitar com sua rede local ou VPN. O uso de .demo é uma opção segura.
• Permissão do diretório raiz: Certifique-se de que o usuário em execução do ServBay (normalmente seu próprio usuário) tem permissão de leitura sobre o diretório raiz do site e seus arquivos.
• Portas ocupadas: O ServBay usa por padrão as portas 80 (HTTP) e 443 (HTTPS). Se estes portos já estiverem sendo usados por outro programa, o servidor web do ServBay pode não iniciar corretamente e seu site poderá ficar inacessível. Feche qualquer aplicativo que esteja usando estas portas.
• Confiança no ServBay CA: Para acessar sites HTTPS sem alertas ao usar ServBay CA, é necessário confiar no certificado raiz do ServBay User CA ou ServBay Public CA em seu macOS. Consulte a documentação do ServBay para orientações detalhadas.

Perguntas Frequentes (FAQ)

• P: Por que ao abrir meu site aparece HTTP Error 403 - Forbidden ou HTTP Error 404 - File not found?
  • R: Este é o erro mais comum entre desenvolvedores.
  • Primeiramente, verifique se o diretório raiz do site está corretamente apontado. Nos frameworks modernos (Laravel, Symfony, CakePHP, etc.), por segurança e organização, a raiz do projeto (geralmente onde ficam vendor, composer.json, package.json etc.) não é a raiz/entrada do site.
  • Portanto, direcione o diretório raiz do site corretamente para o diretório onde se encontra o arquivo de entrada (index.php, index.htm, index.html) do seu aplicativo.
  • Diretórios de entrada comuns: public, web, www, htdocs, wwwroot, webroot etc.
• P: Adicionei um site, mas ao acessar o domínio no navegador aparece “Não foi possível acessar este site” ou “Conexão recusada”?
  • R: Primeiro, verifique se o ServBay está em execução e se o servidor web (Caddy/Nginx/Apache) está funcionando corretamente (veja no painel principal do ServBay).
  • Certifique-se que o domínio digitado no navegador é exatamente igual ao configurado no ServBay.
  • Confira se o site está em estado “ativo” na lista de sites (não pausado).
  • Verifique se o diretório raiz do site está correto e se existe o arquivo de entrada (como index.html, index.php).
  • Veja se alguma outra aplicação está utilizando as portas 80 ou 443.
• P: Meu site PHP não funciona como esperado, exibindo página em branco ou baixando arquivos?
  • R: Certifique-se de ter selecionado a versão correta do PHP na configuração do site, que ela está instalada no ServBay e está rodando.
  • Verifique permissões dos arquivos no diretório raiz do site.
  • Veja os logs do site (via ações rápidas) para erros de PHP.
  • Assegure-se que o projeto possui index.php ou outro arquivo reconhecido como índice pelo ServBay.
• P: Configurei HTTPS, mas o navegador exibe alerta de certificado?
  • R: Se estiver usando o ServBay CA, é preciso confiar no certificado raiz do ServBay em seu sistema ou navegador. Consulte a documentação oficial do ServBay sobre como confiar em CAs.
  • Se estiver usando ACME, verifique se o domínio aponta corretamente para o ServBay e se o certificado foi emitido e instalado com sucesso. Consulte os logs para mais detalhes.
• P: Minhas regras de reescrita de URL não funcionam e as páginas não carregam corretamente?
  • R: Confira se você selecionou as regras de reescrita adequadas ao seu framework/aplicação na configuração do site.
  • Se for Apache, verifique se existe um .htaccess no diretório raiz ou subdiretórios do site e se a configuração do Apache permite sua leitura.
  • Se for Nginx ou Caddy, as regras geralmente estão nos arquivos de configuração gerados pelo ServBay — confira se foram aplicadas corretamente.

Resumo

Seguindo este guia, você deverá conseguir adicionar e rodar seu primeiro site no ambiente de desenvolvimento local do ServBay com sucesso. Os avançados recursos de gerenciamento, opções de configuração flexíveis (certificados SSL, tipo de site, versão do PHP, regras de reescrita), além da praticidade dos atalhos, vão aprimorar significativamente sua produtividade no desenvolvimento local. Continue explorando outras funcionalidades do ServBay, como gerenciamento de pacotes e bancos de dados, para desenvolver um fluxo de trabalho ainda mais completo e profissional.