ServBay 환경에서 WordPress 설치 및 설정하기

개요

WordPress는 PHP와 MySQL 기반의 강력하고 널리 사용되는 오픈 소스 콘텐츠 관리 시스템(CMS)입니다. 전 세계적으로 가장 인기 있는 웹사이트 및 블로그 구축 플랫폼으로, 방대한 커뮤니티 지원과 다양한 플러그인 및 테마 에코시스템을 갖추고 있어 개인 블로그부터 복잡한 이커머스 사이트까지 다양한 프로젝트에 적합합니다.

ServBay는 macOS에 최적화된 로컬 웹 개발 환경으로, 다양한 버전의 PHP, 대표적인 데이터베이스들(MySQL, PostgreSQL, MongoDB), 웹 서버(Caddy, Nginx), Redis 등 여러 도구를 통합한 원스톱 솔루션입니다. ServBay를 통해 개발자는 격리되고 유연하며 고성능의 로컬 개발 환경을 손쉽게 구축할 수 있어, WordPress를 설치하고 테스트하는 과정이 매우 간편해집니다.

이 문서는 ServBay 환경에서 WordPress를 다운로드, 설치, 설정하는 방법을 단계별로 안내하여 빠르게 로컬 WordPress 개발을 시작할 수 있도록 도와드립니다.

사전 준비 사항

시작하기 전 다음 조건을 충족해야 합니다:

1. macOS 시스템에 ServBay가 정상적으로 설치 및 실행 중일 것.
2. ServBay에서 최소 하나의 PHP 버전(WordPress는 PHP 7.4 이상 필요)과 MySQL 또는 MariaDB 데이터베이스 패키지가 설치 및 실행 중일 것.
3. 웹 서버, 데이터베이스, 터미널 명령 실행에 대한 기초 개념을 알고 있을 것.

WordPress 설치 절차

다음은 ServBay 환경에서 WordPress를 설치하고 설정하는 자세한 단계입니다.

1단계: WordPress 다운로드 및 압축 해제

먼저, 최신 버전의 WordPress 프로그램 파일을 ServBay가 사용하는 웹사이트 루트 디렉터리(/Applications/ServBay/www) 하위 폴더에 받아둡니다.

1. ServBay 웹사이트 루트 디렉터리로 이동

   터미널을 열고 아래 명령어로 ServBay의 기본 웹사이트 루트 디렉터리로 이동합니다:

   cd /Applications/ServBay/www

2. 최신 WordPress 다운로드

   curl 명령어로 WordPress의 최신 압축 파일을 다운로드합니다:

   curl https://wordpress.org/latest.tar.gz -o wordpress.tar.gz

3. 프로젝트 디렉터리 생성 및 WordPress 압축 해제

   WordPress 사이트 파일을 저장할 새 디렉터리(예: servbay-wordpress-app)를 만들고, 압축 파일의 내용을 해당 디렉터리에 해제하세요. --strip-components 1 옵션은 압축 파일 내부의 상위 wordpress 폴더를 제거하고 내용만 직접 지정한 디렉터리에 풉니다.

   mkdir servbay-wordpress-app
   tar zxf wordpress.tar.gz --strip-components 1 -C servbay-wordpress-app

   이제 WordPress 파일들은 /Applications/ServBay/www/servbay-wordpress-app 경로에 위치하게 됩니다.

2단계: 데이터베이스 및 사용자 생성

WordPress는 글, 페이지, 댓글, 플러그인 등 모든 내용과 설정을 저장하기 위해 데이터베이스가 필요합니다. ServBay의 데이터베이스 서비스에서 새 데이터베이스와 접근 전용 사용자를 만들어야 합니다.

1. ServBay 내장 데이터베이스 관리 도구 접속

   ServBay는 기본적으로 phpMyAdmin이나 Adminer(설정에 따라)를 제공합니다. 브라우저에서 ServBay 기본 홈(https://servbay.host/)에 접속 후, 페이지 내 ‘phpMyAdmin’ 또는 ‘Adminer’ 링크를 클릭해 데이터베이스 관리 화면에 들어가세요.

2. 데이터베이스 관리자 도구 로그인

   ServBay의 기본 데이터베이스 root 계정 및 설치 과정에서 설정한 root 패스워드로 로그인하세요.

3. 새 데이터베이스 생성

   다음 절차로 데이터베이스를 만듭니다:

   • 왼쪽 사이드바 또는 메인 페이지에서 ‘새로 만들기(New)’ 혹은 ‘데이터베이스 생성(Create database)’ 메뉴를 찾으세요.
   • ‘데이터베이스 이름(Database name)’ 필드에 원하는 이름을 입력(예: servbay_wordpress_db)
   • 문자셋은 utf8mb4, 정렬(collation)은 utf8mb4_unicode_ci로 설정. 이는 이모지 등 다양한 문자를 지원하기 위한 WordPress 권장 설정입니다.
   • ‘생성(Create)’ 버튼을 클릭하세요.

4. 데이터베이스 전용 사용자 생성 및 권한 부여

   보안을 위해 WordPress 전용 사용자 계정을 만들고 해당 데이터베이스에만 권한을 부여하는 것이 좋습니다.

   • 데이터베이스 관리 도구에서 ‘사용자 계정(User accounts)’ 페이지로 이동
   • ‘사용자 계정 추가(Add user account)’를 클릭
   • 사용자 정보 입력:
     • 사용자 이름(User name): wordpress_user
     • 호스트명(Host name): localhost 선택 또는 직접 입력
     • 비밀번호(Password): 강력한 패스워드 입력(예: your_strong_password_here). 절대 password123 등 약한 비밀번호 사용 금지! 안전한 비밀번호 생성기를 활용해 복잡한 패스워드를 사용하세요. 이 패스워드는 기록해 두었다가 다음 과정에서 사용합니다.
     • 다시 입력(Re-type): 비밀번호 재입력
   • 중요: ‘글로벌 권한(Global privileges)’에서 ‘전체 선택(Check All)’이나 ‘모든 권한 부여(Grant all privileges)’는 체크하지 않습니다. 오직 특정 데이터베이스에만 권한을 줄 것입니다.
   • 맨 아래의 ‘실행(Go)’ 혹은 ‘사용자 추가(Add user)’ 버튼 클릭

   사용자를 만든 후, 다음 절차로 권한을 부여하세요:

   • ‘사용자 계정(User accounts)’ 페이지에서 방금 만든 wordpress_user@localhost의 ‘권한 편집(Edit privileges)’ 클릭
   • ‘특정 데이터베이스 권한(Database-specific privileges)’ 부분으로 이동
   • ‘다음 데이터베이스에 권한 추가(Add privileges to the following database)’ 드롭다운에서 앞서 만든 servbay_wordpress_db를 선택
   • ‘실행(Go)’ 클릭
   • 새 화면에서 ‘전체 선택(Check All)’을 체크해 해당 데이터베이스의 모든 권한(데이터, 구조, 관리권한)을 할당
   • 아래의 ‘실행(Go)’ 버튼을 눌러 변경을 저장하세요

3단계: ServBay에서 사이트 설정

이제 ServBay에 WordPress 사이트의 도메인 요청을 올바른 파일 디렉터리로 연결하는 과정을 진행합니다.

1. ServBay 애플리케이션 실행

   ServBay를 시작하세요.

2. 새 웹사이트 설정 추가

   ServBay 인터페이스에서 사이드바의 ‘웹사이트(Websites)’ 탭 클릭 → 좌측 하단 ‘+’ 버튼 클릭 → ‘웹사이트 추가(Add Website)’ 선택

3. 사이트 정보 입력

   팝업 창에 다음 정보를 입력하세요:

   • 이름(Name): 예) ServBay WordPress Dev (식별하기 쉬운 이름)
   • 도메인(Domain): 로컬에서 접속할 도메인 주소(예: servbay-wordpress.demo). ServBay가 자동으로 이 도메인을 설정하고 로컬 접속을 허용합니다.
   • 사이트 유형(Site Type): PHP 선택
   • PHP 버전(PHP Version): 드롭다운 메뉴에서 WordPress에 적합한 버전 선택(최신 안정 버전, PHP 8.x 권장)
   • 웹사이트 루트(Site Root): 폴더 아이콘 클릭 또는 수동 입력으로 WordPress가 있는 경로, 즉 /Applications/ServBay/www/servbay-wordpress-app 선택

4. 설정 저장

   입력 후 ‘저장(Save)’ 클릭. ServBay가 새로운 설정을 적용하며, 웹 서버 패키지 재시작이 필요하다고 알릴 수 있습니다. 안내에 따라 재시작해 주세요.

   ServBay의 자동화 설정 덕분에, servbay-wordpress.demo 접속 시 로컬 신뢰 SSL 인증서가 자동 생성 및 적용되어 HTTPS 보안 접속이 가능합니다.

4단계: WordPress 설치 마법사 완료

이제 데이터베이스와 사이트 설정이 끝났습니다. 마지막으로 웹 브라우저에서 로컬 도메인으로 접속해 WordPress 설치 마법사를 진행하세요.

1. 로컬 WordPress 사이트 접속

   웹 브라우저 주소창에 앞서 설정한 도메인(예: https://servbay-wordpress.demo)을 입력하세요.

2. WordPress 설치 마법사 시작

   모든 설정이 정상이라면, WordPress 환영 페이지가 보이고 언어 선택 화면이 나타납니다. 언어를 선택한 뒤 ‘계속’을 클릭하세요.

3. 데이터베이스 접속 정보 입력

   다음 화면에서 앞 단계에서 생성한 데이터베이스 정보들을 입력합니다:

   • 데이터베이스명(Database Name): servbay_wordpress_db
   • 사용자명(Username): wordpress_user
   • 비밀번호(Password): your_strong_password_here (2.4단계에서 설정한 실제 비밀번호 사용)
   • 데이터베이스 호스트(Database Host): localhost
   • 테이블 접두사(Table Prefix): wp_ (기본값 / 보안상 원하면 sbwp_ 등으로 변경 가능)

   ‘제출(Submit)’을 클릭하세요. 연결이 성공하면 WordPress에서 설치를 안내합니다.

4. 설치 실행

   ‘설치 실행(Run the installation)’ 버튼 클릭

5. 사이트 정보 입력

   사이트 기본 정보를 입력합니다:

   • 사이트 제목(Site Title): 웹사이트 명칭
   • 사용자명(Username): WordPress 관리자 계정의 사용자명(admin 사용 권장하지 않음, 고유한 이름 사용 추천)
   • 비밀번호(Password): 관리자 계정 비밀번호. WordPress가 강한 비밀번호 사용을 권장하니 반드시 복잡한 비밀번호를 설정하세요.
   • 이메일(Your Email): 본인의 이메일 주소
   • 검색 엔진 노출(Search Engine Visibility): 로컬 개발용 사이트면 ‘검색 엔진이 사이트 색인을 하지 않도록 요청’에 체크하여 본의 아니게 노출되는 것을 막으세요.

6. 설치 완료

   모두 입력했으면 ‘WordPress 설치’ 버튼을 클릭. WordPress가 자동으로 설치를 완료합니다.

   설치가 성공하면 완료 안내와 함께 관리자 로그인 링크가 표시됩니다.

WordPress로 사이트 만들기

축하합니다! ServBay 로컬 환경에 WordPress를 성공적으로 설치하고 설정했습니다. 이제 WordPress의 강력한 기능을 활용해 자유롭게 사이트를 만들 수 있습니다.

WordPress 관리자 패널(대개 https://servbay-wordpress.demo/wp-admin/)에 로그인하면 다음과 같은 기본 작업이 가능합니다:

• 테마 및 플러그인 설치: ‘외모’→‘테마’ 및 ‘플러그인’→‘플러그인 추가’에서 사이트 모양과 기능을 쉽게 확장할 수 있습니다. ServBay의 로컬 환경에서는 다양한 테마와 플러그인을 안전하게 실험할 수 있습니다.
• 콘텐츠 작성 및 관리: ‘글’ 및 ‘페이지’ 메뉴에서 블로그 게시물이나 정적 페이지 작성 가능
• 메뉴 구성: ‘외모’→‘메뉴’에서 사이트 내비게이션 메뉴 구성
• 사이트 디자인 및 커스터마이징: ‘외모’→‘커스터마이즈’ 또는 테마 옵션을 활용해 사이트 레이아웃과 스타일을 변경할 수 있습니다.

자주 묻는 질문 (FAQ)

• Q: https://servbay-wordpress.demo에 접속되지 않습니다. 어떻게 해야 하나요?

  • A: ServBay가 실행 중이며, 웹 서버(Caddy/Nginx) 및 PHP 패키지도 정상 동작 중인지 확인해 주세요.
  • ServBay 내 ‘웹사이트’ 설정에서 도메인 철자, 루트 디렉토리(/Applications/ServBay/www/servbay-wordpress-app) 경로, PHP 버전을 재검토 하세요.
  • 브라우저 캐시를 지우거나 시크릿 모드로 접속해 보세요.
  • macOS 방화벽 설정이 로컬 접속을 막는지 점검 필요

• Q: WordPress 설치 중 데이터베이스 연결 에러가 납니다.

  • A: 설치 마법사에 입력한 데이터베이스 이름, 사용자명, 비밀번호, 데이터베이스 호스트(localhost)를 ServBay의 데이터베이스 관리도구에서 만든 값과 정확히 일치하는지 확인하세요.
  • ServBay의 MySQL 또는 MariaDB 데이터베이스 패키지가 정상적으로 실행되는지 확인하세요.
  • 생성한 데이터베이스 사용자가 해당 데이터베이스(servbay_wordpress_db)에 대한 권한을 가지고 있는지 확인하세요.

• Q: ServBay 한 번에 여러 개의 WordPress 사이트를 설치할 수 있나요?

  • A: 네, 가능합니다. WordPress 파일을 각각의 하위 폴더에 압축 해제하고, 각 사이트마다 별도의 데이터베이스와 사용자 생성, ServBay ‘웹사이트’에서 각기 다른 도메인과 루트 폴더로 신규 사이트를 추가해 주세요.

• Q: WordPress 개발 시 어떤 PHP 버전이 ServBay에서 사용 가능한가요?

  • A: ServBay는 다양한 PHP 버전을 지원합니다. WordPress 공식 권장 버전이나 프로젝트별 요구 사항에 따라 적합한 버전을 선택할 수 있습니다. 대체로 WordPress 권장 최신 호환 버전 사용을 권장합니다.

요약

이상으로 ServBay라는 강력한 로컬 개발 환경을 활용해 첫 번째 로컬 WordPress 사이트를 성공적으로 구축할 수 있습니다. ServBay의 통합 도구와 다중 버전 지원 기능을 통해 테마·플러그인 개발, 기능 테스트, 콘텐츠 관리 등을 효율적이고 유연하게 진행할 수 있습니다. 이 가이드가 여러분의 WordPress 개발 여정에 든든한 출발점이 되길 바랍니다!