[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"page-ru-/guides/linux/nginx-502-error":3,"mdc-92nmtw-key":601,"mdc--z6nnqk-key":611,"mdc-kvnhoy-key":628,"mdc-s0wzvu-key":644,"mdc-u0t2ru-key":652,"mdc-vcecbj-key":668,"mdc--d643kg-key":698,"mdc--944o16-key":734,"mdc-g89oe0-key":742,"related-/guides/linux/nginx-504-error,/errors/linux/nginx-500-internal-server-error,/guides/linux/nginx-install-and-configure":758},{"id":4,"title":5,"appliesTo":6,"author":10,"body":11,"canonical":535,"code":536,"createdAt":537,"description":538,"difficulty":539,"draft":540,"estimatedTime":541,"extension":542,"faq":543,"howToSteps":556,"howToTotalTime":572,"image":535,"keywords":573,"locale":580,"meta":581,"navigation":306,"path":582,"platform":583,"related":584,"section":588,"seo":589,"severity":590,"stem":591,"summary":592,"tags":593,"twitterCreator":535,"twitterSite":535,"type":599,"updatedAt":537,"__hash__":600},"content_ru/guides/linux/nginx-502-error.md","Nginx 502: как быстро устранить ошибку «Bad Gateway» на сервере",[7,8,9],"Nginx 1.20+","Ubuntu 22.04 LTS","Debian 12","FixPedia Team",{"type":12,"value":13,"toc":523},"minimark",[14,19,28,39,42,46,91,95,100,103,130,141,154,158,161,204,215,219,222,261,274,278,281,330,333,385,395,399,402,431,439,442,446,516,519],[15,16,18],"h2",{"id":17},"что-означает-ошибка-502-в-nginx","Что означает ошибка 502 в Nginx",[20,21,22,23,27],"p",{},"Ошибка ",[24,25,26],"strong",{},"502 Bad Gateway"," появляется, когда Nginx не может получить ответ от upstream-сервера (бэкенда), к которому он перенаправляет запросы. В логах вы увидите точную причину, например:",[29,30,35],"pre",{"className":31,"code":33,"language":34},[32],"language-text","2026/06/26 12:34:56 [error] 12345#12345: *1 - upstream timed out (110: Connection timed out) while processing request, client: 192.168.1.10, server: example.com, request: \"GET / HTTP/1.1\", host: \"example.com\"\n","text",[36,37,33],"code",{"__ignoreMap":38},"",[20,40,41],{},"Это значит, что Nginx дождался ответ более 60 секунд (или установленный таймаут) и прервал ожидание.",[15,43,45],{"id":44},"причины-возникновения","Причины возникновения",[47,48,49,59,65,71,77],"ul",{},[50,51,52,58],"li",{},[24,53,54,55],{},"Отсутствие или неверный конфигурационный файл ",[36,56,57],{},"upstream"," – неправильный хост, порт или имя хоста.",[50,60,61,64],{},[24,62,63],{},"Бэкенд-сервер недоступен"," – сервис остановлен, заблокирован брандмауэром или упал.",[50,66,67,70],{},[24,68,69],{},"Таймаут соединения"," – upstream-сервер медленно отвечает или сетевое устройство перегружено.",[50,72,73,76],{},[24,74,75],{},"Неправильные сетевые правила"," – firewall блокирует трафик к бэкенду или порту Nginx.",[50,78,79,82,83,86,87,90],{},[24,80,81],{},"Ошибки в конфигурации Nginx"," – синтаксис, неправильный ",[36,84,85],{},"proxy_pass"," или ",[36,88,89],{},"include"," недействительных файлов.",[15,92,94],{"id":93},"способы-решения","Способы решения",[96,97,99],"h3",{"id":98},"способ-1-проверка-конфигурации-nginx","Способ 1: Проверка конфигурации Nginx",[20,101,102],{},"Сначала убедитесь, что конфигурация синтаксически корректна и пути до upstream серверов существуют.",[29,104,108],{"className":105,"code":106,"language":107,"meta":38,"style":38},"language-bash shiki shiki-themes github-light github-dark","# Проверка конфигурации (без перезагрузки)\nnginx -t\n","bash",[36,109,110,119],{"__ignoreMap":38},[111,112,115],"span",{"class":113,"line":114},"line",1,[111,116,118],{"class":117},"sJ8bj","# Проверка конфигурации (без перезагрузки)\n",[111,120,122,126],{"class":113,"line":121},2,[111,123,125],{"class":124},"sScJk","nginx",[111,127,129],{"class":128},"sj4cs"," -t\n",[20,131,132,133,136,137,140],{},"Если есть ошибка, отредактируйте файл ",[36,134,135],{},"/etc/nginx/nginx.conf"," или включаемые файлы в ",[36,138,139],{},"/etc/nginx/conf.d/",". После исправления выполните команду снова.",[142,143,144],"blockquote",{},[20,145,146,149,150,153],{},[24,147,148],{},"💡 Совет:"," Сохраните последнюю рабочую конфигурацию перед изменениями: ",[36,151,152],{},"cp /etc/nginx/nginx.conf /etc/nginx/nginx.conf.backup",".",[96,155,157],{"id":156},"способ-2-проверка-доступности-upstream-сервера","Способ 2: Проверка доступности upstream-сервера",[20,159,160],{},"Убедитесь, что бэкенд-сервер действительно работает и слушает на нужном порту.",[29,162,164],{"className":105,"code":163,"language":107,"meta":38,"style":38},"# Простой тест с помощью curl (замените на реальные значения)\ncurl -I http://127.0.0.1:8080\n# Альтернатива: netcat\nnc -zv 127.0.0.1 8080\n",[36,165,166,171,183,189],{"__ignoreMap":38},[111,167,168],{"class":113,"line":114},[111,169,170],{"class":117},"# Простой тест с помощью curl (замените на реальные значения)\n",[111,172,173,176,179],{"class":113,"line":121},[111,174,175],{"class":124},"curl",[111,177,178],{"class":128}," -I",[111,180,182],{"class":181},"sZZnC"," http://127.0.0.1:8080\n",[111,184,186],{"class":113,"line":185},3,[111,187,188],{"class":117},"# Альтернатива: netcat\n",[111,190,192,195,198,201],{"class":113,"line":191},4,[111,193,194],{"class":124},"nc",[111,196,197],{"class":128}," -zv",[111,199,200],{"class":128}," 127.0.0.1",[111,202,203],{"class":128}," 8080\n",[20,205,206,207,210,211,214],{},"Если соединение отклонено, запустите сервис (",[36,208,209],{},"systemctl start php-fpm",", ",[36,212,213],{},"systemctl start node","), проверьте его логи или исправьте сетевые правила.",[96,216,218],{"id":217},"способ-3-анализ-логов-nginx","Способ 3: Анализ логов Nginx",[20,220,221],{},"Логи ошибок содержат точную причину сбоя upstream.",[29,223,225],{"className":105,"code":224,"language":107,"meta":38,"style":38},"# Просмотр последних записей\ntail -n 50 /var/log/nginx/error.log\n# Поиск строк, связанных с 502\ngrep \"502\" /var/log/nginx/error.log\n",[36,226,227,232,246,251],{"__ignoreMap":38},[111,228,229],{"class":113,"line":114},[111,230,231],{"class":117},"# Просмотр последних записей\n",[111,233,234,237,240,243],{"class":113,"line":121},[111,235,236],{"class":124},"tail",[111,238,239],{"class":128}," -n",[111,241,242],{"class":128}," 50",[111,244,245],{"class":181}," /var/log/nginx/error.log\n",[111,247,248],{"class":113,"line":185},[111,249,250],{"class":117},"# Поиск строк, связанных с 502\n",[111,252,253,256,259],{"class":113,"line":191},[111,254,255],{"class":124},"grep",[111,257,258],{"class":181}," \"502\"",[111,260,245],{"class":181},[20,262,263,264,210,267,86,270,273],{},"Ищите сообщения типа ",[36,265,266],{},"upstream timed out",[36,268,269],{},"connection refused",[36,271,272],{},"no response",". Эти строки укажут на проблемный сервер или порт.",[96,275,277],{"id":276},"способ-4-проверка-сетевых-правил-и-брандмауэра","Способ 4: Проверка сетевых правил и брандмауэра",[20,279,280],{},"Если брандмауэр блокирует трафик, ошибка 502 также проявится как таймаут.",[29,282,284],{"className":105,"code":283,"language":107,"meta":38,"style":38},"# Для UFW\nufw status verbose\n\n# Для iptables (пример для chain INPUT)\niptables -L INPUT -n --line-numbers\n",[36,285,286,291,302,308,313],{"__ignoreMap":38},[111,287,288],{"class":113,"line":114},[111,289,290],{"class":117},"# Для UFW\n",[111,292,293,296,299],{"class":113,"line":121},[111,294,295],{"class":124},"ufw",[111,297,298],{"class":181}," status",[111,300,301],{"class":181}," verbose\n",[111,303,304],{"class":113,"line":185},[111,305,307],{"emptyLinePlaceholder":306},true,"\n",[111,309,310],{"class":113,"line":191},[111,311,312],{"class":117},"# Для iptables (пример для chain INPUT)\n",[111,314,316,319,322,325,327],{"class":113,"line":315},5,[111,317,318],{"class":124},"iptables",[111,320,321],{"class":128}," -L",[111,323,324],{"class":181}," INPUT",[111,326,239],{"class":128},[111,328,329],{"class":128}," --line-numbers\n",[20,331,332],{},"Разрешите необходимые порты:",[29,334,336],{"className":105,"code":335,"language":107,"meta":38,"style":38},"# Пример для UFW\nufw allow 8080/tcp\n# Пример для iptables (добавить правило в конец)\niptables -A INPUT -p tcp --dport 8080 -j ACCEPT\n",[36,337,338,343,353,358],{"__ignoreMap":38},[111,339,340],{"class":113,"line":114},[111,341,342],{"class":117},"# Пример для UFW\n",[111,344,345,347,350],{"class":113,"line":121},[111,346,295],{"class":124},[111,348,349],{"class":181}," allow",[111,351,352],{"class":181}," 8080/tcp\n",[111,354,355],{"class":113,"line":185},[111,356,357],{"class":117},"# Пример для iptables (добавить правило в конец)\n",[111,359,360,362,365,367,370,373,376,379,382],{"class":113,"line":191},[111,361,318],{"class":124},[111,363,364],{"class":128}," -A",[111,366,324],{"class":181},[111,368,369],{"class":128}," -p",[111,371,372],{"class":181}," tcp",[111,374,375],{"class":128}," --dport",[111,377,378],{"class":128}," 8080",[111,380,381],{"class":128}," -j",[111,383,384],{"class":181}," ACCEPT\n",[20,386,387,388,86,391,394],{},"После изменений перезапустите брандмауэр (",[36,389,390],{},"systemctl restart ufw",[36,392,393],{},"iptables-restore \u003Crules>",").",[96,396,398],{"id":397},"способ-5-перезапуск-nginx","Способ 5: Перезапуск Nginx",[20,400,401],{},"Если предыдущие шаги не помогли, перезапустите Nginx, чтобы он перезагрузил соединения с upstream.",[29,403,405],{"className":105,"code":404,"language":107,"meta":38,"style":38},"systemctl restart nginx\n# Проверьте статус\nsystemctl status nginx\n",[36,406,407,418,423],{"__ignoreMap":38},[111,408,409,412,415],{"class":113,"line":114},[111,410,411],{"class":124},"systemctl",[111,413,414],{"class":181}," restart",[111,416,417],{"class":181}," nginx\n",[111,419,420],{"class":113,"line":121},[111,421,422],{"class":117},"# Проверьте статус\n",[111,424,425,427,429],{"class":113,"line":185},[111,426,411],{"class":124},[111,428,298],{"class":181},[111,430,417],{"class":181},[142,432,433],{},[20,434,435,438],{},[24,436,437],{},"⚠️ Важно:"," Перед перезапуском убедитесь, что никакие критически важные процессы не используют старый процесс Nginx.",[440,441],"in-article-ad",{},[15,443,445],{"id":444},"профилактика","Профилактика",[47,447,448,460,474,487,500],{},[50,449,450,453,454,456,457,394],{},[24,451,452],{},"Регулярно проверяйте логи"," – автоматизируйте мониторинг записей ",[36,455,266],{}," с помощью скриптов (",[36,458,459],{},"tail -f /var/log/nginx/error.log | grep timed out",[50,461,462,465,466,469,470,473],{},[24,463,464],{},"Используйте health-check"," – настройте ",[36,467,468],{},"proxy_next_upstream"," и ",[36,471,472],{},"health_check"," в конфигурации location для автоматического переключения на другой сервер при ошибках.",[50,475,476,479,480,469,483,486],{},[24,477,478],{},"Ограничьте количество одновременных соединений"," – добавьте в конфигурацию ",[36,481,482],{},"client_body_buffer_size",[36,484,485],{},"proxy_buffering on;"," для снижения нагрузки.",[50,488,489,492,493,496,497,499],{},[24,490,491],{},"Мониторьте доступность бэкенда"," – установите ",[36,494,495],{},"monitor.sh",", который каждую минуту выполняет ",[36,498,175],{}," к бэкенду и отправляет уведомление при сбое.",[50,501,502,505,506,86,509,511,512,515],{},[24,503,504],{},"Обновляйте конфигурацию после изменений"," – после редактирования ",[36,507,508],{},"nginx.conf",[36,510,57],{}," файлов всегда выполняйте ",[36,513,514],{},"nginx -t"," перед перезапуском.",[20,517,518],{},"С помощью этих шагов вы сможете быстро устранить ошибку 502 и сделать ваш веб-сайт стабильным. Удачи!",[520,521,522],"style",{},"html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}",{"title":38,"searchDepth":121,"depth":121,"links":524},[525,526,527,534],{"id":17,"depth":121,"text":18},{"id":44,"depth":121,"text":45},{"id":93,"depth":121,"text":94,"children":528},[529,530,531,532,533],{"id":98,"depth":185,"text":99},{"id":156,"depth":185,"text":157},{"id":217,"depth":185,"text":218},{"id":276,"depth":185,"text":277},{"id":397,"depth":185,"text":398},{"id":444,"depth":121,"text":445},null,"502","2026-06-26 14:42:56","Пошаговое руководство по исправлению ошибки 502 в Nginx. Узнайте причины, как проверить логи и вернуть сайт в рабочее состояние за 5 минут.","medium",false,"5-10 мин","md",[544,547,550,553],{"question":545,"answer":546},"Что означает ошибка 502 в Nginx?","Ошибка 502 означает «Bad Gateway» — Nginx не смог получить ответ от upstream-сервера (например, Apache, Node.js или другого прокси).",{"question":548,"answer":549},"Как быстро найти причину 502 ошибки?","Проверьте лог ошибок Nginx (`/var/log/nginx/error.log`), найдите строку «upstream timed out» или «connection refused».",{"question":551,"answer":552},"Можно ли исправить 502 без перезагрузки сервера?","Да, сначала проверьте конфигурацию (`nginx -t`), исправьте ошибочные настройки upstream и перезапустите процесс Nginx.",{"question":554,"answer":555},"Как предотвратить повторение ошибки 502?","Регулярно проверяйте логи, мониторьте доступность бэкенда, используйте health-check для upstream-серверов и ограничьте количество одновременных соединений.",[557,560,563,566,569],{"name":558,"text":559},"Проверьте конфигурацию Nginx","Выполните `nginx -t`, чтобы убедиться, что конфигурация синтаксически корректна и пути до upstream серверов корректны.",{"name":561,"text":562},"Убедитесь в доступности upstream-сервера","С помощью `curl` или `telnet` проверьте, отвечает ли бэкенд-сервер на порту (например, `curl -I http://127.0.0.1:8080`).",{"name":564,"text":565},"Проанализируйте логи Nginx","Откройте `error.log` и `access.log`, найдите строки, указывающие на сбой соединения с upstream (`upstream timed out`, `502 Bad Gateway`).",{"name":567,"text":568},"Проверьте сетевые правила и брандмауэр","Убедитесь, что firewall (ufw, iptables) не блокирует трафик к upstream-серверу или порту Nginx.",{"name":570,"text":571},"Перезапустите Nginx","Выполните `systemctl restart nginx`, чтобы применить исправления и обновить соединения с upstream.","PT10M",[574,575,576,577,578,579],"nginx 502 ошибка","502 bad gateway nginx","how to fix nginx 502","upstream connection failed nginx 502","nginx error log 502","проверка конфигурации nginx при 502","ru_RU",{},"/guides/linux/nginx-502-error","linux",[585,586,587],"/guides/linux/nginx-504-error","/errors/linux/nginx-500-internal-server-error","/guides/linux/nginx-install-and-configure","Ошибки Nginx",{"title":5,"description":538},"high","guides/linux/nginx-502-error","Ошибка 502 «Bad Gateway» в Nginx означает, что сервер не может получить ответ от upstream-сервера. Эта статья поможет вам быстро выявить причину и восстановить работу сайта.",[125,583,594,595,596,597,598],"web-server","troubleshooting","error-502","backend","proxy","error","Qr-XlYk4JNDeN2Ws_usGTR6Nz9R01gWA4oE8nBUj3I4",{"data":602,"body":603},{},{"type":604,"children":605},"root",[606],{"type":607,"tag":20,"props":608,"children":609},"element",{},[610],{"type":34,"value":546},{"data":612,"body":613},{},{"type":604,"children":614},[615],{"type":607,"tag":20,"props":616,"children":617},{},[618,620,626],{"type":34,"value":619},"Проверьте лог ошибок Nginx (",{"type":607,"tag":36,"props":621,"children":623},{"className":622},[],[624],{"type":34,"value":625},"/var/log/nginx/error.log",{"type":34,"value":627},"), найдите строку «upstream timed out» или «connection refused».",{"data":629,"body":630},{},{"type":604,"children":631},[632],{"type":607,"tag":20,"props":633,"children":634},{},[635,637,642],{"type":34,"value":636},"Да, сначала проверьте конфигурацию (",{"type":607,"tag":36,"props":638,"children":640},{"className":639},[],[641],{"type":34,"value":514},{"type":34,"value":643},"), исправьте ошибочные настройки upstream и перезапустите процесс Nginx.",{"data":645,"body":646},{},{"type":604,"children":647},[648],{"type":607,"tag":20,"props":649,"children":650},{},[651],{"type":34,"value":555},{"data":653,"body":654},{},{"type":604,"children":655},[656],{"type":607,"tag":20,"props":657,"children":658},{},[659,661,666],{"type":34,"value":660},"Выполните ",{"type":607,"tag":36,"props":662,"children":664},{"className":663},[],[665],{"type":34,"value":514},{"type":34,"value":667},", чтобы убедиться, что конфигурация синтаксически корректна и пути до upstream серверов корректны.",{"data":669,"body":670},{},{"type":604,"children":671},[672],{"type":607,"tag":20,"props":673,"children":674},{},[675,677,682,683,689,691,697],{"type":34,"value":676},"С помощью ",{"type":607,"tag":36,"props":678,"children":680},{"className":679},[],[681],{"type":34,"value":175},{"type":34,"value":86},{"type":607,"tag":36,"props":684,"children":686},{"className":685},[],[687],{"type":34,"value":688},"telnet",{"type":34,"value":690}," проверьте, отвечает ли бэкенд-сервер на порту (например, ",{"type":607,"tag":36,"props":692,"children":694},{"className":693},[],[695],{"type":34,"value":696},"curl -I http://127.0.0.1:8080",{"type":34,"value":394},{"data":699,"body":700},{},{"type":604,"children":701},[702],{"type":607,"tag":20,"props":703,"children":704},{},[705,707,713,714,720,722,727,728,733],{"type":34,"value":706},"Откройте ",{"type":607,"tag":36,"props":708,"children":710},{"className":709},[],[711],{"type":34,"value":712},"error.log",{"type":34,"value":469},{"type":607,"tag":36,"props":715,"children":717},{"className":716},[],[718],{"type":34,"value":719},"access.log",{"type":34,"value":721},", найдите строки, указывающие на сбой соединения с upstream (",{"type":607,"tag":36,"props":723,"children":725},{"className":724},[],[726],{"type":34,"value":266},{"type":34,"value":210},{"type":607,"tag":36,"props":729,"children":731},{"className":730},[],[732],{"type":34,"value":26},{"type":34,"value":394},{"data":735,"body":736},{},{"type":604,"children":737},[738],{"type":607,"tag":20,"props":739,"children":740},{},[741],{"type":34,"value":568},{"data":743,"body":744},{},{"type":604,"children":745},[746],{"type":607,"tag":20,"props":747,"children":748},{},[749,750,756],{"type":34,"value":660},{"type":607,"tag":36,"props":751,"children":753},{"className":752},[],[754],{"type":34,"value":755},"systemctl restart nginx",{"type":34,"value":757},", чтобы применить исправления и обновить соединения с upstream.",[]]