> 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.

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

<div align="center"><img src="https://1301762840-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-5b98c3bbd6899e24eb2ba9c9d503e67af1b1766b%2FNginx_server.png?alt=media" alt="Logotipo do Nginx"></div>

O Nginx é usado tanto para a solução Navixy On-Premise quanto para os servidores PaaS da Navixy. É 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 o Navixy On-Premise, poderá usar outro software de servidor web simultaneamente com o Nginx para esses produtos. Nessa situação, é crucial separar as portas desses 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 web.

### Configurações do Linux

A versão atual da plataforma Navixy On-Premise é instalada automaticamente no Linux, seja usando scripts de instalação automática ou 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; ela já fica totalmente preparada para uso posterior.

Se 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 alterações fundamentais no site (por exemplo, alterar o domínio ou ativar/desativar SSL). Se forem necessárias modificações, entre em contato com [o suporte técnico da Navixy](mailto:support@navixy.com) para obter mais instruções.

### Configurações do 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 facilitar o processo de configuração, são fornecidos modelos de configuração, que podem ser usados após simplesmente substituir as variáveis pelos valores reais do domínio e dos nomes dos certificados SSL.

Os modelos estão localizados em `\windows\nginx` na pasta de `navixy-package` (compilação da distribuição descompactada 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 a forma 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 um domínio registrado 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 com três domínios ou o domínio principal da sua plataforma em uma instalação com um único domínio.
* `${api_domain}` - o domínio da API em uma instalação com três domínios. Para uma instalação com um único domínio, exclua a variável, mas preserve o restante da linha.
* `${panel_domain}` - o domínio do painel de administração em uma instalação com três domínios. Para uma instalação com um único domínio, exclua a variável, mas preserve o restante da linha.

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

No caso de uma instalação com um único domínio, o painel de administração estará disponível em `/panel` caminho (por exemplo, `http://my.domain.com/panel`), e a API estará disponível em `/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 da sua chave privada.

{% hint style="info" %}
Para obter mais informações sobre certificados SSL, consulte [a página correspondente](https://navixy.com/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 com três domínios ou o domínio principal da sua plataforma em uma instalação com um único domínio.
* `${api_domain}` - o domínio da API em uma instalação com três domínios. Para uma instalação com um único domínio, exclua a variável, mas preserve o restante da linha.
* `${panel_domain}` - o domínio do painel de administração em uma instalação com três domínios. Para uma instalação com um único domínio, 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. O seu site Navixy deve estar disponível no(s) domínio(s) especificado(s).

No caso de uma instalação com um único 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 seção **“HTTP”** e então 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/on-premise/pt-br/on-premise/how-to-guide/configuration/nginx-web-server.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
