Szybka odpowiedź: co zmienia Astro 6 i czy warto na nie migrować?
- Astro 6 stabilizuje Live Content Collections, Fonts API i wbudowaną obsługę Content Security Policy.
- Nowy serwer deweloperski oparty na Vite Environment API zbliża środowisko lokalne do produkcji, a przy Cloudflare Workers
astro devdziała wworkerd. - Migracja wymaga Node 22.12+, Vite 7 i importu Zod z
astro/zod. - Adapter Cloudflare v13 nie obsługuje już Cloudflare Pages.
- Nowe projekty zaczynaj od Astro 7, dostępnego od 22 czerwca 2026, a Astro 6 traktuj jako etap pośredni przy migracji z Astro 5.
to największa aktualizacja Astro od lat. Przejście z gałęzi 5.x na 6.x zmienia architekturę lokalnego środowiska programistycznego przez przebudowany serwer deweloperski, głębszą integrację z Cloudflare Workers, stabilne Live Content Collections, wbudowane zarządzanie fontami i obsługa Content Security Policy. Te wszystkie zmiany wyznaczają nowe standardy pracy.
Astro 6 i Cloudflare: dlaczego ta integracja jest ważna?
16 stycznia 2026 roku Cloudflare przejął The Astro Technology Company. Framework pozostał na licencji MIT i nadal działa niezależnie od platformy, na przykład na Netlify, Vercel, AWS i własnym VPS-ie. Z Astro 6 przyszła głęboka integracja z ekosystemem Cloudflare, która istotnie zmienia sposób lokalnej pracy z frameworkiem.
W praktyce rynek coraz częściej dzieli się na dwie pary, z jednej strony Vercel + Next.js, a z drugiej Cloudflare + Astro. Więcej na temat różnic między tymi technologiami, szczegółowo opisałem w artykule Astro.js vs Next.js, które narzędzie wybrać w 2026 roku?.
Workerd jako nowe środowisko uruchomieniowe w Astro 6
Największa techniczna zmiana w Astro 6 to przebudowa astro dev i trzeba tutaj podkreślić, że jest to bardzo znacząca zmiana. Wcześniej lokalny serwer działał w Node.js, a produkcja w Cloudflare Workers, Deno albo Bun. Ten rozdźwięk był architektoniczną pułapką, która rodziła najdroższe błędy z kategorii „u mnie działało”, i w praktyce mocno ograniczał wartość testów lokalnych.
Astro 6 rozwiązał ten problem, ponieważ dzięki kod uruchamiany lokalnie działa w tym samym środowisku uruchomieniowym co na produkcji. Dla użytkowników infrastruktury Cloudflare oznacza to, że astro dev startuje bezpośrednio w , czyli w tym samym silniku JavaScript, który napędza Cloudflare Workers. Masz pełen dostęp do , KV Namespaces, R2 Storage i D1 bez pisania własnych zaślepek. Domyślnie wiązania działają jednak na lokalnych danych, a nie produkcyjnych, a zależności w CommonJS mogą wymagać prekompilacji, bo workerd ich nie obsługuje. Konfigurację wiązań i lokalnego środowiska opisuję w artykule o Astro na Cloudflare Workers.
Start nowego projektu z adapterem wygląda tak (cały proces od zera opisuję w poradniku o pierwszym projekcie w Astro):
Kluczem do sukcesu jest eliminacja zaślepek. Nie ma już bibliotek symulujących Cloudflare lokalnie, a dawne Astro.locals.runtime zastępuje bezpośredni import env z cloudflare:workers. Jeśli korzystasz z KV, R2 albo Durable Objects, pracujesz na nich bezpośrednio i masz pełne .
Live Content Collections w Astro 6 bez przebudowywania projektu
Klasyczny mechanizm Content Collections bazował wyłącznie na etapie budowania, więc cała zawartość była ładowana i weryfikowana podczas generowania statycznych plików. Dla blogów i dokumentacji to idealne rozwiązanie. Dla danych zmieniających się w czasie rzeczywistym, takich jak stany magazynowe, aktualne ceny i spersonalizowane dane użytkownika, był to mur techniczny.
Astro 6 burzy ten mur, stabilizując wprowadzone eksperymentalnie w Astro 5.10 . To ten sam typowany system pracy z treścią, ale z loaderami danych wykonywanymi na żądanie w czasie działania aplikacji. Schematy i autouzupełnianie w edytorze zostają, a zmienia się tylko źródło danych, które jest odpytywane przy każdym żądaniu użytkownika. Wymaga to renderowania na żądanie, czyli adaptera serwerowego.
Wartość biznesowa jest konkretna: statyczna obudowa strony plus dynamiczne dane, takie jak cena i stan magazynu, odświeżane na żądanie i przechodzące przez ten sam typowany system. To rozwiązanie zmniejsza dystans między Astro a Next.js w zastosowaniach e-commerce bez rezygnowania z architektonicznych atutów Astro.
Fonts API w Astro 6 i zarządzanie krojami pisma
Poprawne ładowanie fontów to pole minowe: preload, fonty zastępcze, hosting lokalny kontra Google Fonts, prywatność użytkowników, wynikający z zamiany kroju. Astro 6 eliminuje to pole minowe jedną konfiguracją.
Podczas budowania Astro pobierze wskazane kroje pisma, skopiuje je do lokalnych zasobów projektu i wygeneruje CSS z dopasowanymi fontami zastępczymi. Font trzeba jeszcze dodać do <head> komponentem <Font cssVariable="--font-inter" /> z astro:assets, a prop preload dodaje <link rel="preload"> dla wybranego kroju. Produkcja nie odpytuje zewnętrznych serwerów Google Fonts, ręczna konfiguracja przestaje istnieć.
Dla serwisów obsługujących polskie znaki diakrytyczne, czyli dla większości rodzimych projektów, obsługa podzbioru latin-ext działa bez kompromisów w standardzie.
Content Security Policy w Astro 6
Obsługa to jedna z najbardziej wyczekiwanych funkcji Astro. Wdrażamy ją teraz jednym przełącznikiem. Zamiast ręcznego liczenia haszy skryptów dostajesz deklaratywną konfigurację w pliku projektu.
Astro dodaje do <head> każdej strony element <meta http-equiv="content-security-policy"> razem z hashami dla wbudowanych skryptów i stylów, w tym ładowanych przez mechanizm wysp. CSP nie działa w astro dev, więc sprawdzaj je przez astro build i astro preview, a dyrektywy wymagające nagłówka HTTP, np. frame-ancestors, ustaw osobno na serwerze lub w CDN. Dla serwisów objętych audytami bezpieczeństwa to znacząca oszczędność pracy. Przed czym CSP faktycznie chroni, opisuję w artykule o lukach CSRF, XSS i Injection.
Nowy kompilator Astro napisany w Rust
Astro 6 dostarcza eksperymentalny kompilator w Rust (flaga rustCompiler), który docelowo zastąpi wariant oparty na Go. Na dużych projektach z wieloma komponentami .astro różnica w czasie budowania może być wyraźna. Na blogu opartym głównie na MDX będzie raczej znikoma, bo pliki MDX nie przechodzą przez kompilator .astro. W Astro 6 kompilator jest opcjonalny, a w Astro 7 stał się domyślnym i jedynym, więc kierunek jest jasny: szybkość kompilacji staje się przewagą architektury.
Zmiany łamiące kompatybilność w Astro 6
Lista zmian łamiących kompatybilność jest długa, ale większość dotyczy przestarzałych API, które w zadbanych projektach i tak powinny być już usunięte. Oto najważniejsze punkty:
Obowiązkowe środowisko Node 22+ ponieważ wsparcie dla Node 20 wygasa w kwietniu 2026 r., dlatego Astro 6 oficjalnie porzuca gałęzie 18 i 20. Upewnij się, że CI, Dockerfile i infrastruktura serwerowa używają właściwej wersji.
Usunięto przestarzałe API.
import.meta.glob(), które nie zwraca już Promise, zastępujeAstro.glob(), znikają teżemitESMImage()na rzeczemitImageMetadata(), komponentViewTransitions, którego rolę przejąłClientRouter, oraz stary system Content Collections.Zablokowano wsparcie dla pliku
astro.config.cjs. Usunięto rozszerzenia.cjsi.cts, obsługiwane są.mjs,.js,.tsi.mts.Przesiadka na Vite 7 wymaga weryfikacji kompatybilności, jeżeli Twój projekt korzysta z niestandardowych wtyczek Vite.
Zmiana w wyliczaniu identyfikatorów dla nagłówków Markdown oznacza, że nagłówki kończące się znakiem specjalnym zachowują końcowy myślnik (np.
## <Picture />dajeid="picture-"). Bezpośrednie linki do takich sekcji trzeba zaktualizować, bo fragmentu#nie da się przekierować po stronie serwera.Znaczne przebudowanie adaptera Cloudflare (v13) usuwa obsługę Cloudflare Pages, więc serwisy postawione na Pages trzeba przenieść na Workers. Usunięto też
Astro.locals.runtimena rzecz bezpośredniego dostępu do API Workers, np.import { env } from 'cloudflare:workers'.
Lista kontrolna przed migracją do Astro 6
Przed uruchomieniem komend aktualizujących wdrażamy krótką ocenę ryzyka. Problemy nigdy nie leżą w samym Astro 6, tylko w adapterach, wtyczkach i bibliotekach dołączonych do projektu.
- Node 22.12.0 lub wyższy lokalnie i w CI.
Usunięte wywołania
Astro.glob(), zastąpioneimport.meta.glob()lub Content Collections.Schematy Zod z importem
zzastro/zod, a nie zastro:content.Własne wtyczki Vite po weryfikacji kompatybilności z Vite 7.
Adapter Cloudflare po testach na Workers, z weryfikacją bindingów, statycznych zasobów i sesji.
Bezpośrednie linki do sekcji artykułów, ponieważ nowy algorytm identyfikatorów nagłówków Markdown może je zepsuć.
Typowy blog z kilkudziesięcioma plikami MDX i przewidywalną architekturą da się zwykle przenieść w 2-4 roboczogodziny, ale większe projekty z własnymi integracjami wymagają kilku dni testów i poprawek.
Jak bezpiecznie zaktualizować projekt do Astro 6?
Astro dostarcza narzędzie CLI, które automatyzuje aktualizację rdzenia i oficjalnych integracji.
Narzędzie podnosi wersję astro, aktualizuje wspierane pakiety @astrojs/* i raportuje konflikty peer dependencies. Po aktualizacji weryfikuj projekt przez oficjalny przewodnik po migracji w dokumentacji Astro, szczególnie przy niestandardowych adapterach.
Proces migracji na poziomie produkcyjnym:
- Nowa gałąź w systemie kontroli wersji i aktualizacja tylko na niej.
astro checkw celu weryfikacji typowania i naprawy wykrytych błędów.astro buildiastro previewuruchomione ręcznie, aby ostrzeżenia pokazały problemy z buildem, a podgląd pozwolił sprawdzić CSP, które nie działa wastro dev.- Test interaktywności w środowisku bliskim produkcji: workerd albo Node.
- Deployment testowy oraz weryfikacja i braku nowych błędów indeksowania w Google Search Console (techniczny fundament SEO opisuję w artykule o SEO w Astro).
Czy warto migrować do Astro 6 teraz?
Astro 6 jest produkcyjnie stabilne od marca 2026, ale od 22 czerwca 2026 dostępne jest już Astro 7, dlatego nowe projekty zaczynaj od najnowszej wersji, a Astro 6 traktuj jako etap pośredni przy migracji z Astro 5. W sytuacji, kiedy hosting opierasz na Cloudflare, największą korzyścią jest lokalne środowisko identyczne z produkcją. Przy innych dostawcach zyskujesz Fonts API, stabilne CSP, Live Content Collections i wygodniejszą pracę programistyczną.
Dla istniejących projektów na Astro 5 migracja etapami jest możliwa, ale odkładanie jej w nieokreśloną przyszłość nie jest dobrym rozwiązaniem. Im bardziej rozjadą się wersje adapterów i integracji, tym droższa stanie się późniejsza aktualizacja.


