> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/configuration/nginx-web-server.md). # 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. {% hint style="info" %} 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. {% endhint %} ## 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](mailto:support@navixy.com) 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. {% hint style="info" %} 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` {% endhint %} #### 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. {% hint style="info" %} Para mais informações sobre certificados SSL, consulte [a página correspondente](/docs/on-premise/pt-br/on-premise/how-to-guide/configuration/ssl-certificates/ssl-certificates-installation.md) das instruções. {% endhint %} 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): ``` #return 301 https://$host$request_uri; ``` Salve o arquivo e reinicie o Nginx para aplicar as alterações. Agora, as solicitações HTTP serão redirecionadas para HTTPS. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/configuration/nginx-web-server.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.