CyberPanel 비밀번호 재설정이 필요한 상황은 생각보다 자주 발생합니다. 서버를 매일 관리하는 경우에는 문제가 없지만, 몇 달 동안 접속하지 않다가 다시 로그인하려고 하면 비밀번호가 기억나지 않는 경우가 있습니다.
저 역시 OpenLiteSpeed와 CyberPanel을 운영하면서 한동안 관리자 화면에 접속할 일이 없었습니다. 저장해 두었던 메모 파일도 찾지 못해 로그인 자체가 불가능한 상태가 됐습니다.
CyberPanel을 다시 설치할까 고민하기도 했지만 조사해 보니 서버에 접속만 가능하다면 몇 초 만에 비밀번호를 변경할 수 있었습니다. 실제로는 관리자 데이터가 손상된 것이 아니라 비밀번호만 잊어버린 상태였기 때문에 재설치가 필요하지 않았습니다.
목차
CyberPanel 로그인 화면이 열리지 않는 경우
비밀번호를 변경하기 전에 먼저 CyberPanel 접속이 가능한 상태인지 확인하는 것이 좋습니다.
기본적으로 CyberPanel은 다음 주소를 사용합니다.
https://서버IP:8090로그인 화면이 열리지 않는다면 비밀번호 문제가 아니라 포트 문제일 수 있습니다.
AWS Lightsail 환경에서는 인스턴스 방화벽 규칙에서 8090 포트가 열려 있어야 접속할 수 있습니다.
예전 서버를 점검할 때 8090 포트 규칙이 삭제되어 관리자 화면 자체가 열리지 않았던 적이 있었습니다. 이 경우에는 CyberPanel 비밀번호 재설정보다 먼저 네트워크 설정을 확인해야 합니다.
CyberPanel 비밀번호 재설정을 위한 SSH 접속
CyberPanel 비밀번호 설정은 웹 브라우저가 아니라 SSH에서 진행합니다.
Lightsail을 사용한다면 인스턴스 관리 화면의 연결 메뉴에서 브라우저 SSH 기능을 사용할 수 있습니다.
PuTTY나 Windows Terminal을 사용하는 방법도 있지만 비밀번호를 변경하는 정도라면 브라우저 SSH만으로 충분했습니다.
CyberPanel 비밀번호 설정 명령어
SSH 접속이 완료되면 아래 명령어를 입력합니다.
sudo adminPass 새비밀번호예시
sudo adminPass MyNewPassword123CyberPanel 비밀번호 설정 명령어는 관리자 계정(admin)의 비밀번호를 즉시 변경합니다.
명령 실행 후 오류가 없다면 변경 결과가 출력됩니다.
비밀번호 변경 완료 여부 확인
명령어 실행 후 성공 메시지가 나타나면 변경이 완료된 상태입니다.
이후 CyberPanel 로그인 화면으로 돌아가 새 비밀번호를 입력하면 바로 접속할 수 있습니다.
OpenLiteSpeed 설정이나 웹사이트 데이터는 전혀 영향을 받지 않기 때문에 서비스 중인 사이트를 중단할 필요도 없습니다.
CyberPanel 비밀번호 재설정이 안 되는 경우
CyberPanel 비밀번호 재설정 명령어를 입력했는데 변경되지 않는다면 다음 부분을 확인해 보는 것이 좋습니다.
- sudo 권한이 있는 계정인지 확인
- CyberPanel 설치가 정상 상태인지 확인
- SSH 접속 계정 확인
- 서버 디스크 공간 부족 여부 확인
대부분은 권한 문제보다 명령어 오타 때문에 발생하는 경우가 많았습니다.
특히 adminPass의 대소문자를 잘못 입력하면 명령어를 찾을 수 없다는 오류가 나타날 수 있습니다.
변경 후 확인한 부분
CyberPanel 비밀번호 설정을 마친 뒤에는 관리자 화면 접속 여부만 확인하지 않고 몇 가지를 추가로 점검했습니다.
- CyberPanel 로그인 정상 여부
- OpenLiteSpeed 서비스 상태
- LiteSpeed Cache 동작 상태
- SSL 인증서 상태
- 사이트 접속 여부
비밀번호만 변경하는 작업이라 서버 설정에는 영향이 없었고, 로그인 문제도 바로 해결됐습니다.
서버를 오래 운영하다 보면 관리자 계정 정보를 잊어버리는 경우가 생길 수 있습니다. 그럴 때는 재설치부터 생각하기보다 SSH 접속 가능 여부를 먼저 확인하는 것이 시간을 훨씬 절약할 수 있었습니다.
FAQ
CyberPanel 비밀번호 재설정 후 사이트가 중단되나요?
아닙니다. 관리자 계정 비밀번호만 변경되며 웹사이트 서비스에는 영향을 주지 않습니다.
CyberPanel 비밀번호 재설정은 root 권한이 필요한가요?
일반적으로 sudo 권한이 있는 계정이면 실행할 수 있습니다.
CyberPanel 비밀번호 재설정 후 기존 설정은 유지되나요?
네. OpenLiteSpeed 설정, 도메인 설정, SSL 인증서, 웹사이트 데이터는 그대로 유지됩니다.
