🛠️ CyberPanel
OpenLiteSpeed 기반 웹 호스팅 제어 패널로, 호스팅 관리를 간소화하도록 설계되었습니다.
🔧 기능 및 서비스
- 🔐 다양한 사용자 액세스 수준 (ACL 기반).
- 🌌 Auto SSL로 웹사이트 보안 강화.
- 💻 FTP 서버로 파일 전송 지원.
- 🕒 경량 DNS 서버 (PowerDNS).
- 🔐 phpMyAdmin으로 데이터베이스 관리 (MariaDB).
- 📧 이메일 지원 (SnappyMail).
- 🕌 파일 관리자로 빠른 파일 액세스.
- 🌐 PHP 관리를 쉽게.
- 🔒 방화벽 (FirewallD 및 ConfigServer Firewall 통합).
- 📀 원클릭 백업 및 복원.
- 🐳 Docker 관리 및 명령 실행 기능.
- 🤖 AI 기반 보안 스캐너로 강화된 보호.
- 📊 월간 대역폭 리셋 - 대역폭 사용량 자동 리셋 (최신 버전에서 수정됨).
📖 문서 및 가이드
CyberPanel은 포괄적인 문서와 단계별 가이드를 제공합니다:
🔢 지원되는 PHP 버전
CyberPanel은 다양한 운영 체제에서 광범위한 PHP 버전을 지원합니다:
☑️ 현재 지원되는 PHP 버전
- PHP 8.5 - 최신 안정 버전 (EOL: 2028년 12월)
- PHP 8.4 - 안정 버전 (EOL: 2027년 12월)
- PHP 8.3 - 안정 버전 (EOL: 2027년 12월)
- PHP 8.2 - 안정 버전 (EOL: 2026년 12월)
- PHP 8.1 - 안정 버전 (EOL: 2025년 12월)
- PHP 8.0 - 레거시 지원 (EOL: 2023년 11월)
- PHP 7.4 - 레거시 지원 (EOL: 2022년 11월)
🔧 타사 PHP 애드온
추가 PHP 버전이나 특정 요구 사항이 있는 경우 타사 패키지를 설치할 수 있습니다:
Ubuntu/Debian
- Ondrej의 PPA: PHP 5.6 ~ 8.5 제공
- Sury의 PPA: 최신 PHP 버전을 제공하는 대체 저장소
RHEL 기반 시스템 (AlmaLinux, RockyLinux, CentOS, RHEL)
- Remi 저장소: 포괄적인 PHP 패키지 모음
- EPEL 저장소: 엔터프라이즈 Linux용 추가 패키지
CloudLinux
- CloudLinux PHP Selector: 여러 PHP 버전을 관리하는 기본 제공 도구
- Remi 저장소: 추가 PHP 버전 및 확장 기능
참고: 타사 저장소는 기본 저장소에서 제공하는 것보다 더 많은 PHP 버전을 제공할 수 있습니다. 항상 특정 사용 사례와의 호환성을 확인하세요.
🌐 지원되는 운영 체제
CyberPanel은 x86_64 아키텍처에서 실행되며 다음 운영 체제를 지원합니다:
✅ 현재 지원됨
- Ubuntu 24.04.3 - 2029년 4월까지 지원 ⭐ 신규!
- Ubuntu 22.04 - 2027년 4월까지 지원
- Ubuntu 20.04 - 2025년 4월까지 지원
- AlmaLinux 10 - 2030년 5월까지 지원 ⭐ 신규!
- AlmaLinux 9 - 2032년 5월까지 지원
- AlmaLinux 8 - 2029년 5월까지 지원
- RockyLinux 9 - 2032년 5월까지 지원
- RockyLinux 8 - 2029년 5월까지 지원
- RHEL 9 - 2032년 5월까지 지원
- RHEL 8 - 2029년 5월까지 지원
- CloudLinux 8 - 2029년 5월까지 지원
- CentOS 9 - 2027년 5월까지 지원
🔧 타사 OS 지원
추가 운영 체제는 타사 저장소나 커뮤니티 노력을 통해 지원될 수 있습니다:
- Debian - Ubuntu 호환 패키지로 작동할 수 있음
- openEuler - 제한된 테스트로 커뮤니티 지원
- 기타 RHEL 파생 배포판 - AlmaLinux/RockyLinux 패키지로 작동할 수 있음
참고: 지원되지 않는 운영 체제의 경우 호환성이 보장되지 않습니다. 항상 비프로덕션 환경에서 먼저 테스트하세요.
⚙️ 설치 방법
다음 명령으로 CyberPanel을 쉽게 설치할 수 있습니다:
sh <(curl https://cyberpanel.net/install.sh || wget -O - https://cyberpanel.net/install.sh)
📊 CyberPanel 업그레이드
다음 명령을 사용하여 CyberPanel 설치를 업그레이드하세요:
sh <(curl https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh || wget -O - https://raw.githubusercontent.com/usmannasir/cyberpanel/stable/preUpgrade.sh)
🆕 최근 업데이트 및 수정 사항
대역폭 리셋 문제 수정 (2025년 1월)
- 문제: 월간 대역폭 사용량이 리셋되지 않아 누적 값이 무한정 증가하는 문제
- 해결 방법: 모든 웹사이트 및 하위 도메인에 대한 월간 대역폭 자동 리셋 구현
- 영향받는 OS: 모든 지원 운영 체제 (Ubuntu, AlmaLinux, RockyLinux, RHEL, CloudLinux, CentOS)
- 수동 리셋: 즉시 리셋하려면
/usr/local/CyberCP/scripts/reset_bandwidth.sh 사용
- 문서: 대역폭 리셋 수정 가이드 참조
새로운 운영 체제 지원 추가 (2025년 1월)
- Ubuntu 24.04.3: 최신 Ubuntu LTS와 완전한 호환성
- AlmaLinux 10: 최신 AlmaLinux 릴리스와 완전한 호환성
- 장기 지원: 둘 다 2029~2030년까지 지원
📚 리소스
📖 빠른 시작 가이드
🔗 직접 가이드 링크
🧪 테스트
CyberPanel에는 모든 맞춤형 OpenLiteSpeed 기능을 다루는 128개의 테스트로 구성된 OLS 기능 테스트 스위트가 포함되어 있습니다.
테스트 실행
# On the target server, set up test data (once):
bash tests/ols_test_setup.sh
# Run the full 128-test suite:
bash tests/ols_feature_tests.sh
테스트 범위
| 단계 | 테스트 | 범위 |
|---|
| 1단계: 라이브 환경 | 56 | 바이너리 무결성, CyberPanel 모듈, Auto-SSL, LE 인증서, SSL 리스너 자동 매핑, 인증서 제공, HTTPS/HTTP, .htaccess 처리, VHost 구성, 원본 헤더, PHP 구성 |
| 2단계: ReadApacheConf | 72 | Include/IncludeOptional, 전역 튜닝, 리스너 생성, ProxyPass, IfModule, VHost 생성, SSL 중복 제거, Directory/Location 블록, PHP 버전 감지, ScriptAlias, HTTP/HTTPS, 프로세스 상태, graceful 재시작 |
🔧 문제 해결
일반적인 문제 및 해결 방법
월간 대역폭이 리셋되지 않는 문제
- 문제: 대역폭 사용량이 월간 사용량 대신 누적 값으로 표시됨
- 해결 방법: 대역폭 리셋 스크립트 실행:
/usr/local/CyberCP/scripts/reset_bandwidth.sh
- 예방 방법: 월간 cron 작업이 실행 중인지 확인:
0 0 1 * * /usr/local/CyberCP/bin/python /usr/local/CyberCP/postfixSenderPolicy/client.py monthlyCleanup
일반 지원
- 로그 확인:
/usr/local/lscp/logs/error.log
- cron 작업 확인:
crontab -l
- 수동 리셋 테스트:
/usr/local/CyberCP/scripts/의 제공 스크립트 사용
usmannasir/cyberpanel
