Jak zresetować hasło administratora NextCloud za pomocą OCC

Jeśli nie możesz już zalogować się do Nextcloud na koncie administratora, occpolecenie po stronie serwera umożliwia zresetowanie hasła tego konta bez korzystania z interfejsu internetowego. occto interfejs wiersza poleceń Nextcloud do administracji. Resetowanie zmienia hasło do konta Nextcloud; nie zmienia jednak loginu do systemu Linux, hasła do bazy danych ani hasła do panelu sterowania hostingiem.

W tym przewodniku wykorzystano aktualny podręcznik administratora NextCloud 35, dostępny od 6 października 2026 r. Podstawowe polecenie jest stabilne w wielu wersjach, ale ścieżki instalacji, polecenia PHP, konta usług i przepływy pracy kontenerów różnią się. Użyj przykładowych wartości dopiero po sprawdzeniu, jak zainstalowana jest Twoja instancja.

Czego potrzebujesz przed uruchomieniem resetu

• Dostęp do powłoki serwera lub kontenera, na którym uruchomiona jest aplikacja PHP Nextcloud.
• Ścieżka systemu plików do instalacji Nextcloud, czyli katalogu zawierającego occplik.
• Dokładny identyfikator konta Nextcloud, którego hasło należy zmienić. Identyfikator konta może być inny niż admin.
• Konto systemu operacyjnego używane przez serwer WWW lub środowisko wykonawcze PHP. W systemach Debian i Ubuntu jest to często używane konto www-data; inne systemy mogą używać innego konta.
• Nowe, unikalne hasło zapisane w menedżerze haseł.

Uruchom occjako użytkownik HTTP – konto systemu operacyjnego, na którym działa aplikacja internetowa – aby zachować spójność własności i uprawnień plików. Ten wymóg jest udokumentowany w podręczniku NextCloud. Nie uruchamiaj poleceń domyślnie jako użytkownik root tylko dlatego, że masz dostęp sudo.

Krok 1: Znajdź odpowiednią instalację i konto

Połącz się przez SSH lub otwórz powłokę dostarczoną przez środowisko hostingowe. Przejdź do katalogu instalacyjnego Nextcloud. Typowa ścieżka instalacji źródłowej to /var/www/nextcloud, ale pakiety, urządzenia, kontenery i usługi hostowane mogą korzystać z innych ścieżek.

cd /var/www/nextcloud
ls -l occ

Drugie polecenie powinno wyświetlić occplik. Jeśli tak się nie stanie, przerwij i znajdź właściwy katalog aplikacji, zamiast próbować zgadywać ścieżki. Jeśli masz inną nazwę konta, zastąp ją adminw kolejnym poleceniu tym samym identyfikatorem użytkownika Nextcloud. Identyfikator użytkownika nie musi być nazwą wyświetlaną ani adresem e-mail.

Krok 2: Uruchom interaktywne resetowanie hasła

W przypadku typowej instalacji źródłowej Debiana lub Ubuntu, której serwer WWW działa jako www-data, uruchom to polecenie z katalogu Nextcloud:

sudo -E -u www-data php occ user:resetpassword admin

www-dataJeśli Twój serwer używa innego użytkownika HTTP, zastąp go potwierdzonym adminidentyfikatorem konta. Jeśli nie jesteś jeszcze w katalogu instalacyjnym, użyj pełnej ścieżki:

sudo -E -u www-data php /var/www/nextcloud/occ user:resetpassword admin

Nextcloud poprosi o podanie nowego hasła i jego potwierdzenie. Znaki hasła zazwyczaj nie pojawiają się podczas wpisywania – to normalne zachowanie. Wprowadź to samo hasło w obu monitach. Komunikat o pomyślnym zakończeniu operacji potwierdza, że ​​Nextcloud zaakceptował resetowanie.

Krok 3: Używaj zmiennej środowiskowej tylko do automatyzacji

Nextcloud obsługuje również --password-from-envoperacje skryptowe. Odczytuje hasło ze OC_PASSzmiennej środowiskowej. Unikaj wpisywania prawdziwego hasła bezpośrednio w wierszu poleceń, historii powłoki, skrypcie zatwierdzonym w systemie kontroli wersji lub w transkrypcie współdzielonego terminala.

W przypadku jednorazowej sesji powłoki możesz wprowadzić klucz tajny bez jego powtarzania, wyeksportować go, uruchomić udokumentowane polecenie, a następnie go wyczyścić:

read -s OC_PASS
export OC_PASS
sudo -E -u www-data php occ user:resetpassword --password-from-env admin
unset OC_PASS

Po read -swpisaniu nowego hasła wpisz nowe hasło i naciśnij Enter; dane pozostają ukryte. -EOpcja ta prosi sudo o zachowanie środowiska, ale lokalna polityka sudo może ograniczyć to zachowanie. Jeśli polecenie zgłosi OC_PASSbrak lub brak hasła, użyj interaktywnego resetowania lub postępuj zgodnie z procedurą zarządzania hasłami na swojej platformie. Nie wyłączaj zabezpieczeń sudo tylko po to, aby skrypt działał.

Krok 4: Sprawdź, czy konto umożliwia zalogowanie się

Otwórz swój standardowy adres URL Nextcloud w prywatnym oknie przeglądarki lub wyloguj się z bieżącej sesji, a następnie zaloguj się przy użyciu tego samego identyfikatora konta i nowego hasła. Pomyślne logowanie potwierdza, że ​​dane uwierzytelniające działają w aplikacji internetowej, a nie tylko, że polecenie CLI zostało uruchomione. Jeśli Twoja organizacja korzysta z drugiego czynnika uwierzytelniania, wykonaj również standardowe wyzwanie.

Typowe problemy i jak na nie reagować

• Could not open input file: occlub błąd brakującego pliku: Prawdopodobnie znajdujesz się w niewłaściwym katalogu lub używasz niewłaściwej ścieżki. Znajdź zainstalowany occplik i ponownie uruchom polecenie.
• Błędy uprawnień lub własności: Sprawdź konto serwera WWW/PHP dla swojej dystrybucji i uruchom polecenie z tego konta. Nie zmieniaj rekurencyjnie własności jako szybkiego rozwiązania; może to spowodować poważniejsze problemy z dostępem.
• Błąd „Użytkownik nie istnieje” lub podobny błąd konta: Sprawdź identyfikator konta, uwzględniając wielkość liter, tam gdzie to konieczne. Nie zastępuj adresu e-mail, chyba że jest to rzeczywisty identyfikator konta.
• phpBrakuje pliku PHP lub wybrano nieprawidłową wersję PHP: Użyj pliku binarnego PHP CLI obsługiwanego przez instalację Nextcloud i platformę hostingową. Serwer może mieć więcej niż jedną instalację PHP, więc nie zakładaj, że domyślne polecenie jest zgodne ze środowiskiem uruchomieniowym.
• Serwer działa w Dockerze, Nextcloud AIO, Snap lub urządzeniu: Uruchom occw środowisku aplikacji i postępuj zgodnie z oficjalną procedurą poleceń dla tego wdrożenia. Ścieżka hosta, nazwa kontenera i użytkownik środowiska wykonawczego różnią się; polecenie na poziomie hosta skopiowane z instalacji źródłowej może dotyczyć niewłaściwego systemu plików.
• Konto jest zarządzane przez LDAP lub Active Directory: Te systemy mogą być autoryzowane do uwierzytelniania konta. Lokalny reset hasła w Nextcloud może nie zaktualizować hasła zarządzanego zewnętrznie. Postępuj zgodnie z procedurą resetowania administratora katalogu i sprawdź konfigurację swojego dostawcy tożsamości.
• Nie masz dostępu do powłoki: Jeśli konto ma zapisany w Nextcloud działający adres e-mail, spróbuj skorzystać z łącza resetowania hasła na stronie logowania lub poproś innego administratora Nextcloud lub swojego dostawcę hostingu o zresetowanie hasła.

Czego unikać po rekonwalescencji

Nie edytuj bazy danych Nextcloud bezpośrednio w celu zastąpienia skrótu hasła. Nie zmieniaj hasła systemu operacyjnego, oczekując, że zresetuje to użytkownika Nextcloud. Zachowaj nowe hasło w tajemnicy, usuń wszelkie tymczasowe tajne dane ze środowiska powłoki i zapisz je w menedżerze haseł. Jeśli podejrzewasz, że stare dane uwierzytelniające zostały ujawnione, sprawdź dostęp za pomocą standardowej procedury bezpieczeństwa obowiązującej w Twojej organizacji.

Oficjalne referencje

Nextcloud dokumentuje opcje odzyskiwania i procedurę utraconego hasła administratora w sekcji „ Resetowanie utraconego hasła administratora” . Obsługiwane polecenia, monity o podanie hasła i opcje zmiennych środowiskowych opisano w sekcjach „Polecenia użytkownika i grupy” oraz „Korzystanie z polecenia occ” .