Naprawa błędu „Integrity Check Failed” w ownCloud po aktualizacji wersji

Jeśli ownCloud wyświetla komunikat „Niepowodzenie kontroli integralności” po aktualizacji, skorzystaj z raportu o nieprawidłowym pliku, aby zidentyfikować przyczynę błędu przed zmianą plików. Ponowne skanowanie jedynie powtarza weryfikację; nie przywraca brakujących plików, nie cofa niestandardowych edycji ani nie instaluje poprawionej wersji aplikacji. W przypadku plików podstawowych porównaj je z dokładną wersją ownCloud, do której dokonano aktualizacji. W przypadku problemu z podpisem aplikacji poszukaj kompatybilnej, poprawnie podpisanej aktualizacji aplikacji lub skontaktuj się z jej opiekunem.

Właściwa naprawa zależy od zakresu ostrzeżenia. Zastąpienie całej instalacji może być bezpieczniejsze po aktualizacji częściowej lub mieszanej, ale wymaga dłuższego przestoju i starannego zachowania konfiguracji oraz danych użytkownika. Zastąpienie jednego potwierdzonego pliku głównego jest szybsze, ale tylko wtedy, gdy można zweryfikować, czy plik należy do zainstalowanej wersji. Wyłączenie walidacji podpisu może umożliwić korzystanie z konkretnej aplikacji, ale zmniejsza poziom ochrony i powinno być udokumentowanym wyjątkiem, a nie rutynową naprawą.

Najpierw dowiedz się, co zawiodło

Zaloguj się jako administrator i otwórz stronę administratora. Postępuj zgodnie z ostrzeżeniem o integralności, aby przejść do listy nieprawidłowych plików. W aktualnej dokumentacji ownCloud raport grupuje problemy według komponentów, takich jak pliki główne lub aplikacja, i używa etykiet, takich jak INVALID_HASH, FILE_MISSING, EXTRA_FILEi EXCEPTION. Etykiety te wskazują na różne przyczyny, dlatego przed wprowadzeniem zmian zapisz komponent, ścieżkę i błąd.

  • INVALID_HASHOznacza to, że bieżąca zawartość pliku nie zgadza się z hashem w danych jego sygnatury. Typowe przyczyny to częściowa aktualizacja, pozostawienie starego pliku lub lokalna edycja.
  • FILE_MISSINGOznacza to brak podpisanego pliku. Przyczyną może być niekompletne rozpakowanie lub wdrożenie archiwum.
  • EXTRA_FILEOznacza, że ​​instalacja zawiera plik, którego nie ma w sygnaturze. Może to być przypadkowa pozostałość, plik niestandardowy lub legalny dodatek lokalny, który wymaga sprawdzenia.
  • EXCEPTIONOznacza to, że ownCloud nie mógł zweryfikować podpisu. Raport może zawierać informację o braku danych podpisu, nieprawidłowym lub unieważnionym certyfikacie albo o niemożności ukończenia weryfikacji.

Nie usuwaj pliku tylko dlatego, że wyświetla się jako zbędny. Sprawdź, do czego służy i kto go dodał. W szczególności nigdy nie edytuj kodu aplikacji signature.json, aby wyciszyć ostrzeżenie; wytyczne dotyczące podpisywania kodu w ownCloud wyraźnie mówią, aby go nie modyfikować.

Wybierz naprawę na podstawie dowodów

OdkryciePreferowany następny krokKompromis
Kilka plików rdzeniowych ma nieprawidłowe skróty lub brakuje ich po ręcznej aktualizacjiWykonaj nową kopię dokładnego wydania docelowego i przywróć uszkodzone pliki oficjalne lub powtórz ręczną aktualizację w sposób czystyCzysta aktualizacja wymaga więcej pracy i może wymagać przestoju, ale zmniejsza ryzyko pozostawienia drzewa kodu o mieszanej wersji
Jeden plik główny jest nieprawidłowy i wiesz, że był edytowany lokalniePorównaj edycję z odpowiadającym jej plikiem wydania; zachowaj niestandardową zmianę poza podpisanym drzewem rdzenia i zastosuj ją ponownie tylko wtedy, gdy jest obsługiwanaZachowanie zmiany może zachować lokalne zachowanie, podczas gdy edycja podpisanych plików rdzenia nadal będzie powodować niepowodzenie kontroli integralności
Aplikacja zgłasza brakujące lub nieprawidłowe dane podpisuZainstaluj kompatybilną wersję od administratora aplikacji lub wyłącz/usuń aplikację, jeśli nie jest już potrzebnaAktualizacja zachowuje funkcjonalność; wyłączenie pomija kod aplikacji, ale może spowodować usunięcie funkcji, od których zależą użytkownicy
Certyfikat aplikacji jest unieważniony lub nieprawidłowyPoproś administratora aplikacji o nową, podpisaną i kompatybilną wersję; nie wykorzystuj ponownie ani nie zmieniaj plików podpisówMoże to potrwać chwilę, ale pozwala zachować walidację podpisu
Zidentyfikowano dodatkowy plikPrzed przeniesieniem poza katalog instalacyjny sprawdź jego właściciela, cel i to, czy jest częścią dostosowaniaUsunięcie nieznanego pliku może spowodować przerwanie integracji lokalnej lub usunięcie czegoś ważnego

W ownCloud 11 wprowadzono wymóg specyficzny dla danej wersji: aplikacje innych firm muszą mieć prawidłowe podpisy, aby mogły zostać zainstalowane, zaktualizowane lub włączone, a nieprawidłową aplikację można zablokować, a nie tylko oznaczyć flagą. Według stanu na 6 października 2026 roku, dokumentacja ownCloud 11.0 podaje, że aplikacje korzystające z poprzedniego schematu podpisywania są akceptowane z ostrzeżeniem do 31 grudnia 2026 roku; po tej dacie zaufane są tylko podpisy w ramach nowej infrastruktury klucza publicznego (PKI). Jeśli korzystasz z ownCloud 10.x, zapoznaj się z dokumentacją konkretnej wersji, zamiast zakładać, że obowiązują zasady egzekwowania z wersji 11.0.

Przygotuj się przed zmianą instalacji

  1. Sprawdź wersję serwera uruchomionego i wersję docelową wskazaną w procesie aktualizacji. Sprawdź odpowiednie informacje o wydaniu i wymagania systemowe, w tym obsługiwane wersje PHP.
  2. Utwórz nową kopię zapasową bazy danych, konfiguracji i katalogu danych. Zachowaj aktualne drzewo kodu lub migawkę systemu plików, jeśli Twoja metoda wdrożenia to obsługuje.
  3. Przed wymianą kodu podczas naprawy przełącz serwer w tryb konserwacyjny. Użyj metody opisanej w dokumentacji instalacji i upewnij się, że użytkownicy nie zapisują plików podczas tej operacji.
  4. Określ, w jaki sposób zainstalowano ownCloud: archiwum/instrukcję, pakiet systemu operacyjnego lub Docker. Postępuj zgodnie z procedurą aktualizacji dla tej instalacji. Nie mieszaj plików z archiwum tar z instalacją zarządzaną pakietem.
  5. Zachowaj oryginalny raport i zanotuj każdy przeniesiony lub zastąpiony plik. To znacznie ułatwi przywracanie i późniejszą diagnostykę.

Te środki ostrożności są istotne, ponieważ ostrzeżenie o integralności dotyczy kodu wykonywalnego aplikacji, podczas gdy baza danych i pliki użytkownika stanowią oddzielne części instalacji. Przywrócenie starego katalogu kodu na nowszych plikach zarządzanych przez pakiet może samo w sobie spowodować niezgodności. Wskazówki dotyczące aktualizacji ownCloud zalecają wykonanie nowej kopii zapasowej, zapoznanie się z informacjami o wydaniu i wymaganiami oraz sprawdzenie zgodności aplikacji innych firm przed aktualizacją.

Napraw pliki rdzenia po częściowej aktualizacji

Jeśli raport wskazuje oficjalne ścieżki do głównego katalogu, takie jak index.php, version.php, lub pliki w drzewie głównym, pobierz oficjalne archiwum dla dokładnej wersji, która ma być aktualnie uruchomiona. Nie używaj nowszego archiwum tylko dlatego, że jest dostępne: skróty integralności odpowiadają konkretnej wersji.

W przypadku niewielkiej, ale zrozumiałej niezgodności, porównaj zgłoszoną ścieżkę z tą samą ścieżką w tym archiwum. Po potwierdzeniu, że jest to niezmodyfikowany plik oficjalny, zastąp tylko ten, którego dotyczy problem, zachowując prawa własności i uprawnienia wymagane przez serwer WWW. Jeśli brakuje kilku plików lub są one niezgodne, albo nie możesz określić, która wersja dostarczyła pliki live, zazwyczaj bardziej niezawodną opcją jest czysta aktualizacja z katalogu z nową wersją.

W przypadku ręcznej instalacji archiwum, bezpiecznym rozwiązaniem jest oddzielne przygotowanie wydania, zachowanie configi datawykonanie oficjalnych kroków aktualizacji w celu przeniesienia kodu. Nie należy nadpisywać katalogu danych użytkownika zawartością archiwum. Wdrożenia pakietów i kontenerów mają własne procedury aktualizacji; należy z nich korzystać zamiast stosować do nich ręczną metodę archiwizacji. W przypadku przesyłania pojedynczych plików przez FTP, dokumentacja integralności ownCloud określa tryb przesyłania binarnego.

Obsługuj ostrzeżenia aplikacji osobno

Jeśli raport wskazuje aplikację, a nie jej rdzeń, najpierw sprawdź, czy obsługuje ona Twoją wersję ownCloud. Zainstaluj oficjalną wersję lub wersję dostarczoną przez administratora, która jest zgodna z serwerem i posiada prawidłowy podpis. Jeśli nie istnieje zgodna wersja, wyłącz aplikację i upewnij się, że nie zakłóci to wymaganego procesu. Usunięcie aplikacji jest rozwiązaniem trwalszym i powinno być zgodne z instrukcjami usuwania samej aplikacji.

W przypadku ownCloud 11 wyłączenie walidacji dla konkretnej aplikacji to wyjątek kontrolowany przez administratora, który jest rejestrowany i powoduje utratę integralności oraz ochrony przed unieważnieniem dla tej aplikacji. Należy go używać dopiero po ocenie źródła i wpływu aplikacji oraz udokumentowaniu, kto zatwierdził wyjątek i dlaczego. Nie jest to sposób na naprawienie uszkodzonej lub zmodyfikowanej instalacji jądra. W przypadku starszych wersji dostępne mechanizmy egzekwowania różnią się, dlatego należy sprawdzić dokumentację zainstalowanej wersji.

Przeprowadź nowe sprawdzenie i potwierdź wynik

Po poprawieniu plików bazowych, skorzystaj z opcji ponownego skanowania na stronie administratora, jeśli jest dostępna. Możesz również uruchomić udokumentowane occkontrole. W przypadku Docker Compose, aktualny przewodnik po podpisywaniu kodu w chmurze ownCloud zawiera następujące przykłady:

docker compose exec owncloud occ integrity:check-core
docker compose exec owncloud occ integrity:check-app calendar

Zastąp calendaridentyfikatorem aplikacji podanym w raporcie. W przypadku instalacji bez kontenerów, wywołaj occplik z katalogu ownCloud jako użytkownik serwera WWW; dokładna ścieżka i użytkownik różnią się w zależności od systemu operacyjnego i metody instalacji. Udokumentowane polecenie sprawdza rdzeń lub aplikację o określonej nazwie; w obecnym przewodniku podano, że nie ma tam ani jednego polecenia do ręcznego ponownego skanowania każdej aplikacji.

Naprawa jest weryfikowana, gdy nowy raport nie zawiera już poprawionych plików, a odpowiednia funkcja działa prawidłowo. Jeśli wystąpi ten sam błąd skrótu, należy poszukać automatycznego wdrożenia, lokalnej poprawki, zadania synchronizacji lub incydentu bezpieczeństwa, który ponownie zmienia plik. Jeśli raport wskazuje na unieważniony certyfikat, brakujący podpis aplikacji lub niezgodność wersji, której nie można rozwiązać w oficjalnym wydaniu, należy przerwać skanowanie i skontaktować się z administratorem aplikacji lub działem pomocy technicznej ownCloud, podając raport i dokładną wersję serwera.

Które podejście powinieneś wybrać?

Wybierz docelową zamianę pliku, gdy raport zidentyfikuje jeden oficjalny plik główny, znana jest dokładna wersja i można znaleźć pasujący oryginał. Powtórz czystą aktualizację, gdy wiele plików głównych ulegnie awarii, aktualizacja została przerwana lub instalacja zawiera pliki z więcej niż jednej wersji. W przypadku błędów dotyczących tylko aplikacji, zaleca się aktualizację konserwatora lub wyłączenie nieużywanej aplikacji; rozwiązuje to problematyczny komponent bez zastępowania niepowiązanych plików głównych. Zarezerwuj wyjątki walidacji dla konkretnej, ocenianej aplikacji, gdy nie ma podpisanego zamiennika, a potrzeba operacyjna przeważa nad utratą ochrony integralności.

Przy kolejnej aktualizacji najpierw zapoznaj się z informacjami o wydaniu i wymaganiami, wyłącz niekompatybilne aplikacje innych firm zgodnie z zaleceniami ownCloud i utwórz nową kopię zapasową. Te kroki wymagają czasu na planowanie, ale ułatwiają diagnozę ostrzeżenia o integralności po aktualizacji i zwiększają bezpieczeństwo odzyskiwania.

Oficjalne referencje

Zostaw komentarz

10 najlepszych narzędzi do pingowania w celu znajdowania urządzeń w sieci

10 najlepszych narzędzi do pingowania w celu znajdowania urządzeń w sieci

Porównaj 10 narzędzi do pingowania, które umożliwiają szybkie wykrywanie sieci LAN, skanowanie międzyplatformowe i zarządzanie adresami IP. Dowiedz się, co narzędzie pingujące może Ci powiedzieć, a czego nie.

6 najlepszych narzędzi do zarządzania siecią, umożliwiających śledzenie wydajności

6 najlepszych narzędzi do zarządzania siecią, umożliwiających śledzenie wydajności

Porównaj sześć narzędzi do zarządzania siecią służących do monitorowania wydajności, obejmujących zasięg SNMP, mapowanie, alerty, modele wdrażania i kompromisy kosztów.

Ping Monitor: 7 darmowych i otwartych narzędzi do monitorowania dostępności sieci

Ping Monitor: 7 darmowych i otwartych narzędzi do monitorowania dostępności sieci

Porównaj siedem darmowych i otwartych monitorów pingów — od kompletnych pakietów sieciowych po ukierunkowane sondy opóźnień — i wybierz odpowiedni monitor pod kątem dostępności, utraty pakietów i historii.

QoS w sieciach: czym jest jakość usług i jak działa

QoS w sieciach: czym jest jakość usług i jak działa

Dowiedz się, co oznacza QoS w sieciach, w jaki sposób oznaczenia DSCP i kolejki ruchu nadają priorytet aplikacjom głosowym, wideo i biznesowym oraz czego QoS nie jest w stanie naprawić.

Najlepsze oprogramowanie serwera SFTP do bezpiecznego przesyłania plików

Najlepsze oprogramowanie serwera SFTP do bezpiecznego przesyłania plików

Porównaj niezawodne oprogramowanie serwera SFTP dla systemów Windows i Linux, w tym OpenSSH, Bitvise, SolarWinds i SFTPGo. Znajdź rozwiązanie odpowiednie dla swoich potrzeb w zakresie bezpieczeństwa i transferu plików.

7 najlepszych narzędzi do zarządzania adresami IP dla zespołów sieciowych

7 najlepszych narzędzi do zarządzania adresami IP dla zespołów sieciowych

Porównaj siedem narzędzi do zarządzania adresami IP służących do wykrywania podsieci, koordynacji DNS i DHCP, inwentaryzacji sieci i otwartego oprogramowania IPAM.

6 najlepszych narzędzi do monitorowania serwerów Windows Server zapewniających lepszą dostępność i wydajność

6 najlepszych narzędzi do monitorowania serwerów Windows Server zapewniających lepszą dostępność i wydajność

Porównaj sześć narzędzi do monitorowania systemu Windows Server pod kątem zbierania danych systemu Windows, widoczności aplikacji, modelu wdrażania i licencjonowania, aby znaleźć odpowiednie rozwiązanie.

10 najlepszych narzędzi do skanowania sieci w celu wykrywania urządzeń i adresów IP

10 najlepszych narzędzi do skanowania sieci w celu wykrywania urządzeń i adresów IP

Porównaj narzędzia do skanowania sieciowego umożliwiające szybkie wykrywanie urządzeń, skanowanie adresów IP na wielu platformach oraz zarządzanie IPAM w przedsiębiorstwie. Znajdziesz tu wskazówki dotyczące dopasowania każdej opcji do swojej sieci.

Najlepsze praktyki monitorowania sieci: co śledzić i jakich narzędzi używać

Najlepsze praktyki monitorowania sieci: co śledzić i jakich narzędzi używać

Zbuduj praktyczny monitoring sieci z przejrzystym zakresem urządzeń, przydatnymi wskaźnikami wydajności, przydatnymi alertami oraz porównaniem SolarWinds NPM, PRTG i OpManager.

Jak używać Nmap do śledzenia trasy i odczytywania ścieżki sieciowej

Jak używać Nmap do śledzenia trasy i odczytywania ścieżki sieciowej

Użyj opcji --traceroute programu Nmap, aby mapować przeskoki do autoryzowanego hosta, zrozumieć dane wyjściowe dotyczące przeskoków i czasu RTT oraz rozwiązywać problemy z brakującymi odpowiedziami bez nadmiernego skanowania.