For the complete documentation index, see llms.txt. This page is also available as Markdown.

Servidor web Nginx

Configure o Nginx como o servidor web do Navixy On-Premise no Linux ou Windows. Configure hosts virtuais HTTP e HTTPS, certificados SSL e regras de proxy baseadas em domínio.

Nginx é o servidor web usado pela plataforma Navixy para executar o site. É um software gratuito projetado para rodar em Linux e também é compatível com Windows.

Logo do Nginx

Nginx é usado tanto na solução Navixy On-Premise quanto nos servidores Navixy PaaS. É o único tipo de servidor web com compatibilidade garantida com a plataforma. Nenhum outro servidor web (Apache, IIS etc.) é compatível.

Se você tiver outros aplicativos web instalados no seu servidor junto com Navixy On-Premise, você pode utilizar outro software de servidor web em paralelo com o Nginx para esses produtos. Nessa situação, é crucial fazer a separação de portas para esses servidores web para evitar conflitos de porta nas mesmas portas.

Configurações do Nginx

Usar um servidor web significa configurá-lo para que seu site funcione como esperado. A configuração especifica itens importantes como:

  • Domínio(s) do seu site

  • Protocolo (HTTP/HTTPS)

  • Certificados SSL

  • A localização do conteúdo do site

E outros parâmetros necessários para o funcionamento adequado da página.

Configurações no Linux

A versão atual da plataforma Navixy On-Premise é instalada no Linux automaticamente, seja usando scripts de instalação automática, seja implantando contêineres Docker. Em ambos os casos, a configuração do Nginx é feita automaticamente durante a instalação e você não precisa fazer nenhuma alteração nela, e ela fica totalmente pronta para uso posterior.

Se a sua instância foi implantada manualmente no passado, as configurações feitas anteriormente continuam totalmente funcionais e não precisam ser modificadas, a menos que você vá aplicar algumas mudanças fundamentais ao site (por exemplo, alterar o domínio ou ativar/desativar o SSL). Se forem necessárias modificações, entre em contato com suporte técnico da Navixy para obter mais instruções.

Configurações no Windows

No caso do Windows, toda a instalação e configuração da plataforma Navixy On-Premise é feita manualmente e não há automação. Portanto, o Nginx também deve ser configurado manualmente.

Para tornar o processo de configuração mais fácil, são fornecidos modelos de configuração, que podem ser usados simplesmente substituindo as variáveis pelos valores reais do domínio e dos nomes dos certificados SSL.

Os modelos estão localizados na \windows\nginx pasta de navixy-package (compilação descompactada da distribuição da plataforma Navixy On-Premise). Os arquivos são:

  • navixy.conf - arquivo de configuração do site da plataforma aberto em HTTP, sem proteção SSL.

  • navixy_ssl.conf - arquivo de configuração do site protegido por SSL.

Escolha o arquivo de acordo com como você planeja configurar o site.

Os valores das variáveis são especificados com um cifrão e entre chaves - esses caracteres identificam a variável. Por exemplo: ${service_domain} Ao substituir a variável pelo valor real, esses caracteres devem ser removidos. Por exemplo: ${service_domain} torna-se my.domain.com

HTTP, sem proteção SSL

Esta é a opção mais fácil para configurar o site da plataforma Navixy; você só precisa de domínio(s) registrado(s) apontando para o seu servidor.

Edite o arquivo navixy.conf localizado em C:\nginx\conf\conf.d. Substitua os seguintes valores:

  • ${service_domain} - domínio da interface do usuário em uma instalação de três domínios ou o domínio principal da sua plataforma em uma instalação de domínio único.

  • ${api_domain} - o domínio da API em uma instalação de três domínios. Para uma instalação de domínio único, exclua a variável, mas preserve o restante da linha.

  • ${panel_domain} - o domínio do painel de administração em uma instalação de três domínios. Para uma instalação de domínio único, exclua a variável, mas preserve o restante da linha.

Salve o arquivo e reinicie o Nginx. Seu site Navixy deve estar disponível no(s) domínio(s) especificado(s).

No caso de uma instalação de um domínio, o painel de administração estará disponível no caminho /panel caminho (por exemplo, http://my.domain.com/panel), e a API estará disponível no /api caminho (por exemplo, http://my.domain.com/api).

HTTPS, protegido por SSL

Para configurar um site protegido por SSL, você precisa não apenas de um domínio registrado, mas também de um certificado SSL válido e sua chave privada.

Para mais informações sobre certificados SSL, consulte a página correspondente das instruções.

Coloque os certificados SSL e as chaves privadas em C:\nginx\ssl pasta. Crie-a se ela não existir.

Edite o arquivo navixy_ssl.conf localizado em C:\nginx\conf\conf.d. Substitua os seguintes valores:

  • ${service_domain} - domínio da interface do usuário em uma instalação de três domínios ou o domínio principal da sua plataforma em uma instalação de domínio único.

  • ${api_domain} - o domínio da API em uma instalação de três domínios. Para uma instalação de domínio único, exclua a variável, mas preserve o restante da linha.

  • ${panel_domain} - o domínio do painel de administração em uma instalação de três domínios. Para uma instalação de domínio único, exclua a variável, mas preserve o restante da linha.

  • ${certificate_name} - nome do arquivo do certificado com extensão. Deve ser o certificado emitido para o domínio.

  • ${private_key_name} - nome do arquivo da chave privada com extensão. A chave deve corresponder ao certificado.

Salve o arquivo e reinicie o Nginx. Seu site Navixy deve estar disponível no(s) domínio(s) especificado(s).

No caso de uma instalação de um domínio, o painel de administração estará disponível no caminho /panel (por exemplo, https://my.domain.com/panel), e a API estará disponível no caminho /api (por exemplo, https://my.domain.com/api).

Redirecionamento de HTTP para HTTPS

Quando você usa HTTPS, talvez queira que seus usuários consigam acessar a plataforma mesmo se abrirem o endereço via HTTP. Para isso, você precisa ter navixy.conf (configuração HTTP) aplicada junto com navixy_ssl.conf (configuração HTTPS).

Configure navixy.conf conforme especificado acima na “HTTP” seção e, em seguida, descomente a seguinte linha (remova o # caractere):

Salve o arquivo e reinicie o Nginx para aplicar as alterações. Agora, as solicitações HTTP serão redirecionadas para HTTPS.

Atualizado

Isto foi útil?