Risoluzione dei problemi relativi alle notifiche e-mail di WP Cerber
English version: Troubleshooting WP Cerber Email Notifications
Se una notifica di WP Cerber non arriva, la diagnostica delle email può aiutarti a capire cosa è successo quando il plugin ha tentato di inviarla. Questo è particolarmente utile quando le email di prova arrivano a destinazione ma gli avvisi di sicurezza o i report programmati no.
La diagnostica delle email registra i tentativi di invio di WP Cerber. Non traccia i messaggi inviati da altri plugin di WordPress né conferma che un messaggio abbia raggiunto la casella di posta del destinatario. L'attivazione della diagnostica non modifica le impostazioni di invio delle email né rimuove i limiti di notifica.
Prima di iniziare
Controlla la notifica interessata
Verifica che la notifica sia abilitata e che i destinatari siano corretti. Per un avviso di attività, controlla le condizioni, il canale e-mail, la data di scadenza e il limite di notifica. Per le notifiche di blocco, controlla la soglia di blocco configurata e il limite di avvisi all'ora. Un evento di sicurezza registrato non sempre richiede l'invio di un'e-mail.
Controlla se un plugin modifica la cartella di caricamento
Innanzitutto, verifica se un plugin, un tema o una personalizzazione controlla la cartella di caricamento locale. Un'impostazione che ti permette di scegliere quella cartella è un buon motivo per verificarne la compatibilità. Alcune configurazioni possono far sì che WP Cerber perda traccia del registro di diagnostica e della quarantena, lasciando i file sul disco ma non disponibili tramite la dashboard. Se utilizzi questo tipo di configurazione o non ne sei sicuro, disattiva la diagnostica via email.
Un percorso fisso già impostato tramite
UPLOADSinwp-config.phpo l'opzioneupload_pathdi WordPress non causa di per sé questo problema. Un altro plugin può comunque sovrascriverlo.
1. Abilita la diagnostica della posta elettronica
Dopo aver completato il controllo della cartella degli upload descritto sopra, salva una copia del file wp-config.php del tuo sito. Aggiungi questa riga all'interno della sezione PHP esistente, sopra la riga che carica wp-settings.php :
define ( 'CERBER_MAIL_DEBUG' , true );
Se il file definisce già CERBER_MAIL_DEBUG , invece di aggiungere un'altra definizione, modifica il suo valore in true .
2. Invia una notifica di prova
Apri le impostazioni delle notifiche di WP Cerber e fai clic per inviare un'email di prova accanto a "Notifica di blocco" . Annota l'ora e verifica se l'email di prova è stata ricevuta. Se non è arrivata, controlla la casella di posta del destinatario, inclusa la cartella spam, e prendi nota di eventuali errori visualizzati da WP Cerber.
Successivamente, raccogli i record relativi alla notifica effettivamente mancante. Un test del dashboard riuscito non conferma che un avviso di attività abbia soddisfatto le sue condizioni, che un report pianificato sia stato eseguito o che una notifica creata in precedenza in una richiesta abbia seguito lo stesso percorso di invio.
Per gli avvisi intermittenti, mantieni la diagnostica attiva solo per il tempo necessario a osservare il successivo evento rilevante. Annota l'ora e il tuo fuso orario in modo da poter trovare le voci corrispondenti. Evita di modificare le impostazioni e-mail tra il test e la notifica interessata, poiché ciò rende più difficile il confronto dei risultati.
Non è necessario attaccare il proprio sito o bloccarsi deliberatamente l'accesso per generare una registrazione. Se non esiste un modo sicuro per riprodurre l'evento, è sufficiente attendere che si verifichi naturalmente.
3. Esaminare il registro diagnostico
Vai su WP Cerber → Strumenti → Registro diagnostico e cerca le voci contrassegnate con [MAIL] intorno agli orari registrati per il test e alla notifica interessata. Utilizza Scarica registro se hai bisogno di un file, oppure copia le voci pertinenti come testo. Il testo conserva i dati completi ed è più facile da consultare rispetto a uno screenshot di una lunga riga.
Ogni voce inizia con explain , un riassunto in una sola frase del tentativo di invio, scritto in un linguaggio semplice. I campi tecnici che seguono sono quelli che l'assistenza utilizza per le indagini.
Gli esempi seguenti sono a scopo illustrativo. Mostrano la parte [MAIL] di ogni voce, senza il prefisso di data e ora aggiunto dal registro di diagnostica.
Esempio: un test del pannello di controllo
[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
Esempio: una notifica di blocco inviata al termine di una richiesta
[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
Entrambe le chiamate di esempio hanno avuto esito positivo. I diversi percorsi di invio e le diverse categorie di directory di lavoro possono aiutare a confrontare il test con la notifica reale, ma non chiariscono perché un messaggio non sia arrivato a destinazione.
Utilizzare il campo ts per confrontare gli orari. È sempre espresso in UTC, indicato dalla Z finale. Il prefisso separato per data e ora del registro diagnostico potrebbe utilizzare un fuso orario diverso.
4. Comprendere il risultato
result=ok non conferma la consegna al destinatario. Significa che la funzione di invio email di WordPress ha restituito un risultato positivo per quella chiamata. WordPress spiega questa distinzione nella documentazione relativa alla funzione di invio email . Lo stesso vale per "WordPress ha segnalato un successo" nel testo explain , e un tentativo fallito in explain non identifica la causa dell'errore.
| Ciò che vedi | Cosa ti dice | Cosa fare dopo? |
|---|---|---|
result=error |
La chiamata ha restituito un errore. | Salva il record e qualsiasi errore di posta elettronica correlato visualizzato da WP Cerber. |
result=ok , ma il messaggio è mancante |
L'invio è andato a buon fine. La ricezione nella casella di posta non è ancora confermata. | Chiedi al provider che gestisce l'invio delle email del tuo sito web (il tuo host o il servizio SMTP) di controllare i log di invio intorno ts (UTC). Fornisci loro privatamente l'indirizzo del destinatario e chiedi se hanno ricevuto il tentativo di invio e cosa è successo in seguito. |
| Il test arriva, ma la notifica interessata non | I due scenari hanno esiti diversi. | Raccogli entrambe le serie di registrazioni e identifica quale notifica manca. |
Nessuna corrispondenza nella voce [MAIL] |
Il registro non riporta alcun risultato per il tentativo previsto. | Conferma la versione, l'orario di attivazione, le condizioni di notifica e i limiti. Verifica che il test della dashboard produca una registrazione. |
Diverse voci con lo stesso rid |
Diverse chiamate registrate si riferiscono alla stessa richiesta. | Mantieni le voci raggruppate. Non si tratta necessariamente di consegne duplicate. |
Le impostazioni o i limiti di frequenza possono impedire un tentativo di invio. Un record potrebbe anche mancare se non è stato possibile scrivere nel log o se l'esecuzione si è interrotta prima che la funzione di posta elettronica restituisse un risultato. L'assenza di una voce non implica necessariamente che il provider di hosting abbia bloccato il messaggio. Contatta l'assistenza se un test noto non produce alcun risultato.
5. Disattivare la diagnostica dopo aver raccolto i dati.
Una volta individuati i tentativi rilevanti, modifica la definizione esistente in:
define ( 'CERBER_MAIL_DEBUG' , false );
Puoi anche rimuovere la riga che hai aggiunto. Non aggiungere una seconda definizione. Se l'assistenza ti ha aiutato a impostare un percorso di archiviazione fisso per il tuo sito, mantieni tale impostazione separata.
Questa operazione impedisce la creazione di nuove voci diagnostiche per le email. I record esistenti rimangono nel registro diagnostico. Salva ciò che ti serve prima di utilizzare Cancella registro , che cancella il registro condiviso, incluse le voci provenienti da altre funzionalità di WP Cerber.
6. Condividi i dettagli rilevanti con l'assistenza
Scegli il canale per la tua versione:
- WP Cerber Professional: Apri un ticket privato nel portale di supporto di WP Cerber .
- Versione gratuita: Avvia una discussione sul forum della community di WP Cerber .
Includi i seguenti dettagli:
- La tua versione di WP Cerber e la notifica mancante.
- Quando era previsto, incluso il tuo fuso orario.
- Se il test del cruscotto è arrivato.
- Le voci
[MAIL]pertinenti. - Sia che utilizziate le impostazioni SMTP di WP Cerber o un altro plugin di posta elettronica per WordPress.
Se WP Cerber visualizza un errore relativo all'email, includilo nel tuo ticket privato. In una discussione pubblica, menziona che si è verificato un errore ed evita di pubblicare dettagli che identificano utenti o account.
Per una notifica di sicurezza, può essere utile anche una voce correlata nel Registro attività. Condividi le voci del Registro attività privatamente , poiché possono contenere indirizzi IP e nomi utente. Per trovare la voce, copia l' rid del record di posta, apri il Registro attività, fai clic su Altro , inseriscilo in ID richiesta e fai clic su Filtra . Vedi Che cos'è l'RID e come utilizzarlo .
Le nuove righe [MAIL] descritte in questa guida omettono indirizzi email, indirizzi IP, oggetto, corpo del messaggio, credenziali e percorsi del file system non elaborati. È possibile condividere queste singole righe in una discussione pubblica del forum. Copiate solo le righe [MAIL] pertinenti, senza includere voci di registro o screenshot che contengano altri dati.
Le esportazioni complete del registro diagnostico possono contenere voci relative ad altre funzionalità di WP Cerber e devono essere condivise privatamente. Se utilizzi la versione gratuita e un membro dello staff richiede una voce del registro attività o un'esportazione completa, chiedigli come inviarla privatamente prima di condividerla. Non includere password o il file wp-config.php completo. Condividi gli indirizzi dei destinatari solo tramite un canale privato quando necessario.
Riferimento al campo
È possibile condividere i record con l'assistenza senza decodificare ogni singolo campo. Questo documento di riferimento fornisce ulteriori informazioni contestuali, qualora si desideri approfondire l'argomento.
| Campo | Senso |
|---|---|
explain |
Un riepilogo in una sola frase del tentativo, creato a partire dai campi recipient , recipients , attempt , smtp e result . Descrive ciò che la funzione email ha segnalato e la decisione SMTP di WP Cerber, non se il messaggio è stato consegnato. |
ts |
L'ora UTC viene rilevata immediatamente prima che venga richiamata la funzione di invio e-mail. |
rid |
Identificativo della richiesta di WP Cerber, utilizzato per collegare i record della stessa richiesta. Non è un ID messaggio di posta elettronica. |
type |
Il tipo di notifica. I valori comuni includono lockout , send_alert , report , scan , generic e 2fa . I tipi non riconosciuti vengono visualizzati come other . |
event |
Il codice che indica il motivo o l'attività di blocco originario, se disponibile. Non si tratta di un codice di errore di posta elettronica. |
dispatch |
Come la notifica ha raggiunto la funzione di posta elettronica. Vedi la tabella sottostante. |
cwd / cwd_send |
Categorie per la directory di lavoro di PHP al momento della preparazione della notifica e immediatamente prima dell'invio dell'e-mail. |
pwd / pwd_send |
Categorie per la variabile d'ambiente PWD del server in quegli stessi due punti. Questa variabile può essere non impostata o diversa dalla directory di lavoro effettiva di PHP. |
recipient / recipients |
Posizione del destinatario all'interno di questa notifica e numero di destinatari della notifica. Gli indirizzi e-mail non vengono registrati. |
attempt |
initial retry per la prima chiamata a un destinatario, oppure quando WP Cerber ripete una chiamata non riuscita per lo stesso destinatario. WP Cerber effettua il tentativo solo quando l'impostazione SMTP è attiva. |
smtp |
Decisione SMTP di WP Cerber per la chiamata. Vedi la tabella sottostante. |
result |
ok o error , a seconda del valore di ritorno di quella chiamata e-mail. |
Il campo event viene omesso quando non è stato fornito alcun codice applicabile. I test della dashboard possono ometterlo, ma l'assenza di un event non identifica di per sé un messaggio di test.
Percorsi di invio
dispatch |
Senso |
|---|---|
direct |
WP Cerber ha inviato la notifica senza posticiparla a nessuna delle fasi seguenti. |
plugins_loaded |
La notifica è stata preparata in anticipo e inviata quando WordPress ha raggiunto la fase plugins_loaded . |
shutdown |
La notifica è stata preparata in anticipo e inviata tramite una funzione di callback al termine della richiesta PHP. Ciò non significa che il server si sia arrestato o che la richiesta sia fallita. |
Questi valori descrivono il percorso di invio di WP Cerber. Non identificano un server SMTP né descrivono la coda di consegna di un provider di posta. In particolare, direct non indica se è stato utilizzato SMTP.
decisioni SMTP
smtp |
Senso |
|---|---|
enabled |
WP Cerber applica le proprie impostazioni SMTP alla chiamata. |
disabled |
WP Cerber non applica le sue impostazioni SMTP perché sono disattivate o richiedono WP Cerber Professional. |
bypassed |
Le impostazioni SMTP sono attivate, ma WP Cerber le ignora per questa chiamata a seguito di una precedente chiamata fallita nella stessa richiesta. |
Questo campo riflette solo la configurazione di WP Cerber. Un altro plugin potrebbe comunque modificare il modo in cui WordPress invia il messaggio, quindi enabled non garantisce che sia stato utilizzato il server SMTP configurato.
Categorie della directory
Il registro utilizza categorie anziché registrare i percorsi effettivi.
| Valore | Senso |
|---|---|
root |
La radice del filesystem / . |
abspath |
La directory di installazione di WordPress. |
inside_abspath |
Una directory all'interno dell'installazione di WordPress. |
outside_abspath |
Una directory esterna all'installazione di WordPress. |
none |
Il valore non era disponibile o era vuoto. |
pwd=none e dispatch=shutdown non sono di per sé errori. Una modifica come cwd=abspath seguita da cwd_send=root fornisce informazioni utili sull'ambiente di invio, ma non dimostra un errore di consegna. Anche la corrispondenza delle categorie non garantisce la corrispondenza dei percorsi e l'istantanea precedente alla chiamata non mostra le modifiche apportate all'interno della funzione di posta elettronica o dei suoi hook.
Sui server con la restrizione open_basedir di PHP, un percorso PWD che raggiunge la directory di WordPress tramite un collegamento simbolico potrebbe essere classificato come outside_abspath . Il supporto può tenere conto di questa limitazione durante la revisione delle voci.
Perché una singola notifica può generare più record
Ogni chiamata registrata ha un risultato diverso. Più destinatari o un fallback SMTP esistente possono generare più di una notifica. Anche una singola richiesta può generare notifiche diverse.
Ad esempio, una notifica con due destinatari e un server SMTP irraggiungibile può generare questi tre record, mostrati qui con i campi tecnici omessi:
[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
Il tentativo SMTP non è andato a buon fine ed entrambe le chiamate successive sono state effettuate senza le impostazioni SMTP di WP Cerber. Nulla indica che il server SMTP si sia ripristinato o che i messaggi siano stati recapitati.
La numerazione dei destinatari si riavvia a ogni notifica e gli indirizzi e-mail vengono volutamente omessi, quindi una posizione non indica quale indirizzo è stato utilizzato. Conserva tutte le voci correlate quando segnali un problema, anche quando a un error segue un " ok .
Problema noto: modifiche alla cartella di caricamento locale
Questo problema riguarda i siti in cui un plugin, un tema o una personalizzazione fa sì che WP Cerber visualizzi cartelle di base diverse per i caricamenti locali durante le richieste iniziali e le normali richieste alla dashboard. Ad esempio, un plugin potrebbe modificare tale cartella solo dopo il caricamento.
WP Cerber utilizza la posizione di caricamento per trovare la cartella di archiviazione condivisa. Se la cartella esistente non viene trovata nell'altra posizione, WP Cerber può crearne una nuova e perdere traccia di quella precedente. I vecchi file rimangono sul disco, ma i file in quarantena potrebbero scomparire dalla pagina di quarantena e non essere più disponibili per il ripristino. Anche i record di diagnostica possono finire in cartelle diverse.
Una posizione fissa configurata tramite UPLOADS in wp-config.php o l'opzione upload_path non causa di per sé questa incoerenza all'avvio. Un plugin o una personalizzazione possono comunque sovrascriverla in seguito. Allo stesso modo, l'impostazione local-folder di un plugin è un motivo per verificarne il funzionamento, piuttosto che una prova che il sito ne sia affetto. Questi sono esempi di configurazioni esistenti, non istruzioni per modificare le impostazioni di caricamento.
Se la tua configurazione potrebbe essere interessata, disattiva la diagnostica via email e richiedi assistenza . Indica il nome del plugin, del tema o della personalizzazione che controlla la posizione di caricamento dei file.
Mantieni tutte le cartelle wp-cerber-* esistenti e il loro contenuto al loro posto. Non spostarle, rinominarle o eliminarle, non modificare le impostazioni del plugin di caricamento e non provare percorsi di archiviazione intuitivi. La configurazione corretta deve preservare la cartella già utilizzata da WP Cerber.
Se la diagnostica è già attiva sul sito interessato, disattivarla durante la verifica della posizione di archiviazione. Questa operazione non ripristina la connessione di WP Cerber alla cartella precedente. Altre funzioni di WP Cerber potrebbero comunque causare il problema di archiviazione.