Generator Nginx gzip

Generator bloku gzip dla Nginx

Kompresja gzip zmniejsza rozmiar odpowiedzi tekstowych, co przyspiesza stronę i oszczędza transfer. Konfiguracja sprowadza się do kilku dyrektyw.

Najważniejsze dyrektywy

Przykład

Blok z poziomem 6 i typami text/plain, text/css, application/javascript oraz JSON zmniejsza rozmiar CSS i JS nawet o 80%.

gzip_static

Jeśli masz wcześniej przygotowane pliki .gz, dyrektywa gzip_static on serwuje je bez kompresji w locie — oszczędza CPU przy dużym ruchu.

Jak Nginx decyduje, co skompresować

Kompresja nie działa globalnie na wszystko, co wychodzi z serwera. Przy każdym żądaniu Nginx sprawdza najpierw, czy klient w ogóle ją obsługuje, czyli czy w nagłówku Accept-Encoding zadeklarował gzip. Dopiero potem porównuje typ MIME odpowiedzi z listą w gzip_types, rozmiar treści z progiem gzip_min_length oraz warunki dodatkowe, takie jak obsługa żądań przez proxy. Jeśli którykolwiek warunek nie jest spełniony, odpowiedź leci do klienta bez zmian. Gdy wszystkie przejdą, treść trafia do kompresora zlib.

Sama kompresja to wariant deflate — algorytm szuka w buforze powtórzonych fragmentów i zastępuje je krótkimi wskazaniami, a wynik dodatkowo koduje Huffmanem. Krótsze znaczniki dostają najczęściej występujące bajty, dzięki czemu tekst kurczy się najmocniej. Poziom od 1 do 9 reguluje, jak długo algorytm szuka lepszych dopasowań: niski poziom robi mniej prób i odpowiada szybciej, wysoki znajduje więcej powtórzeń, ale zużywa więcej procesora. Do skompresowanej odpowiedzi Nginx dokłada nagłówek Content-Encoding: gzip oraz Vary: Accept-Encoding.

Warto odróżnić dwie ścieżki. Kompresja w locie dzieje się przy każdym żądaniu i obciąża CPU serwera. gzip_static sięga po gotowy plik z rozszerzeniem .gz leżący obok oryginału i nie kompresuje niczego w trakcie odpowiedzi. Sam generator niczego nie kompresuje ani nie łączy się z Twoim serwerem — wypisuje blok dyrektyw, który wklejasz do konfiguracji, sprawdzasz przez nginx -t i wczytujesz przez reload.

Przykład: kompresja bundle.js krok po kroku

1. Punkt wyjścia: plik bundle.js w katalogu statycznym ma 300 KB i jest serwowany bez kompresji.
2. W bloku server ustawiasz gzip on oraz gzip_comp_level 6, a do gzip_types dopisujesz application/javascript.
3. Ustawiasz gzip_min_length tak, aby plik 300 KB bez problemu przekraczał próg — inaczej Nginx pominie kompresję mimo włączonej dyrektywy.
4. Nginx kompresuje odpowiedź. Przy redukcji tekstu rzędu 80%, jaką podaje się dla CSS i JS, plik spada z 300 KB do około 60 KB.
5. Pojedyncze pobranie oszczędza więc około 240 KB (300 odjąć 60). Przy 10 000 pobrań dziennie daje to około 2,4 GB mniej transferu.
6. Weryfikacja: curl -I -H "Accept-Encoding: gzip" https://twoja-domena/static/bundle.js powinien zwrócić nagłówki Content-Encoding: gzip oraz Vary: Accept-Encoding.

Które typy MIME warto kompresować

Praktyczne wskazówki

• Nie przepisuj listy typów bezmyślnie — wpisuj tylko te typy MIME, które faktycznie serwujesz. Wpisy dla formatów, których nie używasz, nie dają nic poza dłuższą konfiguracją.
• Dobierz próg gzip_min_length do treści — dla bardzo małych odpowiedzi narzut na kompresję bywa większy niż zaoszczędzone bajty. Ustaw próg tak, aby obejmował realne pliki tekstowe, a pomijał drobne odpowiedzi.
• Włącz gzip_vary, gdy masz proxy lub CDN — bez nagłówka Vary cache może zapisać jedną wersję odpowiedzi i podać ją klientowi, który gzipa nie obsługuje.
• Sprawdź, czy nie kompresujesz podwójnie — jeśli warstwa przed Nginx już kompresuje, kolejny przebieg tylko marnuje CPU i może psuć nagłówki.
• Testuj po każdej zmianie poziomu — przeładuj konfigurację i porównaj czas odpowiedzi oraz obciążenie procesora na realnym ruchu, nie na jednym żądaniu z konsoli.

Czego narzędzie nie uwzględnia

• Twojego ruchu i zapasu CPU — nie wie, jaki masz serwer ani ile wolnych rdzeni. Wybór poziomu kompresji zostaje po Twojej stronie.
• Wcześniejszych warstw w łańcuchu — nie sprawdzi, czy CDN albo reverse proxy przed Nginx już kompresuje odpowiedzi, więc nie ostrzeże przed podwójną kompresją.
• Zawartości katalogu z plikami — nie zgadnie, czy masz przygotowane pliki .gz ani czy są aktualne względem oryginałów, więc decyzja o gzip_static należy do Ciebie.
• Wsparcia klientów i alternatyw — nie wie, jakich przeglądarek oczekujesz ani czy używasz Brotli, więc nie oceni, czy gzip to nadal najlepszy wybór.

Najczęstsze pytania