← Cloudflare Workers / workers / framework-guides / web-apps

adaptér OpenNext

Tento průvodce použijte ke správě stávající aplikace OpenNext. Jakmile to kompatibilita umožní, přejděte na vinext.

OpenNext ↗ přizpůsobuje výstup next build aby mohl běžet na různých platformách, včetně Cloudflare Workers.

Podporované funkce

Většinu funkcí Next.js podporuje adaptér Cloudflare OpenNext:

Funkce	Adaptér Cloudflare OpenNext	Poznámky
App Router	Podporováno
Pages Router	Podporováno
Obslužné rutiny tras	Podporováno
React Server Components	Podporováno
Generování statických stránek (SSG)	Podporováno
Vykreslování na straně serveru (SSR)	Podporováno
Incremental Static Regeneration (ISR)	Podporováno
Server Actions	Podporováno
Streamování odpovědi	Podporováno
Asynchronní práce s `next/after`	Podporováno
Middleware	Podporováno
Optimalizace obrázků	Podporováno	Podporováno prostřednictvím Cloudflare Images.
Partial Prerendering (PPR)	Podporováno	PPR je v Next.js experimentální funkce.
Composable Caching (`"use cache"`)	Podporováno	Composable Caching je v Next.js experimentální funkce.
Node.js v Middleware	Zatím není podporováno	Middleware Node.js zavedený v Next.js 15.2 zatím není podporován.

Podrobnou dokumentaci OpenNext najdete v OpenNext pro Cloudflare ↗.

Nakonfigurujte OpenNext ručně

Automatická konfigurace Wrangleru používá pro projekty Next.js vinext. Chcete-li použít OpenNext, nakonfigurujte adaptér ručně.

Nainstalujte adaptér OpenNext Cloudflare.
npm i @opennextjs/cloudflare@latest
Nainstalujte Wrangler.
npm i -D wrangler@latest

Přidejte konfigurační soubor Wrangler.

V kořenovém adresáři projektu vytvořte Konfigurační soubor Wrangler následujícím obsahem:

{
  "$schema": "./node_modules/wrangler/config-schema.json",
  "name": "my-app",
  "main": ".open-next/worker.js",
  // Set this to today's date
  "compatibility_date": "2026-08-28",
  "compatibility_flags": [
    "nodejs_compat"
  ],
  "assets": {
    "directory": ".open-next/assets",
    "binding": "ASSETS"
  },
  "observability": {
    "enabled": true
  }
}

name = "my-app"
main = ".open-next/worker.js"
# Set this to today's date
compatibility_date = "2026-08-28"
compatibility_flags = ["nodejs_compat"]

[assets]
directory = ".open-next/assets"
binding = "ASSETS"

[observability]
enabled = true

Přidejte konfigurační soubor OpenNext.

V kořenovém adresáři projektu vytvořte open-next.config.ts:
```
import { defineCloudflareConfig } from "@opennextjs/cloudflare";

export default defineCloudflareConfig();
```
Tento soubor slouží ke konfiguraci funkcí OpenNext, například cachování. Další informace najdete v Ukládání do cache v OpenNext ↗.
Aktualizujte package.json.

Přidejte skripty pro náhled, nasazení a generování typů Cloudflare:
```
{
  "scripts": {
    "preview": "opennextjs-cloudflare build && opennextjs-cloudflare preview",
    "deploy": "opennextjs-cloudflare build && opennextjs-cloudflare deploy",
    "cf-typegen": "wrangler types --env-interface CloudflareEnv cloudflare-env.d.ts"
  }
}
```
Využití skriptu
- preview: Sestaví vaši aplikaci a spustí ji lokálně v Workers runtime.
- deploy: Sestaví vaši aplikaci a nasadí ji do Cloudflare Workers.
- cf-typegen: Vygeneruje cloudflare-env.d.ts s typy Cloudflare binding.
Vývoj lokálně.

Spusťte vývojový server Next.js.
npm run dev
Náhled s OpenNext.

Zobrazte náhled své aplikace v Workers runtime.
npm run preview
Nasaďte svůj projekt.

Nasaďte svůj projekt na Cloudflare Workers.
npm run deploy