Reverse proxy zwraca błąd 502 po przebudowie kontenera, gdy nie może już nawiązać prawidłowego połączenia z przebudowanym upstreamem.
Przebudowa może zastąpić kontener, przypisać mu nowy adres, odłączyć go od sieci Dockera lub zmienić jej nazwę, zmienić udostępniony port, przywrócić niekompletną konfigurację albo uruchomić proxy, zanim aplikacja będzie gotowa. Prawidłowa diagnoza zaczyna się od logu błędów proxy i polega na prześledzeniu dokładnego adresu upstreamu od proxy do kontenera, zamiast na ponownym uruchamianiu obu usług, aż błąd chwilowo zniknie.
Potwierdź, że błąd 502 wynika z problemu z połączeniem z upstreamem
Wyślij jedno żądanie do domeny, której dotyczy problem, i zanotuj jego znacznik czasu, status proxy, adres upstreamu oraz pełny komunikat o błędzie. Ustal, czy wystąpiła odmowa połączenia, nieznany host, przekroczenie limitu czasu, zerwanie połączenia, błąd uzgadniania TLS czy nieprawidłowa odpowiedź.
Błąd 502 oznacza, że proxy nie otrzymało prawidłowej odpowiedzi upstreamu, ale szczegóły błędu wskazują, czy cel nie istniał, był nieosiągalny, nie nasłuchiwał czy używał niewłaściwego protokołu. Aktualny poradnik rozwiązywania problemów z NGINX wskazuje, że przebudowa kontenera może sprawić, iż proxy nadal będzie używać starego adresu backendu, dopóki rozpoznawanie nazw lub konfiguracja nie zostaną odświeżone.
Przetestuj aplikację bezpośrednio z hosta proxy lub kontenera proxy, używając nazwy upstreamu, adresu, portu i protokołu podanych w logu. Jeśli bezpośrednie żądanie kończy się tym samym błędem, skup dalsze dochodzenie na połączeniu między proxy a kontenerem, zamiast zmieniać publiczny DNS lub certyfikaty.
Porównaj cel upstreamu przed przebudową i po niej
Sprawdź nazwę przebudowanego kontenera, nazwę usługi, wewnętrzny adres IP, port udostępniony przez kontener, opublikowany port, aliasy sieciowe i podłączone sieci. Porównaj je z konfiguracją proxy i jego ostatnim działającym celem.
Jeden z problemów nginx-proxy opisuje przypadek, w którym przebudowa zmieniła adres IP kontenera aplikacji, a proxy nadal kierowało żądania do nieosiągalnego kontenera upstream. Publiczna domena pozostała poprawna, zmieniła się tylko tożsamość prywatnego upstreamu.
Zamiast adresu IP kontenera używaj stabilnej nazwy usługi Compose lub aliasu sieciowego. Jeśli adres IP został celowo przypisany na stałe, sprawdź, czy przebudowana usługa rzeczywiście go otrzymała i czy żaden inny kontener nie używa teraz tego adresu.
Sprawdź, czy proxy i aplikacja nadal współdzielą sieć Dockera
Wymień sieci podłączone do proxy i aplikacji oraz potwierdź, że mają co najmniej jedną wspólną sieć zdefiniowaną przez użytkownika. Opublikowanie portu hosta nie sprawia automatycznie, że nazwa kontenera jest osiągalna z innej, odizolowanej sieci Dockera.
W jednym z przypadków dotyczących sieci Dockera przeniesienie usługi zależnej do odpowiedniej sieci natychmiast wyeliminowało powtarzające się odpowiedzi 502, pokazując, że ścieżka do usługi nadrzędnej może być niedostępna, nawet gdy wszystkie kontenery nadal działają.
Przypisuj usługi do sieci za pośrednictwem Compose, a nie za pomocą jednorazowych poleceń, aby ta relacja przetrwała przebudowy. Po ponownym utworzeniu stosu sprawdź rozpoznawanie DNS i port usługi nadrzędnej z poziomu kontenera proxy.
Sprawdź wewnętrzny port nasłuchiwania i adres powiązania
Sprawdź, czy aplikacja nasłuchuje na porcie używanym przez proxy oraz pod adresem dostępnym z sieci kontenerów. Nie myl portu opublikowanego na hoście z wewnętrznym portem nasłuchiwania kontenera.
Proxy może połączyć się z aplikacją dopiero wtedy, gdy nasłuchuje ona poza interfejsem loopback. Usługa nasłuchująca na 127.0.0.1 we własnym kontenerze jest niedostępna dla proxy, nawet jeśli lokalny test gotowości kończy się powodzeniem.
Sprawdź log aplikacji, listę gniazd i pojedyncze bezpośrednie żądanie wysłane z kontenera proxy. Jeśli połączenie z portem jest odrzucane, napraw nasłuchiwanie aplikacji lub jej konfigurację, zanim dodasz ponowne próby albo wydłużysz limity czasu proxy.
Poczekaj na gotowość aplikacji, a nie tylko na uruchomienie kontenera
Przebudowany kontener może działać, mimo że migracje, odzyskiwanie bazy danych, rozgrzewanie pamięci podręcznej lub generowanie konfiguracji nadal uniemożliwiają aplikacji przyjmowanie żądań. Porównaj czas wystąpienia pierwszego błędu 502 z danymi o gotowości i logami uruchamiania.
Dyskusja dotycząca rozwiązywania problemów z Grist pokazuje, jak architektura Dockera, ustawienia środowiska i gotowość usługi nadrzędnej mogą łącznie prowadzić do trwałych błędów 502 po stronie kontenera po jego przebudowaniu.
Dodaj miarodajny test gotowości i skonfiguruj proxy lub usługi zależne tak, by czekały na operację wymaganą przez klientów, a nie tylko na uruchomienie procesu. Ogranicz liczbę ponowień, aby aplikacja, która uległa trwałej awarii, nie sprawiała wrażenia wolno uruchamiającej się.
Odśwież rozpoznawanie nazw przez proxy i odbuduj stabilną ścieżkę
Po potwierdzeniu poprawności nazwy usługi, sieci, portu i stanu gotowości przeładuj proxy lub utwórz je ponownie. Jeśli proxy rozpoznaje nazwy tylko podczas uruchamiania, skonfiguruj obsługiwaną aktualizację rozpoznawania nazw w czasie działania lub przewidywalną kolejność restartów.
Procedura ZimaSpace dotycząca izolowania niesprawnej zależności kontenera zawiera dodatkowe wskazówki diagnostyczne na wypadek, gdy usługa nadrzędna wielokrotnie się wyłącza zamiast utrzymywać stan gotowości.
Naprawa jest zakończona dopiero wtedy, gdy po kolejnym przebudowaniu proxy rozpoznaje nazwę usługi, łączy się z właściwym portem wewnętrznym, czeka na uruchomienie i obsługuje domenę bez ręcznej zmiany adresów IP. Po weryfikacji usuń tymczasowe cele wskazujące bezpośrednio na adres IP oraz nieudokumentowane przypisania do sieci.
Wsparcie i porady
Więcej do przeczytania

Jak ukryć filmy dla dorosłych na serwerze NAS przed członkami rodziny
Przechowuj filmy dla dorosłych prywatnie na rodzinnym serwerze NAS. Sprawdź uprawnienia folderów, dostęp do bibliotek Plex i Jellyfin, miniatury, historię oglądania, wspólne loginy do...

Co sprawdzić przed załadowaniem modelu społecznościowego w Transformers
Użyj aktualizacji piaskownicy Jinja dla Transformers, aby sprawdzić pochodzenie modelu, szablony czatu, zdalny kod, serializowane wagi i pierwsze uruchomienia w izolowanym środowisku.

Uruchom Mirage lokalnie: OCR i wykrywanie obiektów na podstawie jednego obrazu
Przetestuj niewielki lokalny model wizyjny Cactus Compute, zweryfikuj OCR i ekstrakcję obiektów na rzeczywistych danych wejściowych oraz poznaj ograniczenia związane z pamięcią, językiem i...



