Cum se resetează o parolă de administrator Nextcloud cu OCC

Dacă nu vă mai puteți conecta la Nextcloud cu un cont de administrator, occcomanda de pe server poate reseta parola contului respectiv fără a utiliza interfața web. occeste interfața de linie de comandă a Nextcloud pentru administrare. Resetarea modifică parola contului Nextcloud; nu modifică datele de conectare Linux, parola bazei de date sau parola panoului de control al găzduirii.

Această prezentare folosește Manualul de administrare Nextcloud 35 actual, disponibil pe 6 octombrie 2026. Comanda de bază este stabilă în multe versiuni, dar căile de instalare, comenzile PHP, conturile de serviciu și fluxurile de lucru ale containerelor variază. Folosiți valorile exemplu numai după ce verificați cum este instalată propria instanță.

Ce ai nevoie înainte de a executa resetarea

• Acces shell la serverul sau containerul care rulează aplicația PHP Nextcloud.
• Calea sistemului de fișiere către instalarea Nextcloud, care este directorul care conține occfișierul.
• ID-ul exact al contului Nextcloud a cărui parolă trebuie schimbată. Este posibil ca ID-ul contului să nu fie admin.
• Contul sistemului de operare utilizat de serverul web sau de runtime-ul PHP. Pe Debian și Ubuntu acesta este adesea www-data; alte sisteme pot folosi un alt cont.
• O parolă nouă, unică, stocată într-un manager de parole.

Executați occca utilizator HTTP — contul sistemului de operare care rulează aplicația web — astfel încât proprietatea și permisiunile fișierelor să rămână consecvente. Manualul Nextcloud documentează această cerință. Nu executați comenzi ca root în mod implicit doar pentru că aveți acces sudo.

Pasul 1: Găsiți instalarea și contul potrivite

Conectați-vă prin SSH sau deschideți shell-ul furnizat de mediul dvs. de găzduire. Mutați-vă în directorul de instalare Nextcloud. O cale comună de instalare a sursei este /var/www/nextcloud, dar pachetele, dispozitivele, containerele și serviciile găzduite pot utiliza căi diferite.

cd /var/www/nextcloud
ls -l occ

A doua comandă ar trebui să afișeze un occfișier. Dacă nu, opriți-vă și localizați directorul real al aplicației în loc să încercați căi ghicite. Dacă aveți un nume de cont diferit, înlocuiți-l adminîn comanda ulterioară cu exact același ID de utilizator Nextcloud. ID-ul de utilizator nu este neapărat numele afișat sau adresa de e-mail.

Pasul 2: Executați resetarea interactivă a parolei

Pentru o instalare tipică de surse Debian sau Ubuntu al cărei server web rulează ca www-data, rulați acest cod din directorul Nextcloud:

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

Înlocuiți www-datadacă serverul dvs. folosește un alt utilizator HTTP și înlocuiți-l admincu ID-ul contului pe care l-ați confirmat. Dacă nu vă aflați deja în directorul de instalare, utilizați calea completă:

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

Nextcloud solicită noua parolă și vă cere să o confirmați. Caracterele parolei nu apar în mod normal în timp ce tastați; acesta este comportamentul așteptat. Introduceți aceeași parolă la ambele solicitări. Un mesaj de succes confirmă că Nextcloud a acceptat resetarea.

Pasul 3: Folosește o variabilă de mediu doar pentru automatizare

Nextcloud acceptă și --password-from-envoperațiuni scriptate. Citește parola din OC_PASSvariabila de mediu. Evitați să plasați o parolă reală direct într-o linie de comandă, istoricul shell-ului, scriptul trimis către controlul sursei sau transcrierea terminalului partajat.

Pentru o sesiune shell unică, puteți introduce secretul fără a-l afișa, îl puteți exporta, rula comanda documentată și apoi îl puteți șterge:

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

După read -s, introduceți noua parolă și apăsați Enter; intrarea rămâne ascunsă. Opțiunea -Esolicită sudo să păstreze mediul, dar politica sudo locală poate restricționa acest comportament. Dacă comanda raportează că OC_PASSlipsește sau este goală, utilizați resetarea interactivă sau urmați procedura de gestionare a secretelor platformei dvs. Nu dezactivați protecțiile sudo doar pentru a face un script să funcționeze.

Pasul 4: Verificați dacă se poate conecta contul

Deschideți adresa URL Nextcloud obișnuită într-o fereastră privată a browserului sau deconectați-vă de la sesiunea curentă, apoi conectați-vă cu același ID de cont și noua parolă. O conectare reușită confirmă că acreditările funcționează prin aplicația web, nu doar că a fost executată comanda CLI. Dacă organizația dvs. utilizează un al doilea factor de autentificare, finalizați și acea provocare normală.

Probleme frecvente și cum să reacționați

• Could not open input file: occsau o eroare de fișier lipsă: Probabil vă aflați în directorul greșit sau utilizați calea greșită. Localizați occfișierul instalat și rulați din nou comanda acolo.
• Erori de permisiune sau de proprietate: Verificați serverul web/contul PHP pentru distribuția dvs. și executați comanda cu acel cont. Nu schimbați recursiv proprietatea ca o soluție rapidă; acest lucru poate crea probleme de acces mai ample.
• „Utilizatorul nu există” sau o eroare similară în cont: Confirmați ID-ul contului, inclusiv majusculele, acolo unde este cazul. Nu înlocuiți cu o adresă de e-mail decât dacă aceasta este de fapt ID-ul contului.
• phplipsește sau este selectată o versiune PHP greșită: Folosiți fișierul binar CLI PHP acceptat de platforma de instalare și găzduire Nextcloud. Un server poate avea mai multe instalări PHP, deci nu presupuneți că comanda implicită se potrivește cu runtime-ul web.
• Serverul rulează în Docker, Nextcloud AIO, Snap sau un dispozitiv: Rulați occîn mediul aplicației și urmați procedura oficială de comandă a implementării respective. Calea gazdă, numele containerului și utilizatorul runtime diferă; o comandă la nivel de gazdă copiată dintr-o instalare sursă poate viza sistemul de fișiere greșit.
• Contul este gestionat prin LDAP sau Active Directory: Aceste sisteme pot fi autoritatea pentru acreditările contului. O resetare locală a parolei Nextcloud poate să nu actualizeze o parolă gestionată extern. Urmați procedura de resetare a administratorului de director și verificați configurația furnizorului de identitate.
• Nu aveți acces la shell: Încercați linkul de resetare a parolei de pe pagina de conectare dacă contul are o adresă de e-mail funcțională salvată în Nextcloud sau solicitați unui alt administrator Nextcloud sau furnizorului dvs. de găzduire să o reseteze.

Ce trebuie evitat după recuperare

Nu editați baza de date Nextcloud direct pentru a înlocui un hash de parolă. Nu modificați parola sistemului de operare așteptându-vă ca aceasta să reseteze un utilizator Nextcloud. Păstrați noua parolă privată, eliminați orice secret temporar din mediul shell și stocați-l în managerul de parole. Dacă suspectați că vechile acreditări au fost expuse, verificați accesul prin procesul normal de securitate al organizației dvs.

Referințe oficiale

Nextcloud documentează opțiunile de recuperare și procedura „lost-admin-password” în secțiunea Resetarea unei parole de administrator pierdute . Comanda, solicitările de parolă și opțiunea variabilei de mediu acceptate sunt descrise în secțiunile „User and group commands” și „Using the occ command” .