Napraw ostrzeżenie Nextcloud „Niektóre pliki nie przeszły kontroli integralności”

Po aktualizacji lub ręcznej zmianie możesz otworzyć panel administracyjny Nextcloud i zobaczyć komunikat „Niektóre pliki nie przeszły kontroli integralności”. Ostrzeżenie może być alarmujące, ale nie identyfikuje jednego, uniwersalnego błędu. Nextcloud sprawdza, czy zainstalowany kod serwera i aplikacji jest zgodny z oczekiwanymi podpisanymi plikami. Zmieniony lub brakujący plik, nieoczekiwany plik lub problem z podpisem aplikacji mogą wywołać alert. Ponowne skanowanie raportuje aktualny stan, ale nie naprawia plików.

Oficjalna strona pobierania Nextcloud podaje wersję Server 35.0.0, wydaną 16 września 2026 r., jako najnowszą wersję w momencie pisania tego tekstu. Aktualna dokumentacja administracyjna nadal zaleca administratorom sprawdzenie raportu o nieprawidłowym pliku, naprawienie konkretnej przyczyny i ponowne skanowanie. Poniższe kroki dotyczą tego trwałego procesu; dokładna treść menu może się różnić w zależności od wersji lub pakietu hostingowego.

1. Przeczytaj raport o nieprawidłowym pliku przed wprowadzeniem jakichkolwiek zmian

Zaloguj się jako administrator i otwórz Ustawienia administracyjne > Przegląd . W ostrzeżeniu o integralności wybierz opcję Lista nieprawidłowych plików… (etykieta może się nieznacznie różnić). Zapisz lub skopiuj raport w prywatnym miejscu, aby móc go porównać po naprawie. Raport identyfikuje aplikację lub obszar główny i zawiera listę warunków, takich jak INVALID_HASH, MISSING_FILE, EXTRA_FILEi EXCEPTION.

Przed zastąpieniem plików serwera utwórz kopię zapasową konfiguracji Nextcloud, bazy danych i dowolnego kodu aplikacji niestandardowej. Nie edytuj signature.json, nie generuj zastępczego podpisu, aby wyciszyć ostrzeżenie, ani nie usuwaj plików tylko dlatego, że ich nazwy pojawiają się w raporcie. Weryfikacja chroni autentyczność kodu i może również ujawnić nieoczekiwany plik, który wymaga zbadania.

2. Dopasuj typ błędu do właściwej naprawy

Etykiety te stanowią wskazówki diagnostyczne, a nie dowód ataku ani bezpieczeństwa instalacji. Lokalna edycja dokonana przez programistę, skopiowany plik kopii zapasowej, niekompletne wdrożenie i nieautoryzowany kod mogą prowadzić do odmiennych wyników. Jeśli nie potrafisz wyjaśnić nieoczekiwanego pliku PHP lub zmienionego pliku core, zachowaj raport i zbadaj go przed usunięciem lub nadpisaniem.

3. Przywróć pliki główne z dokładnej wersji Nextcloud

Jeśli w raporcie pliki są nazwane pod core, na przykład index.phplub version.php, najpierw sprawdź, czy aktualizacja nie została zatrzymana w trakcie lub czy proces wdrożenia nie zmienił kodu. Potwierdź zainstalowaną wersję w przeglądzie administratora lub w standardowych rekordach wdrożenia. Nie kopiuj pliku z innej wersji Nextcloud: jego skrót nie będzie zgodny z wersją zainstalowaną na serwerze.

Użyj obsługiwanego programu do aktualizacji, aby w miarę możliwości dokończyć przerwaną aktualizację. Jeśli musisz przywrócić pliki ręcznie, pobierz archiwum serwera z oficjalnej strony pobierania Nextcloud, zweryfikuj archiwum za pomocą opublikowanej sumy kontrolnej lub podpisu PGP i zastąp tylko uszkodzone pliki kodu aplikacji zgodnie z instrukcjami aktualizacji Nextcloud. Zachowaj katalog danych (Preserve) config/, katalog danych oraz wszelkie lokalnie obsługiwane aplikacje lub motywy. Postępuj zgodnie z procedurą tworzenia kopii zapasowej i trybu konserwacji dla wybranej metody instalacji; Docker, Snap, urządzenia i hosting zarządzany mogą wymagać własnego procesu aktualizacji.

Poradnik integralności Nextcloud podaje tę samą zasadę w przypadku nieprawidłowego skrótu rdzenia: przywróć poprawne pliki, a następnie przeskanuj je ponownie. W przypadku przesyłania plików przez FTP, poradnik wyraźnie ostrzega przed korzystaniem z trybu transferu binarnego. Unikaj uruchamiania aktualizacji z wyłączoną weryfikacją podpisów jako skrótu. Ręcznie zainstalowane archiwum, które nie zostało zweryfikowane, może spowodować nowy problem z integralnością i bezpieczeństwem.

4. Dokładnie przejrzyj dodatkowe pliki i niestandardowe zmiany

Wpis EXTRA_FILEmoże być pozostałością pliku tymczasowego, kopią zapasową edytora, niestandardowym skryptem lub czymś, czego nie rozpoznajesz. Sprawdź pełną ścieżkę, znacznik czasu, właściciela i historię wdrożenia. Jeśli jest to legalne narzędzie niestandardowe, przenieś je poza obsługiwany katalog kodu Nextcloud i udostępnij za pośrednictwem obsługiwanej aplikacji lub oddzielnej usługi, jeśli to konieczne. Jeśli jest to przestarzała kopia zapasowa, usuń ją dopiero po zachowaniu wszystkich potrzebnych danych. Jeśli niedawno pojawił się niewyjaśniony plik wykonywalny lub plik PHP, potraktuj to jako dochodzenie w sprawie bezpieczeństwa: zachowaj dowody, przejrzyj dzienniki dostępu i serwera WWW oraz postępuj zgodnie z procedurą reagowania na incydenty, zamiast po prostu usunąć ostrzeżenie.

W przypadku INVALID_HASHpliku rdzenia, który celowo edytowałeś, trwałym rozwiązaniem jest przywrócenie podpisanego pliku rdzenia i przeniesienie niestandardowego zachowania do obsługiwanej aplikacji, motywu lub udokumentowanego punktu rozszerzenia. Nie zmieniaj oczekiwanego skrótu ani metadanych wersji, aby sprawdzenie przebiegło pomyślnie. Niestandardowe dystrybucje Nextcloud mają oddzielne uwagi dotyczące gałęzi wydania w dokumentacji podpisu kodu; zmiana tego ustawienia jest przeznaczona dla opiekunów niestandardowej dystrybucji, a nie rutynowej naprawy standardowej instalacji.

5. Napraw podpis aplikacji lub plik aplikacji

Jeśli raport wskazuje katalog aplikacji, zidentyfikuj jego identyfikator aplikacji i ustal, czy aplikacja została zaktualizowana, skopiowana ręcznie, czy zmodyfikowana lokalnie. Użyj interfejsu aplikacji Nextcloud lub swojej metody wdrożenia, aby zaktualizować lub ponownie zainstalować kompatybilną wersję z zaufanego źródła. Najpierw utwórz kopię zapasową danych i konfiguracji specyficznej dla aplikacji i sprawdź zgodność z główną wersją Nextcloud. W przypadku aplikacji niestandardowej lub opracowanej wewnętrznie poproś jej opiekuna o podpisany pakiet lub poprawioną wersję. Nextcloud wymaga podpisywania kodu dla aplikacji publikowanych w swoim sklepie z aplikacjami; wymagania dotyczące podpisywania i egzekwowania mogą się różnić w przypadku innych kategorii aplikacji, dlatego zamiast tworzyć lokalny podpis, skorzystaj z odpowiedniej dokumentacji dla deweloperów.

Nie nadpisuj katalogu aplikacji losowym archiwum ani nie kopiuj go signature.jsonz innej wersji. Sygnatura opisuje konkretny kod; mieszanie plików z różnych wydań może powodować dodatkowe błędy. Jeśli musisz usunąć aplikację, skorzystaj z obsługiwanego procesu zarządzania aplikacjami i upewnij się, że usunięcie nie spowoduje utraty danych potrzebnych Twojej organizacji.

6. Uruchom nową kontrolę integralności

Po naprawieniu zgłoszonych plików wróć do Ustawień administracyjnych > Przegląd i wybierz Skanuj ponownie… . Poczekaj na zakończenie skanowania, a następnie ponownie otwórz listę nieprawidłowych plików. Jeśli administrujesz serwerem przez SSH, Nextcloud 35 dokumentuje następujące polecenia z katalogu instalacyjnego Nextcloud:

sudo -E -u www-data php occ integrity:check-core
sudo -E -u www-data php occ integrity:check-app calendar
sudo -E -u www-data php occ integrity:check-app --all

Zastąp calendaridentyfikatorem aplikacji widocznym w raporcie. www-dataKonto jest typowe dla instalacji opartych na Debianie lub Ubuntu, ale użytkownik serwera WWW i plik wykonywalny PHP mogą się różnić. Użyj odpowiedniego konta i środowiska PHP dla swojego systemu; w przypadku instalacji kontenerowych uruchom odpowiednie polecenie w odpowiednim kontenerze. Aktualny podręcznik OCC podaje, że pomyślne sprawdzenie aplikacji może nie wygenerować żadnych danych wyjściowych, chyba że zostanie wybrany tryb szczegółowy, natomiast w przypadku błędów podano szczegóły.

Jak stwierdzić, czy ostrzeżenie zostało naprawione

Otwórz ponownie panel administracyjny i sprawdź, czy ostrzeżenie o integralności zniknęło po nowym skanowaniu. Jeśli nadal występuje, porównaj nowy raport z zapisaną kopią: ta sama ścieżka oznacza, że ​​plik źródłowy nie został przywrócony lub użyto niewłaściwej wersji; inna ścieżka może ujawnić inny problem. Ponownie uruchom odpowiednie sprawdzenie rdzenia lub aplikacji i przejrzyj dziennik Nextcloud pod kątem błędu sygnatury. Sprawdź również, czy instancja normalnie się loguje, przegląda pliki, przesyła i pobiera pliki.

Jeśli ostrzeżenie pojawi się ponownie po wdrożeniu, należy poszukać automatyzacji, wtyczek lub skryptów konserwacji ręcznej, które przepisują pliki w obrębie podpisanego drzewa kodu. Jeśli raport integralności jest czysty, ale użytkownicy nadal widzą błędy, pierwotny problem może mieć inną przyczynę i powinien zostać rozwiązany samodzielnie. W przypadku hostowanej usługi NextCloud należy przesłać dostawcy dokładny raport i zainstalowaną wersję; należy unikać dołączania haseł, kluczy prywatnych ani zawartości plików użytkownika.

Szczegóły dotyczące poszczególnych wersji można znaleźć w dokumentacji podpisu kodu i integralności Nextcloud , w odniesieniu do sprawdzania integralności OCC , w podręczniku programu aktualizującego Nextcloud oraz na oficjalnej stronie pobierania .