SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Jak działa protokół HTTP: przewodnik dla administratora

Zrozumienie działania protokołu HTTP w kontekście administracji serwerami. Analiza metod, kodów stanu, nagłówków oraz konfiguracji nginx i logów dla wersji HTTP/1.1 do HTTP/3.

Czym jest HTTP?

HTTP (hypertext transfer protocol) to zestaw reguł, których używa klient oraz serwer WWW do przesyłania zapytań i odpowiedzi. Klient wysyła żądanie: metodę taką jak GET, ścieżkę taką jak /pricing, wersję protokołu, listę nagłówków oraz opcjonalnie treść. Serwer odpowiada kodem stanu, takim jak 200, po którym następują jego własne nagłówki oraz zazwyczaj treść. Każde wyświetlenie strony i każde wywołanie API (application programming interface) na serwerze to pojedyncza, powtarzana wymiana danych.

Protokół HTTP jest bezstanowy. Serwer nie przechowuje informacji o poprzednich zapytaniach, dlatego każdy mechanizm wymagający pamięci, na przykład sesja logowania, jest przenoszony w nagłówku każdego pojedynczego żądania. Ta właściwość wyjaśnia większość dalszych zagadnień: buforowanie jest w całości sterowane nagłówkami, a load balancer może przekierować kolejne żądanie do innego backendu bez przerywania działania usługi.

Poniżej przedstawiono, jak ten model wygląda z perspektywy serwera, w logach dostępu oraz w konfiguracji nginx.

Surowe żądanie i odpowiedź z opisem

Poniżej znajduje się kompletne żądanie HTTP/1.1. Pusta linia kończy nagłówki, a wszystko, co znajduje się za nią, stanowi treść (body). Żądanie GET zazwyczaj nie posiada treści.

GET /pricing HTTP/1.1
Host: example.com
User-Agent: curl/8.5.0
Accept: */*
Accept-Encoding: gzip
  • GET to metoda, która określa oczekiwaną operację. GET służy do odczytu, POST do wysyłania danych, PUT do zastępowania, DELETE do usuwania, a HEAD prosi o nagłówki żądania GET bez pobierania treści.
  • /pricing to ścieżka. Nazwa hosta nie jest częścią linii żądania, dlatego wymagany jest kolejny nagłówek.
  • HTTP/1.1 to wersja protokołu używana przez klienta.
  • Host: example.com określa witrynę, do której klient chce uzyskać dostęp. HTTP/1.1 wymaga tego nagłówka, dlatego nginx odpowiada na żądanie bez niego błędem 400 Bad Request.
  • Pozostałe linie to preferencje. Accept-Encoding: gzip informuje, że klient obsługuje dekompresję, więc serwer może skompresować treść.

Odpowiedź ma taką samą strukturę, z linią statusu na początku.

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 to kod statusu wraz z opisem. Istotny jest kod; opis ma charakter informacyjny i jest ignorowany przez klientów.
  • Content-Type informuje klienta, jak interpretować przesyłane bajty.
  • Content-Length to rozmiar treści w bajtach, dzięki czemu klient wie, gdzie kończy się komunikat. Gdy rozmiar nie jest znany z góry, serwer wysyła Transfer-Encoding: chunked i oznacza koniec za pomocą fragmentu o zerowej długości.
  • Cache-Control określa przeglądarce i pośredniczącym pamięciom podręcznym, jak długo odpowiedź może być uznawana za aktualną. Po upływie max-age sekund staje się ona przestarzała, co nie oznacza usunięcia: pamięć podręczna może zachować przestarzałą kopię i zrewalidować ją z serwerem zamiast ponownie pobierać całą treść.
  • Pusta linia po nagłówkach oddziela je od treści w obu kierunkach.

Nazwy nagłówków nie są wrażliwe na wielkość liter, a każda linia kończy się znakiem powrotu karetki (carriage return) oraz znakiem przejścia do nowej linii (line feed), a nie samym znakiem nowej linii. Nie wprowadza się ich ręcznie, ale można je napotkać podczas analizy przechwyconych pakietów.

Aby podejrzeć rzeczywistą parę żądanie-odpowiedź, należy wykonać poniższe polecenie dla własnej witryny:

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

-D - wypisuje nagłówki odpowiedzi w terminalu, a -o /dev/null odrzuca treść. Należy preferować to rozwiązanie zamiast curl -I, ponieważ -I wysyła żądanie HEAD. Serwer aplikacji, który obsługuje HEAD inaczej niż GET (a wiele tak robi), wyświetli wtedy nagłówki, których żadna przeglądarka nigdy nie otrzyma. curl -v wyświetla obie strony, przy czym linie żądania są oznaczone jako >, a linie odpowiedzi jako <.

Jak wygląda linia żądania w logu dostępu nginx

nginx dostarcza format logowania combined, którego definicja wygląda następująco:

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

Jedna linia wygenerowana przez ten format:

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 to $remote_addr, adres, który nawiązał połączenie TCP (transmission control protocol). Za proxy jest to adres proxy, a nie użytkownika, chyba że skonfigurowano moduł realip opisany poniżej w celu jego zastąpienia.
  • Pierwszy - to stały symbol zastępczy. Drugi to $remote_user, który jest wypełniany tylko wtedy, gdy używane jest uwierzytelnianie HTTP basic.
  • "GET /pricing HTTP/1.1" to $request, pełna oryginalna linia żądania. Przy domyślnym maskowaniu logów nginx, cudzysłów, odwrotny ukośnik oraz każdy bajt poniżej 32 lub powyżej 126 jest zapisywany jako \xXX, więc linia jest wierna, ale nie zawsze identyczna bajt po bajcie.
  • 200 to status zwrócony przez serwer, a nie status odebrany przez użytkownika.
  • 5310 to $body_bytes_sent, sama treść odpowiedzi. Nagłówki odpowiedzi nie są wliczane, więc ta liczba jest zawsze mniejsza niż liczba faktycznie wysłanych bajtów.
  • Ostatnie dwa pola w cudzysłowie to Referer oraz User-Agent. Oba pochodzą od klienta, więc mogą zawierać dowolne dane.

Śmieciowe dane również są logowane w formie maskowanej. Klient, który używa TLS (transport layer security) na porcie 80 przeznaczonym dla czystego tekstu, pozostawia linię 400, której pole żądania zaczyna się od zamaskowanych bajtów, takich jak "\x16\x03\x01\x02\x00\x01". \x16 to typ rekordu handshake TLS, więc te bajty są początkiem ClientHello, a nie linią żądania. Serwer zachowuje się poprawnie. Coś kieruje ruch HTTPS na port HTTP.

Dodaj również $server_protocol do formatu logowania. Drukuje ono HTTP/1.1, HTTP/2.0 lub HTTP/3.0 i jest to najszybszy sposób na potwierdzenie, że zmiana protokołu faktycznie weszła w życie.

Co oznaczają popularne kody stanu, gdy zwraca je własna witryna

Pierwsza cyfra oznacza klasę i to od niej należy rozpocząć analizę.

2xx oznacza powodzenie. 200 OK przy standardowym odczycie. 201 Created po żądaniu POST, które utworzyło zasób. 204 No Content przy sukcesie bez treści do odesłania, co jest typową odpowiedzią na DELETE.

3xx oznacza przekierowanie. 301 jest trwałe i przeglądarki buforują je bardzo agresywnie, czasem aż do wyczyszczenia profilu użytkownika, dlatego błędne 301 wskazujące na niewłaściwą nazwę hosta jest trudne do naprawienia. Podczas testowania przekierowań należy używać 302. 304 Not Modified to sukces, a nie błąd: klient wysłał żądanie warunkowe, albo If-None-Match z nagłówkiem ETag (entity tag), który serwer nadal rozpoznaje, albo If-Modified-Since z datą, od której zasób się nie zmienił, więc serwer odpowiedział tylko nagłówkami bez treści. Dziennik pełen 304 oznacza, że buforowanie działa poprawnie.

4xx oznacza błędne żądanie. 400 Bad Request to nieprawidłowo sformułowane dane wejściowe. 401 Unauthorized oznacza brak uwierzytelnienia i musi zawierać nagłówek WWW-Authenticate określający schemat. 403 Forbidden oznacza, że żądanie zostało zrozumiane, ale mimo to odrzucone. 404 Not Found to ścieżka, która nie istnieje lub której serwer nie chce ujawnić; niektóre aplikacje zwracają 404 zamiast 403, aby ukryć zasób przed klientami bez uprawnień. 405 Method Not Allowed to poprawna ścieżka z niewłaściwą metodą, co zwraca na przykład POST wysłane do lokalizacji z plikami statycznymi. 413 oznacza treść większą niż limit client_max_body_size w nginx, który domyślnie wynosi 1 megabajt, co dziennik błędów potwierdza wpisem client intended to send too large body.

403 dla pliku statycznego prawie zawsze wynika z uprawnień systemu plików, a nie z reguł HTTP. Przed zmianą konfiguracji należy sprawdzić /var/log/nginx/error.log. open() "/srv/site/index.html" failed (13: Permission denied) oznacza, że użytkownik procesu roboczego nginx nie może odczytać pliku, najczęściej z powodu braku uprawnień wykonywania dla innych użytkowników na katalogu nadrzędnym. directory index of "/srv/site/" is forbidden oznacza, że ścieżka wskazuje na katalog, w którym nie ma pliku indeksowego, podczas gdy autoindex jest wyłączone.

5xx oznacza awarię po stronie serwera. 500 to ogólny błąd serwera; we własnej witrynie zazwyczaj wskazuje na nieobsłużony błąd w aplikacji. 502 Bad Gateway oznacza, że nginx nie otrzymał poprawnej odpowiedzi od upstreamu, a dziennik błędów wskazuje przyczynę: connect() failed (111: Connection refused) while connecting to upstream oznacza, że nikt nie nasłuchuje pod adresem proxy_pass. 504 Gateway Timeout oznacza, że nginx przestał czekać na upstream. Typowy przypadek to upstream, który przyjął połączenie, ale nie odpowiedział w czasie proxy_read_timeout (domyślnie 60 sekund), co dziennik rejestruje jako upstream timed out (110: Connection timed out) while reading response header from upstream. Próba połączenia, która nie zakończy się w czasie proxy_connect_timeout (również domyślnie 60 sekund), kończy się błędem 504, a linia w dzienniku kończy się wpisem while connecting to upstream. 503 Service Unavailable oznacza, że serwer jest tymczasowo niezdolny do obsługi żądania, zazwyczaj z powodu przeciążenia lub planowanej konserwacji. Należy pamiętać, że własny ogranicznik szybkości (rate limiter) nginx zwraca 503, ponieważ limit_req_status domyślnie ustawia 503. Jeśli w dzienniku poszukujesz 429 Too Many Requests, a znajdujesz 503, to właśnie dlatego. Aby uzyskać dokładny kod, należy ustawić limit_req_status 429;.

Nagłówki istotne podczas uruchamiania serwera

Host wybiera witrynę. Jeden adres IP może obsługiwać setki nazw hostów, a nginx dopasowuje Host do server_name, aby zdecydować, który blok server obsłuży żądanie. Jeśli nie ma dopasowania, nginx używa domyślnego serwera, czyli pierwszego bloku nasłuchującego na danym adresie i porcie, chyba że inny został oznaczony jako default_server. Otrzymanie niewłaściwej witryny po dodaniu nowego wirtualnego hosta niemal zawsze wynika z tego, że nazwa nie pasowała, więc żądanie zostało przekierowane do domyślnego serwera. Przetestuj to bez modyfikowania DNS:

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

User-Agent to opis własny klienta, będący dowolnym tekstem. Traktuj go jako wskazówkę podczas analizy logów. Nigdy nie używaj go jako mechanizmu kontrolnego, ponieważ klient, który chce podać nieprawdziwe dane, po prostu to zrobi, więc blokowanie scrapera przez User-Agent wyeliminuje tylko te uczciwe.

Content-Type decyduje o tym, jak interpretowane są bajty: application/json dla żądania API, text/html; charset=utf-8 dla strony. nginx mapuje rozszerzenia plików na typy za pomocą /etc/nginx/mime.types, a dostarczony plik nginx.conf ustawia default_type application/octet-stream;, więc plik z rozszerzeniem, którego nginx nie rozpoznaje, jest oferowany jako plik do pobrania zamiast być wyrenderowanym. Widocznym objawem jest strona, która ładuje się bez stylów, podczas gdy konsola przeglądarki wyświetla Refused to apply style from ... because its MIME type ('text/plain') is not a supported stylesheet MIME type. MIME to skrót od Multipurpose Internet Mail Extensions, czyli schematu nazewnictwa, z którego pochodzą te ciągi typów.

Cache-Control pozwala kontrolować każdą pamięć podręczną między serwerem a czytelnikiem. public, max-age=31536000, immutable pasuje do zasobów, których nazwa pliku zawiera skrót zawartości, ponieważ nazwa zmienia się wraz z treścią. no-store należy stosować do wszystkiego, co jest specyficzne dla użytkownika, ponieważ współdzielona pamięć podręczna przechowująca stronę zalogowanego użytkownika przekaże ją kolejnej osobie, która zapyta o ten sam URL. private to ustawienie pośrednie: przeglądarka może zachować zasób, ale współdzielona pamięć podręczna nie powinna tego robić.

X-Forwarded-For istnieje, ponieważ proxy ukrywa odwiedzającego. Gdy żądanie przechodzi przez reverse proxy, $remote_addr jest adresem proxy, więc logi, geolokalizacja i rate limiting widzą tylko jednego klienta, dopóki nie przywrócisz oryginalnego adresu. Proxy musi przekazać oryginalny adres dalej:

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

Serwer odbierający musi następnie otrzymać instrukcję, aby ufać tym danym oraz informację, komu dokładnie ufać:

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

Te dwie dyrektywy należą do modułu realip w nginx. Zastępują one $remote_addr przekazanym adresem i zachowują własny adres połączenia w $realip_remote_addr. Jeśli kompilujesz nginx samodzielnie, dodaj --with-http_realip_module, ponieważ moduł ten nie jest domyślnie wbudowany.

Wymieniaj tylko zakresy, które kontrolujesz. X-Forwarded-For to zwykły tekst, który może wysłać każdy klient, więc set_real_ip_from 0.0.0.0/0; pozwala odwiedzającemu wybrać adres, który logujesz i który zlicza Twój rate limiter.

X-Forwarded-Proto zapobiega konkretnej i bardzo częstej awarii. Twoje proxy kończy połączenie TLS i przekazuje żądanie do aplikacji przez zwykłe HTTP. Aplikacja widzi zwykłe żądanie, uznaje, że odwiedzający powinien korzystać z HTTPS i odpowiada 301 https://example.com/. Przeglądarka podąża za tym, proxy ponownie kończy TLS i znów przekazuje zwykłe HTTP, a pętla powtarza się, dopóki przeglądarka nie przerwie operacji z błędem ERR_TOO_MANY_REDIRECTS. Wysłanie X-Forwarded-Proto: https informuje aplikację, że odwiedzający już korzysta z HTTPS, więc przestaje ona przekierowywać.

HTTP/1.1 a HTTP/2 a HTTP/3: co się zmienia dla użytkownika

HTTP/1.1 jest protokołem tekstowym, który w praktyce obsługuje jedno żądanie na raz w ramach jednego połączenia. Connection: keep-alive pozwala kolejnym żądaniom na ponowne wykorzystanie tego samego połączenia TCP, co eliminuje koszt nawiązywania sesji, jednak odpowiedzi nadal wracają w kolejności ich wysłania. Protokół wspiera również pipelining, gdzie klient wysyła kilka żądań bez czekania na odpowiedzi, ale zasada kolejności nadal obowiązuje i żadna nowoczesna przeglądarka nie ma domyślnie włączonego pipeliningu. Jedna wolna odpowiedź blokuje wszystko, co znajduje się za nią w kolejce. Jest to zjawisko head-of-line blocking, które przeglądarki obchodzą poprzez otwieranie wielu połączeń do tego samego hosta jednocześnie.

HTTP/2 zachowuje te same metody i kody statusu, zmieniając jedynie formatowanie na binarne. Wiele żądań współdzieli jedno połączenie jako niezależne strumienie, a powtarzający się tekst nagłówków jest kompresowany, co ma znaczenie, ponieważ współczesne żądania zawierają ich bardzo dużo. Połączenie nadal opiera się na TCP, więc jeden utracony pakiet wstrzymuje wszystkie strumienie w ramach tego połączenia do czasu retransmisji. Zjawisko head-of-line blocking nie zniknęło; przeniosło się z warstwy HTTP do warstwy transportowej. Server push był częścią HTTP/2, ale w praktyce przestał być używany, ponieważ Chrome usunął jego obsługę w 2022 roku.

HTTP/3 ponownie zachowuje tę samą semantykę, zastępując TCP protokołem QUIC, zbudowanym na bazie UDP (user datagram protocol). Strumienie QUIC są w pełni niezależne, więc utrata pakietu wstrzymuje tylko ten strumień, do którego należał. TLS 1.3 jest wbudowany w proces nawiązywania połączenia QUIC, zamiast być nakładany jako warstwa zewnętrzna, dzięki czemu nowe połączenie wymaga mniejszej liczby wymian danych (round trips). Wynikają z tego dwie praktyczne konsekwencje: port UDP używany przez serwer dla HTTP/3 musi być otwarty w każdej zaporze sieciowej na drodze pakietów, a każda sieć ograniczająca lub blokująca ruch UDP wymusi na klientach powrót do HTTP/2. Port ten to zazwyczaj 443, jednak protokół pozwala serwerowi użyć dowolnego portu UDP, ponieważ ogłoszenie wskazujące przeglądarkom obsługę HTTP/3 zawsze jawnie podaje numer portu.

Co zmienia się konkretnie dla administratora. Przeglądarki zazwyczaj nie rozpoczynają połączenia od HTTP/3. Łączą się przez HTTP/2 lub HTTP/1.1, odczytują nagłówek Alt-Svc: h3=":443"; ma=86400 w odpowiedzi i używają HTTP/3 przy kolejnych połączeniach do danego hosta. Wyjątkiem jest rekord HTTPS w DNS, którego wartość alpn zawiera h3, co pozwala przeglądarce takiej jak Firefox otworzyć połączenie HTTP/3 już za pierwszym razem. Rekord ten jest dodatkową wskazówką, a nie zamiennikiem, więc nagłówek nie jest opcjonalną dekoracją. Jest to główny mechanizm wykrywania. W nginx obsługa HTTP/2 stała się oddzielną dyrektywą w wersji 1.25.1 (http2 on; wewnątrz bloku server, zastępując stary parametr listen ... http2), a QUIC pojawił się w wersji mainline 1.25.0, gdzie witryna HTTP/3 wymaga listen 443 quic reuseport; obok standardowego listen 443 ssl;. Moduł HTTP/3 nie jest kompilowany domyślnie (--with-http_v3_module), a dokumentacja nginx nadal określa jego obsługę jako eksperymentalną.

Proxy różnią się stopniem dojrzałości w tym zakresie, co warto zweryfikować w odniesieniu do używanej wersji. Według stanu na listopad 2026, Caddy obsługuje HTTP/3 domyślnie bez dodatkowej konfiguracji. nginx wymaga jawnego słuchacza quic oraz nagłówka Alt-Svc opisanego powyżej. Traefik włącza tę funkcję dla każdego punktu wejścia (entry point) poprzez opcję http3. Jeśli terminacja TLS odbywa się w Traefik przed kilkoma aplikacjami Docker, to tam zapada decyzja o wersji protokołu, a połączenie między proxy a kontenerem zazwyczaj odbywa się przez zwykły HTTP/1.1, niezależnie od tego, co wynegocjowała przeglądarka.

Należy weryfikować, zamiast zakładać. curl --http3 -sS -o /dev/null -D - https://example.com/ działa tylko wtedy, gdy curl -V wymienia HTTP3 wśród swoich funkcji, a większość pakietów dystrybucyjnych nie zawiera tej opcji. Najpewniejszą metodą sprawdzenia jest własny log: należy dodać $server_protocol do formatu logowania i odczytać, co faktycznie negocjują przeglądarki. Przed wykonaniem tych czynności należy potwierdzić, że port UDP używany przez słuchacza quic (w powyższej konfiguracji 443) jest faktycznie otwarty, ponieważ zapora sieciowa przepuszczająca tylko TCP 443 spowoduje, że HTTP/3 będzie cicho zawodzić, podczas gdy witryna będzie nadal działać przez HTTP/2. Znajomość tego, które porty są otwarte i nasłuchują na serwerze Linux, jest pierwszą rzeczą do sprawdzenia.

HTTPS: HTTP to protokół, TLS to otoczka

HTTPS nie jest odrębnym protokołem. To te same żądania i te same kody statusu przesyłane wewnątrz sesji TLS. Port 80 przesyła je w postaci jawnej, a port 443 w postaci zaszyfrowanej. Uścisk dłoni TLS następuje jako pierwszy, a następnie żądanie HTTP przesyłane jest wewnątrz zaszyfrowanego kanału. Z tego powodu problem z certyfikatem nigdy nie posiada przypisanego kodu statusu: błąd występuje, zanim zostanie wysłany choćby jeden bajt HTTP, więc nie ma odpowiedzi, którą można by ponumerować.

W przypadku serwera obsługującego kilka witryn istotny jest jeden szczegół dotyczący kolejności. Certyfikat wybierany jest przy użyciu SNI (Server Name Indication), pola w uścisku dłoni TLS, które przesyła nazwę hosta w postaci jawnej, zanim powstanie jakikolwiek nagłówek HTTP. Serwer wybiera więc najpierw certyfikat na podstawie SNI, a następnie w drugiej kolejności wybiera wirtualny host na podstawie nagłówka Host. Są to dwa oddzielne wyszukiwania, które zazwyczaj są ze sobą zgodne. Gdy tak nie jest, przeglądarka wyświetla błąd niezgodności nazwy, taki jak NET::ERR_CERT_COMMON_NAME_INVALID, i w ogóle nie wysyła żądania, ponieważ dla nazwy, której certyfikat nie obejmuje, został zaoferowany certyfikat domyślnego serwera.

Dla publicznej witryny należy uzyskać właściwy certyfikat i pozwolić mu na automatyczne odnawianie. Certbot z Let's Encrypt na nginx zapisuje ścieżki do certyfikatów w bloku serwera i instaluje timer odnawiania. Dla nazwy hosta, której żaden publiczny urząd nie może zweryfikować, takiej jak nazwa wewnętrzna lub adres IP w sieci lokalnej, certyfikat z podpisem własnym na Ubuntu jest uczciwym rozwiązaniem, pod warunkiem zaakceptowania konieczności ręcznego zaufania certyfikatowi przez każdego klienta.

Gdy TLS działa, należy przekierować cały ruch z portu 80 na port 443:

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

Nagłówek Strict-Transport-Security należy dodać dopiero po uzyskaniu pewności. Nagłówek add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always; nakazuje przeglądarkom odrzucanie zwykłego HTTP dla danej nazwy hosta przez dwa lata; przeglądarki przestrzegają tego polecenia z własnej pamięci podręcznej, co oznacza, że późniejsze usunięcie nagłówka nie cofa tego efektu. Należy zacząć od wartości max-age wynoszącej kilka godzin, potwierdzić, że każda subdomena faktycznie działa przez HTTPS, a następnie zwiększyć ten czas.

FAQ

Jaka jest różnica między HTTP a HTTPS?

HTTPS to HTTP przesyłane wewnątrz sesji TLS (transport layer security). Metody oraz kody statusu są identyczne. Zmiana polega na tym, że bajty są szyfrowane między klientem a punktem terminacji TLS, a domyślny port zmienia się z 80 na 443. Ponieważ uzgadnianie TLS kończy się przed wysłaniem pierwszego bajtu HTTP, błąd certyfikatu nigdy nie generuje kodu statusu. Dlatego ostrzeżenie przeglądarki o certyfikacie wyświetla nazwę błędu, taką jak NET::ERR_CERT_COMMON_NAME_INVALID, zamiast liczby typu 403.

Dlaczego moja witryna zwraca 502 Bad Gateway?

Kod 502 z nginx oznacza, że nginx nie otrzymał użytecznej odpowiedzi od backendu, do którego przesyła ruch, więc żądanie użytkownika było poprawne, ale coś za nginx nie działało. Przeczytaj /var/log/nginx/error.log. connect() failed (111: Connection refused) while connecting to upstream oznacza, że nikt nie nasłuchuje na adresie i porcie w proxy_pass, więc sprawdź, czy aplikacja działa i jest powiązana z oczekiwanym adresem. no live upstreams while connecting to upstream oznacza, że każdy serwer w bloku upstream został oznaczony jako niedostępny po wielokrotnych awariach. Porównaj to z 504 Gateway Timeout, co oznacza, że nginx przekroczył limit czasu oczekiwania na backend, albo na nawiązanie połączenia w ramach proxy_connect_timeout, albo na odpowiedź w ramach proxy_read_timeout.

Dlaczego mój log dostępu pokazuje ten sam adres IP dla każdego odwiedzającego?

Ponieważ $remote_addr rejestruje adres, który otworzył połączenie TCP, a za reverse proxy lub siecią dostarczania treści (CDN) tym adresem jest proxy. Adres odwiedzającego dociera w nagłówku X-Forwarded-For. Ustaw proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; na proxy, a następnie na odbierającym nginx ustaw set_real_ip_from na zakres adresów proxy oraz real_ip_header X-Forwarded-For;. Wymieniaj tylko zakresy, które kontrolujesz, ponieważ ten nagłówek to tekst, który może wysłać każdy klient. Ufanie mu w przypadku całego Internetu pozwala odwiedzającemu wybrać adres, który logujesz i który poddajesz limitowaniu (rate limiting).

Czy muszę włączać HTTP/2 lub HTTP/3?

HTTP/2 warto włączyć, ponieważ wymaga to tylko jednej dyrektywy w witrynie, która już posiada TLS, i usuwa limit żądań na połączenie, który spowalnia strony z wieloma małymi plikami. HTTP/3 daje mniejszy i mniej pewny zysk, a kosztuje otwarcie portu UDP, zazwyczaj 443, oraz wymaga kompilacji proxy z obsługą QUIC. Pamiętaj, że przeglądarki zazwyczaj przełączają się na HTTP/3 dopiero po zobaczeniu nagłówka Alt-Svc w poprzedniej odpowiedzi lub rekordu DNS HTTPS, który wymienia h3. Bez tego nic się nie zmieni, niezależnie od tego, co mówi Twoja linia listen. Dodaj $server_protocol do formatu logów i zmierz, co faktycznie negocjują odwiedzający, zanim poświęcisz na to czas.

Co oznacza 403 Forbidden, gdy plik istnieje?

W przypadku statycznej witryny 403 zazwyczaj wynika z uprawnień systemu plików, a nie z reguły HTTP. open() ... failed (13: Permission denied) w /var/log/nginx/error.log oznacza, że użytkownik procesu roboczego nginx nie może odczytać pliku. Najczęściej dzieje się tak dlatego, że katalog nadrzędny nie ma uprawnień wykonywania dla innych użytkowników, a nie dlatego, że same uprawnienia pliku są błędne. directory index of ... is forbidden oznacza, że żądanie wskazało katalog bez pliku indeksowego, podczas gdy autoindex jest wyłączone. Jawna reguła deny w pasującym bloku location również zwraca 403, więc przeczytaj ten blok, gdy log błędów nie zawiera żadnych informacji.

Czy ten artykuł był przydatny?

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