SSD Nodes Learn Hosting plans →
راهنماها Matt Connorتوسط Matt Connor

HTTP چیست؟ راهنمای جامع برای مدیران سرور

در این راهنما با ساختار HTTP، متدها، کدهای وضعیت و هدرهای کلیدی آشنا شوید. بررسی دقیق نحوه ثبت درخواست‌ها در access log سرورهای nginx و نقش TLS و HTTP/3 در امنیت و سرعت.

HTTP چیست؟

HTTP (مخفف hypertext transfer protocol) مجموعه‌ای از قوانین است که کلاینت و وب‌سرور برای درخواست یک منبع و ارسال پاسخ از آن استفاده می‌کنند. کلاینت یک درخواست ارسال می‌کند: متدی مانند GET، مسیری مانند /pricing، نسخه پروتکل، فهرستی از هدرها و گاهی اوقات یک بدنه (body). سرور با یک کد وضعیت مانند 200 پاسخ می‌دهد که به دنبال آن هدرهای خود سرور و معمولاً یک بدنه قرار می‌گیرد. هر بار مشاهده صفحه و هر فراخوانی API (مخفف application programming interface) روی سرور شما، همین تبادل است که تکرار می‌شود.

پروتکل HTTP به‌خودی‌خود فاقد وضعیت (stateless) است. سرور به خاطر نمی‌آورد که شما یک ثانیه پیش چه چیزی درخواست کرده‌اید؛ بنابراین هر چیزی که رفتاری شبیه به حافظه داشته باشد، مانند نشست ورود (login session)، در هر درخواست درون یک هدر حمل می‌شود. همین ویژگی، بسیاری از موارد بعدی را توضیح می‌دهد: کشینگ کاملاً مبتنی بر هدر است و یک load balancer می‌تواند درخواست بعدی شما را بدون ایجاد اختلال، به یک backend متفاوت ارسال کند.

تمام موارد زیر نشان‌دهنده چگونگی نمایش این مدل از سمت سرور، در access log و در پیکربندی nginx شما است.

یک درخواست و پاسخ خام، همراه با توضیحات

در اینجا یک درخواست کامل HTTP/1.1 آورده شده است. یک خط خالی پایان هدرها را مشخص می‌کند و هر چیزی بعد از آن خط، بدنه (body) محسوب می‌شود. یک GET معمولاً بدنه ندارد.

GET /pricing HTTP/1.1
Host: example.com
User-Agent: curl/8.5.0
Accept: */*
Accept-Encoding: gzip
  • GET متد است که مشخص می‌کند چه کاری باید انجام شود. GET برای خواندن، POST برای ارسال داده، PUT برای جایگزینی، DELETE برای حذف و HEAD برای درخواست هدرهای یک GET بدون دریافت بدنه استفاده می‌شود.
  • /pricing مسیر (path) است. نام میزبان (hostname) بخشی از خط درخواست نیست و به همین دلیل هدر بعدی وجود دارد.
  • HTTP/1.1 نسخه پروتکلی است که کلاینت از آن استفاده می‌کند.
  • Host: example.com نام سایتی را که کلاینت می‌خواهد مشخص می‌کند. HTTP/1.1 به آن نیاز دارد، بنابراین nginx به درخواستی که فاقد آن باشد، پاسخ 400 Bad Request می‌دهد.
  • بقیه موارد، تنظیمات ترجیحی هستند. Accept-Encoding: gzip می‌گوید کلاینت می‌تواند داده‌های فشرده را باز کند، بنابراین سرور اجازه دارد بدنه را فشرده کند.

پاسخ نیز ساختار مشابهی دارد و در بالا با یک خط وضعیت (status line) شروع می‌شود.

HTTP/1.1 200 OK
Date: Thu, 06 Aug 2026 09:12:44 GMT
Server: nginx
Content-Type: text/html; charset=utf-8
Content-Length: 5310
Cache-Control: public, max-age=300

<!doctype html>...
  • 200 OK کد وضعیت به همراه عبارت توصیفی آن است. کد وضعیت اهمیت دارد، اما عبارت توصیفی صرفاً جنبه تزئینی دارد و کلاینت‌ها آن را نادیده می‌گیرند.
  • Content-Type به کلاینت می‌گوید که با بایت‌های بعدی چگونه رفتار کند.
  • Content-Length اندازه بدنه به بایت است تا کلاینت بداند بدنه کجا تمام می‌شود. وقتی اندازه از قبل مشخص نباشد، سرور به جای آن Transfer-Encoding: chunked ارسال می‌کند و پایان را با یک chunk با طول صفر مشخص می‌کند.
  • Cache-Control به مرورگر و هر کش (cache) میانی می‌گوید که تا چه مدت می‌توانند این پاسخ را تازه (fresh) تلقی کنند. پس از گذشت max-age ثانیه، پاسخ کهنه (stale) می‌شود؛ این به معنای حذف شدن نیست: کش ممکن است یک نسخه کهنه را نگه دارد و به جای دانلود مجدد کل بدنه، آن را با سرور شما بازبینی (revalidate) کند.
  • خط خالی بعد از هدرها، آن‌ها را از بدنه جدا می‌کند؛ این قاعده در هر دو جهت (درخواست و پاسخ) صادق است.

نام هدرها به کوچک یا بزرگ بودن حروف حساس نیستند و هر خط با یک carriage return و به دنبال آن یک line feed پایان می‌یابد، نه فقط یک newline ساده. شما این‌ها را دستی تایپ نخواهید کرد، اما در تحلیل بسته‌های شبکه (packet capture) با آن‌ها مواجه می‌شوید.

برای مشاهده یک جفت واقعی، دستور زیر را روی سایتی که مالک آن هستید اجرا کنید:

curl -sS -o /dev/null -D - https://example.com/

-D - هدرهای پاسخ را در ترمینال شما می‌نویسد و -o /dev/null بدنه را دور می‌ریزد. این روش را به curl -I ترجیح دهید، زیرا -I یک درخواست HEAD ارسال می‌کند. یک سرور اپلیکیشن که با HEAD متفاوت از GET برخورد می‌کند (که بسیاری از آن‌ها چنین هستند)، هدرهایی را به شما نشان می‌دهد که هیچ مرورگری هرگز دریافت نمی‌کند. curl -v هر دو سمت را چاپ می‌کند، به طوری که خطوط درخواست با > و خطوط پاسخ با < مشخص می‌شوند.

ساختار خط درخواست در لاگ دسترسی nginx شما

نرم‌افزار nginx از فرمت لاگ combined استفاده می‌کند که تعریف آن به شرح زیر است:

log_format combined '$remote_addr - $remote_user [$time_local] '
                    '"$request" $status $body_bytes_sent '
                    '"$http_referer" "$http_user_agent"';

یک نمونه خط تولید شده توسط این فرمت:

203.0.113.45 - - [06/Aug/2026:09:12:44 +0000] "GET /pricing HTTP/1.1" 200 5310 "https://example.com/" "Mozilla/5.0 (X11; Linux x86_64) Chrome/127.0.0.0 Safari/537.36"
  • 203.0.113.45 همان $remote_addr است؛ یعنی آدرسی که اتصال TCP (پروتکل کنترل انتقال) را برقرار کرده است. پشت یک پروکسی، این مقدار آدرس خودِ پروکسی است، نه بازدیدکننده، مگر اینکه ماژول realip را که در ادامه توضیح داده شده برای جایگزینی آن پیکربندی کرده باشید.
  • اولین - یک جای‌نگهدار ثابت است. دومی $remote_user است که فقط در صورت استفاده از احراز هویت پایه HTTP پر می‌شود.
  • "GET /pricing HTTP/1.1" همان $request یا خط کامل درخواست اصلی است. با قابلیت escaping پیش‌فرض لاگ در nginx، کاراکترهای دابل کوتیشن، بک‌اسلش و هر بایتی که مقدار آن کمتر از 32 یا بیشتر از 126 باشد به صورت \xXX نوشته می‌شود؛ بنابراین خط لاگ دقیق است اما لزوماً بایت‌به‌بایت با درخواست اصلی یکسان نیست.
  • 200 وضعیتی است که سرور شما بازگردانده است، نه وضعیتی که بازدیدکننده دریافت کرده است.
  • 5310 همان $body_bytes_sent یا فقط بدنه پاسخ است. هدرهای پاسخ محاسبه نمی‌شوند، بنابراین این عدد همیشه از تعداد بایت‌های واقعاً ارسال‌شده کمتر است.
  • دو فیلد آخر که داخل کوتیشن هستند، Referer و User-Agent می‌باشند. هر دو از سمت کلاینت می‌آیند، بنابراین هر مقداری می‌توانند داشته باشند.

داده‌های نامعتبر (Junk) نیز به صورت escape شده لاگ می‌شوند. کلاینتی که سعی می‌کند با پروتکل TLS (امنیت لایه انتقال) به پورت 80 (که برای متن ساده است) متصل شود، یک خط 400 ایجاد می‌کند که فیلد درخواست آن با بایت‌های escape شده‌ای مانند "\x16\x03\x01\x02\x00\x01" شروع می‌شود. \x16 نوع رکورد handshake پروتکل TLS است، بنابراین آن بایت‌ها شروع یک ClientHello هستند و اصلاً یک خط درخواست نیستند. سرور شما به درستی عمل می‌کند. چیزی در حال ارسال ترافیک HTTPS به یک پورت HTTP است.

مقدار $server_protocol را نیز به فرمت لاگ خود اضافه کنید. این مقدار HTTP/1.1، HTTP/2.0 یا HTTP/3.0 را چاپ می‌کند و سریع‌ترین راه برای اثبات این است که تغییر پروتکل واقعاً اعمال شده است.

معنای کدهای وضعیت رایج هنگام بازگرداندن آن‌ها توسط سایت شما

رقم اول نشان‌دهنده کلاس کد است و شما باید ابتدا کلاس را بررسی کنید.

کدهای 2xx به معنای موفقیت‌آمیز بودن عملیات هستند. 200 OK برای یک خواندن عادی است. 201 Created پس از یک درخواست POST که منجر به ایجاد چیزی شده است، بازگردانده می‌شود. 204 No Content برای موفقیت بدون محتوای ارسالی است که پاسخ معمول به یک درخواست DELETE محسوب می‌شود.

کدهای 3xx به معنای ارجاع به جای دیگر هستند. 301 دائمی است و مرورگرها آن را به‌شدت کش می‌کنند، گاهی تا زمانی که کاربر پروفایل خود را پاک کند؛ بنابراین یک 301 که به نام میزبان اشتباه اشاره کند، به‌سختی قابل اصلاح است. در حین تست کردن redirect از 302 استفاده کنید. 304 Not Modified یک موفقیت است، نه خطا: کلاینت یک درخواست شرطی ارسال کرده است، یا If-None-Match حاوی یک ETag (entity tag) که هنوز آن را می‌شناسید، یا If-Modified-Since با تاریخی که منبع از آن زمان تغییر نکرده است؛ بنابراین شما فقط هدرها را بدون بدنه پاسخ داده‌اید. پر بودن لاگ از 304ها به معنای عملکرد صحیح کش است.

کدهای 4xx به معنای اشتباه بودن درخواست هستند. 400 Bad Request به معنای ورودی با فرمت نادرست است. 401 Unauthorized در واقع به معنای احراز هویت‌نشده است و باید حاوی یک هدر WWW-Authenticate باشد که طرح احراز هویت را مشخص کند. 403 Forbidden یعنی درخواست فهمیده شده اما به هر حال رد شده است. 404 Not Found مسیری است که وجود ندارد، یا مسیری است که سرور ترجیح می‌دهد وجود آن را تایید نکند، زیرا برخی برنامه‌ها برای پنهان کردن یک منبع از کلاینت‌های بدون دسترسی، به جای 403، پاسخ 404 می‌دهند. 405 Method Not Allowed مسیر درست با متد اشتباه است، که نتیجه ارسال یک POST به محل یک فایل ایستا است. 413 یعنی بدنه درخواست بزرگ‌تر از مقدار client_max_body_size در nginx است که به‌صورت پیش‌فرض 1 مگابایت است و لاگ خطا آن را با client intended to send too large body تایید می‌کند.

یک 403 روی یک فایل ایستا تقریباً همیشه مربوط به سیستم فایل است تا قوانین HTTP. پیش از تغییر هر پیکربندی، /var/log/nginx/error.log را مطالعه کنید. open() "/srv/site/index.html" failed (13: Permission denied) یعنی کاربر worker در nginx نمی‌تواند فایل را بخواند، که معمولاً به دلیل فقدان مجوز اجرای (execute) دایرکتوری والد برای سایر کاربران است. directory index of "/srv/site/" is forbidden یعنی مسیر به دایرکتوری‌ای اشاره دارد که فایل index ندارد و autoindex نیز غیرفعال است.

کدهای 5xx به معنای بروز مشکل در سمت سرور شما هستند. 500 خطای عمومی سرور است و در سایت شما معمولاً به یک خطای مدیریت‌نشده در برنامه اشاره دارد. 502 Bad Gateway یعنی nginx نتوانسته پاسخ قابل استفاده‌ای از upstream دریافت کند و لاگ خطا علت را مشخص می‌کند: connect() failed (111: Connection refused) while connecting to upstream یعنی هیچ سرویسی روی آدرس مشخص‌شده در proxy_pass گوش نمی‌دهد. 504 Gateway Timeout یعنی nginx از انتظار برای upstream دست کشیده است. حالت معمول، upstreamای است که اتصال را پذیرفته اما در مدت proxy_read_timeout (به‌صورت پیش‌فرض 60 ثانیه) پاسخی نداده است، که لاگ آن را با upstream timed out (110: Connection timed out) while reading response header from upstream ثبت می‌کند. تلاش برای اتصال که در مدت proxy_connect_timeout (نیز به‌صورت پیش‌فرض 60 ثانیه) تکمیل نشود، به 504 ختم می‌شود و خط لاگ با while connecting to upstream پایان می‌یابد. 503 Service Unavailable یعنی سرور به‌طور موقت قادر به رسیدگی به درخواست نیست، معمولاً به این دلیل که تحت فشار زیاد است یا برای تعمیرات زمان‌بندی‌شده خاموش شده است. توجه داشته باشید که محدودکننده نرخ (rate limiter) خودِ nginx کد 503 را برمی‌گرداند، زیرا مقدار پیش‌فرض limit_req_status برابر با 503 است. اگر در لاگ خود به دنبال 429 Too Many Requests هستید و به جای آن 503 می‌بینید، دلیل آن همین است. برای دریافت کد دقیق، limit_req_status 429; را تنظیم کنید.

هدرهایی که هنگام اجرای سرور اهمیت دارند

Host سایت را انتخاب می‌کند. یک آدرس IP می‌تواند به صدها نام میزبان سرویس‌دهی کند و nginx مقدار Host را با server_name مطابقت می‌دهد تا تصمیم بگیرد کدام بلوک server پاسخگو باشد. اگر هیچ موردی مطابقت نداشته باشد، nginx از سرور پیش‌فرض استفاده می‌کند؛ یعنی اولین بلوکی که روی آن آدرس و پورت گوش می‌دهد، مگر اینکه بلوک دیگری با default_server مشخص شده باشد. دریافت سایت اشتباه از یک میزبان مجازی جدید تقریباً همیشه به این دلیل است: نام مطابقت نداشته و درخواست به سرور پیش‌فرض ارجاع داده شده است. آن را بدون دستکاری DNS تست کنید:

curl -sS -o /dev/null -D - -H 'Host: app.example.com' http://127.0.0.1/

User-Agent یک توصیف خودکار است که توسط کلاینت نوشته می‌شود و متنی آزاد است. هنگام خواندن لاگ‌ها از آن به عنوان یک راهنما استفاده کنید. هرگز از آن به عنوان یک ابزار کنترلی استفاده نکنید، زیرا کلاینتی که بخواهد در مورد آن دروغ بگوید به سادگی این کار را انجام می‌دهد؛ بنابراین مسدود کردن یک اسکرپر با User-Agent فقط موارد مودب را فیلتر می‌کند.

Content-Type تعیین می‌کند که بایت‌ها چگونه تفسیر شوند: application/json برای یک درخواست API و text/html; charset=utf-8 برای یک صفحه. nginx پسوندهای فایل را با /etc/nginx/mime.types به انواع مختلف نگاشت می‌کند و فایل بسته‌بندی‌شده nginx.conf مقدار default_type application/octet-stream; را تنظیم می‌کند، بنابراین فایلی با پسوندی که nginx نمی‌شناسد، به جای نمایش داده شدن، به عنوان دانلود ارائه می‌شود. نشانه ظاهری آن، صفحه‌ای است که بدون استایل بارگذاری می‌شود در حالی که کنسول مرورگر Refused to apply style from ... because its MIME type ('text/plain') is not a supported stylesheet MIME type را چاپ می‌کند. MIME در اینجا مخفف Multipurpose Internet Mail Extensions است، طرح نام‌گذاری که این رشته‌های نوع از آن می‌آیند.

Cache-Control روشی است که با آن هر کش (حافظه پنهان) بین سرور خود و خواننده را کنترل می‌کنید. public, max-age=31536000, immutable برای دارایی‌هایی مناسب است که نام فایل آن‌ها حاوی یک هش محتوا است، زیرا با تغییر محتوا، نام نیز تغییر می‌کند. no-store باید برای هر چیزی که مختص کاربر است استفاده شود، زیرا یک کش اشتراکی که یک صفحه ورود به سیستم را نگه می‌دارد، آن را به نفر بعدی که همان URL را درخواست کند، تحویل می‌دهد. private تنظیم میانه است: مرورگر ممکن است آن را نگه دارد، اما کش اشتراکی مجاز به ذخیره‌سازی آن نیست.

X-Forwarded-For به این دلیل وجود دارد که یک پروکسی، بازدیدکننده را پنهان می‌کند. هنگامی که یک درخواست از یک پروکسی معکوس عبور می‌کند، $remote_addr آدرس پروکسی است، بنابراین لاگ‌ها، موقعیت جغرافیایی و محدودیت نرخ (rate limiting) شما همگی یک کلاینت را می‌بینند تا زمانی که آدرس اصلی را بازیابی کنید. پروکسی باید آدرس اصلی را به همراه درخواست ارسال کند:

proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;

سپس باید به سرور دریافت‌کننده دستور داد که آن را بپذیرد و دقیقاً مشخص کرد که به چه کسی اعتماد کند:

set_real_ip_from 10.0.0.0/8;
real_ip_header X-Forwarded-For;

این دو دستور متعلق به ماژول realip در nginx هستند. این ماژول $remote_addr را با آدرس فوروارد شده جایگزین می‌کند و آدرس خودِ اتصال را در $realip_remote_addr نگه می‌دارد. اگر nginx را خودتان کامپایل می‌کنید، --with-http_realip_module را اضافه کنید، زیرا این ماژول به صورت پیش‌فرض ساخته نمی‌شود.

فقط محدوده‌هایی را لیست کنید که کنترل می‌کنید. set_real_ip_from 0.0.0.0/0; به بازدیدکننده اجازه می‌دهد آدرسی را انتخاب کند که شما لاگ می‌کنید و محدودکننده نرخ شما آن را می‌شمارد، زیرا X-Forwarded-For متن ساده‌ای است که هر کلاینتی می‌تواند ارسال کند.

X-Forwarded-Proto از یک خطای خاص و بسیار رایج جلوگیری می‌کند. پروکسی شما TLS را خاتمه می‌دهد و درخواست را از طریق HTTP ساده به برنامه فوروارد می‌کند. برنامه یک درخواست ساده می‌بیند، تصمیم می‌گیرد که بازدیدکننده باید روی HTTPS باشد و پاسخ 301 https://example.com/ را می‌دهد. مرورگر آن را دنبال می‌کند، پروکسی دوباره TLS را خاتمه می‌دهد و دوباره HTTP ساده را فوروارد می‌کند و این حلقه تا زمانی که مرورگر با ERR_TOO_MANY_REDIRECTS تسلیم شود، تکرار می‌شود. ارسال X-Forwarded-Proto: https به برنامه می‌گوید که بازدیدکننده در حال حاضر روی HTTPS است، بنابراین برنامه از تغییر مسیر (redirect) دست می‌کشد.

مقایسه HTTP/1.1، HTTP/2 و HTTP/3: چه چیزی برای شما تغییر می‌کند

پروتکل HTTP/1.1 متنی است و در عمل، در هر اتصال تنها یک درخواست را در لحظه مدیریت می‌کند. Connection: keep-alive به درخواست بعدی اجازه می‌دهد از همان اتصال TCP استفاده مجدد کند که باعث صرفه‌جویی در هزینه راه‌اندازی می‌شود، اما پاسخ‌ها همچنان به همان ترتیبی که درخواست شده‌اند بازمی‌گردند. این پروتکل همچنین از pipelining پشتیبانی می‌کند که در آن کلاینت چندین درخواست را بدون انتظار برای پاسخ ارسال می‌کند، اما قانون ترتیب همچنان اعمال می‌شود و هیچ مرورگر مدرنی pipelining را به‌صورت پیش‌فرض فعال نمی‌کند. یک پاسخ کند، تمام درخواست‌های پشت سر خود را مسدود می‌کند. این همان مسدودسازی در سطح سر (head-of-line blocking) است و مرورگرها با باز کردن چندین اتصال همزمان به یک نام میزبان، آن را دور می‌زنند.

پروتکل HTTP/2 همان متدها و کدهای وضعیت را حفظ کرده و ساختار بسته‌بندی (framing) را به باینری تغییر داده است. بسیاری از درخواست‌ها یک اتصال را به عنوان جریان‌های (stream) مستقل به اشتراک می‌گذارند و متن تکراری هدرها فشرده می‌شود؛ این موضوع مهم است زیرا درخواست‌های مدرن حاوی حجم زیادی از هدر هستند. اتصال همچنان TCP است، بنابراین یک بسته گم‌شده، تمام جریان‌های آن اتصال را تا زمان ارسال مجدد متوقف می‌کند. مسدودسازی در سطح سر از بین نرفته است؛ بلکه از لایه HTTP به لایه انتقال منتقل شده است. قابلیت Server push بخشی از HTTP/2 بود که در عمل کنار گذاشته شد، زیرا کروم پشتیبانی از آن را در سال 2022 حذف کرد.

پروتکل HTTP/3 دوباره همان معناشناسی را حفظ کرده و TCP را با QUIC جایگزین می‌کند؛ یک پروتکل انتقال که بر پایه UDP (پروتکل دیتاگرام کاربر) ساخته شده است. جریان‌های QUIC در تمام سطوح مستقل هستند، بنابراین یک بسته گم‌شده فقط همان جریانی را که به آن تعلق دارد متوقف می‌کند. TLS 1.3 به جای اینکه روی لایه انتقال قرار بگیرد، در دست‌دادن (handshake) پروتکل QUIC ادغام شده است، بنابراین یک اتصال جدید به رفت‌وبرگشت‌های کمتری نیاز دارد. دو نتیجه عملی حاصل می‌شود: پورت UDP که سرور شما برای HTTP/3 استفاده می‌کند باید در تمام فایروال‌های مسیر باز باشد و هر شبکه‌ای که UDP را محدود یا مسدود کند، کلاینت‌ها را به HTTP/2 بازمی‌گرداند. این پورت معمولاً 443 است، اما پروتکل به سرور اجازه می‌دهد از هر پورت UDP استفاده کند، زیرا اعلانی که مرورگرها را به سمت HTTP/3 هدایت می‌کند، همیشه پورت را به‌صراحت نام می‌برد.

به‌طور مشخص چه چیزی برای شما تغییر می‌کند. مرورگرها معمولاً با HTTP/3 شروع نمی‌کنند. آن‌ها از طریق HTTP/2 یا HTTP/1.1 متصل می‌شوند، هدر Alt-Svc: h3=":443"; ma=86400 را در پاسخ می‌بینند و برای اتصالات بعدی به آن میزبان از HTTP/3 استفاده می‌کنند. استثنا، رکورد HTTPS در DNS است که مقدار alpn آن شامل h3 باشد؛ این به مرورگری مانند فایرفاکس اجازه می‌دهد در همان اولین اتصال، HTTP/3 را باز کند. آن رکورد یک راهنمایی اضافی است، نه جایگزین، بنابراین هدر یک تزئین اختیاری نیست. این هدر مکانیزم اصلی کشف پروتکل است. در nginx، پروتکل HTTP/2 در نسخه 1.25.1 به دستورالعمل اختصاصی خود تبدیل شد (http2 on; در داخل بلوک server، که جایگزین پارامتر قدیمی listen ... http2 شد) و QUIC در نسخه اصلی 1.25.0 ارائه شد، جایی که یک سایت HTTP/3 به listen 443 quic reuseport; در کنار listen 443 ssl; معمولی نیاز دارد. ماژول HTTP/3 به‌صورت پیش‌فرض ساخته نمی‌شود (--with-http_v3_module) و مستندات nginx همچنان پشتیبانی از آن را آزمایشی می‌دانند.

پروکسی‌ها از نظر بلوغ در اینجا متفاوت هستند و ارزش دارد که این موضوع را با نسخه‌ای که واقعاً اجرا می‌کنید بررسی کنید. تا نوامبر 2026، Caddy به‌صورت پیش‌فرض و بدون نیاز به پیکربندی، HTTP/3 را ارائه می‌دهد. nginx به شنونده صریح quic به همراه هدر Alt-Svc که در بالا توضیح داده شد نیاز دارد. Traefik آن را برای هر نقطه ورود (entry point) از طریق گزینه صریح http3 فعال می‌کند. اگر TLS را در Traefik در مقابل چندین برنامه Docker خاتمه دهید، نسخه پروتکلی که بازدیدکنندگان دریافت می‌کنند در همان‌جا تعیین می‌شود و پرش (hop) از پروکسی به کانتینر شما معمولاً HTTP/1.1 ساده است، فارغ از اینکه مرورگر چه چیزی را مذاکره کرده باشد.

به جای فرض کردن، بررسی کنید. curl --http3 -sS -o /dev/null -D - https://example.com/ تنها در صورتی کار می‌کند که curl -V در لیست ویژگی‌های خود HTTP3 را داشته باشد و اکثر نسخه‌های توزیع‌شده شامل آن نیستند. بررسی قابل‌اطمینان، لاگ خودتان است: $server_protocol را به فرمت لاگ اضافه کنید و بخوانید که مرورگرهای واقعی چه چیزی را مذاکره می‌کنند. پیش از هر چیز، تأیید کنید که پورت UDP که شنونده quic شما استفاده می‌کند (در پیکربندی بالا 443)، واقعاً باز است؛ زیرا فایروالی که فقط TCP 443 را مجاز می‌داند، باعث می‌شود HTTP/3 بدون خطا از کار بیفتد در حالی که سایت همچنان از طریق HTTP/2 به کار خود ادامه می‌دهد. دانستن اینکه کدام پورت‌ها در سرور لینوکس شما باز و در حال گوش دادن هستند اولین چیزی است که باید بررسی کنید.

HTTPS: HTTP پروتکل است، TLS پوشش آن

HTTPS یک پروتکل مجزا نیست. این همان درخواست‌ها و کدهای وضعیت است که درون یک نشست TLS منتقل می‌شوند. پورت 80 آن‌ها را به‌صورت متن آشکار (clear text) و پورت 443 آن‌ها را به‌صورت رمزنگاری‌شده منتقل می‌کند. ابتدا handshake مربوط به TLS تکمیل می‌شود و سپس درخواست HTTP درون کانال رمزنگاری‌شده ارسال می‌گردد. به همین دلیل است که مشکلات گواهی (certificate) هرگز کد وضعیت HTTP ندارند: خطا پیش از ارسال حتی یک بایت از داده‌های HTTP رخ می‌دهد، بنابراین پاسخی برای شماره‌گذاری وجود ندارد.

در سروری که چندین سایت را میزبانی می‌کند، یک نکته در ترتیب عملیات اهمیت دارد. گواهی با استفاده از SNI (نشان‌گر نام سرور) انتخاب می‌شود؛ فیلدی در handshake مربوط به TLS که نام میزبان را پیش از وجود هرگونه هدر HTTP به‌صورت آشکار منتقل می‌کند. بنابراین سرور ابتدا گواهی را بر اساس SNI انتخاب کرده و سپس در مرحله دوم، virtual host را از هدر Host برمی‌گزیند. این‌ها دو جستجوی مجزا هستند که معمولاً با هم مطابقت دارند. هنگامی که چنین نباشد، مرورگر خطای عدم تطابق نام مانند NET::ERR_CERT_COMMON_NAME_INVALID را نمایش می‌دهد و هیچ درخواستی ارسال نمی‌کند، زیرا گواهی سرور پیش‌فرض برای نامی ارائه شده که آن را پوشش نمی‌دهد.

برای یک سایت عمومی، یک گواهی معتبر تهیه کنید و اجازه دهید به‌طور خودکار تمدید شود. Certbot با Let's Encrypt روی nginx مسیرهای گواهی را در server block شما می‌نویسد و تایمر تمدید را برایتان نصب می‌کند. برای نام میزبان‌هایی که هیچ مرجع عمومی نمی‌تواند آن‌ها را تأیید کند، مانند نام‌های داخلی یا آدرس IP خام در شبکه شخصی، گواهی خودامضا (self-signed) روی Ubuntu گزینه صادقانه‌ای است، به شرط آنکه بپذیرید هر کلاینت باید برای اعتماد به آن تنظیم شود.

هنگامی که TLS به‌درستی کار کرد، تمام ترافیک پورت 80 را به پورت 443 هدایت کنید:

server {
    listen 80;
    server_name example.com;
    return 301 https://$host$request_uri;
}

هدر Strict-Transport-Security را تنها زمانی اضافه کنید که از عملکرد خود مطمئن هستید. هدر add_header Strict-Transport-Security "max-age=63072000; includeSubDomains" always; به مرورگرها دستور می‌دهد که برای آن نام میزبان، از پذیرش HTTP ساده به مدت دو سال خودداری کنند؛ مرورگرها این دستور را در کش خود ذخیره می‌کنند و این یعنی حذف هدر در آینده، اثر آن را از بین نمی‌برد. کار را با یک max-age چند ساعته شروع کنید، مطمئن شوید که تمام زیردامنه‌ها واقعاً روی HTTPS هستند، سپس آن را افزایش دهید.

FAQ

تفاوت HTTP و HTTPS در چیست؟

HTTPS همان پروتکل HTTP است که درون یک نشست TLS (امنیت لایه انتقال) ارسال می‌شود. متدها و کدهای وضعیت در هر دو یکسان هستند. تفاوت در این است که بایت‌ها بین کلاینت و هر آنچه که TLS را خاتمه می‌دهد رمزنگاری می‌شوند و پورت پیش‌فرض از 80 به 443 تغییر می‌کند. از آنجایی که دست‌دادن (handshake) پروتکل TLS پیش از ارسال اولین بایت HTTP تکمیل می‌شود، خطای گواهی هرگز منجر به تولید کد وضعیت نمی‌شود؛ به همین دلیل است که هشدار گواهی در مرورگر، نام خطایی مانند NET::ERR_CERT_COMMON_NAME_INVALID را نمایش می‌دهد و نه کدی مانند 403.

چرا سایت من خطای 502 Bad Gateway برمی‌گرداند؟

یک 502 از سمت nginx به این معناست که nginx نتوانسته پاسخ قابل استفاده‌ای از upstream که به آن پروکسی می‌کند دریافت کند؛ بنابراین درخواست بازدیدکننده صحیح بوده اما مشکلی در پشت nginx وجود دارد. /var/log/nginx/error.log را مطالعه کنید. connect() failed (111: Connection refused) while connecting to upstream به این معناست که هیچ سرویسی روی آدرس و پورت مشخص‌شده در proxy_pass گوش نمی‌دهد؛ پس بررسی کنید که برنامه در حال اجرا باشد و روی آدرسی که انتظار دارید bind شده باشد. no live upstreams while connecting to upstream به این معناست که تمام سرورهای موجود در بلوک upstream پس از شکست‌های مکرر، از دسترس خارج (down) شده‌اند. این مورد را با 504 Gateway Timeout مقایسه کنید که به معنای timeout شدن nginx در انتظار upstream است؛ این اتفاق یا به دلیل عدم تکمیل اتصال در بازه proxy_connect_timeout رخ می‌دهد و یا به دلیل عدم دریافت پاسخ در بازه proxy_read_timeout.

چرا لاگ دسترسی من برای همه بازدیدکنندگان یک IP آدرس یکسان را نشان می‌دهد؟

زیرا $remote_addr آدرسی را ثبت می‌کند که اتصال TCP را برقرار کرده است و در پشت یک reverse proxy یا شبکه توزیع محتوا (CDN)، آن آدرس همان پروکسی است. آدرس واقعی بازدیدکننده در هدر X-Forwarded-For ارسال می‌شود. گزینه proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; را روی پروکسی تنظیم کنید، سپس در nginx دریافت‌کننده، set_real_ip_from را روی محدوده آدرس‌های پروکسی تنظیم کرده و real_ip_header X-Forwarded-For; را فعال کنید. فقط محدوده‌هایی را لیست کنید که تحت کنترل شما هستند، زیرا آن هدر متنی است که هر کلاینتی می‌تواند ارسال کند؛ بنابراین اعتماد به آن از کل اینترنت به بازدیدکننده اجازه می‌دهد آدرسی که شما لاگ می‌کنید و آدرسی که بر اساس آن rate limit اعمال می‌کنید را انتخاب کند.

آیا نیاز است HTTP/2 یا HTTP/3 را فعال کنم؟

فعال‌سازی HTTP/2 توصیه می‌شود، زیرا تنها با یک دستورالعمل در سایتی که از قبل TLS دارد فعال شده و محدودیت تعداد درخواست در هر اتصال را که باعث کندی صفحات دارای فایل‌های کوچک متعدد می‌شود، از بین می‌برد. HTTP/3 دستاورد کمتر و نامطمئن‌تری دارد و هزینه آن باز کردن یک پورت UDP (معمولاً 443) و نیاز به بیلد کردن پروکسی با پشتیبانی از QUIC است. به یاد داشته باشید که مرورگرها معمولاً تنها پس از مشاهده هدر Alt-Svc در یک پاسخ قبلی یا یک رکورد DNS از نوع HTTPS که h3 را لیست کرده باشد، به HTTP/3 سوئیچ می‌کنند؛ بنابراین بدون یکی از این دو، تنظیمات خط listen شما تغییری ایجاد نخواهد کرد. برای اندازه‌گیری آنچه بازدیدکنندگان واقعاً مذاکره می‌کنند، $server_protocol را به فرمت لاگ خود اضافه کنید و پیش از صرف وقت، آن را بسنجید.

وقتی فایل وجود دارد، خطای 403 Forbidden به چه معناست؟

در یک سایت استاتیک، 403 معمولاً مربوط به مجوزهای سیستم‌فایل است تا قوانین HTTP. خطای open() ... failed (13: Permission denied) در /var/log/nginx/error.log به این معناست که کاربر worker در nginx نمی‌تواند فایل را بخواند؛ این اتفاق اغلب به این دلیل رخ می‌دهد که دایرکتوری والد فاقد مجوز اجرای (execute) برای سایر کاربران است، نه به این دلیل که خودِ فایل مجوز اشتباهی دارد. directory index of ... is forbidden به این معناست که درخواست به دایرکتوری‌ای ارجاع شده که فایل index ندارد و autoindex نیز خاموش است. یک قانون صریح deny در بلوک تطبیق‌یافته location نیز می‌تواند منجر به بازگشت 403 شود؛ بنابراین وقتی لاگ خطا اطلاعاتی نمی‌دهد، آن بلوک را بررسی کنید.

آیا این مقاله مفید بود؟