Como Instalar e Executar o Servidor Nginx no Windows

Imagem em Destaque da Combinação Windows e Nginx (Representação apenas)

O Nginx é um servidor web muito popular entre sistemas Linux e BSD. Ele também pode ser instalado no Windows, desde que você consiga lidar com limitações de desempenho que ainda não foram mitigadas. Você ainda pode hospedar um servidor web ou um portal de cliente/funcionário no conforto do seu laptop com Windows. Para instalar e executar o Nginx com sucesso no Windows, siga os passos abaixo.

Índice

  • Instalando Nginx no Windows
  • Como Iniciar o Nginx no Windows
    1. Usando o Arquivo Aplicativo do Nginx
    1. Usando o PowerShell
    1. Usando o IIS Manager
  • Como Configurar o Nginx Para Windows
  • Exemplo de Aplicação do Nginx no Windows
  • Perguntas Frequentes

Dica: se tudo o que você precisa é de um servidor web local para testar suas aplicações, aqui estão as maneiras de configurar um servidor web local no Windows.

Instalando Nginx no Windows

Para começar, precisaremos instalar o Nginx no seu laptop ou PC com Windows. Não existem instaladores convencionais do Nginx para este sistema operacional. Você precisará baixar uma de suas versões online e salvá-la em um local do drive C: do seu PC.

  1. Selecione a versão que deseja e baixe o arquivo zip para o seu PC. O Nginx recomenda usar a “versão mainline”, pois ela vem com os recursos mais recentes. Se você não precisa desses recursos, a versão estável mais recente também funcionará.

Baixando a versão mainline do Nginx do seu site oficial.

  1. Após o download, extraia a nova pasta clicando com o botão direito. Você também pode usar softwares de compressão populares como 7-zip ou WinRAR.

Clique com o botão direito para extrair todos os arquivos do software instalador Nginx baixado.

  1. Mova toda a pasta que veio com a cópia embutida do download para o drive C:. Neste exemplo, nós a movemos para “Program Files”, mas pode ser salva em qualquer local no seu PC, incluindo o drive D.

Movendo a pasta Nginx extraída para o Program Files.

  1. Selecione e clique duas vezes no arquivo “Nginx.exe”. Ele agora foi ativado para uso posterior. Executaremos o Nginx a partir deste local como um programa de serviço web padrão.

Clique duas vezes no aplicativo Nginx dentro da pasta Program Files.

  1. Se você habilitou o filtro SmartScreen do Windows, ele pode impedir o instalador do Nginx de ser executado. Clique em “Mais informações” para contornar a limitação.

Clique em

  1. Clique no texto “Executar assim mesmo” para executar o arquivo nginx.exe.

SmartScreen bloqueia o aplicativo Nginx que você pode executar assim mesmo.

  1. Você pode encontrar uma tela de bloqueio do firewall do Windows Defender ao executar o servidor Nginx, que deve ser permitido por você. Depois de fazer isso, você pode usar o Nginx prontamente em seu dispositivo Windows.

O firewall do Windows Defender bloqueou o aplicativo Nginx. Clique em Permitir acesso para executá-lo.

Você sabia: está se perguntando qual é a diferença entre Nginx e Apache? Temos as respostas aqui.

Como Iniciar o Nginx no Windows

Existem várias maneiras de executar o Nginx no seu PC com Windows, dependendo das suas necessidades de uso final. Você pode usar esses métodos simultaneamente. Por exemplo, você pode iniciar o servidor Nginx usando seu arquivo de aplicativo ou a partir do PowerShell.

1. Usando o Arquivo Aplicativo do Nginx

O Nginx possui um arquivo de aplicativo embutido que você pode clicar duas vezes, como descrito na seção acima. Você precisará contornar quaisquer restrições devido ao SmartScreen ou ao Windows Defender.

  1. Uma vez feito, vá para seu navegador padrão e digite localhost. O Microsoft Edge é o navegador usado no exemplo abaixo.
  2. Se você vir uma tela dizendo que o servidor web Nginx foi instalado e está funcionando com sucesso, isso significa que não houve problemas com sua instalação do Nginx no Windows.

Navegador Edge no Windows mostrando o script padrão do Nginx após digitar

  1. Para parar o Nginx, você pode encerrá-lo pela janela do Gerenciador de Tarefas. Se você não conseguir encerrá-lo diretamente nos Processos, clique com o botão direito para selecionar “Ir para detalhes.”

Clique com o botão direito para selecionar

  1. Identifique todas as instâncias do Nginx.exe e clique com o botão direito para encerrar cada tarefa.

Clique com o botão direito para selecionar

  1. Ignore qualquer aviso como “você deseja encerrar o Nginx.exe.” Clique em “Encerrar processo” para continuar com a terminação.

Clique em

  1. Quando você digitar localhost, verá uma tela “não é possível acessar esta página” na página do seu navegador.

Nginx localhost exibindo o erro

2. Usando o PowerShell

A melhor parte do Nginx é que ele pode ser executado como um script automatizado a partir do PowerShell e também do Prompt de Comando. Nós iremos demonstrar isso para o PowerShell abaixo.

  1. Abra o PowerShell no modo Administrador.

Executando o PowerShell como administrador.

  1. Volte para a pasta onde você salvou o aplicativo Nginx e clique com o botão direito para ir às Propriedades. Aqui você pode copiar o caminho exato da pasta. Neste exemplo, é “C:\nginx-1.25.1\nginx-1.25.1”

Caminho local do arquivo aplicativo Nginx na pasta Nginx instalada.

  1. Mude o diretório do PowerShell para apontar para o caminho acima.
cd Caminho do instalador do Nginx

Redirecionando o PowerShell para o caminho da pasta do aplicativo Nginx.

  1. Para iniciar o servidor Nginx, digite o seguinte comando.
start nginx

Iniciar o Nginx no PowerShell em modo Administrador.

  1. Você pode visualizar as instâncias do processo Nginx.exe no Gerenciador de Tarefas aninhadas sob o Windows PowerShell.

Nginx executando como processos em segundo plano na janela do PowerShell conforme visto no Gerenciador de Tarefas.

  1. No Windows, o Nginx pode ser executado como um aplicativo de console padrão. Para gerenciá-lo, os seguintes comandos simples são frequentemente usados:
nginx -s stopDesligamento rápido
nginx -s quitDesligamento elegante
nginx -s reloadMudando a configuração, iniciando novos processos de trabalho com uma nova configuração, desligamento elegante dos antigos processos de trabalho
nginx -s reopenReabrindo arquivos de log
  1. Se você encontrar algum erro como “o comando nginx não foi encontrado, mas existe na localização atual”, o PowerShell solicitará que você use um comando diferente. No exemplo seguinte, substituímos todas as instâncias de nginx por /.nginx, utilizando-os para recarregar e sair do programa.

Lista de comandos Nginx na janela do PowerShell.

3. Usando o IIS Manager

Você também pode usar o Internet Information Services (IIS) para executar o Nginx, que é um servidor web da Microsoft que serve páginas HTML ou arquivos solicitados. No passado, isso era obrigatório, mas não é mais o caso.

  1. Você pode habilitá-lo em “Ativar ou desativar recursos do Windows” no Painel de Controle. Marque os campos necessários para “Ferramentas de Gerenciamento da Web” e “Console de Gerenciamento do IIS.”

Ativar o Console de Gerenciamento do IIS sob os Serviços de Informações da Internet.

  1. Pode levar um tempo para o IIS ser habilitado em seu computador enquanto as mudanças são aplicadas.

Aplicando mudanças para ativar recursos do Windows na janela.

  1. Você verá um status de sucesso que “o Windows concluiu as alterações solicitadas.”

O Windows concluiu as alterações solicitadas para ativar os recursos necessários com o Console do IIS.

  1. Você pode abrir o Gerenciador do IIS diretamente no menu Iniciar. Sempre abra no modo Administrador.

Abrir o aplicativo Gerenciador do IIS a partir do menu Iniciar em modo Administrador.

  1. Aqui, você poderá acessar o site padrão, que geralmente está localizado em “inetpub wwwroot.” Isso também é conhecido como a raiz da aplicação web. Você pode procurá-lo no Explorer de Arquivos através de uma busca simples.
  2. Quando você clicar duas vezes na opção “site web padrão” no Gerenciador do IIS, isso deve levar a esta nova pasta. Como alternativa, você pode clicar com o botão direito no menu e selecionar “Explorar” para obter o mesmo resultado.

Pasta raiz do PC como identificada usando o Gerenciador do IIS.

  1. Uma vez que seu Console do IIS esteja habilitado, você pode visualizar sua página web digitando localhost no seu navegador padrão.

Local Host no Nginx apontando para o site do IIS.

Como Configurar o Nginx Para Windows

Para executar o Nginx no Windows, todas as alterações desejadas são feitas a partir de várias strings modificadas nos arquivos “index.html” e “nginx.conf” na pasta de instalação. Essas strings geralmente são editadas usando o editor de texto Notepad, mas você pode usar qualquer outro editor como Atom, Notepad++ ou Visual Studio Code. Neste caso, editaremos o arquivo de configuração usando o Notepad++.

  1. Vá para a pasta onde você salvou seu aplicativo Nginx. Clique na subpasta “html”.

Subpasta HTML na pasta Nginx.

  1. Clique com o botão direito para selecionar “Editar com Notepad++” para o arquivo index.html.

Clique com o botão direito para editar o arquivo Index HTML na pasta Nginx usando o Notepad++.

  1. Você pode editar o arquivo index.html na pasta raiz em uma nova ou separada aba. Mude o texto para o que você quer que o servidor web exiba na tela.
  2. Não se esqueça de clicar no botão “Salvar” na parte superior assim que estiver feito.
  3. Saia do programa Nginx.exe usando “Finalizar Tarefa”, conforme mostrado na seção acima, e reinicie-o.

Editando o arquivo HTML do Nginx com mudanças de texto e salvando o arquivo.

  1. Digite localhost em uma janela do navegador. O servidor web Nginx destacará as edições que você fez.

Texto editado visualizado como localhost no navegador padrão.

  1. Após isso, clique em “Conf” e clique com o botão direito para selecionar “nginx.conf” seguido de “Editar com Notepad++.”

Clique com o botão direito para editar o arquivo Conf do Nginx com Notepad++.

  1. Encontre a localização da raiz e mude-a do padrão html para qualquer outro caminho físico.

Mudando o caminho da raiz do arquivo Conf utilizando o Notepad++.

Para saber mais sobre comandos do Nginx, incluindo a documentação, visite este link.

Exemplo de Aplicação do Nginx no Windows

O Nginx suporta várias aplicações no Windows, como servidor web, balanceador de carga, proxy reverso ou até mesmo hospedar seu próprio site do Youtube. O site de recursos do Nginx tem uma lista completa de aplicações de servidor web que você pode usar para executar várias aplicações em um PC com Windows.

Por exemplo, você pode usar o Nginx no Windows para vincular a uma página web, como uma página de login de cliente. Assim que você fizer as alterações de configuração no arquivo “nginx.conf”, seus usuários finais poderão acessar a página de login do lado deles.

  1. Volte para o arquivo “nginx.conf” compartilhado na seção anterior. Em vez de “somename”, você precisa de um nome de domínio para o servidor acessar.

Adicionando um nome de domínio no arquivo Conf do Nginx.

  1. Vá até “location” e modifique o texto usando um “api”, seguido de um servidor proxy adicionado com um ping “http”. Isso deve apontar para qualquer página de login que você queira que esta página direcione. Aqui temos um campo “proxy_pass” que possui uma URL “127.0.0.1” local à sua máquina Windows.
  2. Salve o arquivo e execute o programa “Nginx.exe” em modo Admin.

Substitua o caminho Proxy por uma página de login no arquivo Conf do Nginx.

  1. Como mostrado aqui, 127.0.0.1 é o que o Nginx.exe aponta, e este é o caminho que você pode modificar no arquivo Conf acima para apontar para um portal ou servidor web externo de clientes.

Página 127.0.0.1 visível no navegador com Nginx.

Perguntas Frequentes

Como resolver o erro “O sistema não consegue encontrar o caminho especificado” do Nginx no Windows?

Às vezes, ao executar o Nginx no Prompt de Comando/Powershell do Windows, você pode encontrar um erro “O sistema não consegue encontrar o caminho especificado”. Para evitá-lo, vá até a pasta onde você salvou o aplicativo Nginx.exe e clique com o botão direito nele para visualizar suas propriedades, o que dará o caminho exato em que ele está localizado. Pode haver alguns outros motivos por trás disso, e temos um guia detalhado para resolver o problema.

Quais são as desvantagens do Nginx no Windows?

Apesar de suportar o Windows, o Nginx não é a melhor escolha para o sistema operacional. Sua maior desvantagem é que ele é incapaz de multitarefa. Por exemplo, você pode executar apenas um processo por vez. Se você estiver executando um servidor web, sua máquina Windows estará ocupada com essa única tarefa. Isso apresenta desafios em escalabilidade, e um único dispositivo Windows não é suficiente para trabalhar com o Nginx.

Quão popular é o Nginx?

O Nginx é uma das principais empresas de servidores web hoje. Além disso, é mais rápido, pode lidar com mais problemas simultâneos e é confiável. Resumindo, se você tem um site simples que deseja conectar ao Nginx, você pode fazê-lo agora sem problemas. Continue lendo para conferir a comparação do Nginx com o OpenLiteSpeed.

Todas as imagens e capturas de tela de Sayak Boral.