ENKROK 01Odděl vývoj od produkce
Návod předpokládá aktuální Next.js aplikaci, npm lockfile a podporu Node.js 24 LTS v projektu. npm run dev slouží vývoji. Nejdřív lokálně nebo v CI spusť kontroly a produkční build. Některé routes mohou potřebovat proměnné nebo přístup k databázi už při sestavení.
npm ci
npm run buildKROK 02Zapni standalone výstup
Do existující Next.js konfigurace přidej output: standalone. Ostatní volby zachovej. Build vytvoří minimální server v .next/standalone. Veřejné soubory a .next/static se do runtime adresáře kopírují zvlášť.
// next.config.ts — doplň do stávající konfigurace
const nextConfig = { output: 'standalone' };
export default nextConfig;KROK 03Zabal produkční runtime
Použij vícestupňový Docker build. Pokud projekt nemá složku public, vytvoř ji nebo vynech její COPY. V .dockerignore vyluč .env, node_modules, .git a .next.
FROM node:24-bookworm-slim AS build
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build
FROM node:24-bookworm-slim AS runtime
WORKDIR /app
ENV NODE_ENV=production
ENV HOSTNAME=0.0.0.0
ENV PORT=3000
COPY --from=build --chown=node:node /app/.next/standalone ./
COPY --from=build --chown=node:node /app/.next/static ./.next/static
COPY --from=build --chown=node:node /app/public ./public
USER node
EXPOSE 3000
CMD ["node", "server.js"]KROK 04Připoj proxy a vyřeš stav aplikace
Podle Docker Compose návodu dej před kontejner Caddy. Tajné runtime proměnné patří do prostředí, ne do Dockerfilu. NEXT_PUBLIC proměnné jsou veřejné a vkládají se při sestavení. Uploady ulož trvale mimo kontejner. Více instancí vyžaduje další návrh cache a revalidace.
KROK 05Testuj skutečné uživatelské operace
Ověř HTML ze serveru, soubory, formuláře, přihlašovací callbacky a optimalizaci obrázků. Projdi logy a restartuj kontejner. Vyzkoušej zápis dat a jejich zachování. Předchozí image nech dostupný pro návrat.
COPY → YOUR AI
Vezmi si další krok do svého chatu.
Bezpečný kontext k tomuto návodu. Žádné tajné údaje. Funguje pro ChatGPT, Claude i další asistenty.
Zdroje a technická dokumentace
Next.js self-hosting ↗Node.js releases ↗Postup je vzor pro uvedené předpoklady. Před použitím na živém serveru ověř kompatibilitu svého projektu a konkrétní konfiguraci.