Rozwiązywanie problemów z powiadomieniami e-mail w WP Cerber
English version: Troubleshooting WP Cerber Email Notifications
Jeśli powiadomienie WP Cerber nie dotrze, diagnostyka poczty e-mail pomoże Ci dowiedzieć się, co się stało, gdy wtyczka próbowała je wysłać. Jest to szczególnie przydatne, gdy wiadomości testowe docierają, ale alerty bezpieczeństwa lub zaplanowane raporty nie docierają.
Diagnostyka poczty e-mail rejestruje próby wysłania wiadomości e-mail przez WP Cerber. Nie śledzi wiadomości z innych wtyczek WordPress ani nie potwierdza, że wiadomość dotarła do skrzynki odbiorczej odbiorcy. Włączenie diagnostyki nie zmienia również ustawień dostarczania wiadomości e-mail ani nie usuwa limitów powiadomień.
Zanim zaczniesz
Sprawdź powiadomienie, którego dotyczy problem
Sprawdź, czy powiadomienie jest włączone i czy jego odbiorcy są poprawni. W przypadku alertu o aktywności sprawdź jego warunki, kanał e-mail, datę wygaśnięcia i limit powiadomień. W przypadku powiadomień o blokadzie sprawdź skonfigurowany próg blokady i limit alertów na godzinę. Zarejestrowane zdarzenie bezpieczeństwa nie zawsze wymaga wysłania wiadomości e-mail.
Sprawdź, czy wtyczka zmienia folder przesyłania plików
Najpierw sprawdź, czy wtyczka, motyw lub dostosowanie kontroluje lokalny folder przesyłania. Ustawienie umożliwiające wybór tego folderu jest powodem do sprawdzenia zgodności. Niektóre konfiguracje mogą powodować, że WP Cerber straci kontrolę nad dziennikiem diagnostycznym i kwarantanną, pozostawiając pliki na dysku, ale niedostępne z poziomu pulpitu. Jeśli korzystasz z takiej konfiguracji lub nie masz pewności, wyłącz diagnostykę poczty e-mail.
Stała lokalizacja ustawiona już za pomocą
UPLOADSwwp-config.phplub opcjiupload_pathWordPressa sama w sobie nie powoduje tego problemu. Inna wtyczka może ją zastąpić.
1. Włącz diagnostykę poczty e-mail
Po sprawdzeniu folderu uploads powyżej, zapisz kopię pliku wp-config.php swojej witryny. Dodaj ten wiersz w istniejącej sekcji PHP, nad wierszem ładującym wp-settings.php :
define ( 'CERBER_MAIL_DEBUG' , true );
Jeżeli plik już definiuje CERBER_MAIL_DEBUG , zmień jego wartość na true zamiast dodawać kolejną definicję.
2. Wyślij powiadomienie testowe
Otwórz ustawienia powiadomień WP Cerber i kliknij przycisk „Kliknij, aby wysłać test” obok opcji „Powiadomienie o blokadzie” . Zanotuj godzinę i informację, czy wiadomość testowa dotarła. Jeśli nie dotarła, sprawdź skrzynkę odbiorczą, w tym folder ze spamem, i zanotuj wszelkie błędy wyświetlane przez WP Cerber.
Następnie zbierz rekordy dotyczące powiadomienia, którego faktycznie brakuje. Pomyślny test na pulpicie nawigacyjnym nie potwierdza, że alert dotyczący aktywności spełnił swoje warunki, że zaplanowany raport został uruchomiony ani że powiadomienie utworzone wcześniej w żądaniu przeszło tę samą ścieżkę wysyłki.
W przypadku alertów okresowych, diagnostyka powinna być włączona tylko tak długo, jak jest to konieczne do zaobserwowania kolejnego istotnego zdarzenia. Zanotuj godzinę i swoją strefę czasową, aby móc znaleźć odpowiednie wpisy. Unikaj zmiany ustawień poczty e-mail między testem a powiadomieniem, którego dotyczy problem, ponieważ utrudnia to porównywanie wyników.
Nie musisz atakować swojej witryny ani celowo się blokować, aby wygenerować rekord. Jeśli nie ma bezpiecznego sposobu na odtworzenie zdarzenia, poczekaj, aż nastąpi ono naturalnie.
3. Przejrzyj dziennik diagnostyczny
Przejdź do WP Cerber → Narzędzia → Dziennik diagnostyczny i poszukaj wpisów oznaczonych jako [MAIL] w okolicach czasu zarejestrowanego dla testu i powiadomienia, którego dotyczy problem. Użyj opcji Pobierz dziennik, jeśli potrzebujesz pliku, lub skopiuj odpowiednie wpisy w formie tekstu. Tekst zachowuje kompletne rekordy i jest łatwiejszy do przeglądania niż zrzut ekranu długiego wiersza.
Każdy wpis zaczyna się od explain , czyli jednozdaniowego podsumowania próby wysłania wiadomości w prostym języku angielskim. Pola techniczne, które następują, służą działowi wsparcia do analizy.
Poniższe przykłady mają charakter poglądowy. Pokazują one część [MAIL] każdego wpisu, bez prefiksu daty i godziny dodanego przez dziennik diagnostyczny.
Przykład: test pulpitu nawigacyjnego
[MAIL] explain="WordPress reported success for recipient 1 of 1 with WP Cerber SMTP disabled." ts=2026-11-06T15:20:00Z rid=EXAMPLETEST01 type=lockout dispatch=direct cwd=inside_abspath pwd=none cwd_send=inside_abspath pwd_send=none recipient=1 recipients=1 attempt=initial smtp=disabled result=ok
Przykład: powiadomienie o blokadzie wysłane po zakończeniu żądania
[MAIL] explain="WordPress reported success for recipient 1 of 1 with WP Cerber SMTP disabled." ts=2026-11-06T15:25:00Z rid=EXAMPLEALERT02 type=lockout event=708 dispatch=shutdown cwd=abspath pwd=none cwd_send=root pwd_send=none recipient=1 recipients=1 attempt=initial smtp=disabled result=ok
Oba przykładowe wywołania zakończyły się sukcesem. Ich różne ścieżki wysyłania i kategorie katalogów roboczych mogą pomóc w porównaniu testu z rzeczywistym powiadomieniem, ale nie pozwalają ustalić, dlaczego wiadomość nie dotarła.
Porównując czasy, należy używać pola ts . Jest ono zawsze podawane w formacie UTC, co wskazuje końcowe Z Oddzielny prefiks daty i godziny w dzienniku diagnostycznym może używać innej strefy czasowej.
4. Zrozum wynik
result=ok nie potwierdza doręczenia do odbiorcy. Oznacza to, że funkcja e-mail WordPressa zwróciła powodzenie dla tego wywołania. WordPress wyjaśnia to rozróżnienie w dokumentacji funkcji e-mail . To samo dotyczy komunikatu „WordPress zgłosił powodzenie” w tekście explain , a nieudana próba w explain nie identyfikuje przyczyny niepowodzenia.
| Co widzisz | Co ci to mówi | Co robić dalej |
|---|---|---|
result=error |
To połączenie zwróciło błąd. | Zapisz rekord i wszelkie powiązane błędy e-mail wyświetlane przez WP Cerber. |
result=ok , ale komunikatu brakuje |
Funkcja wysyłania zgłosiła powodzenie. Odbiór w skrzynce pocztowej nadal nie został potwierdzony. | Poproś dostawcę poczty e-mail dla Twojej witryny (hosta lub usługę SMTP) o sprawdzenie logów wysyłania w okolicach ts UTC. Podaj im adres odbiorcy w prywatnej wiadomości i zapytaj, czy wiadomość dotarła i co się stało później. |
| Test dotarł, ale powiadomienie, którego dotyczył, nie dotarło | Oba scenariusze mają różne wyniki. | Zbierz oba zestawy rekordów i określ, którego powiadomienia brakuje. |
Brak pasującego wpisu [MAIL] |
W dzienniku nie odnotowano żadnego rezultatu oczekiwanej próby. | Potwierdź wersję, czas aktywacji, warunki powiadomień i limity. Sprawdź, czy test pulpitu generuje rekord. |
Kilka wpisów z tym samym rid |
Kilka nagranych rozmów dotyczy tego samego żądania. | Zachowaj wpisy razem. Nie muszą one oznaczać duplikacji dostaw. |
Ustawienia lub limity prędkości mogą uniemożliwić próbę wysłania. Rekord może również zniknąć, jeśli nie udało się zapisać dziennika lub wykonywanie zostało przerwane przed zwróceniem funkcji e-mail. Brak wpisu nie oznacza, że dostawca hostingu zablokował wiadomość. Poinformuj dział wsparcia, jeśli znany test nie wygeneruje rekordu.
5. Wyłącz diagnostykę po zebraniu danych
Po przechwyceniu odpowiednich prób zmień istniejącą definicję na:
define ( 'CERBER_MAIL_DEBUG' , false );
Możesz również usunąć dodany wiersz. Nie dodawaj drugiej definicji. Jeśli pomoc techniczna pomogła Ci ustalić stałą ścieżkę przechowywania danych dla Twojej witryny, zachowaj to osobne ustawienie.
To zatrzymuje nowe wpisy diagnostyczne w e-mailach. Istniejące rekordy pozostają w dzienniku diagnostycznym. Zapisz potrzebne informacje przed użyciem opcji Wyczyść dziennik , która wyczyści współdzielony dziennik, w tym wpisy z innych funkcji WP Cerber.
6. Udostępnij istotne szczegóły działowi wsparcia
Wybierz kanał dla swojej wersji:
- WP Cerber Professional: Złóż prywatny wniosek w portalu pomocy technicznej WP Cerber .
- Wersja bezpłatna: Rozpocznij temat na forum społeczności WP Cerber .
Podaj następujące szczegóły:
- Twoja wersja WP Cerber i brakujące powiadomienie.
- Kiedy było to oczekiwane, podając Twoją strefę czasową.
- Czy test deski rozdzielczej dotarł.
- Odpowiednie wpisy
[MAIL]. - Niezależnie od tego, czy używasz ustawień SMTP WP Cerber czy innej wtyczki pocztowej WordPress.
Jeśli WP Cerber wyświetla błąd e-mail, napisz o tym w swoim prywatnym zgłoszeniu. W temacie publicznym wspomnij o wystąpieniu błędu i unikaj publikowania informacji identyfikujących użytkowników lub konta.
W przypadku powiadomień o bezpieczeństwie pomocny może być również powiązany wpis w dzienniku aktywności. Udostępniaj wpisy w dzienniku aktywności prywatnie , ponieważ mogą one zawierać adresy IP i nazwy użytkowników. Aby znaleźć wpis, skopiuj rid rekordu poczty, otwórz dziennik aktywności, kliknij Więcej , wprowadź go w polu Żądanie ID i kliknij Filtruj . Zobacz Co to jest RID i jak go używać .
Nowe wiersze [MAIL] opisane w tym przewodniku pomijają adresy e-mail, adresy IP, tematy, treści wiadomości, dane uwierzytelniające i surowe ścieżki do systemów plików. Możesz udostępnić te pojedyncze wiersze w publicznym wątku na forum. Kopiuj tylko odpowiednie wiersze [MAIL] , bez otaczających wpisów w dzienniku lub zrzutów ekranu zawierających inne dane.
Pełny eksport dziennika diagnostycznego może zawierać wpisy z innych funkcji WP Cerber i powinien być udostępniany prywatnie. Jeśli korzystasz z wersji bezpłatnej, a członek zespołu poprosi o wpis w dzienniku aktywności lub pełny eksport, zapytaj go, jak wysłać go prywatnie, zanim go udostępnisz. Nie dołączaj haseł ani całego pliku wp-config.php . Udostępniaj adresy odbiorców tylko za pośrednictwem kanału prywatnego, gdy jest to konieczne.
Odniesienie terenowe
Możesz udostępnić rekordy działowi pomocy technicznej bez konieczności dekodowania każdego pola. Ten odnośnik wyjaśnia dodatkowy kontekst, jeśli chcesz się bliżej przyjrzeć.
| Pole | Oznaczający |
|---|---|
explain |
Jednozdaniowe podsumowanie próby, zbudowane z pól recipient , recipients , attempt , smtp i result . Opisuje ono raport funkcji e-mail oraz decyzję SMTP WP Cerber, a nie to, czy wiadomość została dostarczona. |
ts |
Czas UTC rejestrowany bezpośrednio przed wywołaniem funkcji e-mail. |
rid |
Identyfikator żądania WP Cerber, używany do łączenia rekordów z tego samego żądania. Nie jest to identyfikator wiadomości e-mail. |
type |
Typ powiadomienia. Typowe wartości to lockout , send_alert , report , scan , generic i 2fa . Nierozpoznane typy są wyświetlane jako other . |
event |
Przyczyna blokady lub kod aktywności, jeśli jest dostępny. Nie jest to kod błędu e-mail. |
dispatch |
Jak powiadomienie dotarło do funkcji e-mail. Zobacz poniższą tabelę. |
cwd / cwd_send |
Kategorie dla katalogu roboczego PHP w momencie przygotowywania powiadomienia i tuż przed wysłaniem wiadomości e-mail. |
pwd / pwd_send |
Kategorie zmiennej środowiskowej PWD serwera w tych samych dwóch punktach. Ta zmienna może być nieustawiona lub różnić się od rzeczywistego katalogu roboczego PHP. |
recipient / recipients |
Pozycja odbiorcy w powiadomieniu oraz liczba odbiorców powiadomienia. Adresy e-mail nie są rejestrowane. |
attempt |
initial przy pierwszym połączeniu z odbiorcą lub retry , gdy WP Cerber powtarza nieudane połączenie z tym samym odbiorcą. WP Cerber ponawia próbę tylko wtedy, gdy włączone jest ustawienie SMTP. |
smtp |
Decyzja SMTP WP Cerbera dotycząca połączenia. Zobacz poniższą tabelę. |
result |
ok lub error , w zależności od wartości zwracanej przez to wywołanie e-mail. |
Pole event jest pomijane, jeśli nie podano odpowiedniego kodu. Testy pulpitu nawigacyjnego mogą je pominąć, ale brak event sam w sobie nie identyfikuje komunikatu testowego.
Wysyłanie ścieżek
dispatch |
Oznaczający |
|---|---|
direct |
WP Cerber wysłał powiadomienie bez opóźniania go do któregokolwiek z poniższych etapów. |
plugins_loaded |
Powiadomienie przygotowano wcześniej i wysłano, gdy WordPress osiągnął etap plugins_loaded . |
shutdown |
Powiadomienie zostało przygotowane wcześniej i wysłane przez wywołanie zwrotne po zakończeniu żądania PHP. Nie oznacza to wyłączenia serwera ani niepowodzenia żądania. |
Te wartości opisują ścieżkę wysyłania WP Cerber. Nie identyfikują serwera SMTP ani nie opisują kolejki dostaw dostawcy poczty. W szczególności direct nie informuje, czy użyto SMTP.
Decyzje SMTP
smtp |
Oznaczający |
|---|---|
enabled |
WP Cerber stosuje ustawienia SMTP do połączenia. |
disabled |
WP Cerber nie stosuje ustawień SMTP, ponieważ są one wyłączone lub wymagają WP Cerber Professional. |
bypassed |
Ustawienia SMTP są włączone, ale WP Cerber pomija je w tym wywołaniu po wcześniejszym nieudanym wywołaniu w tym samym żądaniu. |
To pole odzwierciedla tylko konfigurację WP Cerber. Inna wtyczka nadal może zmienić sposób wysyłania wiadomości przez WordPress, więc enabled nie oznacza, że użyto skonfigurowanego serwera SMTP.
Kategorie katalogów
Dziennik wykorzystuje kategorie zamiast rejestrować faktyczne ścieżki.
| Wartość | Oznaczający |
|---|---|
root |
Katalog główny systemu plików / . |
abspath |
Katalog instalacyjny WordPressa. |
inside_abspath |
Katalog wewnątrz instalacji WordPress. |
outside_abspath |
Katalog poza instalacją WordPress. |
none |
Wartość była niedostępna lub pusta. |
pwd=none i dispatch=shutdown same w sobie nie są błędami. Zmiana taka jak cwd=abspath po którym następuje cwd_send=root stanowi przydatny dowód na temat środowiska nadawczego, ale nie dowodzi błędu dostarczenia. Dopasowanie kategorii również nie gwarantuje dopasowania ścieżek, a migawka przed wywołaniem nie pokazuje zmian wprowadzonych w funkcji e-mail ani jej hakach.
Na serwerach z ograniczeniem PHP open_basedir ścieżka PWD prowadząca do katalogu WordPress poprzez dowiązanie symboliczne może zostać sklasyfikowana jako outside_abspath . Wsparcie może wziąć to ograniczenie pod uwagę podczas przeglądania wpisów.
Dlaczego jedno powiadomienie może wygenerować kilka rekordów
Każde zarejestrowane połączenie ma swój własny wynik. Wielu odbiorców lub istniejący zapasowy serwer SMTP może wygenerować więcej niż jeden rekord dla powiadomienia. Pojedyncze żądanie może również generować różne powiadomienia.
Na przykład powiadomienie z dwoma odbiorcami i niedostępnym serwerem SMTP może wygenerować następujące trzy rekordy, pokazane tutaj z pominiętymi polami technicznymi:
[MAIL] explain="The email attempt for recipient 1 of 2 failed with WP Cerber SMTP enabled." ... recipient=1 recipients=2 attempt=initial smtp=enabled result=error
[MAIL] explain="WordPress reported success for the retry to recipient 1 of 2 without WP Cerber SMTP settings." ... recipient=1 recipients=2 attempt=retry smtp=bypassed result=ok
[MAIL] explain="WordPress reported success for recipient 2 of 2 without WP Cerber SMTP settings." ... recipient=2 recipients=2 attempt=initial smtp=bypassed result=ok
Próba SMTP nie powiodła się, a oba późniejsze połączenia zostały wykonane bez ustawień SMTP WP Cerber. Nic tutaj nie wskazuje na to, że serwer SMTP odzyskał sprawność ani że któraś z wiadomości dotarła.
Numeracja odbiorców jest resetowana z każdym powiadomieniem, a adresy e-mail są celowo pomijane, więc pozycja nie informuje, który adres został użyty. Zachowaj wszystkie powiązane wpisy podczas zgłaszania problemu, nawet jeśli po error następuje ok .
Znany problem: zmiany w lokalnym folderze przesyłania
Ten problem dotyczy witryn, w których wtyczka, motyw lub dostosowanie powoduje, że WP Cerber widzi różne lokalne foldery bazowe podczas wczesnych żądań i standardowych żądań w panelu. Na przykład, wtyczka może zmienić ten folder dopiero po załadowaniu.
WP Cerber korzysta z lokalizacji przesłanych plików, aby znaleźć swój współdzielony folder pamięci masowej. Jeśli istniejący folder nie zostanie znaleziony w innej lokalizacji, WP Cerber może utworzyć nowy folder i stracić kontakt ze starym. Stare pliki pozostają na dysku, ale pliki poddane kwarantannie mogą zniknąć ze strony kwarantanny i stać się niedostępne do przywrócenia. Rekordy diagnostyczne mogą również znaleźć się w innych folderach.
Stała lokalizacja skonfigurowana za pomocą UPLOADS w wp-config.php lub opcja upload_path sama w sobie nie powoduje tej niespójności podczas uruchamiania. Wtyczka lub modyfikacja może ją później nadpisać. Podobnie, ustawienie folderu lokalnego wtyczki jest powodem do sprawdzenia, jak działa, a nie dowodem na to, że witryna jest dotknięta problemem. Są to przykłady istniejących konfiguracji, a nie instrukcje dotyczące zmiany ustawień przesyłania.
Jeśli Twoja konfiguracja może być uszkodzona, wyłącz diagnostykę poczty e-mail i uzyskaj pomoc . Podaj nazwę wtyczki, motywu lub dostosowania, które kontroluje lokalizację przesyłania.
Zachowaj wszystkie istniejące foldery wp-cerber-* i ich zawartość. Nie przenoś ich, nie zmieniaj ich nazw, nie usuwaj, nie zmieniaj ustawień wtyczki do przesyłania ani nie próbuj używać nieznanej ścieżki do przechowywania. Prawidłowa konfiguracja musi zachować folder, z którego WP Cerber już korzysta.
Jeśli diagnostyka jest już włączona na dotkniętej problemem stronie, wyłącz ją, gdy sprawdzana jest lokalizacja pamięci masowej. Nie przywróci to połączenia WP Cerber z poprzednim folderem. Inne funkcje WP Cerber nadal mogą powodować problem z pamięcią masową.