{"canonical_url":"https://engineer.company/uk/glossary/nginx/","content_markdown":"# nginx\n\n## Що це таке\n\nnginx — це програма з відкритим кодом, яка приймає HTTP-з'єднання і на кожен\nзапит або відповідає файлами з диска, або передає його іншому серверу й\nповертає клієнтові отриману відповідь. Назву вимовляють як «engine x», а\nвласні сторінки проєкту пишуть її також NGINX. Автор програми — Ігор Сисоєв, і\nперша публічна версія, 0.1.0, вийшла 4 жовтня 2004 року. Користуватися нею\nможна безкоштовно за двопунктовою ліцензією BSD, а F5, Inc. продає корпоративні\nдистрибутиви, підтримку й навчання.\n\nПроєкт перелічує шість ролей: HTTP-сервер, зворотний проксі, кеш вмісту,\nбалансувальник навантаження, проксі для TCP і UDP та поштовий проксі. На\nвебхостингу nginx зазвичай виконує одну або обидві з двох робіт: віддає\nстатичні файли з диска і стоїть перед сервером застосунку, де завершує TLS і\nпередає кожен запит усередину.\n\nПід час запуску nginx створює один головний процес (master) і кілька робочих\n(worker). Головний читає й перевіряє конфігурацію та наглядає за робочими.\nРобочі процеси працюють від імені непривілейованого користувача й виконують\nусю обробку запитів. Кожен із них використовує цикл подій, побудований на\nepoll у Linux і kqueue у FreeBSD, тож кілька робочих процесів можуть тримати\nвідкритими тисячі з'єднань одночасно. Директива worker_processes задає їхню\nкількість — або фіксованим числом, або значенням auto, тобто по одному на ядро\nпроцесора, — а перелік можливостей проєкту оцінює 10 000 неактивних\nkeep-alive-з'єднань приблизно у 2,5 МБ пам'яті.\n\nКонфігурація — це текстовий файл із директив. Проста директива складається з\nназви й параметрів і закінчується крапкою з комою. Блокова директива обгортає\nінші директиви у фігурні дужки, а блок, що може містити директиви, називають\nконтекстом. Контексти events і http розташовані на верхньому рівні. Усередині\nhttp кожен блок server описує один віртуальний сервер, який обирають за\nадресою й портом, де він слухає, а тоді за іменем хоста, яке запитав клієнт.\nУсередині блоку server кожен блок location визначає, що робити з певною\nродиною шляхів запиту.\n\n## Чому це важливо\n\nВебсервер — єдина програма, з якою стикається кожен відвідувач, тож його\nповедінка під навантаженням і його типові налаштування стосуються всіх. На\nкористь nginx говорять дві властивості.\n\nПерша — те, як дешево він тримає повільні з'єднання. Буферизацію відповідей\nвід сервера за проксі ввімкнено за замовчуванням: nginx забирає відповідь\nбекенда так швидко, як бекенд її видає, записує її в тимчасовий файл, коли\nвона не вміщається в пам'ять, а тоді віддає клієнтові в тому темпі, який\nклієнт витримує. Сервер застосунку вже вільний для наступного запиту, поки\nтелефон зі слабким сигналом ще завантажує попередню відповідь.\n\nДруга — зміни конфігурації набирають чинності без утрати запитів. Відредагована\nконфігурація діє лише після перезавантаження (reload) або перезапуску. Під час\nreload головний процес перевіряє нову конфігурацію й пробує її застосувати.\nЯкщо це вдається, стартують нові робочі процеси з нею, а старі перестають\nприймати з'єднання, завершують запити, які вже обробляють, і виходять. Якщо\nні, головний процес відкочує зміни й далі обслуговує зі старою конфігурацією.\nПроєкт також згадує оновлення самого виконуваного файлу без переривання\nклієнтів.\n\nПлатити за це доводиться мовою конфігурації: саме її правила пріоритету й\nуспадкування ховають більшість несподіванок. Для шляху запиту nginx спершу\nзнаходить location із найдовшим збіжним префіксом і запам'ятовує його, потім\nперебирає location із регулярними виразами в тому порядку, в якому вони стоять\nу файлі, і бере перший, що збігся. Запам'ятований префікс лишається запасним\nваріантом на випадок, коли регулярні вирази не дали результату. Location,\nпозначений `=`, вимагає точного збігу шляху й одразу завершує пошук, а `^~` на\nнайдовшому префіксі велить nginx пропустити регулярні вирази. Деякі директиви,\nсеред них add_header і proxy_set_header, успадковуються з охопного рівня лише\nтоді, коли поточний рівень не задає власних.\n\nСертифікати довго надходили від ACME-клієнта, що працював поруч із nginx.\nТепер проєкт пропонує також модуль ngx_http_acme_module, який постачають\nокремо від основної збірки.\n\n## Як це виглядає на практиці\n\nДві роботи з хостингу, виконані засновницею на попередніх посадах, стосуються\nnginx; в обох він ділив сервери з Apache, а не замінював його.\n\nПерша —\n[сорок клієнтських вебсайтів, які мали бути швидкими й завжди доступними](/uk/portfolio/administered-40-websites-on-apache-and-nginx/).\nВони стояли на серверах з Ubuntu Linux, де використовували і Apache, і nginx.\nРобота полягала в тому, щоб писати їхню конфігурацію, налаштовувати швидкодію\nй доглядати за ними, поки ними користувалися справжні відвідувачі, і всі сорок\nлишалися високодоступними. Два вебсервери в одному парку означають кожне\nправило двома діалектами: віртуальний хост Apache — це блок server у nginx, і\nвиправлення, знайдене для одного, треба перекласти для іншого.\n\nДруга тривала з 2015 до 2022 року.\n[Автоматизація на ACME взяла на себе сертифікати ста застосунків Docker](/uk/portfolio/automated-ssl-tls-certs-for-100-docker-apps/):\nвона видавала кожен сертифікат, поновлювала його ще до кінця строку дії й\nустановлювала на хости з Ubuntu без участі людини, і на тих хостах так само\nпрацювали і Apache, і nginx. Для nginx оновлений файл на диску — лише половина\nтакої зміни. Сертифікат, указаний звичайним шляхом, nginx читає, коли\nзавантажує конфігурацію, а документація зазначає, що лише ім'я файлу, складене\nзі змінних, змушує його завантажувати сертифікат заново під час кожного\nTLS-рукостискання. Тож поновлення, яке записує нові файли, доходить до\nвідвідувачів лише після reload, і будь-яке автоматичне поновлення для nginx\nмусить ним завершуватися.\n\n## Де виникають проблеми\n\n**Заголовок, заданий для всього сайту, зникає на одному шляху.** Location, що\nмає хоч один власний add_header, не успадковує заголовків із рівнів server чи\nhttp, тож один заголовок кешування, доданий до окремого location, непомітно\nскасовує всі заголовки безпеки над ним. proxy_set_header підкоряється тому\nсамому правилу. До того ж add_header діє лише для кодів успіху й\nперенаправлення, як-от 200, 301 і 304, якщо не додати `always`, тож сторінки\nпомилок ідуть без цих додаткових заголовків. Тримайте спільні заголовки в одному файлі, який\nпідключає include на кожному рівні, що задає власні, або з версії 1.29.3\nзадайте `add_header_inherit merge;`, додайте `always` там, де вони потрібні\nвідповідям із помилками, і перевірте кожен шлях через `curl -sI`.\n\n**На запити до одного сайту відповідає інший.** nginx спершу зіставляє адресу\nй порт, а тоді заголовок Host зі server_name. Коли ім'я невідоме всім блокам\nserver на цьому порту, запит отримує сервер за замовчуванням — перший у\nсписку, якщо інший не позначено default_server. Друкарська помилка в\nserver_name нового сайту тихо віддає сторінки старого сусіда. Оголосіть явний\nсервер за замовчуванням, який на невідомі імена відповідає `return 444`, тобто\nзакриває з'єднання, щоб помилка виявлялася як помилка, а не як чужий сайт.\n\n**Завантаження файлів падають з 413 Request Entity Too Large.**\nclient_max_body_size за замовчуванням дорівнює 1 МБ, і nginx відхиляє більше\nтіло запиту ще до того, як його побачить застосунок. Підніміть ліміт у тому\nlocation, що приймає завантаження, а не для всього сервера, і тримайте його\nузгодженим із власним лімітом застосунку.\n\n**Бекенд будує посилання на хибний хост або отримує хибний шлях.** Якщо не\nвказати інакше, nginx надсилає серверу за проксі заголовок Host, складений з\nадреси в proxy_pass, наприклад `127.0.0.1:8080`, тож застосунок генерує\nперенаправлення й абсолютні посилання на цю адресу. Задайте\n`proxy_set_header Host $host;` у location, що проксіює запити. Шляхи залежать\nвід форми proxy_pass: записаний з URI, навіть з одним `/`, він замінює ту\nчастину шляху, що збіглася з location, а без URI передає шлях без змін.\nОбирайте форму свідомо й перевірте вкладений шлях.\n\n**Клієнти й далі отримують стару конфігурацію або старий сертифікат.**\nВідредагований файл чи сертифікат, поновлений уночі, не впливає на запущений\nnginx до reload, а reload зламаної конфігурації лишає на місці стару.\nПеревіряйте конфігурацію перед кожним reload, тоді читайте журнал помилок і\nдивіться, що клієнти отримують насправді:\n\n```sh\nnginx -t \u0026\u0026 nginx -s reload\nopenssl s_client -connect example.com:443 \\\n  -servername example.com \u003c/dev/null |\n  openssl x509 -noout -enddate\n```\n\n## Що почитати далі\n\n- [nginx documentation](https://nginx.org/en/docs/)\n  — покажчик проєкту з посібниками й довідниками директив для кожного модуля.\n- [Beginner's Guide](https://nginx.org/en/docs/beginners_guide.html)\n  — головний і робочі процеси, перезавантаження та будова конфігурації.\n- [How nginx processes a request](https://nginx.org/en/docs/http/request_processing.html)\n  — як блок server обирають за адресою, портом і заголовком Host.\n- [Module ngx_http_core_module](https://nginx.org/en/docs/http/ngx_http_core_module.html)\n  — порядок зіставлення location, server_name і client_max_body_size.\n- [Module ngx_http_proxy_module](https://nginx.org/en/docs/http/ngx_http_proxy_module.html)\n  — proxy_pass, типові заголовки, тайм-аути й буферизація відповідей.\n- [Module ngx_http_headers_module](https://nginx.org/en/docs/http/ngx_http_headers_module.html)\n  — add_header, коди відповідей, для яких він діє, і його правило успадкування.\n\n\u003chttps://engineer.company/uk/glossary/nginx/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Як nginx обирає блок server і location для кожного запиту, чому перезавантаження не зачіпає запитів у роботі й які типові значення дивують.","formats":{"gemtext":"https://engineer.company/uk/glossary/nginx/index.gmi","gopher":"https://engineer.company/uk/glossary/nginx/gophermap","html":"https://engineer.company/uk/glossary/nginx/","json":"https://engineer.company/uk/glossary/nginx/index.json","markdown":"https://engineer.company/uk/glossary/nginx/index.md","pdf":"https://engineer.company/uk/glossary/nginx/index.pdf"},"kind":"page","language":"uk","title":"Що таке nginx?","url":"https://engineer.company/uk/glossary/nginx/","version":1}