PufferPanel 접속
브라우저를 열고 아래 주소로 이동하세요: https://<SERVER_IP>
브라우저에서 SSL 경고가 표시될 수 있습니다 (자체 서명 인증서).
서버에서 다음 명령어를 실행하여 첫 번째 사용자를 생성하세요. 패널을 완전히 사용하려면 관리자 여부를 묻는 질문에 "Y"를 입력하세요.
pufferpanel user add
관리자 계정으로 로그인하세요.
Settings로 이동하여 다음 항목을 설정하세요:
- 마스터 URL(예:
https://<SERVER_IP>) - 사용자 회원가입 제어
- 이메일 설정 (선택사항)
포트
- 웹 UI: 8080
- SFTP: 5657
주요 파일 및 디렉터리
- 패널 구성:
/etc/pufferpanel/config.json - 패널 로그:
/var/log/pufferpanel - 웹 루트 (nginx):
/var/www/pufferpanel - SSL 인증서:
/etc/nginx/ssl/pufferpanel.crt&/etc/nginx/ssl/pufferpanel.key
서비스 관리
PufferPanel:
systemctl start pufferpanel
systemctl stop pufferpanel
systemctl restart pufferpanel
systemctl status pufferpanel
Nginx:
systemctl start nginx
systemctl stop nginx
systemctl restart nginx
systemctl reload nginx
systemctl status nginx
도메인으로 SSL 활성화하기
1. 도메인을 서버 IP로 연결합니다.
2. Nginx 설정을 편집하여 server_name <IP>; 을 실제 도메인으로 교체합니다 (<your-domain>) HTTP (포트 80) 및 HTTPS (포트 443) 블록 모두에 적용합니다:
vim /etc/nginx/sites-available/pufferpanel.conf
3. Certbot 설치:
apt install -y certbot python3-certbot-nginx
4. 다음 명령어를 실행하여 유효한 Let's Encrypt 인증서를 발급받으세요:
certbot certonly --nginx --non-interactive --agree-tos --email [email protected] -d yourdomain.com
5. Nginx 설정의 SSL 경로를 교체합니다:
vim /etc/nginx/sites-available/pufferpanel.conf
# Before:
# ssl_certificate /etc/nginx/ssl/pufferpanel.crt;
# ssl_certificate_key /etc/nginx/ssl/pufferpanel.key;
# After:
# ssl_certificate /etc/letsencrypt/live/yourdomain.com/fullchain.pem;
# ssl_certificate_key /etc/letsencrypt/live/yourdomain.com/privkey.pem;
6. 변경 사항을 적용하기 위해 Nginx를 재시작합니다:
systemctl restart nginx
7. 웹 UI Settings에서 Master URL를 다음 값으로 설정하세요. https://yourdomain.com
8. 브라우저를 열고 다음 주소로 접속하세요. https://yourdomain.com
메모
- Nginx는 HTTP를 HTTPS로 자동으로 리다이렉트하도록 설정되어 있습니다.
- SSL는 자체 서명 인증서입니다. 프로덕션 환경에서는 Let's Encrypt / Certbot 사용을 권장합니다.
- Docker가 설치되어 있으며
pufferpanel사용자가 Docker 그룹에 추가되었습니다.