DevOps2 min czytania

Statyczna strona na Cloudflare Workers w pięć minut

Bez serwera, bez FTP i zwykle bez kosztów. Konfiguracja wrangler, nagłówki cache, przekierowania i własna strona 404.

workers

Zdjęcie ilustracyjne: Unsplash

Ten blog jest pisany w WordPressie, ale czytasz go jako zwykłe pliki HTML z Cloudflare Workers. Dla strony, która nie potrzebuje bazy danych przy każdym wejściu, to najszybsza i najtańsza droga: pliki leżą na brzegu sieci, blisko czytelnika.

Konfiguracja

Potrzebujesz jednego pliku. Sekcja [assets] mówi, z którego folderu serwować pliki — skryptu Workera nie trzeba pisać wcale.

name = "moja-strona"
compatibility_date = "2026-10-01"

[assets]
directory = "./dist"
not_found_handling = "404-page"

Opcja not_found_handling = "404-page" sprawi, że dla nieistniejących adresów zostanie zwrócony Twój plik 404.html z kodem 404, a nie pusta odpowiedź.

Deploy

npx wrangler login     # raz, otwiera przeglądarkę
npm run build
npx wrangler deploy

Po kilkunastu sekundach strona działa pod adresem moja-strona.<konto>.workers.dev. Własną domenę podpinasz w panelu jednym kliknięciem, jeśli DNS jest w Cloudflare.

Cache i nagłówki

Plik _headers w folderze z buildem ustawia nagłówki dla ścieżek. Pliki z hashem w nazwie można cache’ować „na zawsze”, HTML — krótko, żeby nowa wersja była widoczna od razu.

/assets/*
  Cache-Control: public, max-age=31536000, immutable

/*.html
  Cache-Control: public, max-age=300

Przekierowania

Zmieniłeś adres artykułu? Plik _redirects obsłuży to bez kodu, a wyszukiwarka przeniesie pozycję na nowy URL.

/stary-adres/   /nowy-adres/   301

Ile to kosztuje

W darmowym planie zapytania do samych plików statycznych nie są liczone do limitu wywołań Workera. Dla bloga czy wizytówki rachunek zwykle wynosi zero. Limity i cennik zmieniają się, więc przed większym projektem zajrzyj do aktualnej dokumentacji.

Kiedy nie statyka Komentarze na żywo, logowanie, koszyk z magazynem — to już potrzebuje backendu. Wtedy ten sam Worker może dostać kod i bazę D1, ale to temat na osobny tekst.

STOS

Blog o frontendzie, DevOps i narzędziach

Zbudowany na WordPressie: własny motyw blokowy, Polylang, Yoast SEO. Zobacz panel WordPressa w Playground ↗

STOS to fikcyjny blog — projekt koncepcyjny do portfolio. Autorka i treści są przykładowe.