Версия nginx под Windows использует “родной” Win32 API (не эмуляцию Cygwin).
В настоящий момент в качестве методов обработки соединений используются
select() и poll() (1.15.9),
поэтому не стоит ожидать высокой производительности и масштабируемости.
В силу этого и ряда других известных проблем версия nginx под Windows
рассматривается пока как бета-версия.
На данный момент в ней доступна практически вся функциональность, что и
в версии nginx под UNIX, за исключением
XSLT-фильтра, фильтра изображений, модуля GeoIP и встроенного языка Perl.
Чтобы установить nginx/Windows, скачайте
дистрибутив последней основной версии (1.25.2),
поскольку основная ветвь nginx содержит все известные исправления.
Затем распакуйте дистрибутив, перейдите в каталог
nginx-1.25.2
и запустите nginx.
Вот пример для корневого каталога на диске C:
cd c:\ unzip nginx-1.25.2.zip cd nginx-1.25.2 start nginx
Чтобы увидеть процессы nginx, запустите утилиту командной строки
tasklist:
C:\nginx-1.25.2>tasklist /fi "imagename eq nginx.exe" Image Name PID Session Name Session# Mem Usage =============== ======== ============== ========== ============ nginx.exe 652 Console 0 2 780 K nginx.exe 1332 Console 0 3 112 K
Один из процессов главный, другой — рабочий.
Если nginx не запускается, нужно искать причину в
в файле лога ошибок logs\error.log.
Если же лог-файл не создался, то причину этого следует искать
в Windows Event Log.
Если вместо ожидаемой страницы выводится страница с ошибкой, нужно также
искать причины ошибки в файле logs\error.log.
nginx/Windows использует каталог, в котором он был запущен, в качестве
префикса для относительных путей в конфигурации.
В вышеприведённом примере префиксом является
C:\nginx-1.25.2\.
Пути в конфигурационном файле должны задаваться в UNIX-стиле с использованием
прямых слэшей:
access_log logs/site.log; root C:/web/html;
nginx/Windows работает как стандартное консольное приложение (не сервис)
и управляется при помощи следующих команд:
nginx -s stop быстрое завершение nginx -s quit плавное завершение nginx -s reload изменение конфигурации,
запуск новых рабочих процессов с новой конфигурацией,
плавное завершение старых рабочих процессовnginx -s reopen переоткрытие лог-файлов
Известные проблемы
-
Хоть и возможен запуск нескольких рабочих процессов, только один из них
реально работает. - Проксирование по UDP не поддерживается.
Возможные усовершенствования в будущем
- Запуск в виде сервиса.
-
Использование портов завершения ввода-вывода (I/O completion ports)
в качестве метода обработки соединений. - Использование нескольких рабочих нитей внутри одного рабочего процесса.
Как установить и запустить сервер Nginx на Windows 10
Nginx — это веб-сервер, который очень популярен в Linux и BSD системах. Многие полагают, что установить Nginx на Windows 10 невозможно. Это совсем не так.
Согласно информации, размещенной на сайте Nginx, установка на Windows 10 возможна, но есть несколько ограничений производительности, которые пока не были устранены. К ним относятся только одно рабочее веб-приложение, отсутствие масштабируемости и возможные проблемы с UDP аутентификацией. На данный момент Nginx уже упоминал, что он решит все проблемы в своих будущих выпусках.
Чтобы успешно установить и запустить Nginx на Windows 10, выполните следующие действия.
Загрузите Nginx Server
Существует много загружаемых версий Nginx для Windows, но Nginx рекомендует использовать “mainline version”. Однако, вы не найдете никаких проблем, если загрузите последнюю стабильную версию этой программы.
Выберите последний ZIP-файл и загрузите его в новую папку.
В качестве первого шага необходимо распаковать его. Вы можете использовать 7-Zip, WinRAR или любое другое популярное программное обеспечение для архивации.
После извлечения содержимого архива из первоначальной директории необходимо переместить папку, которая поставлялась со встроенной загрузочной копией. в «Program Files».
Мы запустим Nginx из этого места в качестве веб-сервиса по умолчанию.
Чтобы установить и запустить Nginx, выберите и дважды щелкните файл Nginx.exe.
На следующем шаге вам нужно проверить, была ли установка успешной. Для этого вы можете перейти в браузер по умолчанию и ввести “localhost”. Если вы увидите следующее окно с сообщением об успешной установке и работе веб-сервера Nginx, то проблем с установкой в Windows 10 не было.
Чтобы остановить Nginx, вы можете завершить его из окна Диспетчер задач.
Запуск Nginx на компьютере с ОС Windows
Для запуска Nginx, вы должны использовать Internet Information Services (IIS), который является веб-сервером Microsoft, обслуживающим запрошенные HTML страницы или файлы. Вы можете включить его в меню Turn Windows Features On or Off в Панели управления. Проверьте необходимые поля для Web Management Tools и IIS Management Console.
Для включения IIS на вашем компьютере потребуется некоторое время.
Менеджер IIS Manager можно открыть непосредственно из меню Пуск. Здесь вы сможете получить доступ к веб-сайту по умолчанию, который обычно расположен по адресу “inetpub wwwroot”. Он также известен как корень веб-приложения.
Полезно изменить физический путь этого корня в более подходящую папку. Я создал новую папку “Work” в C:\ и изменил физический путь на “C:\Work”.
После этого перейдите в папку Nginx, которую переименовали в файлах программы. Нажмите “Conf” и выберите “nginx.conf”. Этот файл можно редактировать с помощью текстового редактора Notepad++.
В Notepad++ измените корень на отредактированный физический путь, о котором мы говорили выше.
Вы можете отредактировать файл index.html в корневой папке на отдельной вкладке. Измените текст на то, что вы хотите, чтобы веб-сервер отображался на экране.
Теперь снова запустите программу Nginx.exe и введите “localhost” в окне браузера. Веб-сервер Nginx выделит сделанные вами изменения.
На сайте ресурсов Nginx представлен полный список веб-приложений, которые можно использовать для запуска на Windows PC.
Вывод
Nginx является одной из ведущих компаний по разработке веб-серверов, которая, как ожидается, затмит Apache в будущем. Кроме того, он быстрее, может справляться с большим количеством параллельных задач и надежен. Подводя итог, можно сказать, что если у вас есть простой сайт, который вы хотите подключить к Nginx, вы можете сделать это прямо сейчас без каких-либо проблем.
Спасибо, что читаете! На данный момент большинство моих заметок, статей и подборок выходит в telegram канале «Левашов». Обязательно подписывайтесь, чтобы не пропустить новости мира ИТ, полезные инструкции и нужные сервисы.
Респект за пост! Спасибо за работу!
Хотите больше постов в блоге? Подборок софта и сервисов, а также обзоры на гаджеты? Сейчас, чтобы писать регулярно и радовать вас большими обзорами, мне требуется помощь. Чтобы поддерживать сайт на регулярной основе, вы можете оформить подписку на российском сервисе Boosty. Или воспользоваться ЮMoney (бывшие Яндекс Деньги) для разовой поддержки:
Заранее спасибо! Все собранные средства будут пущены на развитие сайта. Поддержка проекта является подарком владельцу сайта.
Nginx is an open-source, high-performance HTTP server and reverse proxy server. It also functions as a mail proxy server and a generic TCP/UDP proxy server. Renowned for its stability, rich feature set, simple configuration, and low resource consumption, Nginx is often used as a web server or reverse proxy.
This article provides a comprehensive guide on how to install Nginx on a Windows-based operating system. It is worth noting that while Nginx does provide a Windows version, it is mostly recommended for development and testing purposes. For production environments, Linux distributions are typically preferred.
Prerequisites
Before you start with the installation process, make sure you have administrative rights on your Windows system, as they are required for software installation. Additionally, ensure your system meets the minimum hardware requirements for Nginx.
Step 1: Downloading Nginx
- Go to the Nginx download page.
- Under the “Mainline version”, click on the zip file link for the latest Windows version. The file will start downloading.
Downloading Nginx for Windows
Step 2: Extracting Nginx
- Once downloaded, locate the zip file, typically in your Downloads folder.
- Extract the zip file to your desired location. For this guide, we will use C:\nginx.
Extracted Nginx code in C:\nginx directory
Step 3: Running Nginx
- Open the Command Prompt with administrative privileges. You can do this by searching for ‘cmd’ in the Start menu, right-clicking on Command Prompt, and selecting “Run as administrator”.
- Navigate to the directory where you extracted Nginx. You can do this by typing cd C:\nginx and hitting Enter.
- Start Nginx by typing start nginx and hitting Enter.
cd C:\nginxstart nginx.exe
Starting Nginx service on Windows - Nginx should now be running on your Windows machine. You can check this by opening a web browser and navigating to http://localhost. If Nginx has started successfully, you will see a welcome page.
Verify Nginx on Windows
Step 4: Managing Nginx
Here are some basic commands you can use to manage Nginx:
- To stop Nginx, use the command `nginx -s stop`.
- To quit Nginx gracefully, use `nginx -s quit`.
- To reload the Nginx configuration file, use `nginx -s reload`.
- To reopen the Nginx log files, use `nginx -s reopen`.
Remember to run these commands from the directory where Nginx is installed.
Step 5: Configuring Nginx
The primary configuration file for Nginx is nginx.conf, located in the conf subdirectory of the directory where Nginx was extracted. The configuration file is well-commented and provides a good starting point for configuring your server.
For Nginx to serve your website, you need to edit this file with your specific parameters. You may need to set up server blocks (similar to Apache’s virtual hosts) to specify the document root and other parameters for your website.
After making changes to the configuration file, remember to reload Nginx so that the changes take effect.
Conclusion
This guide provided a basic introduction to installing Nginx on a Windows system. While this should get you started, Nginx’s true power comes from its extensive configurability, allowing you to optimize it for your specific needs. Be sure to check out the official Nginx documentation for more detailed information on how to harness this power.
Nginx is a web server that is very popular with Linux and BSD systems. It can also be installed on Windows as long as you can live with performance limitations that have not been mitigated so far. You can still host a web server or a customer/employee portal from the comfort of your Windows laptop. To install and run Nginx successfully on Windows, follow the steps below.
Content
- Installing Nginx in Windows
- How to Start Nginx on Windows
- 1. Using Nginx Application File
- 2. Using PowerShell
- 3. Using IIS Manager
- How to Configure Nginx For Windows
- Example Application of Nginx in Windows
- Frequently Asked Questions
Tip: if all you need is a local web server to test your applications, here are the ways to set up a local web server in Windows.
Installing Nginx in Windows
To get started, we will need to install Nginx on your Windows laptop or PC. There are no conventional Nginx installers with this operating system. You will need to download one of its online versions and save it to a C: drive location of your PC.
- Select the version you want and download its zip file to your PC. Nginx recommends using the «mainline version» as it comes with the latest features. If you don’t need those features, the most recent stable version will work too.
- Once downloaded, extract the new folder by right-clicking on it. You may also use popular compression software such as 7-zip or WinRAR.
- Move the entire folder that came with the built-in download copy into the C: drive. In this example, we moved it to «Program Files» but it can be saved at any location on your PC including D drive.
- Select and double-click the «Nginx.exe» file. It has now been activated for further use. We will run Nginx from this location as a default web service program.
- If you have enabled Windows SmartScreen filter, it may prevent the Nginx installer from running. Click «More info» to bypass the limitation.
- Click the «Run anyway» text to run the nginx.exe file.
- You may further run into a Windows Defender firewall block screen while running the Nginx server, which has to be allowed by you. Once done, you can readily use Nginx on your Windows device.
Do you know: wondering what is the difference between Nginx and Apache? We have the answers here.
There are multiple ways to run Nginx on your Windows PC depending on your end use requirements. You can use these methods simultaneously. For example, you can launch the Nginx server using its application file or from PowerShell.
1. Using Nginx Application File
Nginx has a built-in application file that you can double-click as described in above section. You will need to bypass any restrictions due to SmartScreen or Windows Defender.
- Once done, go to your default browser and type localhost. Microsoft Edge is the browser used in the below example.
- If you see a screen saying the Nginx web server is successfully installed and working, it means there were no problems with your Nginx installation in Windows.
- To stop Nginx, you can end it from the Task Manager window. If you can’t terminate it directly from the Processes, right click to select «Go to details.»
- Identify all instances of Nginx.exe and right click to end each task.
- Ignore any warning such as «do you want to end Nginx.exe.» Click «End process» to continue with the termination.
- When you type localhost, you will see a «can’t reach this page» screen on your browser web page.
2. Using PowerShell
The best part of Nginx is that it can run as an automated script from PowerShell and also the Command Prompt. We will demonstrate that for PowerShell below.
- Launch PowerShell in Administrator mode.
- Go back to the folder where you saved the Nginx application, and right-click to go to its Properties. Here you can copy the exact folder path. In this example, it is «C:\nginx-1.25.1\nginx-1.25.1»
- Change the PowerShell directory to point to the above path.
cd Path of Nginx installer
- To initiate the Nginx server, type the following command.
- You can view Nginx.exe process instances in Task Manager nested under Windows PowerShell.
- On Windows, Nginx can be run as a standard console app. For managing it, the following simple commands are frequently used:
nginx -s stop |
Rapid shutdown |
nginx -s quit |
Graceful shutdown |
nginx -s reload |
Changing configuration, starting new worker processes with a new configuration, graceful shutdown of old worker processes |
nginx -s reopen |
Reopening log files |
- If you encounter any error such as «the command nginx was not found, but does exist in the current location,» PowerShell will prompt you to use a different command. In the following example, we have replaced all instances of
nginxwith/.nginx, using them to reload and quit the program.
3. Using IIS Manager
You can also use Internet Information Services (IIS) to run Nginx which is a Microsoft web server that serves requested HTML pages or files. In the past, it was compulsory but it’s no longer the case.
- You can enable it in «Turn Windows Features On or Off» in the Control Panel. Check the required fields for «Web Management Tools» and «IIS Management Console.»
- It will take a while for IIS to be enabled on your computer as the changes are applied.
- You will see a success status that «Windows completed the requested changes.»
- You can open IIS Manager directly from the Start menu. Always open it in Administrator mode.
- Here, you will be able to access the default website, which is usually located at «inetpub wwwroot.» This is also known as the web application root. You can look for it in File Explorer through a simple search.
- When you double-click on the «default web site» option in IIS Manager, it should lead to this new folder. Alternatively, you can right-click the menu and select «Explore» for the same result.
- Once your IIS Console is enabled, you can view its webpage by typing localhost on your default browser.
How to Configure Nginx For Windows
To run Nginx in Windows, all desired changes are affected from various strings modified in the «index.html» and «nginx.conf» files in the installation folder. These strings are usually edited using the Notepad text editor, but you can use any other editor such as Atom, Notepad++ or Visual Studio Code. In this case, we will edit the configuration file using Notepad++.
- Go to the folder where you saved your Nginx application. Click the «html» subfolder.
- Right click to select «Edit with Notepad++» for the index.html file.
- You can edit the index.html file in the root folder in a new or separate tab. Change the text to what you want the web server to display on the screen.
- Don’t forget to click the «Save» button on top once you’re done.
- Exit the Nginx.exe program using «End Task» as shown in above section and restart it.
- Type localhost in a browser window. The Nginx web server will highlight the edits you made.
- After this, click «Conf» and right click to select «nginx.conf» followed by «Edit with Notepad++.»
- Find the location of the root and change it from the default html to any other physical path.
To know more about Nginx commands, including the documentation, visit this link.
Example Application of Nginx in Windows
Nginx supports multiple applications in Windows, such as web server, load balancer, reverse proxy, or even host your own Youtube site. The Nginx resources site has a full list of web server applications which you can use to run various applications on Windows PC.
For example, you can use Nginx in Windows to link to a webpage such as a customer login page. Once you make the configuration changes in the «nginx.conf» file, your end users will be able to access the login page on their end.
- Go back to the «nginx.conf» file shared in the previous section. Instead of «somename,» you need a domain name for the server to access.
- Go to «location» and modify the text using an «api,» followed by a proxy server added with an «http» ping. This should point to any login page you want this page to direct to. Here we have a «proxy_pass» field which has a «127.0.0.1′ URL local to your Windows machine.
- Save the file and run the «Nginx.exe» program in Admin mode.
- As shown here, 127.0.0.1 is what Nginx.exe points to, and this is the path you can modify in above Conf file to point to an external customer portal or web server.
Frequently Asked Questions
How to solve Nginx’s «The system cannot find the path specified» error in Windows?
Sometimes while running Nginx in Windows Command Prompt/PowerShell, you may run into a «System cannot find the path specificed» error. To avoid it, go to the folder where you saved the Nginx.exe application, and right click on it to view its properties, which will give the exact path it is located. There could be a few other reasons behind this, and we have a detailed guide to fix the issue.
What are the disadvantages of Nginx in Windows?
Even though it supports Windows, Nginx is not the best choice for the operating system. Its biggest disadvantage is that it’s incapable of multitasking. For instance, you can execute only one process at a time. If you are running a web server, your Windows machine will be occupied with that one task. This poses challenges in scalability, and one Windows device isn’t sufficient to work with Nginx.
How popular is Nginx?
Nginx is one of the leading web server companies today. Also, it is faster, can handle more concurrent issues and is reliable. To summarize, if you have a simple website you want to connect to Nginx, you can do it right now without any problems. Read on to check out the comparison of Nginx to OpenLiteSpeed.
All images and screenshots by Sayak Boral.
Sayak Boral is a technology writer with over eleven years of experience working in different industries including semiconductors, IoT, enterprise IT, telecommunications OSS/BSS, and network security. He has been writing for MakeTechEasier on a wide range of technical topics including Windows, Android, Internet, Hardware Guides, Browsers, Software Tools, and Product Reviews.
Subscribe to our newsletter!
Our latest tutorials delivered straight to your inbox
next →
← prev
Installing NGINX on Windows
Nginx comes with pre-compiled binaries for windows which make it extremely easy to get started. If it did not come pre-compiled, we would need to have a compiler installed on our computer with a full environment. Fortunately, this is not the case.
To download the latest version of Nginx for Windows, use the following link: https://nginx.org/en/download.html
Once the downloading is done, we can extract it from any of our folders. Here, I am using the c:\nginx-1.17.0 directory.
Important locations:
- Confis in -> c:\nginx-1.17.0\conf\
- Default config -> c:\ nginx-1.17.0\conf\nginx.conf
- Logs will be in -> c:\ nginx-1.17.0\logs
- Default webroot is -> c:\ nginx-1.17.0\html\
- Default listen address -> http://localhost
Verify Nginx Windows Installation
To make sure that the Nginx is working properly, or installed successfully, open the command prompt on windows and then type the following, make sure that you update the environment path if you have installed in another folder.
C:\nginx\nginx.exe
We should be able to go to http://localhost, and we should see the «Welcome to Nginx» default page. If we see that page, then we can be sure that Nginx has been installed properly.
To operate for nginx, use the following command:
| Command | Description |
|---|---|
| nginx -s stop | fast shutdown |
| nginx -s quit | graceful shutdown |
| nginx -s reload | changing configuration, starting new worker processes with a new configuration, graceful shutdown of old worker processes |
| nginx -s reopen | reopening log files |
Next TopicInstalling Nginx Plus
← prev
next →