SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor

Що таке HTTP: посібник для адміністраторів серверів

Пояснення HTTP для адміністраторів: методи, коди стану, важливі заголовки, журнали nginx, а також місце HTTP/3 і TLS у стеку.

Що таке HTTP?

HTTP (протокол передавання гіпертексту) — це набір правил, за якими клієнт і вебсервер запитують і передають дані. Клієнт надсилає запит: метод, наприклад GET, шлях, наприклад /pricing, версію протоколу, список заголовків і, за потреби, тіло запиту. Сервер відповідає кодом стану, наприклад 200, а потім надсилає власні заголовки та зазвичай тіло відповіді. Кожен перегляд сторінки та кожен виклик API (інтерфейсу прикладного програмування) на вашому сервері — це такий обмін, що повторюється.

HTTP не зберігає стану. Сервер не пам’ятає, що ви запитували секунду тому, тому все, що має поводитися як пам’ять, наприклад сеанс входу, передається в заголовку кожного окремого запиту. Ця властивість пояснює багато з описаного далі: кешування повністю керується заголовками, а балансувальник навантаження може надіслати наступний запит до іншого бекенду без порушення роботи.

Усе нижче показує, як ця модель виглядає на стороні сервера — у журналі доступу та конфігурації nginx.

Необроблені запит і відповідь з поясненнями

Ось повний запит HTTP/1.1. Порожній рядок завершує заголовки, а все після цього рядка є тілом. GET зазвичай не має тіла.

GET /pricing HTTP/1.1
Host: example.com
User-Agent: curl/8.5.0
Accept: */*
Accept-Encoding: gzip
  • GET — це метод, який визначає потрібну дію. GET читає дані, POST надсилає дані, PUT замінює ресурс, DELETE видаляє ресурс, а HEAD запитує заголовки GET без тіла.
  • /pricing — це шлях. Ім’я хоста не входить до рядка запиту, тому існує наступний заголовок.
  • HTTP/1.1 — це версія протоколу, яку використовує клієнт.
  • Host: example.com визначає сайт, який потрібен клієнту. HTTP/1.1 вимагає цей заголовок, тому nginx відповідає на запит без нього кодом 400 Bad Request.
  • Решта — це параметри. Accept-Encoding: gzip означає, що клієнт може розпаковувати дані, тому сервер може стиснути тіло.

Відповідь має таку саму структуру, але зверху містить рядок стану.

HTTP/1.1 200 OK
Date: Thu, 06 Aug 2026 09:12:44 GMT
Server: nginx
Content-Type: text/html; charset=utf-8
Content-Length: 5310
Cache-Control: public, max-age=300

<!doctype html>...
  • 200 OK — це код стану з фразою, що його пояснює. Важливий саме код. Фраза є лише додатковим текстом, і клієнти її ігнорують.
  • Content-Type повідомляє клієнту, як обробляти наступні байти.
  • Content-Length — це розмір тіла в байтах, тому клієнт знає, де воно завершується. Якщо розмір заздалегідь невідомий, сервер замість цього надсилає Transfer-Encoding: chunked і позначає кінець фрагментом нульової довжини.
  • Cache-Control повідомляє браузеру та будь-якому проміжному кешу, як довго цю відповідь можна вважати актуальною. Коли її вік перевищує max-age секунд, вона стає застарілою. Це не означає, що її видалено: кеш може зберегти застарілу копію та повторно перевірити її на сервері замість повторного завантаження всього тіла.
  • Порожній рядок після заголовків відокремлює їх від тіла в обох напрямках.

Назви заголовків нечутливі до регістру, а кожен рядок завершується поверненням каретки, за яким іде переведення рядка, а не лише переведенням рядка. Ви не вводитимете ці символи вручну, але побачите їх у перехопленні пакетів.

Щоб переглянути реальну пару, виконайте цю команду для сайту, яким ви керуєте:

curl -sS -o /dev/null -D - https://example.com/

-D - виводить заголовки відповіді у ваш термінал, а -o /dev/null відкидає тіло. Використовуйте цей варіант замість curl -I, оскільки -I надсилає запит HEAD. Сервер застосунків, який обробляє HEAD інакше, ніж GET, а так роблять багато серверів, покаже вам заголовки, які браузер ніколи не отримує. curl -v виводить обидві сторони, позначаючи рядки запиту як >, а рядки відповіді — як <.

Як виглядає рядок запиту в журналі доступу nginx

nginx постачається з форматом журналу combined, і його визначення має такий вигляд:

log_format combined '$remote_addr - $remote_user [$time_local] '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';

Ось один створений ним рядок:

203.0.113.45 - - [06/Aug/2026:09:12:44 +0000] "GET /pricing HTTP/1.1" 200 5310 "https://example.com/" "Mozilla/5.0 (X11; Linux x86_64) Chrome/127.0.0.0 Safari/537.36"
  • 203.0.113.45 — це $remote_addr, адреса, з якої відкрито TCP (протокол керування передаванням) з’єднання. За проксі це адреса проксі, а не відвідувача, якщо ви не налаштували модуль realip, описаний нижче, щоб замінити її.
  • Перше - — це фіксований заповнювач. Друге — $remote_user, яке заповнюється лише за використання базової HTTP-автентифікації.
  • "GET /pricing HTTP/1.1" — це $request, повний вихідний рядок запиту. За стандартного екранування журналу nginx подвійні лапки, зворотна коса риска та будь-який байт зі значенням менше 32 або більше 126 записуються як \xXX, тому рядок зберігається коректно, але не завжди побітово.
  • 200 — це статус, який повернув ваш сервер, а не статус, який побачив відвідувач.
  • 5310 — це $body_bytes_sent, лише тіло відповіді. Заголовки відповіді не враховуються, тому це значення завжди менше за фактичну кількість переданих байтів.
  • Останні два поля в лапках — це Referer і User-Agent. Обидва надходять від клієнта, тому можуть містити будь-які дані.

У журнал також потрапляють некоректні дані, але в екранованому вигляді. Клієнт, який установлює TLS (безпеку транспортного рівня) з’єднання з вашим незашифрованим портом 80, залишає рядок 400, у якому поле запиту починається з екранованих байтів на кшталт "\x16\x03\x01\x02\x00\x01". \x16 — це тип запису рукостискання TLS, тому ці байти є початком ClientHello, а не рядком запиту. Сервер працює правильно. HTTPS спрямовано на порт HTTP.

Також додайте $server_protocol до формату журналу. Він виводить HTTP/1.1, HTTP/2.0 або HTTP/3.0 і є найшвидшим способом підтвердити, що зміна протоколу справді набула чинності.

Що означають поширені коди стану, коли ваш сайт повертає їх

Перша цифра визначає клас. Саме з класу слід починати аналіз.

2xx означає, що запит виконано. 200 OK повертається для звичайного читання. 201 Created — після POST, який створив ресурс. 204 No Content означає успішне виконання без даних у відповіді. Зазвичай цей код повертається на DELETE.

3xx означає, що потрібно перейти в інше місце. 301 є постійним, і браузери наполегливо кешують його, іноді до очищення профілю користувача. Тому 301, що вказує на неправильне ім’я хоста, складно скасувати. Використовуйте 302, доки тестуєте редирект. 304 Not Modified означає успішне виконання, а не помилку: клієнт надіслав умовний запит — або If-None-Match із ETag (тегом сутності), який ви все ще розпізнаєте, або If-Modified-Since із датою, після якої ресурс не змінювався. Тому ви відповіли лише заголовками, без тіла відповіді. Велика кількість 304 у журналі означає, що кешування працює.

4xx означає, що запит був неправильним. 400 Bad Request означає некоректні вхідні дані. 401 Unauthorized фактично означає відсутність автентифікації. Відповідь має містити заголовок WWW-Authenticate із назвою схеми. 403 Forbidden означає, що запит зрозумілий, але все одно відхилений. 404 Not Found означає шлях, якого не існує, або існування якого сервер не хоче підтверджувати. Деякі застосунки повертають 404 замість 403, щоб приховати ресурс від клієнтів без доступу. 405 Method Not Allowed означає правильний шлях із неправильним методом. Саме це повертає POST для розташування статичних файлів. 413 означає, що тіло запиту перевищує значення client_max_body_size у nginx. Типове значення — 1 megabyte. Журнал помилок підтверджує це повідомленням client intended to send too large body.

403 для статичного файлу майже завжди вказує на проблему у файловій системі, а не в правилі HTTP. Перед зміною конфігурації прочитайте /var/log/nginx/error.log. open() "/srv/site/index.html" failed (13: Permission denied) означає, що користувач worker-процесу nginx не може прочитати файл. Найчастіше батьківський каталог не має дозволу на виконання для інших користувачів. directory index of "/srv/site/" is forbidden означає, що шлях вказує на каталог без index-файлу, коли autoindex вимкнено.

5xx означає, що проблема виникла на вашому боці. 500 — це загальна помилка сервера. На власному сайті вона зазвичай вказує на необроблену помилку в застосунку. 502 Bad Gateway означає, що nginx не отримав коректної відповіді від upstream. Журнал помилок вказує причину: connect() failed (111: Connection refused) while connecting to upstream означає, що на адресі з proxy_pass ніхто не приймає з’єднання. 504 Gateway Timeout означає, що nginx припинив очікування відповіді від upstream. Зазвичай upstream приймає з’єднання, але не надсилає дані протягом proxy_read_timeout, типове значення якого становить 60 seconds. Журнал записує це як upstream timed out (110: Connection timed out) while reading response header from upstream. Якщо спроба з’єднання не завершується протягом proxy_connect_timeout, типове значення якого також становить 60 seconds, результатом теж буде 504. У такому разі рядок журналу завершується на while connecting to upstream. 503 Service Unavailable означає, що сервер тимчасово не може обробити запит. Зазвичай причина полягає в перевантаженні або планових технічних роботах. Зверніть увагу: власний обмежувач швидкості nginx повертає 503, оскільки limit_req_status має типове значення 503. Якщо ви шукаєте 429 Too Many Requests у журналі, але знаходите 503, причина саме в цьому. Установіть limit_req_status 429;, щоб отримувати точний код.

Заголовки, які мають значення під час запуску сервера

Host визначає сайт. Одна IP-адреса може обслуговувати сотні імен хостів, а nginx зіставляє Host із server_name, щоб визначити, який блок server обробить запит. Якщо збігу немає, nginx використовує сервер за замовчуванням. Це перший блок, який прослуховує цю адресу й порт, якщо інший блок не позначено як default_server. Якщо після додавання нового virtual host повертається неправильний сайт, майже завжди причина саме в цьому: ім’я не збіглося, тому запит перейшов до сервера за замовчуванням. Перевірте це без зміни DNS:

curl -sS -o /dev/null -D - -H 'Host: app.example.com' http://127.0.0.1/

User-Agent — це опис клієнта, який клієнт надсилає у вигляді довільного тексту. Використовуйте його як підказку під час перегляду журналів. Не використовуйте його для керування доступом, оскільки клієнт, який хоче підробити це значення, просто підробить його. Тому блокування scraper за User-Agent відфільтрує лише сумлінних клієнтів.

Content-Type визначає, як інтерпретувати байти: application/json для API-запиту, text/html; charset=utf-8 для сторінки. nginx зіставляє розширення файлів із типами за допомогою /etc/nginx/mime.types, а пакетний nginx.conf задає default_type application/octet-stream;. Тому файл із розширенням, якого nginx не знає, пропонується для завантаження, а не відображається. Видима ознака — сторінка завантажується без стилів, а консоль браузера виводить Refused to apply style from ... because its MIME type ('text/plain') is not a supported stylesheet MIME type. MIME означає multipurpose internet mail extensions — схему іменування, з якої походять ці рядки типів.

Cache-Control дає змогу керувати кожним кешем між сервером і читачем. public, max-age=31536000, immutable підходить для ресурсів, у назві яких міститься хеш вмісту, оскільки назва змінюється разом зі зміною вмісту. no-store слід використовувати для всього, що залежить від користувача. Спільний кеш, який зберіг сторінку після входу в обліковий запис, передасть її наступній особі, яка запитає той самий URL. private — проміжний варіант: браузер може зберігати відповідь, а спільний кеш — ні.

X-Forwarded-For потрібен тому, що proxy приховує адресу відвідувача. Після проходження запиту через reverse proxy $remote_addr містить адресу proxy. Тому журнали, геолокація та обмеження частоти запитів бачать одного клієнта, доки ви не відновите початкову адресу. Proxy має передати початкову адресу:

proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;

Далі потрібно повідомити серверу, що цій адресі можна довіряти, і точно вказати, кому саме довіряти:

set_real_ip_from 10.0.0.0/8;
real_ip_header X-Forwarded-For;

Ці дві директиви належать до модуля realip у nginx. Він замінює $remote_addr переданою адресою та зберігає власну адресу з’єднання в $realip_remote_addr. Якщо ви компілюєте nginx самостійно, додайте --with-http_realip_module, оскільки цей модуль не входить до стандартної збірки.

Вказуйте лише діапазони, якими ви керуєте. X-Forwarded-For — це звичайний текст, який може надіслати будь-який клієнт, тому set_real_ip_from 0.0.0.0/0; дає відвідувачу змогу вибрати адресу, яку ви запишете в журнал і врахуєте під час обмеження частоти запитів.

X-Forwarded-Proto запобігає конкретній і дуже поширеній проблемі. Ваш proxy завершує TLS і передає запит застосунку через звичайний HTTP. Застосунок бачить звичайний запит, вирішує, що відвідувач має використовувати HTTPS, і відповідає 301 https://example.com/. Браузер переходить за цим перенаправленням, proxy знову завершує TLS і знову передає звичайний HTTP, тому цикл повторюється, доки браузер не припинить його з помилкою ERR_TOO_MANY_REDIRECTS. Передавання X-Forwarded-Proto: https повідомляє застосунку, що відвідувач уже використовує HTTPS, тому застосунок припиняє перенаправлення.

HTTP/1.1 проти HTTP/2 проти HTTP/3: що для вас змінюється

HTTP/1.1 використовує текстовий формат і на практиці обробляє один запит за раз для кожного з’єднання. Connection: keep-alive дає змогу наступному запиту повторно використати те саме TCP-з’єднання, що заощаджує час на встановлення, але відповіді все одно надходять у порядку надсилання запитів. Протокол також підтримує pipelining, коли клієнт надсилає кілька запитів, не очікуючи відповідей, але правило порядку зберігається, і жоден сучасний браузер не вмикає pipelining за замовчуванням. Одна повільна відповідь блокує всі запити в черзі за нею. Це head-of-line blocking, і браузери обходять проблему, відкриваючи одночасно кілька з’єднань до одного hostname.

HTTP/2 зберігає ті самі методи та коди стану, але змінює формат кадрів на бінарний. Багато запитів використовують одне з’єднання як незалежні потоки, а повторюваний текст заголовків стискається. Це важливо, оскільки сучасний запит містить багато заголовків. З’єднання все ще працює через TCP, тому втрачений пакет затримує всі потоки цього з’єднання, доки не надійде повторно переданий пакет. Head-of-line blocking не зник. Він перемістився з HTTP на транспортний рівень. Server push був частиною HTTP/2, але на практиці від нього відмовилися, оскільки Chrome видалив його підтримку у 2022.

HTTP/3 знову зберігає ту саму семантику, але замінює TCP на QUIC — транспорт, побудований на UDP (user datagram protocol). Потоки QUIC є незалежними на всіх рівнях, тому втрачений пакет затримує лише потік, до якого він належав. TLS 1.3 вбудований у handshake QUIC, а не накладається поверх нього, тому для нового з’єднання потрібно менше мережевих обмінів. З цього випливають два практичні наслідки: UDP-порт, який сервер використовує для HTTP/3, має бути відкритий у кожному firewall на шляху, а будь-яка мережа, яка обмежує або блокує UDP, переведе клієнтів назад на HTTP/2. Зазвичай це порт 443, але протокол дає змогу серверу використовувати будь-який UDP-порт, оскільки оголошення, яке вказує браузерам на HTTP/3, завжди містить номер порту явно.

Що конкретно змінюється для вас. Браузери зазвичай не починають роботу з HTTP/3. Вони підключаються через HTTP/2 або HTTP/1.1, бачать заголовок Alt-Svc: h3=":443"; ma=86400 у відповіді та використовують HTTP/3 для наступних з’єднань із цим host. Винятком є HTTPS-запис у DNS, значення alpn якого містить h3. Це дає браузеру, наприклад Firefox, змогу відкрити HTTP/3 уже під час першого з’єднання. Такий запис є додатковою підказкою, а не заміною, тому заголовок не є необов’язковим доповненням. Це основний механізм виявлення. У nginx HTTP/2 став окремою директивою у версії 1.25.1 (http2 on; усередині блоку server, замість старого параметра listen ... http2), а QUIC з’явився в mainline 1.25.0. Для сайту HTTP/3 потрібна директива listen 443 quic reuseport; разом зі звичайною listen 443 ssl;. Модуль HTTP/3 не збирається за замовчуванням (--with-http_v3_module), а документація nginx досі називає його підтримку експериментальною.

Проксі відрізняються рівнем зрілості цієї підтримки, тому перевіряйте саме версію, яку ви використовуєте. Станом на листопад 2026 Caddy обслуговує HTTP/3 за замовчуванням без додаткової конфігурації. nginx потребує явного listener quic і заголовка Alt-Svc, описаного вище. Traefik вмикає HTTP/3 для кожної entry point через явну опцію http3. Якщо ви завершуєте TLS на Traefik перед кількома Docker-застосунками, версія протоколу для відвідувачів визначається саме там, а з’єднання від проксі до контейнера зазвичай використовує звичайний HTTP/1.1 незалежно від протоколу, який узгодив браузер.

Перевіряйте, а не припускайте. curl --http3 -sS -o /dev/null -D - https://example.com/ працює лише тоді, коли curl -V містить HTTP3 серед своїх можливостей, а більшість збірок із дистрибутивів цього не включають. Надійний спосіб перевірки — власний журнал: додайте $server_protocol до формату й перегляньте, який протокол узгоджують реальні браузери. Перед цим переконайтеся, що UDP-порт, який використовує ваш listener quic, — 443 у наведеній конфігурації — справді відкритий, оскільки firewall, який дозволяє лише TCP 443, спричинить непомітну відмову HTTP/3, тоді як сайт продовжить працювати через HTTP/2. Перевірка відкритих і прослуховуваних портів на Linux-сервері — це перший крок.

HTTPS: HTTP — це протокол, а TLS — оболонка

HTTPS не є окремим протоколом. Це ті самі запити й ті самі коди стану, передані всередині сеансу TLS. Порт 80 передає їх у відкритому вигляді, а порт 443 — у зашифрованому. Спочатку завершується рукостискання TLS, потім HTTP-запит проходить усередині зашифрованого каналу. Саме тому проблема із сертифікатом ніколи не має коду стану: помилка виникає до надсилання будь-якого байта HTTP, тому відповіді з кодом немає.

На сервері, де розміщено кілька сайтів, важливий порядок вибору. Сертифікат вибирається за SNI (server name indication) — полем у рукостисканні TLS, яке передає ім’я хоста у відкритому вигляді ще до появи будь-якого HTTP-заголовка. Спочатку сервер вибирає сертифікат за SNI, а потім — віртуальний хост за заголовком Host. Це два окремі пошуки, які зазвичай дають узгоджений результат. Якщо цього не відбувається, браузер показує помилку невідповідності імені, наприклад NET::ERR_CERT_COMMON_NAME_INVALID, і взагалі не надсилає запит, оскільки сертифікат сервера за замовчуванням було запропоновано для імені, яке він не охоплює.

Для публічного сайту отримайте справжній сертифікат і налаштуйте його автоматичне поновлення. Certbot із Let's Encrypt на nginx записує шляхи до сертифіката у ваш server block і встановлює для вас таймер поновлення. Якщо жоден публічний центр сертифікації не може перевірити ім’я хоста, наприклад внутрішнє ім’я або необроблену IP-адресу у вашій мережі, самопідписаний сертифікат в Ubuntu є коректним варіантом, якщо ви погоджуєтеся вручну налаштувати довіру до нього на кожному клієнті.

Після налаштування TLS перенаправте весь трафік із порту 80 на порт 443:

server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;
}

Додавайте Strict-Transport-Security лише після перевірки. Заголовок add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always; повідомляє браузерам не використовувати звичайний HTTP для цього імені хоста протягом двох років. Браузери виконують це правило з власного кешу, тому подальше видалення заголовка його не скасує. Почніть зі значення max-age у кілька годин, переконайтеся, що всі піддомени справді працюють через HTTPS, а потім збільшіть його.

FAQ

У чому різниця між HTTP і HTTPS?

HTTPS — це HTTP, переданий у межах сеансу TLS (transport layer security). Методи й коди стану однакові. Змінюється лише те, що байти шифруються між клієнтом і компонентом, який завершує TLS, а порт за замовчуванням змінюється з 80 на 443. Оскільки рукостискання TLS завершується до передавання першого байта HTTP, помилка сертифіката ніколи не повертає код стану. Саме тому попередження браузера про сертифікат містить назву помилки, наприклад NET::ERR_CERT_COMMON_NAME_INVALID, а не число на кшталт 403.

Чому мій сайт повертає 502 Bad Gateway?

502 від nginx означає, що nginx не зміг отримати придатну відповідь від upstream-сервера, до якого він проксуює запит. Отже, запит відвідувача був коректним, а проблема виникла за nginx. Перегляньте /var/log/nginx/error.log. connect() failed (111: Connection refused) while connecting to upstream означає, що на адресі й порту з proxy_pass немає процесу, який приймає з’єднання. Перевірте, чи запущений застосунок і чи прослуховує він очікувану адресу. no live upstreams while connecting to upstream означає, що всі сервери в upstream-блоці позначено як недоступні після повторних помилок. Порівняйте це з 504 Gateway Timeout. Він означає, що nginx перевищив час очікування відповіді від upstream-сервера: або під час установлення з’єднання в межах proxy_connect_timeout, або під час очікування відповіді в межах proxy_read_timeout.

Чому в моєму журналі доступу для кожного відвідувача відображається одна й та сама IP-адреса?

Тому що $remote_addr записує адресу, з якої було відкрито TCP-з’єднання. За reverse proxy або content delivery network цією адресою є адреса проксі. Адреса відвідувача надходить у заголовку X-Forwarded-For. Налаштуйте proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; на проксі. Потім на nginx, який отримує запит, задайте set_real_ip_from діапазоном адрес проксі та real_ip_header X-Forwarded-For;. Додавайте лише діапазони, якими ви керуєте, оскільки цей заголовок є текстом, який може надіслати будь-який клієнт. Якщо довіряти йому з усього інтернету, відвідувач зможе вибрати адресу, яку ви записуєте в журнал і для якої застосовуєте обмеження частоти запитів.

Чи потрібно вмикати HTTP/2 або HTTP/3?

HTTP/2 варто ввімкнути, оскільки для сайту, де вже налаштовано TLS, це одна директива. Він також усуває обмеження кількості запитів на одне з’єднання, через яке сторінки з багатьма малими файлами завантажуються повільно. Перевага HTTP/3 менша й менш передбачувана. Для нього потрібен відкритий UDP-порт, зазвичай 443, а також збірка проксі з підтримкою QUIC. Пам’ятайте, що браузери зазвичай переходять на HTTP/3 лише після отримання заголовка Alt-Svc у попередній відповіді або HTTPS DNS-запису, який містить h3. Тому без одного з них нічого не зміниться, незалежно від того, що вказано у вашому рядку listen. Додайте $server_protocol до формату журналу та перевірте, який протокол фактично узгоджують відвідувачі, перш ніж витрачати на це час.

Що означає 403 Forbidden, якщо файл існує?

На статичному сайті 403 зазвичай означає проблему з правами файлової системи, а не з правилом HTTP. open() ... failed (13: Permission denied) у /var/log/nginx/error.log означає, що користувач worker-процесу nginx не може прочитати файл. Найчастіше батьківський каталог не має дозволу на виконання для інших користувачів, а не сам файл має неправильний режим доступу. directory index of ... is forbidden означає, що запит було зіставлено з каталогом без index-файлу, коли autoindex вимкнено. Явне правило deny у відповідному блоці location також повертає 403. Тому перевірте цей блок, якщо в журналі помилок немає пояснення.

Чи була ця стаття корисною?

#http#https#web-server#headers#http3