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
| Odkrycie | Preferowany następny krok | Kompromis |
| Kilka plików rdzeniowych ma nieprawidłowe skróty lub brakuje ich po ręcznej aktualizacji | Wykonaj nową kopię dokładnego wydania docelowego i przywróć uszkodzone pliki oficjalne lub powtórz ręczną aktualizację w sposób czysty | Czysta 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 lokalnie | Porównaj edycję z odpowiadającym jej plikiem wydania; zachowaj niestandardową zmianę poza podpisanym drzewem rdzenia i zastosuj ją ponownie tylko wtedy, gdy jest obsługiwana | Zachowanie 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 podpisu | Zainstaluj kompatybilną wersję od administratora aplikacji lub wyłącz/usuń aplikację, jeśli nie jest już potrzebna | Aktualizacja 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łowy | Poproś administratora aplikacji o nową, podpisaną i kompatybilną wersję; nie wykorzystuj ponownie ani nie zmieniaj plików podpisów | Może to potrwać chwilę, ale pozwala zachować walidację podpisu |
| Zidentyfikowano dodatkowy plik | Przed przeniesieniem poza katalog instalacyjny sprawdź jego właściciela, cel i to, czy jest częścią dostosowania | Usunię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
- 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.
- 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.
- 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.
- 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.
- 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