워드프레스 설치 과정은 보통 순조롭게 진행되지만 초보자에게는 몇 가지 오류 메시지가 표시될 수 있습니다. 이러한 문제는 복잡하고 복잡해 보일 수 있지만 원인을 찾으면 쉽게 해결할 수 있습니다. 이 섹션에서는 설치 실패의 일반적인 문제와 구체적인 해결 방법을 요약하여 신속하게 문제를 해결하고 설치를 완료할 수 있도록 도와드립니다.
I. 데이터베이스 연결 실패(가장 일반적인 오류)
잘못된 행동
"데이터베이스 연결을 설정하는 동안 오류가 발생했습니다." 또는 "데이터베이스 연결을 설정하는 동안 오류가 발생했습니다."라는 메시지가 표시되며 다음 단계로 진행할 수 없습니다.
가능한 원인 및 해결 방법
- 잘못된 데이터베이스 정보(90%의 경우)
- 체크 포인트데이터베이스 이름, 사용자 이름, 비밀번호가 레코드와 동일한지 여부(대소문자 구분).
- 운동 단계:
- Pagoda 패널에 로그인하고 '데이터베이스' 페이지로 이동하여 데이터베이스 이름과 사용자 아이디를 확인합니다.
- 비밀번호가 틀린 경우 '더보기' → '비밀번호 변경'을 클릭하여 새 비밀번호를 생성하고 기록하세요.
- 설치 페이지로 돌아가 올바른 정보로 다시 입력한 후 제출합니다.
- 데이터베이스 호스트 주소 오류
- 체크 포인트'데이터베이스 호스트'가 맞나요(거의 대부분 초보자용)?
localhost)。 - 운동 단계:
- 기본값
localhost수정할 필요가 없습니다. - 서버 제공업체에서 지정한 경우(예: 일부 해외 호스트) 제공된 주소를 입력합니다(예.
mysql.example.com)。
- 기본값
- 체크 포인트'데이터베이스 호스트'가 맞나요(거의 대부분 초보자용)?
- 데이터베이스 서비스가 시작되지 않음
- 체크 포인트서버의 MySQL 서비스가 제대로 실행되고 있는지 여부입니다.
- 운동 단계:
- Pagoda 패널에 로그인하고 왼쪽에 있는 '소프트웨어 스토어'를 클릭합니다.
- MySQL 설치를 찾아 상태가 "실행 중"인지 확인합니다.
- 실행 중이 아니라면 '다시 시작' 버튼을 클릭하여 서비스를 시작하세요.
- 데이터베이스 사용자에게 권한이 없습니다.
- 체크 포인트데이터베이스 사용자에게 데이터베이스에 액세스할 수 있는 권한이 있는지 여부입니다.
- 운동 단계:
- Pagoda 패널에 로그인하여 "데이터베이스"로 이동 → 데이터베이스 뒤의 "관리"를 클릭하고 phpMyAdmin으로 이동합니다.
- 상단 메뉴에서 '사용자 계정'을 클릭하여 해당 데이터베이스 사용자를 찾습니다.
- 사용자가 대상 데이터베이스에 대한 '모든 권한'을 가지고 있는지 확인하고, 그렇지 않은 경우 다시 승인합니다.
II. 권한 오류(파일/쓰기 구성을 만들 수 없음)
잘못된 행동
팁: "wp-config.php 파일에 쓸 수 없습니다." 또는 "디렉터리를 만들 수 없습니다."라는 메시지가 표시되면 설치가 중단됩니다.
가능한 원인 및 해결 방법
- 웹사이트 카탈로그 권한 부족
- 체크 포인트서버의 웹 루트 디렉터리에 대한 권한이 올바르게 설정되었는지 여부입니다.
- 운동 단계:
- 파고다 패널에 로그인하고 '사이트' → 해당 사이트를 찾은 다음 '자세히' → '권한'을 클릭합니다.
- "디렉토리 권한"을 다음과 같이 설정합니다.
755"파일 권한"이 다음과 같이 설정된 경우644。 - 소유권 옵션
www(또는 서버의 기본 런타임 사용자)로 로그인한 후 적용을 클릭합니다.
- wp-config.php 파일을 수동으로 생성합니다.
- 작성할 수 없는 구성 파일을 묻는 메시지가 표시되면 수동으로 작성합니다:
- 설치 오류 페이지에서 '프로필 만들기'를 클릭하고 페이지에서 코드를 복사합니다.
- Pagoda 패널에 로그인하고 웹사이트의 루트 디렉터리로 이동하여 "새 파일"을 클릭한 다음 이름을
wp-config.php。 - 파일을 더블 클릭하여 편집기를 열고 복사한 코드를 붙여넣은 후 '저장'을 클릭합니다.
- 설치 페이지로 돌아가서 '설치 진행'을 클릭하여 계속합니다.
- 작성할 수 없는 구성 파일을 묻는 메시지가 표시되면 수동으로 작성합니다:
- 파일 소유권 오류
- 체크 포인트: 파일이 서버를 실행하는 사용자의 소유인지 여부(예: Apache 또는 Nginx를 실행하는 사용자).
- 운동 단계:
- Pagoda 파일 관리자에서 웹사이트 루트 디렉터리를 선택하고 '권한'을 클릭합니다.
- "소유자"와 "그룹"을 서버 런타임 사용자(일반적으로
www또는nginx)。 - "하위 디렉터리에 적용"을 선택하고 "확인"을 클릭합니다.
III. 설치 프로세스 중단 또는 흰색 화면
잘못된 행동
설치 도중에 갑자기 멈추거나 페이지가 공백(흰색 화면)이 되거나 "500 내부 서버 오류"가 표시됩니다.
가능한 원인 및 해결 방법
- PHP 버전 비호환성
- 체크 포인트서버 PHP 버전이 워드프레스 요구 사항을 충족하는지 여부(7.4 이상 권장).
- 운동 단계:
- Pagoda 패널에 로그인하고 "웹사이트" → 해당 웹사이트를 찾아 "PHP 버전"을 클릭합니다.
- 최상의 호환성을 위해 PHP 7.4 또는 8.0을 선택하고 '전환'을 클릭합니다.
- 설치 페이지를 전환하고 다시 방문합니다.
- PHP 메모리 제한 부족
- 체크 포인트PHP 메모리 제한이 너무 낮아 설치 프로세스가 중단됩니다.
- 운동 단계:
- Pagoda 패널에 로그인하여 "소프트웨어 스토어"로 이동 → 설치된 PHP를 찾아 "설정"을 클릭합니다.
- '프로필'로 이동하여 다음을 검색합니다.
memory_limit값을 다음과 같이 변경합니다.128M또는256M。 - 저장을 클릭하여 PHP 서비스를 다시 시작합니다.
- 손상되었거나 불완전한 설치 파일
- 체크 포인트업로드한 워드프레스 설치 패키지가 손상되지 않았습니다.
- 운동 단계:
- 공식 소스에서 워드프레스 설치 패키지를 다시 다운로드합니다(섹션 7.1 참조).
- Pagoda 패널에 로그인하여 사이트의 루트 디렉터리에 있는 모든 파일을 삭제합니다.
- 새 설치 패키지를 다시 업로드하고 압축을 푼 다음(7.2절 참조) 설치를 다시 시작합니다.
IV. 기타 일반적인 오류 및 해결 방법
- 도메인 이름이 확인되지 않거나 서버 포트가 열리지 않음
- 잘못된 행동도메인 이름에 액세스할 때 설치 페이지를 열 수 없으며 "이 사이트에 액세스할 수 없습니다."라는 메시지가 표시됩니다.
- 운동 단계:
- 도메인 네임이 서버 IP로 확인되었는지 확인합니다(4.4절 참조).
- 서버 콘솔에 로그인하여 포트 80(HTTP) 및 443(HTTPS)이 열려 있는지 확인합니다.
- IP를 통해 액세스하는 경우 Pagoda 패널에서 IP 액세스를 제한하지 않는지 확인합니다.
- 데이터베이스 테이블 접두사 충돌
- 잘못된 행동"테이블이 이미 존재합니다."라는 메시지가 표시되거나 설치 후 데이터가 엉망이 됩니다.
- 운동 단계:
- 워드프레스가 이전에 설치되어 있는 경우 phpMyAdmin에 로그인하여 이전 데이터베이스 테이블을 삭제합니다.
- 로 변경하거나 설치 중에 테이블 접두사를 수정합니다(예
wp_로 변경wp2023_)。
- 방화벽 또는 보안 플러그인 차단
- 잘못된 행동설치 페이지가 느리게 로드되거나 차단되었습니다.
- 운동 단계:
- 서버 방화벽 또는 보안 그룹 규칙을 일시적으로 비활성화합니다(설치가 완료된 후 다시 켜세요).
- 국내 서버를 사용하는 경우 파일링 문제로 인해 차단되었는지 확인하세요(미등록 도메인의 경우 포트 80/443을 사용할 수 없습니다).
오류 해결을 위한 일반적인 팁
- 오류 로그 보기
- Pagoda 패널에 로그인하고 해당 사이트의 '사이트' → '로그'로 이동하여 오류의 구체적인 원인을 기록하는 '오류 로그'를 확인합니다.
- 간소화된 설치 환경
- 복잡한 서버 구성을 사용하는 경우 기본 설정(예: PHP 확장, 의사 정적 규칙 등)을 일시적으로 복원합니다.
- 도움 요청하기
- 오류 메시지의 텍스트를 복사하고 검색 엔진에서 해결 방법을 검색합니다(일반적으로 유사한 문제에 대한 해결 방법을 찾을 수 있음).
- 서버 공급업체의 고객 서비스에 문의하여 오류 스크린샷을 제공하면 기술자가 문제 해결에 도움을 줄 수 있습니다.
짧은
대부분의 설치 실패는 잘못된 정보 입력, 부적절한 권한 설정 또는 호환되지 않는 환경으로 인해 발생하며, 이 섹션의 방법에 따라 하나씩 확인하면 99% 문제를 해결할 수 있습니다. 여러 번 시도해도 여전히 실패하면 데이터베이스 생성, 파일 업로드, 정보 입력에 이르기까지 각 단계를 신중하게 확인하여 작업이 올바른지 확인하는 등 프로세스를 재구성하는 것이 좋습니다.
문제를 해결했다면 워드프레스 백엔드로 이동하여 웹사이트 구축을 시작할 수 있습니다.