시놀로지 NAS WordPress 오류 해결

시놀로지 NAS WordPress 오류 해결

시놀로지 NAS 패키지 센터로 설치한 WordPress에서 자주 발생하는 오류 5가지와 해결 방법을 Synology 공식 가이드 기준으로 정리했습니다. Web Station 설정에 대한 자세한 내용은 시놀로지 공식 Web Station 도움말도 참고하세요. 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 복원, 플러그인 비활성화 세 가지로 해결됩니다. 위 방법으로도 해결되지 않는다면 상담 문의로 증상을 알려주세요.

NAS 구매·설치·세팅, 전문가에게 맡기세요
모델 선정부터 초기 세팅, 외부 접속, 백업 구성까지 원스톱으로 도와드립니다.