Skip to main content

Portainer 관리자 비밀번호 재설정 단계

사전 준비​

  1. TNAS의 SSH 터미널을 엽니다.
  2. TNAS 앱 센터에서 Portainer가 중지되었는지 확인합니다(반드시 중지되어야 합니다. 그렇지 않으면 데이터베이스 파일이 잠겨 재설정이 실패합니다).

단계​

1. Portainer 데이터 디렉터리 찾기​

먼저 portainer.db가 들어 있는 Portainer 데이터 폴더를 찾습니다.

다음 명령을 실행합니다:

find /Volume1/@apps/Portainer -name "portainer.db"

실행하면 다음과 유사한 출력이 표시됩니다:

/Volume1/@apps/Portainer/portainer.db

경로 접두사 /Volume1/@apps/Portainer를 기록해 둡니다. 이것이 데이터 디렉터리입니다.

2. 공식 재설정 명령 실행​

아래 명령어의 /path/to/portainer를 이전 단계에서 찾은 데이터 디렉터리 경로로 바꾼 후 터미널에 복사하여 실행합니다:

docker run --rm -v /path/to/portainer:/data portainer/helper-reset-password

예를 들어:

데이터 디렉터리가 /Volume1/@apps/Portainer인 경우 전체 명령은 다음과 같습니다:

docker run --rm -v /Volume1/@apps/Portainer:/data portainer/helper-reset-password

3. 새 비밀번호 확인​

명령 실행 후 터미널에 다음과 유사한 내용이 출력됩니다:

2025/04/22 12:00:00 Password successfully updated for user: admin
2025/04/22 12:00:00 Use the following password to login:  aBcD1234!@#$
  • 첫 번째 줄은 재설정 성공을 나타냅니다.
  • 두 번째 줄의 aBcD1234!@#$가 임시 새 비밀번호입니다. 복사해 두세요!

4. Portainer 시작 및 로그인​

  1. TNAS 앱 센터로 돌아가서 Portainer를 다시 시작합니다.
  2. Portainer 웹 페이지를 엽니다(기본 주소: http://your_TNAS_IP:9000).
  3. 사용자 이름에 admin을 입력하고 이전 단계에서 복사한 임시 비밀번호를 붙여넣으면 로그인할 수 있습니다.

5. (강력 권장) 로그인 후 즉시 비밀번호 변경​

  1. Portainer에 로그인한 후 오른쪽 상단의 사용자 아바타를 클릭합니다.
  2. My Account → Change Password를 선택합니다.
  3. 임시 비밀번호를 입력하고 자신의 새 비밀번호를 설정한 후 저장합니다.

자주 묻는 질문​

1. 왜 먼저 Portainer를 중지해야 하나요?​

Portainer는 실행 중일 때 portainer.db 파일을 잠그기 때문에 재설정 도구가 수정할 수 없습니다. 중지하면 파일이 해제되어 재설정이 성공할 수 있습니다.

2. 재설정 후 이전에 생성한 사용자와 구성이 손실되나요?​

이 작업은 관리자 계정 비밀번호만 재설정합니다. 다른 사용자, 실행 환경, 템플릿 파일 및 시스템 구성 매개변수는 삭제 또는 수정되지 않습니다.

3. 명령 실행 시 docker: command not found 오류가 발생합니다.​

TNAS에서 Docker Engine이 활성화되지 않았음을 의미합니다. TNAS 앱 센터로 이동하여 Docker Engine을 설치 및 활성화한 후 명령을 다시 실행하세요.

4. 명령 실행 후 비밀번호 출력이 보이지 않습니다.​

  • 데이터 디렉터리 경로가 올바른지 확인하세요.
  • Portainer가 완전히 중지되었는지 확인하세요.
  • 명령을 다시 실행하세요.