OCC를 사용하여 분실한 Nextcloud 관리자 암호를 재설정하세요
Nextcloud의 OCC 명령어를 사용하여 서버 셸에서 관리자 암호를 재설정하는 방법을 안내합니다. 사용자 이름, 권한 및 외부 로그인 공급자에 대한 지침도 제공됩니다.
OCC를 사용하여 분실한 Nextcloud 관리자 암호를 재설정하세요
Nextcloud 웹 인터페이스에 접속할 수 없더라도 서버 관리자는 로컬 계정 암호를 변경할 수 있습니다. 서버 셸에 접속할 수 있다면 occ user:resetpassword웹 서버 사용자 계정으로 Nextcloud의 내장 명령어를 실행한 다음, 동일한 계정 이름과 새 암호를 사용하여 로그인하세요. 이 명령어는 관리자 계정뿐 아니라 일반 사용자 계정에서도 작동하며, "admin"은 단지 예시 사용자 이름일 뿐입니다.
아래 명령어는 2026년 10월 10일 기준 Nextcloud 35 관리 설명서를 따릅니다. 예시로 제시된 설치 경로, HTTP 사용자, PHP 실행 파일, 사용자 이름은 사용 중인 서버의 실제 값으로 교체하십시오.
비밀번호를 대화형으로 재설정하세요
1. Nextcloud 설치 및 웹 서버 계정을 찾으세요.
셸을 사용하고 권한을 상승시킬 수 있는 계정으로 호스트에 연결합니다. occ스크립트가 포함된 디렉터리를 찾습니다. 일반적인 Ubuntu 또는 Debian 경로는 다음과 같습니다 /var/www/nextcloud. 일부 패키지, 컨테이너 또는 호스팅 설치에서는 다른 위치를 사용할 수 있습니다. 파일 소유권이 일관되게 유지되도록 명령은 Nextcloud 설치 컨텍스트에서 HTTP 사용자 권한으로 실행되어야 합니다.
Debian이나 Ubuntu에서는 일반적으로 해당 사용자가 입니다 . Fedora 또는 CentOS, Arch, openSUSE용 www-dataNextcloud 문서도 참고하세요. 로그인에 사용하는 Linux 계정이 아닌 실제 웹 서버 계정을 사용하십시오.apachehttpwwwrun
2. OCC 암호 재설정 명령을 실행합니다.
일반적인 데비안 또는 우분투 설치 환경에서 다음 명령어를 사용하십시오. 사용자 이름이 올바르지 않으면 올바른 사용자 이름으로 바꿔야 합니다 admin.
sudo -u www-data php /var/www/nextcloud/occ user:resetpassword adminNextcloud는 새 비밀번호를 입력하라는 메시지를 표시하고 다시 입력하도록 요청합니다. 비밀번호는 셸 명령에 포함되지 않으므로 셸 기록에 남지 않습니다. 명령 실행 후 비밀번호 재설정이 성공적으로 완료되면 해당 사용자 이름과 새 비밀번호를 사용하여 웹 로그인을 시도하십시오. 사용자 이름을 입력할 때는 꺾쇠괄호(<>)를 사용하지 마십시오.
공식 문서에도 나와 있습니다 sudo -E -u www-data. 이 -E옵션은 환경 변수를 유지합니다. 설치 환경에 특정 환경 설정이 필요한 경우가 아니면 일반적인 대화형 재설정에는 필요하지 않습니다. occ웹 서버에 맞게 구성된 PHP CLI 버전으로 실행하십시오. 기본 php실행 파일이 호환되지 않으면 해당 PHP 바이너리를 명시적으로 호출하십시오.
어떤 계정을 초기화해야 할지 확실하지 않은 경우
로그인 이름은 계정의 Nextcloud 사용자 이름이며, 표시 이름이나 이메일 주소가 아닐 수도 있습니다. 다른 관리자 계정이 있는 경우 사용자 페이지를 사용하여 문제가 발생한 로그인 이름을 확인하세요. 관리자는 명령줄에서 다음 명령으로 계정 목록을 확인할 수 있습니다.
sudo -u www-data php /var/www/nextcloud/occ user:list필요에 따라 OCC 경로를 교체하십시오 www-data. 출력에는 여러 사용자 계정이 포함될 수 있으므로 식별 정보가 포함된 경우 공개적으로 공유하지 마십시오. 매우 큰 규모의 설치 환경에서는 제한 및 오프셋과 같은 옵션이 지원됩니다. occ help user:list사용 중인 버전에서 사용 가능한 구문은 현재 출력을 확인하십시오.
다른 Nextcloud 관리자에게 접근할 수 있다면, 사용자 설정에서 비밀번호를 재설정해달라고 요청하는 것이 더 간단한 방법입니다. 로그인 페이지의 비밀번호 재설정 링크는 개인 페이지에 유효한 이메일 주소가 저장되어 있고 서버에서 메일을 보낼 수 있는 경우에만 사용할 수 있습니다. OCC는 두 가지 방법 모두 사용할 수 없지만 셸에 접근할 수 있는 경우에 유용합니다.
일반적인 명령줄 문제 해결
"입력 파일을 열 수 없습니다" 또는 "occ를 찾을 수 없습니다"
명령어가 잘못된 설치 디렉토리를 가리키고 있습니다. 실제 스크립트의 경로를 변경하십시오 occ. 설치 디렉토리로 이동하여 더 간단한 형식의 명령어를 실행할 수도 있습니다 sudo -u www-data php occ user:resetpassword admin. 동일 서버의 다른 Nextcloud 복사본에서 이름이 같은 스크립트를 실행하지 마십시오.
권한, 캐시 또는 PHP 오류
설치 시 요구한 HTTP 계정과 PHP CLI 버전을 사용했는지 확인하십시오. Nextcloud의 OCC 문서에 따르면 PHP 명령줄 모드에서는 APCu가 기본적으로 비활성화되어 있습니다. OCC에서 APCu를 사용할 수 없다고 보고하는 경우, apc.enable_cli올바른 CLI 구성에 맞게 APCu를 활성화하거나 문서에 나와 있는 --define apc.enable_cli=1실행 방법을 따르십시오. CLI 관련 오류를 해결하기 위해 웹 PHP 설정을 임의로 변경하지 마십시오.
해당 계정은 외부 ID 공급자를 사용합니다.
일부 설치 환경에서는 LDAP, SAML 또는 다른 외부 ID 공급자를 통해 계정을 인증합니다. 이 경우 공급자가 암호에 대한 권한을 가질 수 있으며, Nextcloud의 로컬 계정 데이터를 사용하여 OCC로 암호를 재설정해도 로그인에 사용되는 자격 증명이 변경되지 않을 수 있습니다. ID 공급자가 승인한 절차를 통해 암호를 재설정하거나, OCC를 사용하기 전에 구성된 백엔드에서 암호 변경을 지원하는지 확인하십시오. 이 명령은 Nextcloud 계정 암호를 재설정하는 데 사용되며, ID 공급자 자체의 자격 증명은 재설정하지 않습니다.
Nextcloud는 컨테이너 또는 관리형 호스팅 환경에서 실행할 수 있습니다.
OCC는 애플리케이션 컨테이너 내에서 또는 공급자가 지원하는 셸을 통해 실행해야 하며, 관련 없는 호스트에서 실행해서는 안 됩니다. 컨테이너 이름, 설치 경로, PHP 명령 및 서비스 사용자는 배포 환경에 따라 다르므로, 다른 이미지용으로 작성된 Docker 명령을 해당 이미지의 문서를 확인하지 않고 복사하지 마십시오. 관리형 호스팅 환경에서는 셸 액세스가 제한될 수 있습니다. OCC를 실행할 수 없는 경우 제어판을 사용하거나 공급자가 제공하는 복구 방법을 문의하십시오.
접근 권한이 복구되었는지 확인하십시오.
OCC에서 성공 메시지가 출력되었는지 확인한 다음, 평소 사용하는 Nextcloud URL을 개인 브라우저 창에서 열고 정확한 사용자 이름과 새 비밀번호로 로그인하세요. 개인 브라우저 창을 사용하면 비밀번호 문제와 이전 세션 또는 캐시된 로그인 페이지 문제를 구분하는 데 도움이 됩니다. 로그인 후 계정에 관리자 권한이 있는지, 관리 설정에 접근할 수 있는지 확인하세요. 로그인에 계속 실패하는 경우, 사용자 이름, 인증 백엔드, 서버 로그를 다시 확인하고 OCC가 올바른 인스턴스를 대상으로 실행되었는지 확인하세요. 잘못된 인스턴스를 대상으로 재설정을 반복해도 활성 서버 문제는 해결되지 않습니다.
공식 참조
Nextcloud를 제공하는 HTTPS 엔드포인트에 HSTS 헤더를 추가하세요.
Apache, NGINX 또는 TLS 프록시에서 헤더를 설정하여 Nextcloud의 HSTS 경고를 해제한 다음 공개 HTTPS 응답을 안전하게 확인하십시오.
Nextcloud 앱 설치 시 인터넷 연결이 안 된다는 오류 메시지 표시 문제 해결
Nextcloud 서버 자체의 DNS, HTTPS, 프록시, TLS 또는 구성 문제로 인해 App Store 설치가 실패하는 경우 원인을 추적하십시오.
예약 대기열을 사용하여 Nextcloud 미리보기의 CPU 사용량 급증을 제어하세요
썸네일 작업을 제어된 백그라운드 일정으로 이동하고, 사용하지 않는 미리보기 크기를 줄이고, Nextcloud 서버에 과부하를 주지 않고 대기열을 검증하세요.
Nextcloud 데스크톱 동기화, "파일 처리 중" 문제 해결
Nextcloud 동기화를 방해하는 파일, 제외 규칙, 연결 문제 또는 클라이언트 데이터베이스 상태를 찾은 다음 업로드 및 다운로드가 안전하게 진행되는지 확인하십시오.
Nextcloud OPcache 경고를 해결하려면 적정 한도를 조정하세요.
Nextcloud 경고를 유발하는 PHP OPcache 제한을 찾아 올바른 웹 PHP 구성을 업데이트하고 안전하게 재시작한 후 결과를 확인하십시오.
Nextcloud를 CODE Docker에 연결하기: 설정 및 장단점
내장 CODE와 Docker 기반 CODE를 비교한 다음, 안전한 HTTPS 역방향 프록시를 통해 Collabora Online을 Nextcloud에 연결합니다.
Galera를 사용하여 안정적인 Nextcloud 클러스터를 구축하세요
공유 스토리지, Redis 잠금, 쿼럼 인식 MariaDB 라우팅 및 실용적인 장애 조치 점검을 통해 안정적인 Nextcloud 고가용성(HA) 배포를 계획하십시오.
직접 미디어 연결이 실패할 경우 Nextcloud Talk 통화를 연결하세요
방화벽이나 제한적인 NAT로 인해 직접 통화 매체가 차단되는 경우, Nextcloud Talk에 연결 가능한 TURN 릴레이를 구성하고 확인하십시오.
올바른 파일을 복원하여 Nextcloud 무결성 경고를 해결하세요
잘못된 파일 보고서를 사용하여 변경되었거나 누락되었거나 추가된 Nextcloud 코드를 식별하고, 신뢰할 수 있는 파일을 안전하게 복원하고, 결과를 확인할 수 있습니다.