OCC를 사용하여 Nextcloud 관리자 암호를 재설정하는 방법

관리자 계정으로 더 이상 Nextcloud에 로그인할 수 없는 경우, occ웹 인터페이스를 사용하지 않고 서버 측 명령어를 통해 해당 계정의 비밀번호를 재설정할 수 있습니다. ` occnextcloud`는 Nextcloud 관리자용 명령줄 인터페이스입니다. 비밀번호 재설정은 Nextcloud 계정의 비밀번호를 변경하는 것이며, Linux 로그인 비밀번호, 데이터베이스 비밀번호 또는 호스팅 제어판 비밀번호는 변경하지 않습니다.

이 안내서는 2026년 10월 6일 기준으로 제공되는 최신 Nextcloud 35 관리 설명서를 기반으로 합니다. 기본 명령어는 여러 릴리스에서 안정적이지만, 설치 경로, PHP 명령어, 서비스 계정 및 컨테이너 워크플로는 다를 수 있습니다. 예제 값은 사용자의 인스턴스 설치 방식을 확인한 후에만 사용하십시오.

재설정을 실행하기 전에 필요한 사항

• Nextcloud의 PHP 애플리케이션이 실행되는 서버 또는 컨테이너에 대한 셸 액세스 권한.
• Nextcloud 설치 경로, 즉 해당 파일이 포함된 디렉토리 경로입니다 occ.
• 비밀번호를 변경해야 하는 Nextcloud 계정의 정확한 ID를 입력하세요. 계정 ID는 다를 수 있습니다 admin.
• 웹 서버 또는 PHP 런타임에서 사용하는 운영 체제 계정입니다. 데비안 및 우분투에서는 일반적으로 `php.php`를 사용하며 www-data, 다른 시스템에서는 다른 계정을 사용할 수도 있습니다.
• 비밀번호 관리자에 저장된 새롭고 고유한 비밀번호입니다.

occ파일 소유권과 권한이 일관되게 유지되도록 웹 애플리케이션을 실행하는 운영 체제 계정인 HTTP 사용자로 실행하십시오 . Nextcloud 설명서에 이 요구 사항이 명시되어 있습니다. sudo 권한이 있다고 해서 기본적으로 루트 권한으로 명령을 실행하지 마십시오.

1단계: 올바른 설치 및 계정을 찾으세요

SSH로 연결하거나 호스팅 환경에서 제공하는 셸을 엽니다. Nextcloud 설치 디렉토리로 이동합니다. 일반적인 소스 설치 경로는 이지만 /var/www/nextcloud, 패키지, 어플라이언스, 컨테이너 및 호스팅 서비스는 다른 경로를 사용할 수 있습니다.

cd /var/www/nextcloud
ls -l occ

두 번째 명령을 실행하면 occ파일이 표시되어야 합니다. 만약 표시되지 않으면, 추측 경로를 시도하지 말고 실제 애플리케이션 디렉터리를 찾아서 실행을 중단하십시오. 계정 이름이 다른 경우, admin나중 명령에서 <계정 이름> 부분을 해당 Nextcloud 사용자 ID로 정확히 바꿔야 합니다. 사용자 ID는 표시 이름이나 이메일 주소와 다를 수 있습니다.

2단계: 대화형 암호 재설정을 실행합니다.

웹 서버가 로 실행되는 일반적인 Debian 또는 Ubuntu 소스 설치의 경우 www-dataNextcloud 디렉터리에서 다음 명령을 실행하십시오.

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

www-data서버에서 다른 HTTP 사용자를 사용하는 경우 해당 부분을 교체하고 , admin확인한 계정 ID로 교체하십시오. 설치 디렉터리에 있지 않은 경우 전체 경로를 사용하십시오.

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

Nextcloud는 새 비밀번호를 입력하라는 메시지를 표시하고 확인을 요청합니다. 비밀번호를 입력하는 동안 비밀번호 문자는 화면에 나타나지 않으며, 이는 정상적인 동작입니다. 두 번의 확인 메시지에 동일한 비밀번호를 입력하십시오. 비밀번호 재설정이 성공했다는 메시지가 표시되면 Nextcloud가 재설정을 수락한 것입니다.

3단계: 환경 변수는 자동화 목적으로만 사용하십시오.

Nextcloud는 스크립트 기반 작업도 지원합니다 --password-from-env. 비밀번호는 OC_PASS환경 변수에서 읽어옵니다. 따라서 실제 비밀번호를 명령줄, 셸 기록, 소스 코드 관리 시스템에 저장된 스크립트 또는 공유 터미널 대화 내용에 직접 입력하지 마십시오.

일회성 셸 세션의 경우, 비밀 키를 출력하지 않고 입력하고, 내보내고, 문서화된 명령을 실행한 다음, 비밀 키를 지울 수 있습니다.

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

그 후 read -s새 암호를 입력하고 Enter 키를 누르십시오. 입력란은 숨겨진 상태로 유지됩니다. 이 -E옵션은 sudo에게 환경 변수를 유지할지 묻지만, 로컬 sudo 정책에 따라 이 동작이 제한될 수 있습니다. 명령 OC_PASS실행 시 환경 변수가 없거나 비어 있다는 보고가 나오면 대화형 재설정을 사용하거나 플랫폼의 비밀 관리 절차를 따르십시오. 스크립트가 작동하도록 하기 위해 sudo 보호 기능을 비활성화하지 마십시오.

4단계: 계정에 로그인할 수 있는지 확인합니다.

평소에 사용하는 Nextcloud URL을 개인 브라우저 창에서 열거나 현재 세션에서 로그아웃한 다음 동일한 계정 ID와 새 비밀번호로 로그인하세요. 로그인에 성공하면 CLI 명령이 실행되었을 뿐만 아니라 웹 애플리케이션에서도 자격 증명이 제대로 작동하는 것이 확인됩니다. 조직에서 두 번째 인증 요소를 사용하는 경우 해당 인증 절차도 완료하세요.

흔히 발생하는 문제와 해결 방법

• Could not open input file: occ또는 파일 누락 오류가 발생한 경우: 아마도 잘못된 디렉터리에 있거나 잘못된 경로를 사용하고 있을 것입니다. 설치된 occ파일을 찾아서 해당 위치에서 명령을 다시 실행하십시오.
• 권한 또는 소유권 오류: 사용 중인 배포판의 웹 서버/PHP 계정을 확인하고 해당 계정으로 명령을 실행하십시오. 임시 해결책으로 소유권을 재귀적으로 변경하지 마십시오. 더 광범위한 접근 문제를 야기할 수 있습니다.
• "사용자가 존재하지 않습니다" 또는 이와 유사한 계정 오류: 계정 ID를 확인하십시오. 대소문자를 정확히 구분해야 합니다. 계정 ID가 이메일 주소가 아닌 경우 이메일 주소를 입력하지 마십시오.
• phpPHP CLI 바이너리가 없거나 잘못된 PHP 버전이 선택되었습니다. Nextcloud 설치 및 호스팅 플랫폼에서 지원하는 PHP CLI 바이너리를 사용하십시오. 서버에는 여러 개의 PHP 설치가 있을 수 있으므로 기본 명령이 웹 런타임과 일치한다고 가정하지 마십시오.
• 서버는 Docker, Nextcloud AIO, Snap 또는 어플라이언스에서 실행됩니다. 애플리케이션 환경에서 실행 occ하고 해당 배포의 공식 명령 절차를 따르십시오. 호스트 경로, 컨테이너 이름 및 런타임 사용자가 다를 수 있습니다. 소스 설치에서 복사한 호스트 수준 명령은 잘못된 파일 시스템을 대상으로 할 수 있습니다.
• 해당 계정은 LDAP 또는 Active Directory에서 관리됩니다. 이러한 시스템이 계정 자격 증명에 대한 관리 기관일 수 있습니다. 로컬 Nextcloud 암호 재설정으로는 외부에서 관리되는 암호가 업데이트되지 않을 수 있습니다. 디렉터리 관리자의 재설정 절차를 따르고 ID 공급자 구성을 확인하십시오.
• 셸 액세스 권한이 없습니다. Nextcloud에 등록된 이메일 주소가 유효한 경우 로그인 페이지의 비밀번호 재설정 링크를 시도하거나, 다른 Nextcloud 관리자 또는 호스팅 제공업체에 비밀번호 재설정을 요청하세요.

회복 후 피해야 할 사항

Nextcloud 데이터베이스를 직접 편집하여 암호 해시를 변경하지 마십시오. 운영 체제 암호를 변경하여 Nextcloud 사용자 암호를 재설정하지 마십시오. 새 암호는 안전하게 보관하고, 셸 환경에서 임시 암호를 모두 제거한 후 암호 관리자에 저장하십시오. 이전 자격 증명이 노출되었을 가능성이 있는 경우, 조직의 일반적인 보안 절차에 따라 접근 권한을 검토하십시오.

공식 참고 자료

Nextcloud는 분실된 관리자 암호 재설정 문서에서 복구 옵션과 분실된 관리자 암호 재설정 절차를 설명합니다 . 지원되는 명령, 암호 입력 메시지 및 환경 변수 옵션은 사용자 및 그룹 명령 과 occ 명령 사용 문서 에 설명되어 있습니다 .