 Autor: [Adam Nadolny](/autorzy/adam-nadolny) Ekspert DevOps i infrastruktury · Zweryfikowano Kwiecień 2026

1.  [Strona główna](/) ›
2.  [Baza wiedzy](/baza-wiedzy/) ›
3.  PageSpeed Module — automatyczna optymalizacja serwera

# PageSpeed Module — automatyczna optymalizacja wydajności stron

Opublikowano: 10 kwietnia 2026 · Kategoria: Hosting / Wydajność

PageSpeed Module (ngx\_pagespeed dla Nginx, mod\_pagespeed dla Apache) to moduł od Google, który automatycznie optymalizuje strony WWW na poziomie serwera — bez zmian w kodzie aplikacji. Kompresuje obrazy, minimizuje CSS/JS, konwertuje do WebP, odkłada JavaScript i łączy pliki. Idealne rozwiązanie dla stron których kodu nie możesz łatwo zmodyfikować.

## Co PageSpeed Module robi automatycznie?

Kategoria

Filtr

Efekt

Obrazy

rewrite\_images, convert\_to\_webp\_lossless

Kompresja, zmiana rozmiaru, WebP

CSS

combine\_css, inline\_css, move\_css\_to\_head

Łączenie plików, inline małych CSS

JavaScript

combine\_javascript, defer\_javascript

Łączenie plików, async/defer

HTML

collapse\_whitespace, remove\_comments

Minifikacja HTML

Zasoby

insert\_dns\_prefetch, preload\_images

DNS prefetch, preload LCP

## Apache mod\_pagespeed — instalacja

Apache ma gotowe pakiety od Google — znacznie prostsze niż ngx\_pagespeed:

\# Ubuntu/Debian — pobranie i instalacja pakietu
wget https://dl-ssl.google.com/dl/linux/direct/mod-pagespeed-stable\_current\_amd64.deb
dpkg -i mod-pagespeed-stable\_current\_amd64.deb
apt-get install -f  # naprawienie zależności

# CentOS/RHEL
wget https://dl-ssl.google.com/dl/linux/direct/mod-pagespeed-stable\_current\_x86\_64.rpm
rpm -U mod-pagespeed-stable\_current\_x86\_64.rpm

# Sprawdzenie instalacji
apachectl -M | grep pagespeed
# Oczekiwane: pagespeed\_module (shared)

\# /etc/apache2/mods-available/pagespeed.conf

<IfModule pagespeed\_module>
    ModPagespeed on
    ModPagespeedFileCachePath /var/cache/mod\_pagespeed/

    # Poziom optymalizacji: CoreFilters (stabilny)
    ModPagespeedRewriteLevel CoreFilters

    # Dodatkowe filtry ponad CoreFilters
    ModPagespeedEnableFilters convert\_to\_webp\_lossless
    ModPagespeedEnableFilters defer\_javascript
    ModPagespeedEnableFilters insert\_dns\_prefetch

    # Wyłącz ryzykowne filtry
    ModPagespeedDisableFilters inline\_javascript
    ModPagespeedDisableFilters move\_css\_above\_scripts

    # Cache — 1 dzień dla optymalizowanych zasobów
    ModPagespeedFileCacheCleanIntervalMs 3600000
    ModPagespeedFileCacheSizeKb 102400

    # Domain mapping (jeśli CDN)
    # ModPagespeedMapReqestDomain cdn.example.com example.com

    <Location /mod\_pagespeed\_statistics>
        Order allow,deny
        Allow from localhost
    </Location>
</IfModule>

a2enmod pagespeed
apache2ctl configtest && systemctl restart apache2

# Weryfikacja — nagłówek X-Mod-Pagespeed
curl -sI http://localhost/ | grep -i x-mod-pagespeed
# Oczekiwane: X-Mod-Pagespeed: 1.14.x.x-0

## Nginx ngx\_pagespeed — instalacja

ngx\_pagespeed wymaga kompilacji. Najszybszą metodą jest użycie skryptu automatycznego lub Docker:

\# Automatyczny skrypt budowania (Ubuntu/Debian)
apt install build-essential zlib1g-dev libpcre3 libpcre3-dev unzip uuid-dev

# Pobranie ngx\_pagespeed i PSOL library
NPS\_VERSION=1.14.36.1
cd /tmp
wget https://github.com/apache/incubator-pagespeed-ngx/archive/v${NPS\_VERSION}-stable.tar.gz
tar -xzvf v${NPS\_VERSION}-stable.tar.gz
cd incubator-pagespeed-ngx-${NPS\_VERSION}-stable

# Pobranie PSOL (precompiled library)
NPS\_RELEASE\_NUMBER=${NPS\_VERSION/beta/}
NPS\_RELEASE\_NUMBER=${NPS\_RELEASE\_NUMBER/stable/}
psol\_url=https://dl.google.com/dl/page-speed/psol/${NPS\_RELEASE\_NUMBER}.tar.gz
wget ${psol\_url}
tar -xzvf ${NPS\_RELEASE\_NUMBER}.tar.gz

\# Kompilacja Nginx z ngx\_pagespeed
NGINX\_VERSION=1.25.3
cd /tmp
wget http://nginx.org/download/nginx-${NGINX\_VERSION}.tar.gz
tar -xvzf nginx-${NGINX\_VERSION}.tar.gz
cd nginx-${NGINX\_VERSION}/

./configure \\
  --add-dynamic-module=/tmp/incubator-pagespeed-ngx-${NPS\_VERSION}-stable \\
  --with-http\_ssl\_module \\
  --with-http\_v2\_module \\
  --with-http\_v3\_module \\
  --with-http\_gzip\_static\_module

make
make install

\# /etc/nginx/nginx.conf — konfiguracja ngx\_pagespeed
http {
    pagespeed on;
    pagespeed FileCachePath /var/cache/ngx\_pagespeed/;

    # Poziom optymalizacji
    pagespeed RewriteLevel CoreFilters;

    # Dodatkowe filtry
    pagespeed EnableFilters convert\_to\_webp\_lossless;
    pagespeed EnableFilters defer\_javascript;
    pagespeed EnableFilters insert\_dns\_prefetch;

    # Cache lock
    pagespeed CreateSharedMemoryMetadataCache "/var/cache/ngx\_pagespeed/" 51200;
}

server {
    listen 443 ssl;
    server\_name example.com;

    pagespeed on;

    # Statystyki — tylko z localhost
    location /ngx\_pagespeed\_statistics {
        allow 127.0.0.1;
        deny all;
    }

    location /ngx\_pagespeed\_message {
        allow 127.0.0.1;
        deny all;
    }
}

## Rewrite Levels — zakres optymalizacji

-   **PassThrough** — brak filtrów (domyślny stan). Dobry punkt startu — dodawaj filtry ręcznie.
-   **CoreFilters** — stabilne filtry z niskim ryzykiem złamania strony: minifikacja HTML, kompresja obrazów, łączenie CSS, WebP. Zalecany dla nowych instalacji.
-   **OptimizeForBandwidth** — agresywna kompresja, bez inlinowania i modyfikowania kolejności zasobów. Bezpieczniejszy niż CoreFilters dla skomplikowanych stron.
-   **AllFilters** — wszystkie filtry. Ryzykowny — może złamać JavaScript. Tylko do testów.

## PageSpeed Module vs ręczna optymalizacja

Aspekt

PageSpeed Module

Ręczna optymalizacja

Czas wdrożenia

Kilka godzin (instalacja + config)

Dni/tygodnie (zmiany w kodzie)

Wpływ na kod

Brak — działa on-the-fly

Wymaga zmian w HTML/CSS/JS

CPU overhead

Tak — przetwarzanie każdej odpowiedzi

Brak (pre-processed)

Elastyczność

Ograniczona — filtry prefabrykowane

Pełna kontrola

Ryzyko regresji

Średnie (filtry mogą złamać JS)

Niskie (kontrolujesz każdą zmianę)

Wynik PageSpeed

Poprawa 10-40 punktów

Poprawa 20-60 punktów

## Najczęstsze pytania

Czym jest PageSpeed Module (ngx\_pagespeed / mod\_pagespeed)? +

PageSpeed Module to open-source moduł od Google dla Nginx (ngx\_pagespeed) i Apache (mod\_pagespeed). Automatycznie stosuje optymalizacje wydajności: kompresja i zmiana rozmiaru obrazów, minimalizacja CSS/JS/HTML, inline CSS, defer/async JavaScript, WebP konwersja, lazy loading, łączenie plików CSS/JS. Działa on-the-fly bez modyfikacji kodu aplikacji — serwer przetwarza odpowiedź przed wysłaniem do klienta.

Ile PageSpeed Module przyspiesza stronę? +

Wyniki mocno zależą od stanu wyjściowego strony. Typowe efekty: zmniejszenie wagi strony o 30-50% (kompresja obrazów, minifikacja), poprawa LCP o 20-40% (preload images, lazy loading), poprawa CLS jeśli moduł poprawnie skaluje obrazy. Strony niezoptymalizowane zyskują więcej. Strony już zoptymalizowane (Brotli, WebP, minification) zyskują mniej — moduł nie doda tego co już jest zrobione. Porównaj wyniki PageSpeed Insights przed i po włączeniu.

Jak włączyć ngx\_pagespeed bez rekompilacji Nginx? +

Niestety ngx\_pagespeed nie jest dostępny jako gotowy pakiet apt/yum. Możliwości: (1) Skompilować Nginx z modułem dynamicznym (dodając --add-dynamic-module=/path/to/ngx\_pagespeed), (2) Użyć gotowych obrazów Docker z już skompilowanym ngx\_pagespeed, (3) Użyć Apache z mod\_pagespeed (gotowy deb/rpm od Google), (4) Rozważyć alternatywy — CDN z optymalizacją (Cloudflare Polish, BunnyCDN Optimizer) bez konfiguracji serwera.

Które filtry PageSpeed są najbezpieczniejsze do włączenia? +

Bezpieczne filtry (CoreFilters): compress\_whitespace, remove\_comments, collapse\_whitespace (HTML), combine\_css, inline\_css (małe pliki CSS), rewrite\_images (kompresja) i convert\_to\_webp\_lossless. Ryzykowne: move\_css\_above\_scripts (może zmienić kolejność), inline\_javascript (może złamać niektóre skrypty), defer\_javascript (wymaga testów). Zacznij od OptimizeForBandwidth lub CoreFilters i testuj regresje.

## Sprawdź oferty pasujące do tego scenariusza

Poniżej masz szybkie przejścia do ofert i stron z kodami rabatowymi tam, gdzie są dostępne.

Contabo

VPS z dostępem root — instalacja ngx\_pagespeed z pełną kontrolą nad filtrami

VPS PageSpeed

[Aktywuj rabat →](/out/contabo)

#Reklama · link partnerski

[Zobacz kod rabatowy →](/kody-rabatowe/contabo)

LH.pl

Hosting z LiteSpeed — wbudowane optymalizacje podobne do PageSpeed bez konfiguracji

LiteSpeed Opt.

[Aktywuj rabat →](/out/lh-pl)

#Reklama · link partnerski

[Zobacz kod rabatowy →](/kody-rabatowe/lh-pl)

Mikrus

Tani VPS do testowania PageSpeed Module z małymi projektami

Tani VPS

[Aktywuj rabat →](/out/mikrus)

#Reklama · link partnerski

[Zobacz kod rabatowy →](/kody-rabatowe/mikrus)

## Powiązane strony

-   [Core Web Vitals — optymalizacja LCP, CLS i INP](/baza-wiedzy/core-web-vitals-optymalizacja)
-   [Brotli — kompresja w Nginx i Apache](/baza-wiedzy/brotli-kompresja-nginx-apache)
-   [Nginx micro-caching — szybkie cache aplikacji](/baza-wiedzy/nginx-cache-microcaching)
-   [Wszystkie artykuły](/baza-wiedzy/)