SSD Nodes Learn Hosting plans →
मार्गदर्शक Matt Connorद्वारे Matt Connor

Nginx Reverse Proxy कॉन्फिगरेशन कसे करावे?

Ubuntu 24.04 वर Nginx reverse proxy सेट करण्याची संपूर्ण माहिती. proxy_pass, आवश्यक headers, websockets आणि file uploads साठी अचूक कॉन्फिगरेशन कोड येथे पहा.

Nginx reverse proxy configuration काय करते

Nginx reverse proxy पोर्ट 80 आणि पोर्ट 443 वर येणाऱ्या विनंत्या स्वीकारते आणि त्या स्थानिक पोर्टवर (local port) कार्यरत असलेल्या ॲप्लिकेशनकडे पाठवते, त्यानंतर ॲप्लिकेशनचे उत्तर ब्राउझरला परत करते. याची कॉन्फिगरेशन एकच server ब्लॉक असते आणि हा ब्लॉक लहान असतो. यातील बहुतेक गुंतागुंत पाच ते सहा ओळींमध्ये असते, ज्या ॲप्लिकेशनला खरा क्लायंट कोण होता आणि त्याने कोणता प्रोटोकॉल वापरला होता, याची माहिती देतात.

खालील सर्व माहिती Ubuntu 24.04 वर शून्यापासून तयार केली आहे, ज्यासाठी डिस्ट्रिब्युशनमधील nginx पॅकेज वापरले आहे. याची सुरुवात अशा ॲप्लिकेशनपासून होते जे आधीच 127.0.0.1:3000 वर प्रतिसाद देत आहे. जर तुम्ही अद्याप प्रॉक्सी निवडली नसेल, तर nginx ची Caddy आणि Traefik सोबत तुलना हा लेख आधी वाचावा. खाली nginx चे उत्तर ओळीनुसार कसे दिसते, हे दिले आहे.

या कॉन्फिगरेशन्स तुमच्या स्वतःच्या सर्व्हरवर चालवा. प्रत्येक बदल लागू करण्यापूर्वी sudo nginx -t ने तपासा आणि ते काय आउटपुट देते ते वाचा.

Ubuntu वर Nginx चे कॉन्फिगरेशन कोठे असते

sudo apt update
sudo apt install -y nginx
ls -l /etc/nginx/sites-enabled/

मुख्य फाईल /etc/nginx/nginx.conf मध्ये असते. ती http { } ब्लॉकच्या आत जागतिक (global) पर्याय सेट करते आणि त्यानंतर दोन डिरेक्टरीज समाविष्ट (pull) करते: /etc/nginx/conf.d/*.conf आणि /etc/nginx/sites-enabled/*. Ubuntu आणि Debian वर तुम्ही प्रत्येक साईटसाठी /etc/nginx/sites-available/ मध्ये एक फाईल लिहिता आणि /etc/nginx/sites-enabled/ मध्ये सिम्बॉलिक लिंक (symlink) तयार करून ती कार्यान्वित करता. सिम्बॉलिक लिंक हटवल्यास साईट बंद होते, परंतु फाईल सुरक्षित राहते.

नंतर वापरले जाणारे दोन डिरेक्टिव्ह फक्त http कॉन्टेक्स्टमध्येच काम करतात, ते कधीही server ब्लॉकच्या आत चालत नाहीत: map आणि upstream. त्यांना /etc/nginx/conf.d/ अंतर्गत त्यांच्या स्वतःच्या फाईलमध्ये ठेवा, कारण ती डिरेक्टरी http स्तरावर समाविष्ट केली जाते.

पॅकेजसोबत default नावाची एक कार्यान्वित साईट येते. ती default_server म्हणून चिन्हांकित केलेली असते, याचा अर्थ असा की ज्या विनंतीचा Host हेडर तुमच्या कॉन्फिगरेशनमधील कोणत्याही server_name शी जुळत नाही, त्याला ही साईट उत्तर देते. जोपर्यंत ती कार्यान्वित असते, तोपर्यंत तुमच्या नावाशी न जुळणारी विनंती तुमच्या ॲपऐवजी त्यावर जाते. तुमची स्वतःची साईट व्यवस्थित काम करू लागल्यावर ती सिम्बॉलिक लिंक काढून टाका.

sudo rm /etc/nginx/sites-enabled/default
sudo nginx -t
sudo systemctl reload nginx

nginx द्वारे एका अॅपला proxy करणारा सर्वात लहान server block

server {
    listen 80;
    listen [::]:80;
    server_name app.example.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
    }
}

ते /etc/nginx/sites-available/app.example.com म्हणून जतन करा. त्यानंतर ते enable करून load करा.

sudo ln -s /etc/nginx/sites-available/app.example.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
curl -sI -H 'Host: app.example.com' http://127.0.0.1/

listen 80; IPv4 ला bind करते आणि listen [::]:80; IPv6 ला bind करते. दुसरी ओळ वगळल्यास तुमच्या server वरील प्रत्येक IPv6 connection नाकारले जाते. DNS (domain name system) lookup मधून AAAA record मिळवणारा dual-stack browser सहसा IPv4 वर fallback करतो आणि समस्या लपवतो. मात्र IPv6-only visitor किंवा मिळालेल्या पहिल्याच address वर प्रयत्न करणारा client connection refused पाहतो, तर IPv4 वापरणाऱ्या सर्वांना site सुरू असल्याचे दिसते. तुम्हाला मिळणाऱ्या bug report मध्ये "ते माझ्यासाठी चालते" असे लिहिलेले असते.

server_name ची तुलना browser पाठवत असलेल्या Host header शी केली जाते. अनेक names spaces ने विभक्त करून सूचीबद्ध करता येतात. कोणताही block जुळला नाही, तर nginx default_server असलेला block वापरतो. त्यामुळे packaged site काढणे आवश्यक होते.

location / हा request path वरील prefix match आहे आणि / प्रत्येक path शी जुळते. proxy_pass हा nginx connection उघडतो तो address आहे. अॅपला 127.0.0.1 वर bind ठेवावे, जेणेकरून आत येण्याचा एकमेव मार्ग nginx मधून असेल. अॅप container मध्ये चालत असल्यास ते 127.0.0.1:3000:3000 म्हणून publish करा, 3000:3000 म्हणून नाही. कारण Docker स्वतःचे rules लिहिते आणि ports थेट ufw च्या पुढे publish करते, त्यामुळे ufw काहीही सांगत असले तरी bare published port इंटरनेटवरून पोहोचण्यायोग्य असतो. Docker त्याच्या DOCKER-USER chain ला त्या traffic वर filter लावण्याचे ठिकाण म्हणून दस्तऐवजीकरण करते. मात्र 127.0.0.1 ला bind करणे हा अधिक सोपा उपाय आहे.

curl ओळ server कडून योग्य Host header पाठवते. त्यामुळे DNS कुठेही point करण्यापूर्वी तुम्ही block ची चाचणी करू शकता.

तुम्ही आणखी काही लिहिले नाही, तर nginx upstream कडे काय पाठवतो

proxy_pass हे स्वतंत्रपणे वापरल्यास तुमच्या अॅपपासून चार गोष्टी लपतात.

Ubuntu 24.04 सोबत वितरित होणारे nginx 1.24.0 पॅकेज backend शी default ने HTTP/1.0 वापरून संवाद साधते आणि Connection: close पाठवते. त्यामुळे प्रत्येक विनंतीसाठी नवीन upstream connection उघडले जाते आणि कोणतेही protocol upgrade शक्य होत नाही. March 2026 मध्ये released झालेल्या nginx 1.29.7 ने हे defaults बदलले. त्या version पासून nginx upstream शी HTTP/1.1 वापरून संवाद साधते, कोणताही Connection header पाठवत नाही आणि प्रत्येक विनंतीसाठी नवीन connection उघडण्याऐवजी pooled connections पुन्हा वापरते. तरीही WebSocket upgrade साठी खाली दाखवलेले headers आवश्यक आहेत.

Host header चे मूल्य proxy_pass मधील मूल्याने बदलले जाते, जे 127.0.0.1:3000 आहे. Host वरून absolute links तयार करणारे अॅप आता सर्व्हरबाहेरील कोणीही उघडू शकणार नाही अशा links तयार करते.

अॅपपर्यंत पोहोचणारे connection nginx कडून येते. त्यामुळे अॅपला client address 127.0.0.1 दिसतो. त्यानंतर अॅपमधील प्रत्येक log line आणि प्रत्येक rate limit visitor ऐवजी proxy ची नोंद करते.

Browser ने HTTPS वापरले हे अॅपला समजू शकत नाही, कारण त्याला मिळालेले connection loopback address वरील plain HTTP असते.

या सर्व समस्या चार lines ने दूर होतात.

सेट करायचे चार headers आणि प्रत्येक header backend ला काय पाहू देतो

location / {
    proxy_pass http://127.0.0.1:3000;

    proxy_set_header Host              $host;
    proxy_set_header X-Real-IP         $remote_addr;
    proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

Host मध्ये अभ्यागताने टाइप केलेले नाव असते. $host हे request मधील नाव असते; त्यातून port काढलेला असतो आणि अक्षरे lowercase केलेली असतात. हे सेट केल्यास तुमचे app योग्य absolute URLs तयार करते: login नंतरचा redirect किंवा password reset email मधील link. हे वगळल्यास app 127.0.0.1:3000 हे स्वतःचे नाव समजते. nginx चे default proxy_redirect, proxy_pass address कडे निर्देश करणारे Location किंवा Refresh header पुन्हा लिहिते. त्यामुळे login नंतरचा साधा redirect सहसा योग्य ठिकाणी पोहोचतो. मात्र app आपल्या pages आणि emails मध्ये, उदाहरणार्थ password reset link मध्ये, लिहिते ते absolute URLs 127.0.0.1:3000 कडे निर्देश करतात. हा असा address आहे जो अभ्यागताचा browser उघडू शकत नाही. तुमच्या app ला port देखील आवश्यक असल्यास, कारण तुम्ही ते 8080 वर serve करत असाल, $http_host वापरा. यात client ने पाठवलेला header जशाच्या तसा असतो.

X-Real-IP मध्ये एक value असते: $remote_addr. हा तो address आहे ज्यावरून nginx ने connection स्वीकारले. Apps हा value त्यांच्या access logs आणि rate limiting साठी वाचतात.

X-Forwarded-For मध्ये एक list असते. $proxy_add_x_forwarded_for, client ने त्या header मध्ये आधी ठेवलेल्या value मध्ये $remote_addr जोडते. त्यामुळे value comma separated असते आणि तुमच्या nginx ने जोडलेली entry शेवटी असते. हा तपशील header वर विश्वास ठेवता येईल का हे ठरवतो. Client ला आवडणारा कोणताही X-Forwarded-For पाठवता येतो. त्यामुळे first entry वाचणाऱ्या app ला कोणताही address सांगता येतो. nginx edge server असल्यास त्याऐवजी $remote_addr लिहा आणि client ची version टाकून द्या. तुमच्या पुढे CDN किंवा दुसरा proxy असल्यास realip module मधील set_real_ip_from आणि real_ip_header वापरा. त्यामुळे $remote_addr स्वतःच खरा client address बनेल.

X-Forwarded-Proto मध्ये http किंवा https असते. Cookies Secure म्हणून चिन्हांकित करायच्या का आणि HTTPS कडे redirect करायचा का हे ठरवण्यासाठी frameworks ते वाचतात. TLS site वर ते वगळल्यास HTTPS सक्तीने वापरण्यासाठी configured असलेले app http पाहते. ते HTTPS address कडे redirect पाठवते. पुढील request nginx मार्फत येते, तरी app ला http दिसते आणि ते पुन्हा redirect करते. Browser प्रयत्न थांबवतो आणि ERR_TOO_MANY_REDIRECTS दाखवतो.

ही चार lines प्रत्येक location मध्ये पुन्हा लिहिल्यास त्यांच्यात फरक पडतो. त्या एका file मध्ये ठेवा आणि तो include करा.

# /etc/nginx/snippets/proxy-headers.conf
proxy_set_header Host              $host;
proxy_set_header X-Real-IP         $remote_addr;
proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
location / {
    include snippets/proxy-headers.conf;
    proxy_pass http://127.0.0.1:3000;
}

येथे inheritance मध्ये एक अडचण आहे. एखाद्या location मध्ये स्वतःचे कोणतेही proxy_set_header directives नसतील, तेव्हाच तिला तिच्या server block मधील proxy_set_header directives वारशाने मिळतात. location मध्ये एक proxy_set_header जोडल्यास server स्तरावर defined असलेले सर्व headers त्या location साठी काढून टाकले जातात. त्यामुळे सर्व headers एकाच स्तरावर ठेवा किंवा proxy करणाऱ्या प्रत्येक location मध्ये include हा snippet include करा.

माझे WebSocket अॅप कनेक्ट होऊन लगेच disconnect का होते?

कारण default settings upgrade नाकारतात आणि default read timeout idle tunnel 60 सेकंदांनंतर बंद करतो. WebSocket ची सुरुवात Upgrade: websocket आणि Connection: Upgrade असलेली HTTP request म्हणून होते. हे hop-by-hop headers आहेत. याचा अर्थ proxy ने ते स्वतः हाताळणे अपेक्षित आहे; ती headers पुढे पाठवत नाही. तसेच Ubuntu 24.04 मधील nginx 1.24.0 मध्ये upstream protocol default म्हणून HTTP/1.0 असतो. HTTP/1.0 मध्ये upgrade mechanism नसते. त्यामुळे दोन्ही गोष्टी manually पुन्हा सेट कराव्या लागतात.

map http context मध्ये, स्वतंत्र file मध्ये ठेवावा.

# /etc/nginx/conf.d/websocket.conf
map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

त्यानंतर location configuration द्या.

location / {
    include snippets/proxy-headers.conf;
    proxy_pass http://127.0.0.1:3000;

    proxy_http_version 1.1;
    proxy_set_header Upgrade    $http_upgrade;
    proxy_set_header Connection $connection_upgrade;

    proxy_read_timeout 3600s;
    proxy_send_timeout 3600s;
}

map मुळे एकाच location मधून दोन्ही प्रकारचा traffic हाताळता येतो. सामान्य request मध्ये $http_upgrade रिकामे असते, त्यामुळे $connection_upgrade हे close बनते. Upgrade request मध्ये त्यात websocket असते, त्यामुळे upstream कडे पाठवले जाणारे header Connection: upgrade असते. proxy_set_header Connection "upgrade"; hard-code केल्यास प्रत्येक साध्या page request सोबतही ते header पाठवले जाते. अशा request ला काही backend 400 ने उत्तर देतात.

proxy_http_version 1.1; हे nginx 1.29.7 पासूनचे default आहे. त्यामुळे त्या versions मध्ये ही line काही बदल करत नाही आणि कोणतीही अडचण निर्माण करत नाही. 1.24.0 package मध्ये ही line आवश्यक आहे. Upgrade आणि Connection या lines प्रत्येक version मध्ये आवश्यक आहेत, कारण nginx स्वतःहून हे दोन headers पुढे पाठवत नाही.

proxy_read_timeout मुळे “लोड होते, पण update होणे थांबते” अशा reports येतात. याचे default मूल्य 60 सेकंद आहे. हे connection किती वेळ चालू आहे ते मोजत नाही; backend कडून होणाऱ्या दोन reads मधील अंतर मोजते. 60 सेकंद शांत राहणारे WebSocket nginx बंद करतो आणि browser console मध्ये socket code 1006 सह बंद झाल्याचे दिसते. दर मिनिटाला एकापेक्षा जास्त वेळा स्वतःचा heartbeat पाठवणाऱ्या अॅप्सना ही समस्या जाणवत नाही. Heartbeat न पाठवणारी अॅप्स नेमक्या एका मिनिटानंतर बंद होतात. Live editors आणि dashboards मध्ये ही समस्या सर्वप्रथम दिसते. HTTPS मागे चालणारे self-hosted n8n instance हे याचे सामान्य उदाहरण आहे.

proxy_pass मधील ट्रेलिंग स्लॅश (trailing slash) माझ्या URL मध्ये बदल का करतो?

हा नियम एका वाक्याचा आहे. जर proxy_pass मध्ये URI (uniform resource identifier) असेल, अगदी केवळ एक / जरी असेल, तरी nginx विनंतीच्या पाथचा तो भाग काढून टाकतो जो location प्रीफिक्सशी जुळला होता आणि त्या जागी तो URI ठेवतो. जर proxy_pass फक्त होस्ट आणि पोर्टवर थांबत असेल, तर विनंतीचा पाथ जसाच्या तसा पुढे पाठवला जातो.

location /app/ {
    proxy_pass http://127.0.0.1:3000/;
}

/app/status साठीची विनंती बॅकएंडला /status म्हणून पोहोचते.

location /app/ {
    proxy_pass http://127.0.0.1:3000;
}

/app/status साठीची विनंती बॅकएंडला /app/status म्हणून पोहोचते.

तुम्हाला कोणता प्रकार हवा आहे हे तुमच्या ॲपवर अवलंबून असते. ज्या ॲपमध्ये बेस-पाथ किंवा सब-फोल्डर सेटिंग असते, त्याला दुसरा प्रकार हवा असतो आणि त्या सेटिंगला /app बद्दल माहिती दिलेली असते. ज्या ॲपला प्रीफिक्सबद्दल काहीही माहिती नसते, त्याला पहिल्या प्रकारची गरज असते. पहिल्या प्रकाराचा एक परिणाम तुम्हाला लगेच दिसून येतो: ॲप जे HTML परत करते त्यात अजूनही /static/main.css सारखे ॲब्सोल्युट पाथ असतात, ब्राउझर त्यांच्यासाठी साइट रूटला विचारणा करतो, तिथे कोणतेही लोकेशन मॅच होत नाही आणि पेज स्टाईलिंगशिवाय दिसते. ब्राउझरच्या नेटवर्क टॅबमध्ये त्या ॲसेट विनंत्या 404 म्हणून परत येतात. यावर उपाय म्हणजे ॲपची स्वतःची बेस-पाथ सेटिंग किंवा त्याच बॅकएंडला पॉइंट करणारा दुसरा location /static/.

regex लोकेशनमध्ये proxy_pass मध्ये URI असू शकत नाही. sudo nginx -t अशा कॉन्फिगरेशनला नाकारते आणि त्याचे कारण स्पष्ट करते: "proxy_pass" cannot have URI part in location given by regular expression, or inside named location, or inside "if" statement, or inside "limit_except" block.

जेव्हा प्रत्येक ॲपला स्वतःचे नाव, app.example.com मिळते, जे location / वरून प्रॉक्सी केले जाते, तेव्हा या प्रकारच्या सर्व समस्या दूर होतात. जेव्हा तुम्ही DNS रेकॉर्ड जोडू शकत नाही, तेव्हाच सब-पाथ वापरणे फायदेशीर ठरते.

एकाच नावामागे एकापेक्षा अधिक backend कसे ठेवायचे?

upstream block वापरा. तो http context मध्ये येतो. त्यामुळे तो त्याच file मधील server block च्या वर किंवा /etc/nginx/conf.d/ मध्ये लिहा.

upstream app_backend {
    least_conn;
    server 127.0.0.1:3000 max_fails=3 fail_timeout=30s;
    server 127.0.0.1:3001 max_fails=3 fail_timeout=30s;
    keepalive 32;
}

त्यानंतर location मध्ये त्याचे नाव द्या: proxy_pass http://app_backend;.

डीफॉल्ट पद्धत round robin आहे. least_conn प्रत्येक request सध्या सर्वात कमी active connections असलेल्या backend कडे पाठवतो. वेगवेगळ्या कालावधीच्या requests साठी ही पद्धत योग्य आहे. ip_hash एका client address ला एका backend शी जोडून ठेवतो. अॅप स्वतःच्या memory मध्ये sessions ठेवत असेल, तर ip_hash आवश्यक आहे. कारण अशा दोन backends वर round robin वापरल्यास requests त्यांना न पाहिलेल्या instance कडे गेल्यावर users अनियमितपणे logout होतात. Sessions shared storage मध्ये ठेवणे हा अधिक चांगला उपाय आहे.

max_fails=3 fail_timeout=30s याचा अर्थ 30 seconds मध्ये तीन failed attempts झाल्यावर तो server 30 seconds साठी pool मधून काढला जातो. block मधील प्रत्येक server या स्थितीत गेल्यावर clients ना 502 मिळतो आणि error log मध्ये no live upstreams while connecting to upstream दिसते.

keepalive 32 प्रत्येक worker process साठी backends कडे 32 पर्यंत idle connections उघड्या ठेवतो. त्यामुळे बहुतेक requests साठी एक TCP handshake वाचतो. Ubuntu 24.04 मधील 1.24.0 मध्ये ही line cache सुरू करते. nginx 1.29.7 पासून cache डीफॉल्टने सुरू असतो. मात्र documented default keepalive 32 local; आहे आणि local parameter cached connections वेगवेगळ्या locations मध्ये share होण्यापासून थांबवतो. त्यामुळे 1.29.7 आणि त्यानंतरच्या versions मध्ये bare keepalive 32; लिहिणे केवळ default पुन्हा सांगत नाही. local वगळल्यामुळे त्याच upstream server कडे proxy करणारी कोणतीही location pooled connection पुन्हा वापरू शकते. हे default behaviour मधील बदल आहे. या versions मध्ये default ठेवण्यासाठी line वगळा किंवा keepalive 32 local; लिहा. हे sharing हवे असल्यासच ते bare लिहा. local parameter 1.29.7 मध्ये नवीन आहे. त्यामुळे 1.24.0 package ते स्वीकारत नाही. HTTP backends साठी pool चे nginx ने सुचवलेले configuration म्हणजे proxy_http_version ला 1.1 (किंवा nginx 1.29.4 आणि त्यानंतरच्या versions मध्ये 2) ठेवणे आणि upstream कडे जाणारा Connection header रिकामा करणे. nginx HTTP/1.0 persistent connections चेही documentation देते. त्या पद्धतीत त्यांना समर्थन देणाऱ्या backend कडे Connection: Keep-Alive पाठवले जाते. मात्र nginx ही पद्धत सुचवत नाही. 1.29.7 पासून recommended setup चे दोन्ही भाग डीफॉल्ट आहेत. 1.24.0 मध्ये location मध्ये स्वतः proxy_http_version 1.1; आणि proxy_set_header Connection ""; जोडा. अन्यथा nginx Connection: close सह HTTP/1.0 पाठवत राहतो आणि pool पुन्हा वापरला जात नाही. त्याच location मध्ये WebSocket map वापरत असल्यास, ordinary requests मध्ये Connection header जाऊ नये आणि pooled connection पुन्हा वापरला जावा यासाठी empty case close वरून empty string मध्ये बदला.

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      '';
}

upstream block मधील names nginx सुरू होताना resolve होतात. Backend हा restart झाल्यावर नवीन address मिळवणारा container असल्यास, nginx reload करेपर्यंत जुना address वापरत राहतो. nginx 1.27.3 आणि त्यानंतरचे versions reload न करता असे बदल ओळखू शकतात. त्यासाठी resolver, upstream block मधील zone आणि प्रत्येक server line वरील resolve parameter वापरतात. मात्र 1.24.0 package या सुविधेपूर्वीचे आहे. Docker network मध्ये embedded resolver वापरून lookup request time ला करता येतो.

resolver 127.0.0.11 valid=10s;
set $backend http://app:3000;
proxy_pass $backend;

Containers इतक्या वारंवार तयार आणि हटत असतील की त्यानुसार nginx सतत edit करावा लागत असेल, तर container labels वाचणारा proxy अधिक योग्य आहे. अनेक Docker Compose apps च्या पुढे Traefik स्वतः containers मधून routes तयार करतो.

अपलोड 413 Request Entity Too Large त्रुटीमुळे का अपयशी ठरतात?

client_max_body_size ची default मर्यादा 1 megabyte आहे. यापेक्षा मोठा request body nginx 413 त्रुटीसह नाकारतो आणि error log मध्ये client intended to send too large body नोंदवतो. ही मर्यादा server block मध्ये किंवा अपलोड ज्या location मध्ये होतात त्या ठिकाणी वाढवा.

client_max_body_size 512m;

0 मूल्य दिल्यास ही तपासणी पूर्णपणे बंद होते. 512m असल्यास nginx त्या मर्यादेपेक्षा मोठे request bodies तरीही नाकारतो. त्यामुळे हा बदल केल्यानंतरही 413 येत असेल, तर त्याचा स्रोत backend आहे असे निश्चित करता येत नाही. अपलोड हाताळणाऱ्या location मधील प्रभावी client_max_body_size आणि nginx चा error log तपासा. त्यानंतरच अॅपची स्वतःची upload limit तपासा.

Defaultनुसार nginx upstream connection सुरू करण्यापूर्वी संपूर्ण request body वाचतो. मोठा body आधी disk वरील temporary file मध्ये लिहिला जातो. त्यामुळे slow clients पासून अॅपचे संरक्षण होते, कारण backend ला अपलोड स्थानिक नेटवर्कच्या पूर्ण वेगाने मिळतो. अतिशय मोठ्या अपलोडसाठी तुम्ही streaming वापरू शकता.

proxy_request_buffering off;

1.24.0 package मधील HTTP/1.1 chunked uploads साठी त्या location मध्ये proxy_http_version 1.1; देखील सेट करा. अन्यथा nginx body buffer करत राहतो. त्यानंतर backend ला body येताच मिळतो आणि तो तशा पद्धतीने हाताळण्यास सक्षम असणे आवश्यक आहे. nginx ने body upstream कडे पाठवणे सुरू केल्यानंतर तो request दुसऱ्या upstream कडे पुन्हा पाठवू शकत नाही.

client_body_timeout ची default मर्यादा 60 seconds आहे. ती संपूर्ण upload साठी नसून body च्या सलग दोन reads मधील अंतरासाठी लागू होते. हळू पण सतत होणारा upload ही मर्यादा ओलांडत नाही. मात्र थांबलेला upload बंद केला जातो.

रिस्पॉन्स बफरिंग आणि लाइव्ह आउटपुट खंडित करणारी सेटिंग

proxy_buffering हे डीफॉल्टनुसार सुरू असते आणि सामान्यतः तुम्हाला तेच हवे असते. Nginx तुमच्या ॲपकडून येणारा रिस्पॉन्स ॲपच्या वेगाप्रमाणे वाचते, तो साठवून ठेवते आणि संथ क्लायंटला त्यांच्या गतीनुसार पुरवते. यामुळे ॲप वर्कर पूर्ण डाउनलोड संपेपर्यंत व्यस्त न राहता लवकर मोकळा होतो.

हे स्ट्रीमिंग रिस्पॉन्स खंडित करते. Server-sent events आणि लाइव्ह लॉग आउटपुटमध्ये बफर भरेपर्यंत वाचकाला काहीही दिसत नाही. अशा ठिकाणी बफरिंग बंद करा.

proxy_buffering off;

जर तुमचे ॲपवर नियंत्रण असेल, तर स्ट्रीमिंग रिस्पॉन्ससाठी फक्त X-Accel-Buffering: no हेडर पाठवणे अधिक चांगले ठरते. Nginx प्रत्येक रिस्पॉन्ससाठी ते हेडर वाचते आणि फक्त त्याच रिस्पॉन्ससाठी बफरिंग बंद करते, ज्यामुळे सामान्य पेजेसना बफरिंगचा फायदा मिळत राहतो.

जेव्हा एरर लॉगमध्ये upstream sent too big header while reading response header from upstream असा संदेश येतो, तेव्हा रिस्पॉन्स हेडर्स एका बफरमध्ये मावत नाहीत. proxy_buffer_size हे डीफॉल्टनुसार एका मेमरी पेजच्या आकाराचे असते (प्लॅटफॉर्मनुसार 4 किंवा 8 किलोबाइट्स), आणि लांब कुकीज किंवा मोठे ऑथेंटिकेशन हेडर्समुळे ते ओव्हरफ्लो होते. या दोन्ही व्हॅल्यूज वाढवा.

proxy_buffer_size 16k;
proxy_buffers 8 16k;

या कॉन्फिगरेशनमध्ये TLS कोठे असावे?

Nginx वर, वरील सर्व गोष्टींच्या समोर. TLS (transport layer security) हे प्रॉक्सीवर टर्मिनेट होते आणि Nginx कडून ॲपकडे जाणारे कनेक्शन लूपबॅक ॲड्रेसवर साध्या HTTP स्वरूपात राहते, जिथे नेटवर्कवरील इतर कोणतीही गोष्ट ते वाचू शकत नाही. अभ्यागताने HTTPS वापरले आहे हे ॲपला X-Forwarded-Proto या चार हेडर्सपैकी चौथ्या हेडरावरून समजते.

सर्टिफिकेटचे पाथ स्वतः लिहू नका. DNS रेकॉर्ड सर्व्हरकडे पॉइंट करा, फायरवॉल उघडा आणि Certbot ला हाच सर्व्हर ब्लॉक एडिट करू द्या: ते ssl_certificate पाथसह listen 443 ssl ओळ जोडते, तसेच पोर्ट 80 वरून रिडायरेक्ट करते. Certbot वापरून Nginx साठी Let's Encrypt सर्टिफिकेट जारी करणे मध्ये इश्यूअन्स आणि रिन्यूअल टायमरची माहिती दिली आहे.

sudo ufw allow 'Nginx Full'
sudo ufw status

Nginx Full हे एक ॲप्लिकेशन प्रोफाइल आहे जे Nginx पॅकेज इन्स्टॉल करते आणि ते पोर्ट 80 आणि पोर्ट 443 दोन्ही एकत्र उघडते. प्रत्येक अभ्यागताला HTTPS वर रिडायरेक्ट केल्यानंतरही, HTTP-01 रिन्यूअल चॅलेंजसाठी पोर्ट 80 उघडे ठेवणे आवश्यक आहे.

कॉन्फिगरेशन तपासा आणि मग रीलोड करा

sudo nginx -t
sudo systemctl reload nginx

nginx -t प्रत्येक समाविष्ट केलेली फाईल पार्स करते आणि चाचणी यशस्वी झाल्याचा अहवाल देते किंवा ज्या फाईलमध्ये आणि ओळीवर प्रक्रिया थांबली आहे, ती दर्शवते. रीलोड करण्यापूर्वी ते आउटपुट वाचा. सदोष कॉन्फिगरेशनसह रीलोड केल्यास ते लागू होत नाही: nginx मागील कॉन्फिगरेशननुसारच सेवा देत राहते, त्यामुळे तुमचे बदल काहीही परिणाम करत नाहीत आणि साईट सुरू राहते. systemctl restart वेगळ्या आणि अधिक त्रासदायक पद्धतीने काम करते, कारण रीस्टार्ट केल्यास चालू असलेला सर्व्हर आधी बंद केला जातो. त्यामुळे कॉन्फिगरेशनमध्ये चूक असल्यास nginx पूर्णपणे बंद पडते. शक्यतो रीलोड करा आणि केवळ आवश्यक असेल तेव्हाच रीस्टार्टचा वापर करा.

sudo tail -f /var/log/nginx/error.log
sudo ss -lntp | grep -E ':(80|443|3000)'

ss ओळ कोणता प्रोसेस कोणत्या पोर्टवर कार्यरत आहे हे दर्शवते, जेणेकरून proxy_pass ज्या ठिकाणी निर्देशित करते, तिथेच ॲप खरोखर ऐकत (listening) आहे याची तुम्ही खात्री करू शकता.

तुम्हाला प्रत्यक्षपणे जाणवणारे बिघाड

502 Bad Gateway, एरर लॉगमध्ये connect() failed (111: Connection refused) while connecting to upstream सह. proxy_pass वरील पत्त्यावर कोणतीही सेवा विनंती स्वीकारत नाही (listening). ॲप बंद आहे, किंवा ते दुसऱ्या पोर्टवर कार्यरत आहे, किंवा ते अशा कंटेनर-अंतर्गत पत्त्यावर बाइंड झाले आहे जिथे होस्ट पोहोचू शकत नाही.

no live upstreams while connecting to upstream सह 502 एरर. upstream ब्लॉकमधील प्रत्येक सर्व्हर सध्या max_fails द्वारे 'failed' म्हणून चिन्हांकित केला आहे. बॅकएंड दुरुस्त करा. fail_timeout ची मुदत संपल्यावर Nginx पुन्हा प्रयत्न करेल.

504 Gateway Time-out, upstream timed out (110: Connection timed out) while reading response header from upstream सह. बॅकएंडने कनेक्शन स्वीकारले, परंतु proxy_read_timeout सेकंदांपर्यंत कोणताही प्रतिसाद दिला नाही. जर रिपोर्ट खरोखरच संथ असेल तर टाइमआउट वाढवणे योग्य आहे, परंतु जर ॲप अडकले असेल तर ते चुकीचे आहे.

प्रत्येक पाथवरून ॲपकडून 404 एरर मिळणे. ट्रेलिंग स्लॅशच्या नियमाने पाथ पुन्हा लिहिला (rewrite) आहे. ॲप लॉगमध्ये दिसणारा पाथ आणि तुम्ही विनंती केलेला पाथ यांची तुलना करा.

दुसरीच साईट प्रतिसाद देत आहे. server_name हे Host हेडरशी जुळत नाही, त्यामुळे विनंती default_server ब्लॉकमध्ये गेली आहे.

पेज लोड होते, पण एका मिनिटानंतर इंटरफेस फ्रीझ होतो. हे WebSocket चे प्रकरण आहे: Upgrade हाताळणी (handling) गहाळ आहे, किंवा proxy_read_timeout अजूनही 60 सेकंदांवर सेट आहे.

FAQ

nginx मध्ये proxy_pass जोडल्यानंतर 502 Bad Gateway का मिळतो?

nginx proxy_pass मधील पत्त्यावर connection उघडू शकला नाही. /var/log/nginx/error.log येथील error log कारण स्पष्ट करतो: connect() failed (111: Connection refused) while connecting to upstream म्हणजे त्या पत्त्यावर कोणतीही सेवा listening नाही आणि no live upstreams म्हणजे upstream block मधील प्रत्येक server अपयशी म्हणून चिन्हांकित झाला आहे. कोणत्या process ने port वापरला आहे आणि तो कोणत्या पत्त्यावर bind आहे हे पाहण्यासाठी sudo ss -lntp | grep 3000 चालवा. Container-internal पत्त्यावर bind केलेले अॅप किंवा तुम्ही लिहिलेल्या port पेक्षा वेगळ्या port वर चालणारे अॅप यामुळे हा error प्रत्येक वेळी येतो.

nginx मागे चालवल्यानंतर माझे अॅप सुमारे एका मिनिटाने disconnect का होते?

हे connection WebSocket आहे आणि proxy_read_timeout अजूनही त्याच्या default 60 seconds मूल्यावर आहे. हे backend कडून होणाऱ्या दोन reads मधील अंतर मोजते. शांत socket nginx बंद करतो आणि browser console close code 1006 दाखवतो. proxy_http_version 1.1 सेट करा. हे nginx 1.29.7 पासूनचे default आहे; मात्र Ubuntu 24.04 मध्ये येणाऱ्या 1.24.0 package मध्ये ते default नाही. Upgrade आणि Connection हे $http_upgrade वरील map द्वारे pass करा आणि proxy_read_timeout चे मूल्य 3600s सारखे वाढवा. Upgrade header नसल्यास upgrade मुळीच होत नाही. त्यामुळे अॅप polling वर fallback करते किंवा live updates दाखवत नाही.

proxy_pass मधील शेवटचा slash महत्त्वाचा आहे का?

होय. त्यामुळे backend ला मिळणारा path बदलतो. location /app/ आणि proxy_pass http://127.0.0.1:3000/ वापरल्यास /app/status साठीची request backend ला /status म्हणून मिळते, कारण host आणि port नंतरचा कोणताही URI matched location prefix ची जागा घेतो. शेवटचा slash काढल्यास तीच request backend ला /app/status म्हणून मिळते. Prefix काढल्याने अॅपच्या स्वतःच्या asset links मध्ये अनेकदा समस्या येते. हे links absolute राहतात आणि site root वर 404 मिळतो. त्यामुळे base-path setting असलेल्या अॅपसाठी path जसाच्या तसा pass करणारा प्रकार अधिक योग्य असतो.

माझ्या अॅपच्या log मध्ये प्रत्येक visitor चा IP address 127.0.0.1 का दिसतो?

कारण अॅपला मिळणारे connection प्रत्यक्षात loopback address वरील nginx कडून येते. Visitor चा address तुम्ही set केलेल्या header मधूनच अॅपपर्यंत पोहोचतो: एका value साठी proxy_set_header X-Real-IP $remote_addr; आणि जोडलेल्या chain साठी proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;. त्यानंतर अॅपमध्ये या headers वर trust ठेवण्यासाठी configuration करावी लागते. Client स्वतःचा X-Forwarded-For पाठवू शकतो हे लक्षात ठेवा. त्यामुळे nginx edge server असल्यास ते append करण्याऐवजी $remote_addr ने overwrite करा.

nginx आणि माझ्या अॅपमधील connection वर TLS आवश्यक आहे का?

अॅप त्याच server वर चालत असेल आणि 127.0.0.1 वर bind केलेले असेल तर TLS आवश्यक नाही, कारण तो traffic machine च्या बाहेर जात नाही. nginx वर TLS terminate करा, loopback वर proxy_pass plain HTTP ठेवा आणि X-Forwarded-Proto $scheme पाठवा, जेणेकरून visitor ने HTTPS वापरले आहे हे अॅपला समजेल. Backend वेगळ्या host वर आणि तुमच्या नियंत्रणाबाहेरील network मधून उपलब्ध असेल, तर त्या hop ला स्वतंत्र protection आवश्यक आहे. त्यासाठी backend शी HTTPS वापरा किंवा दोन्ही machines दरम्यान private tunnel तयार करा.

हा लेख उपयुक्त होता का?