SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor

nginx reverse proxy কনফিগারেশন করার সঠিক নিয়ম

Ubuntu 24.04-এ nginx reverse proxy সেটআপ করার সম্পূর্ণ গাইড। proxy_pass, প্রয়োজনীয় চারটি হেডার, websockets এবং ফাইল আপলোড কনফিগারেশনের লাইন বাই লাইন ব্যাখ্যা এখানে দেওয়া হলো।

nginx reverse proxy কনফিগারেশন যা করে

একটি nginx reverse proxy পোর্ট 80 এবং 443-এ আসা অনুরোধগুলো গ্রহণ করে এবং প্রতিটি অনুরোধকে লোকাল পোর্টে চলমান অ্যাপ্লিকেশনের কাছে পাঠিয়ে দেয়। এরপর অ্যাপ্লিকেশনটি যে উত্তর দেয়, তা ব্রাউজারে ফেরত পাঠায়। এর কনফিগারেশনটি একটি মাত্র 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 { } ব্লকের ভেতরে গ্লোবাল অপশনগুলো সেট করে এবং এরপর দুটি ডিরেক্টরিকে অন্তর্ভুক্ত করে: /etc/nginx/conf.d/*.conf এবং /etc/nginx/sites-enabled/*। Ubuntu এবং Debian-এ আপনি প্রতিটি সাইটের জন্য /etc/nginx/sites-available/-এ একটি করে ফাইল তৈরি করেন এবং /etc/nginx/sites-enabled/-এ একটি symlink তৈরির মাধ্যমে তা চালু করেন। symlink মুছে ফেললে সাইটটি নিষ্ক্রিয় হয়ে যায়, কিন্তু ফাইলটি থেকে যায়।

পরবর্তীতে ব্যবহৃত দুটি ডিরেক্টিভ শুধুমাত্র http কনটেক্সটেই কাজ করে, কখনোই server ব্লকের ভেতরে নয়: map এবং upstream। এগুলোকে /etc/nginx/conf.d/-এর অধীনে আলাদা ফাইলে রাখুন, কারণ সেই ডিরেক্টরিটি http লেভেলে অন্তর্ভুক্ত করা হয়।

প্যাকেজটি default নামে একটি সক্রিয় সাইট নিয়ে আসে। এটি default_server হিসেবে চিহ্নিত, যার অর্থ হলো এটি এমন যেকোনো অনুরোধের উত্তর দেয় যার Host হেডার আপনার কনফিগারেশনের কোথাও থাকা কোনো server_name-এর সাথে মেলে না। এটি সক্রিয় থাকলে, আপনার ডোমেইন নামের সাথে না মেলা অনুরোধগুলো আপনার অ্যাপের পরিবর্তে এই সাইটে চলে যায়। আপনার নিজস্ব সাইট কাজ করা শুরু করলে symlink-টি মুছে ফেলুন।

sudo rm /etc/nginx/sites-enabled/default
sudo nginx -t
sudo systemctl reload 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 refused হবে। DNS (domain name system) lookup-এ AAAA record পাওয়া dual-stack browser সাধারণত IPv4-এ ফিরে যায় এবং সমস্যাটি আড়াল করে। কিন্তু IPv6-only visitor, অথবা পাওয়া প্রথম address-টিই ব্যবহার করে এমন client, connection refused দেখতে পায়। অন্যদিকে IPv4 ব্যবহারকারী সবাই working site দেখতে পায়। আপনি যে bug report পান, তাতে লেখা থাকে: "এখানে তো কাজ করছে"।

server_name browser পাঠানো Host header-এর সঙ্গে মিলিয়ে দেখা হয়। একাধিক নাম space দিয়ে আলাদা করে লেখা যায়। কোনো block match না করলে nginx যে block-টি default_server সেটি ব্যবহার করে। এ কারণেই packaged site-টি সরাতে হয়েছিল।

location / request path-এর prefix match এবং / প্রতিটি path-এর সঙ্গে match করে। proxy_pass হলো সেই address, যেখানে nginx connection খোলে। অ্যাপটিকে 127.0.0.1-এ bind করে রাখুন, যাতে বাইরে থেকে প্রবেশের একমাত্র পথ nginx হয়। অ্যাপটি container-এ চললে সেটিকে 127.0.0.1:3000:3000 হিসেবে publish করুন, 3000:3000 হিসেবে নয়। কারণ Docker নিজস্ব rule তৈরি করে এবং ufw-কে পাশ কাটিয়ে সরাসরি port publish করে, তাই ufw যা-ই বলুক, bare published port Internet থেকে reachable থাকে। Docker সেই traffic filter করার জন্য তার DOCKER-USER chain ব্যবহার করার কথা বলে। তবে 127.0.0.1-এ bind করাই সহজ সমাধান।

curl line server নিজে থেকে সঠিক Host header পাঠায়। তাই DNS কোনো address-এ point করার আগেই আপনি block-টি test করতে পারেন।

আপনি অন্য কিছু না লিখলে nginx upstream-এ যা পাঠায়

proxy_pass একাই আপনার অ্যাপ্লিকেশনের জন্য চারটি বিষয় গোপন করে।

Ubuntu 24.04-এ থাকা nginx 1.24.0 package ডিফল্টভাবে backend-এর সঙ্গে HTTP/1.0 ব্যবহার করে এবং Connection: close পাঠায়। তাই প্রতিটি অনুরোধে নতুন upstream connection খোলে এবং কোনো protocol upgrade সম্ভব হয় না। March 2026-এ released nginx 1.29.7 এই default পরিবর্তন করেছে: ওই version থেকে nginx upstream-এর সঙ্গে HTTP/1.1 ব্যবহার করে, কোনো Connection header পাঠায় না এবং প্রতিটি অনুরোধে নতুন connection খোলার বদলে pooled connection পুনর্ব্যবহার করে। তবুও WebSocket upgrade-এর জন্য নিচে দেখানো header-গুলো প্রয়োজন।

Host header-টি proxy_pass-এর মানে পরিবর্তন করা হয়, যা হলো 127.0.0.1:3000। Host থেকে absolute link তৈরি করা কোনো app এমন link তৈরি করবে, যা server-এর বাইরে থেকে কেউ খুলতে পারবে না।

অ্যাপে পৌঁছানো connection-টি nginx থেকে আসে। তাই app client address হিসেবে 127.0.0.1 দেখতে পায়। এরপর app-এর প্রতিটি log line এবং rate limit visitor-এর বদলে proxy-কে record করে।

Browser HTTPS ব্যবহার করেছে কি না, app তা বুঝতে পারে না। কারণ app যে connection পেয়েছে, সেটি loopback address-এ plain HTTP।

চারটি line লিখলেই সব ঠিক হয়।

যে 4টি 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 visitor যে নামটি লিখেছে সেটি বহন করে। $host হলো request থেকে নেওয়া নাম; এতে port বাদ দেওয়া হয় এবং অক্ষরগুলো lowercase করা হয়। এটি সেট করলে আপনার app সঠিক absolute URL তৈরি করতে পারে, যেমন login-এর পরের redirect বা password reset email-এর ভেতরের link। এটি বাদ দিলে app 127.0.0.1:3000-কে নিজের নাম হিসেবে ধরে নেয়। nginx-এর default proxy_redirect এমন একটি Location বা Refresh header পুনর্লিখন করে, যা proxy_pass address নির্দেশ করে। তাই login-এর পর সাধারণ redirect সাধারণত সঠিক গন্তব্যে যায়। কিন্তু app তার page ও email-এ যে absolute URL লেখে, যেমন password reset link, সেগুলো 127.0.0.1:3000 নির্দেশ করে। visitor-এর browser সেই address খুলতে পারে না। আপনার app-এর port-ও প্রয়োজন হলে, যেমন এটি 8080-এ পরিবেশিত হলে, $http_host ব্যবহার করুন। এতে client যে header পাঠিয়েছে, সেটিই অপরিবর্তিত থাকে।

X-Real-IP একটি value বহন করে: $remote_addr, অর্থাৎ nginx যে address থেকে connection গ্রহণ করেছে। App নিজস্ব access log এবং rate limiting-এর জন্য এটি পড়ে।

X-Forwarded-For একটি তালিকা বহন করে। $proxy_add_x_forwarded_for client আগে ওই header-এ যা দিয়েছে, তার সঙ্গে $remote_addr যোগ করে। তাই value-টি comma-separated হয় এবং আপনার nginx যোগ করা entry-টি সর্বশেষে থাকে। Header-টি বিশ্বাস করা যাবে কি না, তা এই বিষয়ের ওপর নির্ভর করে। Client ইচ্ছামতো যেকোনো X-Forwarded-For পাঠাতে পারে। তাই প্রথম 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 বহন করে। Framework এগুলো পড়ে cookie-তে Secure flag সেট করবে কি না এবং HTTPS-এ redirect বাধ্যতামূলক করবে কি না, তা নির্ধারণ করে। TLS site-এ এটি বাদ দিলে HTTPS বাধ্যতামূলক করার জন্য configured app http দেখতে পায়। এটি HTTPS address-এ redirect পাঠায়। পরের request nginx-এর মাধ্যমে এলে app আবারও http দেখে এবং আবার redirect করে। Browser শেষ পর্যন্ত চেষ্টা বন্ধ করে ERR_TOO_MANY_REDIRECTS দেখায়।

প্রতিটি location-এ এই 4টি line পুনরাবৃত্তি করলে এগুলোর মধ্যে অমিল তৈরি হয়। এগুলো একটি 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 directive সংজ্ঞায়িত না করা পর্যন্ত সেটি তার server block থেকে proxy_set_header directive inherit করে। location-এর ভেতরে একটি proxy_set_header যোগ করলে server level-এ সংজ্ঞায়িত প্রতিটি header ওই location-এর জন্য বাদ পড়ে। তাই সবগুলো একই level-এ রাখুন, অথবা proxy করা প্রতিটি location-এ snippet-টি include করুন।

কেন আমার WebSocket অ্যাপ connect হয়ে disconnect হয়ে যায়?

কারণ default configuration upgrade অনুমোদন করে না, এবং default read timeout 60 সেকেন্ড পরে idle tunnel বন্ধ করে দেয়। একটি WebSocket শুরু হয় এমন একটি HTTP request হিসেবে, যাতে Upgrade: websocket এবং Connection: Upgrade থাকে। এগুলো hop-by-hop header। অর্থাৎ proxy-এর এগুলো গ্রহণ করে আর forward না করার কথা। এছাড়া Ubuntu 24.04-এর nginx 1.24.0-এ upstream protocol-এর default হলো HTTP/1.0, যাতে upgrade mechanism নেই। দুটিই হাতে সেট করতে হবে।

map-টি http context-এ, আলাদা file-এ রাখতে হবে।

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

এরপর location।

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"; নির্ধারণ করলে প্রতিটি সাধারণ page request-এর সঙ্গেও ওই header পাঠানো হবে। কিছু backend এ ধরনের request-এর উত্তর 400 দিয়ে দেয়।

proxy_http_version 1.1; হলো nginx 1.29.7 থেকে ব্যবহৃত default। তাই ওই version-গুলোতে এই line কোনো পরিবর্তন করে না এবং ক্ষতিও করে না। 1.24.0 package-এ এটি প্রয়োজনীয়। Upgrade এবং Connection line প্রতিটি version-এই প্রয়োজনীয়, কারণ nginx নিজে থেকে ওই দুটি header কখনো pass through করে না।

proxy_read_timeout-এর কারণেই “load হয়, তারপর update বন্ধ হয়ে যায়” ধরনের report দেখা যায়। এর default 60 সেকেন্ড। এটি connection কতক্ষণ চালু আছে তা মাপে না; বরং backend থেকে পরপর দুটি read-এর মধ্যকার বিরতি মাপে। 60 সেকেন্ড কোনো data না পাঠানো WebSocket nginx বন্ধ করে দেয়। Browser console-এ socket code 1006 দিয়ে বন্ধ হওয়ার তথ্য দেখা যায়। যে app প্রতি মিনিটের চেয়ে ঘন ঘন নিজস্ব heartbeat পাঠায়, সেখানে এই সমস্যা দেখা যায় না। যে app heartbeat পাঠায় না, সেটি ঠিক এক মিনিট পরে বন্ধ হয়ে যায়। Live editor এবং dashboard-এ সমস্যাটি আগে দেখা যায়। HTTPS-এর পেছনে থাকা একটি self-hosted n8n instance এর একটি সাধারণ উদাহরণ।

কেন proxy_pass-এ একটি ট্রেইলিং স্ল্যাশ আমার 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 এমন backend-এ পাঠায়, যেখানে active connection-এর সংখ্যা সবচেয়ে কম। অসম দৈর্ঘ্যের request-এর জন্য এটি উপযোগী। ip_hash একটি client address-কে একটি backend-এর সঙ্গে স্থায়ীভাবে যুক্ত করে। অ্যাপটি নিজের memory-তে session রাখলে ip_hash প্রয়োজন। কারণ এমন দুইটি backend-এর মধ্যে round robin ব্যবহার করলে request এমন instance-এ পৌঁছাতে পারে, যেখানে client-এর session তৈরি হয়নি, ফলে ব্যবহারকারী অনিয়মিতভাবে logout হয়ে যায়। Session shared storage-এ রাখা উত্তম সমাধান।

max_fails=3 fail_timeout=30s-এর অর্থ হলো 30 সেকেন্ডের মধ্যে তিনটি ব্যর্থ attempt হলে server-টিকে 30 সেকেন্ডের জন্য pool থেকে সরিয়ে দেওয়া হবে। Block-এর সব server এই অবস্থায় থাকলে client 502 পাবে এবং error log-এ no live upstreams while connecting to upstream লেখা থাকবে।

প্রতি worker process-এর জন্য keepalive 32 backend-গুলোর সঙ্গে সর্বোচ্চ 32টি idle connection খোলা রাখে। এতে অধিকাংশ request-এর ক্ষেত্রে TCP handshake বাদ যায়। Ubuntu 24.04-এর 1.24.0 সংস্করণে এই line-ই cache সক্রিয় করে। nginx 1.29.7 থেকে cache ডিফল্টভাবে সক্রিয়। তবে documented default হলো keepalive 32 local;, এবং local parameter ভিন্ন location-এর মধ্যে cached connection share হওয়া বন্ধ করে। তাই 1.29.7 এবং পরবর্তী সংস্করণে শুধু keepalive 32; লিখলে তা ডিফল্ট পুনরায় ঘোষণা করে না। local বাদ দিলে একই upstream server-এ proxy করা যেকোনো location pooled connection পুনরায় ব্যবহার করতে পারে। এটি ডিফল্ট আচরণ থেকে ভিন্ন। এই সংস্করণগুলোতে ডিফল্ট বজায় রাখতে line-টি বাদ দিন অথবা keepalive 32 local; লিখুন। শুধু sharing চাইলে line-টি parameter ছাড়া লিখুন। local parameter 1.29.7-এ নতুন যোগ হয়েছে। তাই 1.24.0 package এটি গ্রহণ করে না। HTTP backend-এর জন্য pool সংক্রান্ত nginx-এর প্রস্তাবিত setup হলো proxy_http_version-কে 1.1 (অথবা nginx 1.29.4 এবং পরবর্তী সংস্করণে 2) সেট করা এবং upstream-এ যাওয়া Connection header পরিষ্কার করা। nginx HTTP/1.0 persistent connection-ও নথিভুক্ত করেছে। এটি সমর্থিত backend-এ Connection: Keep-Alive পাঠিয়ে তৈরি করা হয়, তবে nginx এই পদ্ধতি সুপারিশ করে না। 1.29.7 থেকে প্রস্তাবিত setup-এর উভয় অংশই ডিফল্ট। 1.24.0-এ location-এ নিজে proxy_http_version 1.1; এবং proxy_set_header Connection ""; যোগ করুন। তা না হলে nginx Connection: close সহ HTTP/1.0 পাঠাতে থাকবে এবং pool কখনো পুনরায় ব্যবহার হবে না। একই location-এ WebSocket map ব্যবহার করা হলে empty case-টি close থেকে empty string-এ পরিবর্তন করুন। এতে সাধারণ request-এ কোনো Connection header থাকবে না এবং pooled connection পুনরায় ব্যবহার করা যাবে।

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

একটি upstream block-এর ভেতরের name nginx start হওয়ার সময় resolve হয়। Backend যদি restart-এর সময় নতুন address পাওয়া container হয়, reload না করা পর্যন্ত nginx পুরোনো address ব্যবহার করতে থাকে। nginx 1.27.3 এবং পরবর্তী সংস্করণে reload ছাড়াই এই পরিবর্তন অনুসরণ করা যায়। এর জন্য একটি resolver, upstream block-এ একটি zone এবং প্রতিটি server line-এ resolve parameter ব্যবহার করতে হয়। তবে 1.24.0 package এই সুবিধার আগের। Docker network-এর ভেতরে embedded resolver ব্যবহার করে lookup request-এর সময়ে করানো যায়।

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

Container ঘন ঘন তৈরি ও সরানো হলে nginx-এর configuration বারবার সম্পাদনা করে তাল মেলানো কঠিন হয়। এ ক্ষেত্রে container label পড়তে পারে এমন proxy ব্যবহার করা ভালো। একাধিক Docker Compose app-এর সামনে Traefik container-গুলোর configuration থেকেই route তৈরি করে।

413 Request Entity Too Large দেখিয়ে upload ব্যর্থ হয় কেন?

client_max_body_size-এর default মান 1 megabyte। request body বড় হলে nginx 413 error দিয়ে request প্রত্যাখ্যান করে এবং error log-এ client intended to send too large body record করে। server block-এ, অথবা upload যে location-এ হয় সেখানে এর মান বাড়ান।

client_max_body_size 512m;

0 মান দিলে এই check সম্পূর্ণ বন্ধ হয়। 512m থাকলে nginx ওই limit-এর বেশি request body এখনও প্রত্যাখ্যান করে। তাই এই পরিবর্তনের পরও 413 থাকলে তার উৎস backend—এমন সিদ্ধান্তে পৌঁছানো যায় না। app-এর নিজস্ব upload limit পরীক্ষা করার আগে upload পরিচালনাকারী location-এ কার্যকর client_max_body_size এবং nginx-এর error log পরীক্ষা করুন।

Defaultভাবে nginx upstream connection খোলার আগে সম্পূর্ণ request body পড়ে। বড় body disk-এর temporary file-এ লেখে। এতে slow client থেকে app সুরক্ষিত থাকে, কারণ backend upload-টি local network-এর পূর্ণ গতিতে পায়। খুব বড় upload-এর ক্ষেত্রে আপনি stream ব্যবহার করতে পারেন।

proxy_request_buffering off;

1.24.0 package-এ HTTP/1.1 chunked upload ব্যবহার করলে ওই location-এ proxy_http_version 1.1;-ও সেট করুন। তা না হলে nginx body buffer করতে থাকবে। এরপর backend body আসার সঙ্গে সঙ্গে পাবে এবং সেটি পরিচালনা করতে সক্ষম হতে হবে। nginx upstream-এ body পাঠানো শুরু করার পর request-টি অন্য upstream-এ retry করতে পারে না।

client_body_timeout-এর default মান 60 seconds। এটি সম্পূর্ণ upload-এর জন্য নয়; body-এর পরপর দুটি read-এর মধ্যবর্তী সময়ের ক্ষেত্রে প্রযোজ্য। ধীর কিন্তু অবিচ্ছিন্ন upload এটি অতিক্রম করে চলতে পারে। কিন্তু upload থেমে গেলে connection বন্ধ হয়ে যায়।

রেসপন্স বাফারিং এবং যে সেটিংসটি লাইভ আউটপুট বাধাগ্রস্ত করে

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) প্রক্সিতেই শেষ (terminate) হয় এবং Nginx থেকে অ্যাপ পর্যন্ত সংযোগটি loopback অ্যাড্রেসের মাধ্যমে plain HTTP হিসেবে থাকে, যেখানে নেটওয়ার্কের অন্য কেউ এটি পড়তে পারে না। অ্যাপটি চারটি হেডারের মধ্যে চতুর্থটি, অর্থাৎ X-Forwarded-Proto থেকে জানতে পারে যে ভিজিটর HTTPS ব্যবহার করেছে।

সার্টিফিকেট পাথ নিজে হাতে লিখবেন না। 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 নির্দেশ করছে।

যেসব ব্যর্থতার সম্মুখীন আপনি হবেন

502 Bad Gateway, সাথে এরর লগে connect() failed (111: Connection refused) while connecting to upstream। proxy_pass-এ উল্লেখিত ঠিকানায় কোনো কিছু লিসেন করছে না। অ্যাপটি বন্ধ আছে, অথবা অন্য কোনো পোর্টে বাইন্ড করা আছে, অথবা এমন কোনো কন্টেইনার-ইন্টারনাল ঠিকানায় বাইন্ড করা আছে যেখানে হোস্ট পৌঁছাতে পারছে না।

no live upstreams while connecting to upstream সহ 502 এরর। upstream ব্লকের প্রতিটি সার্ভারকে বর্তমানে max_fails দ্বারা ফেইলড হিসেবে চিহ্নিত করা হয়েছে। ব্যাকএন্ডগুলো মেরামত করুন। fail_timeout এর মেয়াদ শেষ হলে Nginx সেগুলোকে পুনরায় চেষ্টা করবে।

504 Gateway Time-out, সাথে upstream timed out (110: Connection timed out) while reading response header from upstream। ব্যাকএন্ড সংযোগটি গ্রহণ করেছে কিন্তু proxy_read_timeout সেকেন্ড পর্যন্ত কোনো কিছু পাঠায়নি। সত্যিকারের ধীরগতির রিপোর্টের জন্য টাইমআউট বাড়ানো সঠিক, কিন্তু আটকে থাকা অ্যাপের জন্য এটি ভুল সমাধান।

অ্যাপ থেকে প্রতিটি পাথ 404 রিটার্ন করছে। ট্রেইলিং স্ল্যাশ রুল পাথটিকে রিরাইট করেছে। অ্যাপ যে পাথ লগ করছে তার সাথে আপনার অনুরোধ করা পাথটি তুলনা করে দেখুন।

ভিন্ন একটি সাইট উত্তর দিচ্ছে। server_name এর সাথে Host হেডার মিলছে না, তাই অনুরোধটি default_server ব্লকে চলে গেছে।

পেজ লোড হয়, কিন্তু প্রায় এক মিনিট পর ইন্টারফেস ফ্রিজ হয়ে যায়। এটি WebSocket সংক্রান্ত সমস্যা: Upgrade হ্যান্ডলিং অনুপস্থিত, অথবা proxy_read_timeout এখনো 60 সেকেন্ডে সেট করা আছে।

FAQ

nginx-এ proxy_pass যোগ করার পরে কেন 502 Bad Gateway দেখায়?

nginx proxy_pass-এ সংযোগ খুলতে পারেনি। /var/log/nginx/error.log-এ থাকা error log কারণটি দেখায়: connect() failed (111: Connection refused) while connecting to upstream অর্থ সেখানে কোনো কিছু listen করছে না, আর no live upstreams অর্থ upstream block-এর প্রতিটি server-কে failed হিসেবে চিহ্নিত করা হয়েছে। কোন process port-টি ব্যবহার করছে এবং কোন address-এ bind করা আছে তা দেখতে sudo ss -lntp | grep 3000 চালান। কোনো app container-এর অভ্যন্তরীণ address-এ bind করা থাকলে, অথবা আপনার লেখা port-এর বদলে অন্য port-এ চললে, প্রতিবারই এই error দেখা যাবে।

nginx-এর পেছনে চলার সময় প্রায় এক মিনিট পরে আমার app সংযোগ বিচ্ছিন্ন করে কেন?

সংযোগটি WebSocket, এবং proxy_read_timeout এখনও 60 seconds-এর default মানে আছে। এই মান backend থেকে পরপর দুটি read-এর মধ্যবর্তী ব্যবধান মাপে। socket-এ কোনো activity না থাকলে nginx সেটি বন্ধ করে দেয় এবং browser console close code 1006 দেখায়। proxy_http_version 1.1 সেট করুন (nginx 1.29.7 থেকে এটি default, কিন্তু Ubuntu 24.04 যে 1.24.0 package সরবরাহ করে তাতে নয়), Upgrade এবং Connection-কে $http_upgrade-এ map দিয়ে pass করুন, এবং proxy_read_timeout-এর মান 3600s-এর মতো কিছুতে বাড়ান। Upgrade header না থাকলে upgrade একেবারেই হয় না। ফলে app polling-এ ফিরে যায় অথবা live update দেখায় না।

proxy_pass-এ শেষের slash কি গুরুত্বপূর্ণ?

হ্যাঁ, এবং এটি backend যে path পায় তা পরিবর্তন করে। location /app/ এবং proxy_pass http://127.0.0.1:3000/ থাকলে /app/status-এর জন্য করা request backend-এ /status হিসেবে পৌঁছায়। কারণ host ও port-এর পরের যেকোনো URI মিলে যাওয়া location prefix-কে প্রতিস্থাপন করে। শেষের slash বাদ দিলে একই request /app/status হিসেবে পৌঁছায়। Prefix বাদ দিলে প্রায়ই app-এর নিজস্ব asset link নষ্ট হয়। এগুলো absolute থাকায় site root-এ গিয়ে 404 দেয়। তাই base-path setting থাকা app-এর ক্ষেত্রে path অক্ষুণ্ণ রেখে pass করে এমন form ব্যবহার করা ভালো।

আমার application প্রতিটি visitor-এর IP address হিসেবে 127.0.0.1 log করে কেন?

কারণ app যে connection পায়, সেটি সত্যিই loopback address-এ nginx থেকে আসে। আপনি যে header সেট করেন, তার মাধ্যমেই visitor-এর address app-এ পৌঁছায়: একক মানের জন্য proxy_set_header X-Real-IP $remote_addr; এবং সংযুক্ত chain-এর জন্য proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;। এরপর app-এ ওই header-গুলোকে trust করার configuration দিতে হবে। মনে রাখবেন, client নিজেই X-Forwarded-For পাঠাতে পারে। তাই nginx যখন edge server, তখন এটি append না করে $remote_addr দিয়ে overwrite করুন।

nginx এবং আমার app-এর মধ্যে connection-এ কি TLS দরকার?

app একই server-এ চলে এবং 127.0.0.1-এ bind করা থাকলে দরকার নেই, কারণ ওই traffic machine-এর বাইরে যায় না। nginx-এ TLS termination করুন, loopback-এর ওপর plain HTTP-তে proxy_pass রাখুন, এবং X-Forwarded-Proto $scheme পাঠান, যাতে app জানতে পারে visitor HTTPS ব্যবহার করেছে। backend যদি এমন কোনো network পেরিয়ে অন্য host-এ থাকে যা আপনার নিয়ন্ত্রণে নেই, তাহলে ওই hop-এর নিজস্ব protection দরকার। এর জন্য backend-এ HTTPS ব্যবহার করতে পারেন, অথবা দুই machine-এর মধ্যে private tunnel তৈরি করতে পারেন।

এই লেখাটি কি কাজে লেগেছে?