메인 콘텐츠로 건너뛰기

일반적인 문제 해결

웹사이트 대신 플레이스홀더 페이지가 표시됨​

이 문제가 발생하는 이유는 여러 가지일 수 있습니다. 가장 일반적인 원인은 다음과 같습니다:

  • 웹사이트의 도메인 이름이 타사 서버를 가리킴

    우선 도메인 영역(DNS)에 A 및 AAAA 레코드를 추가할 때 오타가 없는지 확인하는 것이 좋습니다.

  • 웹사이트의 도메인 이름이 이 웹사이트가 존재하지 않는 서버를 가리킴

    서버에 웹사이트가 생성되어 있는지 확인하세요. 새 빈 사이트를 만들려면 매뉴얼을 참조하세요.

  • HTTPS를 사용하여 웹사이트에 접근하려고 하지만, 웹사이트에서 SSL 인증서를 사용하지 않음

    이는 "Full" 암호화 모드를 사용하는 Cloudflare 사용자에게서 흔히 발생하는 문제입니다. SSL 인증서를 사용하거나, "Full" 모드를 비활성화한 상태에서 http://를 통해 웹사이트에 접근해야 합니다.

    Let's Encrypt에서 무료 SSL 인증서를 발급할 수 있습니다. 이미 SSL 인증서가 있다면 서버에 추가할 수 있습니다.

  • 웹사이트의 도메인 이름에 AAAA 레코드가 있지만, 웹사이트 설정에서 IPv6 주소가 선택되지 않음

    이 문제는 IPv6를 통해 웹에 접근하는 방문자에게만 영향을 줍니다.

    웹사이트에서 IPv6를 활성화하거나 AAAA 레코드를 제거해야 합니다.

    웹사이트 설정을 변경하려면 FASTPANEL®의 웹사이트 카드로 이동한 다음 "Settings" → "Basic"으로 이동하세요. "IP address" 드롭다운 목록에서 도메인의 AAAA 레코드에 지정된 주소를 확인하세요.

제어판에 접근할 때 브라우저에 404 오류가 표시됨​

이 오류가 발생하면 fastpanel2 패키지가 있는지 확인하세요. 이 패키지는 다른 소프트웨어를 설치할 때 종속성 해결을 위해 OS 패키지 관리자에 의해 제거되었을 수 있습니다.

Debian/Ubuntu의 경우:

dpkg -l | grep fastpanel2

CentOS/Alma/Rocky의 경우:

rpm -qa | grep fastpanel2

출력에 fastpanel2라는 이름의 패키지가 포함되어 있어야 합니다.

패키지가 실제로 제거된 경우 다시 설치할 수 있습니다:

Debian/Ubuntu의 경우:

apt install fastpanel2

CentOS/Alma/Rocky의 경우:

yum install fastpanel2

fastpanel2를 설치하면 문제를 일으킨 기존 설치 소프트웨어가 제거된다는 점에 유의하세요.

DNS 캐시와 관련 없는 Let's Encrypt SSL 인증서 발급 오류​

인증서를 발급하는 도메인이 /etc/hosts 파일에서 다음으로 시작하는 줄에 포함되어 있으면 인증서 발급이 실패할 수 있습니다:

127.0.0.1
::1

인증서를 성공적으로 발급하려면 /etc/hosts 파일의 해당 줄에서 도메인을 제거하세요.

전역 PHP 설정에 접근할 때 "Unable to execute /path/to/php -f /path/to/file" 오류가 발생함​

특정 PHP 지시문을 전역으로 재정의할 때 Unable to execute /path/to/php -f /path/to/file 오류가 발생합니다.

이 문제를 해결하려면 이러한 변경 사항을 웹사이트의 PHP 설정으로 옮기는 것이 좋습니다. 웹사이트의 PHP 설정은 웹사이트 카드에서 접근할 수 있습니다.

ProFTPD 오류 메시지: "warning: unable to determine IP address of '%hostname'"​

서버의 호스트명이 IP 주소로 해석되지 않으면 ProFTPD FTP 서버 시작 시 warning: unable to determine IP address of '%hostname' 오류가 발생합니다.

이 오류를 해결하려면 서버에 유효한 호스트명을 지정하세요. 예를 들어 www.example.com과 같은 3차 도메인을 사용하는 것이 좋습니다.

다음 명령으로 호스트명을 지정할 수 있습니다:

hostnamectl hostname YOUR_DOMAIN

여기서 YOUR_DOMAIN은 원하는 호스트명입니다.

.htaccess 사이트 규칙이 작동하지 않음​

사이트의 PHP 핸들러가 PHP-FPM으로 설정되어 있어 .htaccess 파일의 내용을 무시하고 있을 가능성이 높습니다.

.htaccess 파일이 작동하도록 하려면 핸들러로 CGI, FastCGI 또는 Apache를 선택해야 합니다.

웹사이트 로그에 "Fatal error: Allowed memory size of X bytes exhausted (tried to allocate Y bytes)" 오류가 표시됨​

이 오류는 PHP의 스크립트가 메모리 사용 한도를 초과하기 때문에 발생합니다.

일반적으로 이는 웹사이트의 PHP 설정에서 memory_limit 매개변수 값을 늘리면 해결됩니다.

또한 이 매개변수 값은 .htaccess 파일이나 PHP 스크립트 자체에서 직접 재정의될 수 있습니다.

PHP-FPM 서비스가 시작되지 않음​

"Settings" → "Services" 메뉴의 PHP-FPM 서비스가 Stopped 상태이며, 시작을 시도하면 Unable to start the service. 오류가 발생합니다

PHP-FPM 서비스는 자동으로 시작되며, 특정 PHP 버전의 서비스가 웹사이트에 연결된 경우에만 관리할 수 있습니다. 특정 PHP 버전의 PHP-FPM 서비스가 어떤 웹사이트에도 연결되어 있지 않으면 시작할 수 없습니다.

FASTPANEL에서 phpMyAdmin 및 파일 관리자 업로드 한도 변경​

"Settings" → "Main" → "Other" 메뉴에서 파일 업로드 한도를 변경할 수 있습니다.
Maximum file upload size (MB) 필드에 원하는 값을 입력하세요.

521 Cloudflare 오류 - "Web server is down"​

이 서비스는 원본 서버로부터 응답을 받을 수 없었다고 보고합니다. 이 문제는 다음 원인 중 하나로 인해 발생할 수 있습니다:

  • Cloudflare DNS 설정의 잘못된 IP 주소
    Cloudflare DNS 설정에서 IP 주소를 확인하세요. 올바르지 않다면 정확한 값으로 업데이트하세요.

  • Nginx 웹 서버가 실행되고 있지 않음
    서버에서 Nginx 웹 서버가 실행 중인지 확인하세요. 상태를 확인하려면 "Settings" → "Services"로 이동하세요. 실행 중이 아니라면 시작을 시도하세요.

  • 방화벽이 웹 서버 접근을 차단함
    웹 서버가 방화벽 규칙에 의해 차단되지 않는지 확인하세요. SSH를 통해 서버에 연결한 후 다음 명령을 사용하여 현재 방화벽 규칙을 확인하세요:

    iptables-save  
    ip6tables-save

기타 문제​

이 문서에서 FASTPANEL 문제에 대한 해결책을 찾지 못했다면 지원 서비스로 문의해 주세요. 기꺼이 도와드리겠습니다!