시놀로지 NAS WordPress 오류 해결

시놀로지 NAS 패키지 센터로 설치한 WordPress에서 자주 발생하는 오류 5가지와 해결 방법을 Synology 공식 가이드 기준으로 정리했습니다. DSM 7.0 기준이며, DSM 6.2와 경로가 일부 다릅니다.

이 글은 패키지 센터 WordPress 기준입니다. DSM 7.0에서 WordPress 파일 경로는 /web_packages/wordpress/, DSM 6.2는 /web/wordpress/입니다.

1. 500 내부 서버 오류

Web Station에서 WordPress용 웹 포털 설정 후 “500 내부 서버 오류”가 뜨는 경우입니다. PHP 확장 모듈이 활성화되어 있지 않아서 발생하는 경우가 대부분입니다.

해결 방법 (DSM 7.3)

  1. Web Station > 스크립트 언어 설정 > PHP 로 이동
  2. WordPress에 연결된 PHP 프로필 선택 후 편집 클릭
  3. 확장 프로그램 탭에서 필요한 확장 모듈을 모두 선택
  4. 저장 후 WordPress 다시 접속 확인

WordPress 구동에 필요한 주요 PHP 확장: mysqli, curl, gd, mbstring, xml, json

해결 방법 (DSM 6.2)

  1. Web Station > 가상 호스트에서 현재 PHP 버전 확인
  2. PHP 설정 > 해당 PHP 버전 선택 > 편집
  3. 기본 서버 설정 탭의 확장 항목에서 필요한 모듈 모두 체크 후 저장

2. .htaccess 편집 시 403 오류

.htaccess 파일을 수정한 후 “403이 요청을 처리하는 동안 오류가 발생했습니다” 메시지가 뜨는 경우입니다. 파일 내용이 잘못된 것이 원인입니다.

파일 위치

  • DSM 7.3: File Station > /web_packages/wordpress/.htaccess
  • DSM 6.2: File Station > /web/wordpress/.htaccess

해결 방법

  1. File Station에서 .htaccess 파일을 다른 폴더로 이동해서 임시 제거
  2. WordPress에 다시 접속해서 오류가 사라지는지 확인
  3. 오류가 해결되면 파일 내용이 잘못된 것 — 아래 기본값으로 교체 후 되돌림

WordPress .htaccess 기본값:

# BEGIN WordPress

RewriteEngine On
RewriteBase /wordpress/
RewriteRule ^index.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /wordpress/index.php [L]

# END WordPress

WordPress가 루트 경로에 설치된 경우 RewriteBase /, RewriteRule . /index.php [L]로 변경합니다.

3. 데이터베이스 연결 오류

“데이터베이스 연결 설정 중 오류가 발생했습니다” 메시지가 뜨면 WordPress가 MariaDB에 접속하지 못하는 상태입니다. 아래 순서대로 확인합니다.

1단계: MariaDB 실행 여부 확인

DSM > 패키지 센터 > MariaDB 10 상태가 “실행 중”인지 확인합니다. 실행 중이 아니면 시작합니다.

2단계: MySQL 확장 활성화 확인

Web Station > 스크립트 언어 설정 > PHP > 확장 탭에서 mysqli 또는 pdo_mysql이 체크되어 있는지 확인합니다.

3단계: wp-config.php 자격증명 확인

File Station에서 wp-config.php를 열어 DB 정보가 올바른지 확인합니다.

define( 'DB_NAME',     'wordpress' );   // DB 이름
define( 'DB_USER',     'wp_user' );     // DB 사용자명
define( 'DB_PASSWORD', '비밀번호' );    // DB 비밀번호
define( 'DB_HOST',     '127.0.0.1' );  // 기본값

phpMyAdmin에서 동일한 계정으로 로그인이 되는지 확인합니다. 로그인이 안 된다면 비밀번호가 틀린 것입니다.

4단계: 재설치 (최후 수단)

위 방법으로 해결이 안 된다면 WordPress 패키지를 제거하고 관련 DB를 삭제한 뒤 재설치합니다. 콘텐츠 백업을 먼저 해두세요.

4. 공백 페이지 (화면이 비어 있음)

오류 메시지 없이 흰 화면만 나오는 경우입니다. 대부분 플러그인 충돌이 원인입니다.

방법 1: 관리자 화면 접속 가능한 경우

WordPress 관리자 > 플러그인에서 설치된 플러그인을 모두 비활성화합니다. 페이지가 정상으로 돌아오면 플러그인 충돌이 원인입니다. 하나씩 다시 활성화하면서 원인 플러그인을 찾아 제거합니다.

방법 2: 관리자 화면도 접속 불가한 경우

  1. File Station에서 WordPress 플러그인 폴더로 이동
    • DSM 7.3: /web_packages/wordpress/wp-content/
    • DSM 6.2: /web/wordpress/wp-content/
  2. plugins 폴더 이름을 plugins-bk로 변경
  3. WordPress 관리자 화면 접속 확인
  4. 접속되면 plugins-bk를 다시 plugins로 복원
  5. 관리자 > 플러그인에서 하나씩 활성화하며 원인 찾기

테마가 원인인 경우도 있습니다. 같은 방식으로 themes 폴더 이름을 변경해서 확인합니다. 단, 폴더명만 변경해도 테마가 자동 비활성화되지는 않으므로 관리자 화면에서 기본 테마로 전환 후 확인하세요.

5. “안전하지 않음” 보안 경고

브라우저 주소창에 “안전하지 않음”이 표시되는 경우입니다. SSL 인증서가 없거나 HTTP로 접속 중인 것이 원인입니다. 자세한 해결 방법은 추후 별도 글로 다룰 예정입니다.

간략한 해결 순서:

  1. DSM > 제어판 > 보안 > 인증서에서 Let’s Encrypt 무료 인증서 발급
  2. WordPress 관리자 > 설정 > 일반에서 WordPress 주소와 사이트 주소를 https://로 변경
  3. DB 내 HTTP 링크는 Better Search Replace 플러그인으로 일괄 교체

참고: 패키지 센터 WordPress로 여러 사이트 운영 가능한가요?

패키지 센터의 WordPress 패키지는 단일 사이트만 지원합니다. 여러 사이트를 운영하려면 Web Station + Container Manager를 이용한 컨테이너 방식으로 설치해야 합니다.

  • Web Station > 웹 서비스 > 생성 > 컨테이너화된 스크립트 언어 웹사이트 선택
  • WordPress 버전 선택 후 각 사이트별 DB·포트·호스트명 설정
  • 사이트마다 독립된 컨테이너로 운영되어 충돌 없음

오류별 빠른 정리

오류원인가장 먼저 확인할 것
500 오류PHP 확장 미활성화Web Station > PHP 확장 탭에서 필요 모듈 체크
403 오류.htaccess 내용 오류.htaccess 파일을 다른 곳으로 이동 후 재접속
DB 연결 오류MariaDB 미실행 또는 자격증명 불일치MariaDB 실행 여부 확인, wp-config.php DB 정보 점검
공백 페이지플러그인 또는 테마 충돌plugins 폴더를 plugins-bk로 임시 변경
안전하지 않음SSL 인증서 없음Let’s Encrypt 인증서 발급

마무리

대부분의 오류는 PHP 확장 활성화, .htaccess 복원, 플러그인 비활성화 세 가지로 해결됩니다. 위 방법으로도 해결되지 않는다면 상담 문의로 증상을 알려주세요.

코멘트

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다