Se dopo un aggiornamento ownCloud visualizza il messaggio "Verifica di integrità non riuscita", utilizza il report dei file non validi per identificare la causa del problema prima di modificare i file. Una nuova scansione ripete solo la verifica; non ripristina i file mancanti, non annulla le modifiche personalizzate né installa una versione corretta dell'app. Per i file di sistema, confrontali con la versione esatta di ownCloud a cui hai eseguito l'aggiornamento. In caso di problemi con la firma dell'app, cerca un aggiornamento compatibile e correttamente firmato oppure contatta il suo sviluppatore.
La soluzione più appropriata dipende dalla portata dell'avviso. Sostituire l'intera installazione può essere più sicuro dopo un aggiornamento parziale o di versioni miste, ma richiede tempi di inattività maggiori e un'attenta conservazione della configurazione e dei dati utente. Sostituire un singolo file di sistema confermato è più rapido, ma solo se si può verificare che il file appartenga alla versione installata. Disabilitare la convalida della firma può rendere utilizzabile una specifica applicazione, ma riduce la protezione e dovrebbe essere un'eccezione documentata, non una soluzione di routine.
Accedi come amministratore e apri la pagina di amministrazione. Segui l'avviso di integrità per visualizzare l'elenco dei file non validi. Nella documentazione attuale di ownCloud, il report raggruppa i problemi per componente, come i file principali o un'app, e utilizza etichette quali INVALID_HASH, FILE_MISSING, EXTRA_FILE, e EXCEPTION. Queste etichette indicano cause diverse, quindi annota il componente, il percorso e l'errore prima di apportare modifiche.
INVALID_HASHSignifica che il contenuto corrente di un file non corrisponde all'hash presente nei dati della sua firma. Le spiegazioni più comuni includono un aggiornamento parziale, un vecchio file rimasto nella posizione originale o una modifica locale.FILE_MISSINGSignifica che manca un file firmato. Questo problema può essere causato da un'estrazione o una distribuzione incompleta dell'archivio.EXTRA_FILESignifica che l'installazione contiene un file non elencato nella firma. Potrebbe trattarsi di un file residuo accidentale, di un file personalizzato o di un'aggiunta locale legittima che necessita di essere verificata.EXCEPTIONSignifica che ownCloud non è riuscito a verificare la firma. Il report potrebbe indicare che i dati della firma sono mancanti, che il certificato non è valido o è stato revocato, oppure che la verifica non è stata completata.Non eliminare un file solo perché sembra superfluo. Verifica la sua funzione e chi lo ha aggiunto. In particolare, non modificare mai il codice di un'app signature.jsonper silenziare l'avviso; le linee guida di ownCloud sulla firma del codice lo vietano esplicitamente.
| Trovare | Passo successivo preferito | Scambio |
|---|---|---|
| Diversi file di base presentano hash non validi o risultano mancanti dopo un aggiornamento manuale. | Crea una nuova copia della versione di destinazione esatta e ripristina i file ufficiali interessati oppure ripeti l'aggiornamento manuale in modo pulito | Un aggiornamento pulito richiede più lavoro e potrebbe comportare tempi di inattività, ma riduce il rischio di lasciare un albero di codice con versioni miste. |
| Un file di base non è valido e sai che è stato modificato localmente | Confronta la modifica con il file di rilascio corrispondente; conserva la modifica personalizzata al di fuori dell'albero principale firmato e riapplicala solo se supportata | Mantenere la modifica potrebbe preservare il comportamento locale, mentre la modifica dei file core firmati continuerà a non superare i controlli di integrità. |
| Un'app segnala dati di firma mancanti o non validi | Installa una versione compatibile dal sito del manutentore dell'app oppure disattiva/rimuovi l'app se non è più necessaria. | Un aggiornamento preserva la funzionalità; la disattivazione evita di modificare il codice dell'app, ma può rimuovere funzionalità da cui gli utenti dipendono. |
| Il certificato dell'app è stato revocato o non è valido. | Richiedi al manutentore dell'app una nuova versione compatibile firmata; non riutilizzare o modificare i file di firma. | Questo potrebbe richiedere del tempo, ma mantiene intatta la validazione della firma. |
| È stato identificato un file aggiuntivo | Prima di spostarlo fuori dalla directory di installazione, verifica il proprietario, lo scopo e se fa parte di una personalizzazione. | La rimozione di un file sconosciuto può interrompere un'integrazione locale o eliminare qualcosa di importante |
ownCloud 11 introduce una considerazione specifica per la versione: le app di terze parti devono avere firme valide per poter essere installate, aggiornate o abilitate, e un'app non valida può essere bloccata anziché semplicemente segnalata. A partire dal 6 ottobre 2026, la documentazione di ownCloud 11.0 afferma che le app che utilizzano il precedente schema di firma sono accettate con un avviso fino al 31 dicembre 2026; dopo tale data, saranno considerate valide solo le firme conformi alla nuova infrastruttura a chiave pubblica (PKI). Se si utilizza ownCloud 10.x, consultare la documentazione specifica per la propria versione anziché presumere che si applichino le regole di applicazione della versione 11.0.
Queste precauzioni sono importanti perché un avviso di integrità riguarda il codice eseguibile dell'applicazione, mentre il database e i file utente sono parti separate dell'installazione. Il ripristino di una vecchia directory di codice su file più recenti gestiti tramite pacchetti può a sua volta creare incongruenze. La guida all'aggiornamento di ownCloud raccomanda di eseguire un backup recente, di esaminare le note di rilascio e i requisiti e di verificare la compatibilità delle app di terze parti prima di procedere con l'aggiornamento.
Se il report indica percorsi ufficiali del core come index.php, version.php, o file sotto l'albero del core, procurati l'archivio ufficiale per la versione esatta che intendi eseguire. Non utilizzare un archivio più recente solo perché è disponibile: gli hash di integrità corrispondono a una versione specifica.
Per una piccola discrepanza ben definita, confronta il percorso segnalato con lo stesso percorso nell'archivio. Dopo aver confermato che si tratta di un file ufficiale non modificato, sostituisci solo il file interessato, preservando la proprietà e le autorizzazioni richieste dal tuo server web. Se mancano o non corrispondono diversi file, oppure non riesci a determinare quale versione ha fornito i file attivi, un aggiornamento pulito da una nuova directory di rilascio è solitamente l'opzione più affidabile.
Per un'installazione manuale da archivio, la procedura più sicura è quella di predisporre la release separatamente, preservare confige dataquindi seguire i passaggi di aggiornamento ufficiali per spostare il codice nella posizione corretta. Non sovrascrivere la directory dei dati utente con il contenuto dell'archivio. Le distribuzioni di pacchetti e container hanno procedure di aggiornamento proprie; utilizzare queste invece di applicare il metodo di archiviazione manuale. Se si trasferiscono singoli file tramite FTP, la documentazione di ownCloud sull'integrità specifica la modalità di trasferimento binario.
Se il report menziona un'app anziché il core, verifica innanzitutto se tale app è compatibile con la tua versione di ownCloud. Installa una versione ufficiale o fornita dal manutentore che corrisponda al server e che abbia una firma valida. Se non esiste una versione compatibile, disabilita l'app e verifica che questa operazione non interrompa un flusso di lavoro necessario. La rimozione di un'app è una scelta più definitiva e dovrebbe seguire le istruzioni di rimozione fornite dall'app stessa.
Per ownCloud 11, la disabilitazione della convalida per una specifica app è un'eccezione controllata dall'amministratore che viene registrata e comporta la perdita della protezione dall'integrità e dalla revoca per tale app. Utilizzatela solo dopo aver valutato l'origine e l'impatto dell'app e documentate chi ha approvato l'eccezione e perché. Non è un metodo per riparare un'installazione del core danneggiata o manomessa. Per le versioni precedenti, il comportamento di applicazione disponibile è diverso, quindi consultate la documentazione per la versione installata.
Dopo aver corretto i file sottostanti, se disponibile, utilizza l'azione di nuova scansione nella pagina di amministrazione. Puoi anche eseguire i occcontrolli documentati. Per Docker Compose, la guida attuale alla firma del codice di ownCloud fornisce questi esempi:
docker compose exec owncloud occ integrity:check-core
docker compose exec owncloud occ integrity:check-app calendarSostituisci calendarcon l'ID dell'app indicato nel tuo report. Per le installazioni non container, esegui il occfile dalla tua directory ownCloud come utente del server web; il percorso e l'utente esatti variano a seconda del sistema operativo e del metodo di installazione. Il comando documentato controlla il core o un'app specifica; la guida attuale afferma che non esiste un singolo comando per eseguire manualmente la scansione di ogni app.
Una riparazione è considerata verificata quando un nuovo report non elenca più i file corretti e la relativa funzionalità funziona normalmente. Se si ripresenta lo stesso errore di hash, verificare la presenza di una distribuzione automatizzata, una patch locale, un processo di sincronizzazione o un incidente di sicurezza che stia modificando nuovamente il file. Se il report indica un certificato revocato, una firma dell'app mancante o una mancata corrispondenza di versione che non è possibile risolvere con una versione ufficiale, interrompere la ripetizione della scansione e contattare il manutentore dell'app o l'assistenza ownCloud fornendo il report e la versione esatta del server.
Scegliete una sostituzione mirata dei file quando il report identifica un file principale ufficiale, la versione esatta è nota ed è possibile reperire l'originale corrispondente. Ripetete l'aggiornamento pulito quando molti file principali non funzionano, l'aggiornamento è stato interrotto o l'installazione contiene file provenienti da più di una versione. Per gli errori che interessano solo un'app, preferite un aggiornamento del manutentore o la disabilitazione di un'app non utilizzata; in questo modo si risolve il problema del componente interessato senza sostituire file principali non correlati. Riservate le eccezioni di convalida a una specifica app valutata quando non esiste una sostituzione firmata e l'esigenza operativa prevale sulla perdita di protezione dell'integrità.
Per il prossimo aggiornamento, consulta prima le note di rilascio e i requisiti, disabilita le app di terze parti incompatibili come consigliato da ownCloud ed esegui un backup aggiornato. Questi passaggi richiedono tempo per la pianificazione, ma rendono più facile diagnosticare un avviso di integrità post-aggiornamento e più sicuro il ripristino.
Scopri cosa fa Microsoft IIS, come funzionano la sua pipeline di richieste e i pool di applicazioni e quando Apache, NGINX o Caddy potrebbero essere più adatti alle tue esigenze di server web.
Diagnostica i picchi di utilizzo della CPU del browser Jitsi Meet e riduci il carico del client controllando i riquadri video, gli effetti della fotocamera, la grafica del browser e le impostazioni dell'host.
Monitora lo stato di salute, il carico della conferenza e il traffico di Jitsi Videobridge con il suo endpoint Prometheus integrato, quindi esplora e visualizza i dati in Grafana.
Configura un dominio personalizzato per Jitsi Meet Docker con DNS, URL pubblico, HTTPS, Let's Encrypt, porte del firewall, impostazioni NAT e verifica end-to-end.
Fix Zimbra Admin Console 404 errors after SSL renewal by checking the correct URL and port, proxy routing, service status, deployed certificates, and logs.
Scopri come diagnosticare e risolvere l'avviso di configurazione di PHP OPcache di Nextcloud controllando l'SAPI PHP attivo, i limiti di dimensionamento, i commenti e le impostazioni di riconvalida.
Risolvere i problemi di migrazione del database Kopano dopo un aggiornamento di MySQL o MariaDB verificando i backup, le versioni del server, le modalità SQL, il set di caratteri, lo stato dello schema e i log.
Collega Nextcloud a LDAP o Active Directory con trasporto sicuro, filtri per utenti e gruppi, attributi di accesso e un'implementazione collaudata.
Risolvi i problemi di notifiche di Element Android sui telefoni senza Google configurando UnifiedPush, le autorizzazioni Android, le impostazioni della batteria ed eseguendo test di verifica affidabili.
Risolvi l'avviso di Nextcloud relativo agli indici del database mancanti utilizzando il comando ufficiale occ. Prima di procedere, esegui un backup, visualizza in anteprima le modifiche, avvia la riparazione e verifica il risultato.
