फ्रेमवर्क गाइडस्टैटिक रूट और 404 पेज

स्टैटिक रूट्स और 404

जेनरेट की गई कंटेंट साइट को हर रूट का HTML सर्व करना चाहिए और न मिलने वाले पेज के लिए HTTP 404 लौटाना चाहिए। Astro स्टैटिक, Docusaurus, VitePress, Hugo और SvelteKit adapter-static के नए lizardpack बिल्ड यही नीति अपनाते हैं। React और Vue SPA वह index.html फ़ॉलबैक बनाए रखते हैं जिसकी ब्राउज़र राउटर को ज़रूरत होती है।

ये बिल्ड न मिलने वाले पेज पर nginx का अपना 404 पेज दिखाते हैं, साइट का 404.html कभी नहीं। अपना 404 पेज दिखाने के लिए नीचे दिया गया nginx कॉन्फ़िगरेशन और Dockerfile इस्तेमाल करें।

बिना ट्रेलिंग स्लैश वाला फ़ोल्डर URL, जैसे guide/index.html के लिए /guide, http://YOUR_PUBLIC_HOST/guide/ पर 301 रीडायरेक्ट हो जाता है, और फिर Lizard उसे HTTPS पर रीडायरेक्ट करता है। दोनों रीडायरेक्ट से बचने के लिए ट्रेलिंग-स्लैश वाले रूप से लिंक करें, या नीचे दिया गया कॉन्फ़िगरेशन इस्तेमाल करें, जो रीडायरेक्ट को HTTPS पर ही रखता है।

नीचे दिया गया कस्टम कॉन्फ़िगरेशन वैकल्पिक है। इसे उस रूटिंग नीति के लिए इस्तेमाल करें जो पहचाना गया फ्रेमवर्क नहीं देता। मौजूदा इमेज रीबिल्ड होने तक अपने पुराने नियम ही रखती हैं।

रूटिंग नीति चुनें

ऐप का प्रकाररूट का व्यवहार
React या Vue SPAसही क्लाइंट रूट index.html लोड करता है, फिर क्लाइंट राउटर उसे रेंडर करता है।
जेनरेट किया गया डॉक्यूमेंटेशन या कंटेंटरूट अपने जेनरेट हुए HTML पर resolve होता है; अनजान पाथ HTTP 404 लौटाता है।
सर्वर पर रेंडर होने वाला ऐपएप्लिकेशन सर्वर रूट्स resolve करता है और स्टेटस लौटाता है।

SPA का catch-all व्यू “पेज नहीं मिला” जैसा मैसेज दिखा सकता है, लेकिन ब्राउज़र का कोड पहले से भेजे जा चुके HTML रिस्पॉन्स का HTTP स्टेटस नहीं बदल सकता। अगर SPA के लिए आपको रूट के हिसाब से सही HTTP स्टेटस चाहिए, तो सर्वर या प्रीरेंडर किए गए रूट्स वाला सेटअप इस्तेमाल करें, जिसे पता हो कि कौन-से पाथ मौजूद हैं।

जेनरेट किए गए पेजों के लिए nginx कॉन्फ़िगर करें

एप्लिकेशन के रूट में nginx.conf बनाएँ:

server {
  listen 80;
  server_name _;
  root /usr/share/nginx/html;
  index index.html;
  absolute_redirect off;
 
  location / {
    try_files $uri $uri.html $uri/ =404;
  }
 
  error_page 404 /404.html;
  location = /404.html {
    internal;
  }
}

यह guide.html और guide/index.html, दोनों तरह के आउटपुट लेआउट सपोर्ट करता है। error_page साइट का जेनरेट हुआ 404.html स्टेटस 404 के साथ सर्व करता है; अगर साइट में 404.html नहीं है, तो nginx की डिफ़ॉल्ट एरर बॉडी इस्तेमाल करने के लिए error_page और exact-match location वाले ब्लॉक हटा दें। absolute_redirect off फ़ोल्डर रीडायरेक्ट को relative Location: /guide/ के रूप में भेजता है, इसलिए ब्राउज़र HTTPS पर ही रहता है। साइट के लिंक और sitemap में canonical URL का एक ही रूप रखें; यह lookup नियम canonical रीडायरेक्ट नहीं जोड़ता।

इस कॉन्फ़िगरेशन के साथ साइट बिल्ड करें

जिस npm प्रोजेक्ट में लॉकफ़ाइल कमिट की हुई है, उसके लिए यह पूरा Dockerfile इस्तेमाल करें। BUILD_SCRIPT और OUTPUT_DIR की डिफ़ॉल्ट वैल्यू नीचे की टेबल के हिसाब से बदलें:

FROM node:22-slim AS build
WORKDIR /app
COPY package.json package-lock.json ./
RUN npm ci
COPY . .
ARG BUILD_SCRIPT=build
RUN npm run "$BUILD_SCRIPT"
 
FROM nginx:alpine
ARG OUTPUT_DIR=dist
COPY --from=build /app/${OUTPUT_DIR}/ /usr/share/nginx/html/
COPY nginx.conf /etc/nginx/conf.d/default.conf
EXPOSE 80
साइटBUILD_SCRIPTOUTPUT_DIR
Astro स्टैटिकbuilddist
Docusaurusbuildbuild
docs/ रूट वाला VitePressdocs:builddocs/.vitepress/dist
प्रोजेक्ट रूट पर VitePressdocs:build या आपकी असली स्क्रिप्ट.vitepress/dist
adapter-static के साथ SvelteKitbuildbuild
Next.js एक्सपोर्टbuildout
Nuxt generatenuxt generate वाली build.output/public

जेनरेट किए गए पेजों वाली नीति तभी इस्तेमाल करें जब ऐप में वे रूट फ़ाइलें हों। उदाहरण के लिए, SvelteKit SPA फ़ॉलबैक को अपनी अलग रूटिंग नीति चाहिए। Next.js स्टैटिक एक्सपोर्ट में ट्रेलिंग-स्लैश लेआउट वाली पूरी रेसिपी है।

.dockerignore में डिपेंडेंसी, बिल्ड आउटपुट, .git और .env* जोड़कर इन्हें बाहर रखें। अगर बिल्ड को पब्लिक वेरिएबल्स चाहिए, तो उन्हें बिल्ड कमांड से पहले ENV लाइनों के रूप में लिखें। Lizard COMMIT_SHA के अलावा कोई बिल्ड आर्गुमेंट पास नहीं करता, इसलिए ARG खाली रहता है। प्राइवेट सीक्रेट्स को इमेज या ब्राउज़र आउटपुट में कॉपी न करें।

CLI सेटअप के बाद lizard add --service web से सर्विस बनाएँ, फिर इस सोर्स को lizard up --service web --port 80 से डिप्लॉय करें। अगर सर्विस पहले से मौजूद है, तो add वाला स्टेप छोड़ दें। मौजूदा सर्विस पर बिल्ड का निर्णय-क्रम जाँचें: कमांड ओवरराइड Dockerfile से ऊपर प्राथमिकता ले सकते हैं। सिर्फ़ कॉन्फ़िग फ़ाइल रख देने से जेनरेट होने वाला nginx कॉन्फ़िगरेशन नहीं बदलता; Dockerfile को उसे इमेज में कॉपी करना होगा।

HTTP रिस्पॉन्स की जाँच करें

SITE_URL को असली लोकल टेस्ट URL या डिप्लॉय किए गए ऐप के origin पर सेट करें, फिर /guide/ की जगह कोई ऐसा पेज लिखें जो मौजूद है:

SITE_URL=https://YOUR_PUBLIC_HOST
curl -sS -o /dev/null -w '%{http_code}\n' "$SITE_URL/"
curl -sS -o /dev/null -w '%{http_code}\n' "$SITE_URL/guide/"
curl -sS -o /dev/null -w '%{http_code}\n' "$SITE_URL/this-page-does-not-exist"

असली पेजों के लिए 200 और न मौजूद पाथ के लिए 404 आना चाहिए। अगर कोई सही रूट अपने canonical रूप पर रीडायरेक्ट करता है, तो रीडायरेक्ट देखें और फिर गंतव्य पेज जाँचें। किसी असली एसेट और किसी काल्पनिक .js पाथ को भी टेस्ट करें: न मौजूद स्क्रिप्ट के लिए स्टेटस 200 के साथ होम पेज का HTML नहीं लौटना चाहिए।

आख़िर में अंदरूनी रूट को सीधे ब्राउज़र में खोलें और रीलोड करें। सिर्फ़ क्लाइंट-साइड नेविगेशन सही चलने से सर्वर रूटिंग की गलती छिप सकती है। इंडेक्स होने वाली साइट पब्लिश करने से पहले HTTP स्टेटस के साथ-साथ फ्रेमवर्क की canonical URL और sitemap सेटिंग्स भी जाँचें।

9 सितंबर 2026 के डिप्लॉयमेंट चेक और उनकी सीमाओं के लिए टेस्ट किए गए वर्ज़न और क्लाउड नतीजे देखें।

अपडेट: