ServBay

한국어

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย

한국어

English
简体中文
繁體中文
Español
العربية
Português
Русский
日本語
Deutsch
Français
Tiếng Việt
Türkçe
Italiano
हिन्दी
Bahasa Indonesia
Bahasa Melayu
Polski
Nederlands
Українська
ไทย

Appearance

첫 번째 웹사이트 추가하기 ​

ServBay에서 새로운 웹사이트를 추가해 로컬 개발 프로젝트를 시작하는 과정은 간단하고 직관적입니다. 본 문서에서는 ServBay에서 첫 번째 웹사이트를 추가하는 방법, 주요 설정 옵션, 몇 가지 유용한 팁을 자세히 소개합니다.

PHP, Node.js, 정적 웹사이트 개발은 물론 리버스 프록시 또는 리디렉션 설정이 필요한 경우에도 ServBay는 유연하게 지원합니다.

개요 ​

ServBay는 웹 개발자를 위한 강력하면서도 관리가 용이한 로컬 개발 환경을 제공합니다. 사용자 친화적인 그래픽 인터페이스(GUI)로 여러 로컬 웹사이트를 손쉽게 추가, 설정, 관리할 수 있습니다. 아래 절차에 따라 첫 번째 로컬 사이트를 빠르게 생성하고 프로젝트 요구사항에 맞게 다양한 옵션을 설정할 수 있습니다.

사전 준비 ​

웹사이트 추가를 시작하기 전에 다음을 확인하세요.

  • macOS 시스템에 ServBay 애플리케이션을 성공적으로 설치하고 실행했는지 확인하세요.

웹사이트 추가 절차 ​

다음은 ServBay GUI를 사용해 새 웹사이트를 추가하는 상세 단계입니다.

1단계: ServBay 애플리케이션 실행 ​

먼저, macOS 애플리케이션 폴더에서 ServBay 아이콘을 찾아 더블 클릭해 애플리케이션을 실행하세요.

2단계: 웹사이트 관리 화면으로 이동 ​

ServBay 앱이 실행되면 메인 화면이 보입니다. 왼쪽 내비게이션 메뉴에서 웹사이트 항목을 클릭하세요. 이 메뉴를 통해 ServBay의 웹사이트 관리 페이지로 이동할 수 있습니다.

웹사이트 관리로 이동

3단계: 새 웹사이트 추가 시작 ​

웹사이트 관리 페이지 좌측 하단에서 + 버튼을 찾아 클릭하세요. 클릭 후 우측 화면에 새 사이트의 설정 정보를 입력할 수 있는 신규 폼 영역이 열립니다.

플러스 아이콘 클릭하여 새 사이트 추가

4단계: 사이트 설정 구성 ​

새로 열린 사이트 설정 폼에서 아래의 주요 정보를 입력하거나 선택하세요.

  1. 이름: 로컬 사이트를 구분하기 쉬운 관리용 이름을 입력합니다. 이 값은 ServBay 내에서만 사용됩니다.
  2. 도메인: 로컬에서 접속할 사이트의 도메인을 입력합니다. 실제 도메인과의 충돌을 피하기 위해 .demo나 ServBay에서 제공하는 다른 로컬 최상위 도메인(TLD) 사용을 권장합니다(예: servbay.demo, myproject.servbay.demo). ServBay가 자동으로 로컬 DNS를 처리하여 지정한 도메인으로 브라우저 접근이 가능합니다.
  3. 프로토콜: 지원할 프로토콜을 선택하세요. 일반적으로 HTTP/HTTPS가 기본값이며, ServBay가 로컬 HTTPS 설정을 자동으로 처리합니다.
  4. SSL 인증서 요청 방식: 로컬 사이트의 SSL/TLS 암호화 방식을 설정합니다.
    • ServBay CA: 로컬 개발에 권장되는 방식입니다. ServBay 내부 PKI를 통해 자체 CA로부터 SSL 인증서를 자동 발급/관리합니다. 시스템에 ServBay 루트 인증서(ServBay User CA 혹은 ServBay Public CA)만 신뢰 추가하면 브라우저에서 경고 없이 HTTPS 접속이 가능합니다.
    • ACME: 운영 환경을 모사해야 한다면, ACME 프로토콜(Let's Encrypt, ZeroSSL, Google Trust Services 등)로 진짜 공신력 있는 인증서를 발급받을 수 있습니다. 단, 해당 도메인이 외부 접속이 가능하며 로컬 ServBay 인스턴스로 연결되어야 하며, 인증서 자동 발급/갱신을 지원합니다.
  5. 사이트 유형: 프로젝트 기술 스택에 따라 적합한 유형을 선택하세요.
    • PHP: 워드프레스, 라라벨, 심포니 등 PHP 기반 프로젝트용. ServBay가 Nginx/Apache와 PHP-FPM을 자동 연동해 처리합니다.
    • Node.js: Node.js 애플리케이션용. Web 요청이 프록시를 통해 Node.js 앱이 대기 중인 포트로 전송됩니다.
    • 정적: HTML, CSS, JS 등 정적 파일만 제공하는 사이트용. 웹서버가 파일 서빙을 담당합니다.
    • 리버스 프록시: 특정 도메인 또는 경로의 요청을 다른 로컬/원격 주소 및 포트로 전달할 수 있습니다. (서비스나 앱 프록시 등 활용)
    • 리디렉션: 사이트의 모든 요청을 다른 URL로 리디렉션합니다.
  6. PHP 버전: 사이트 유형으로 PHP를 선택했다면, 드롭다운에서 설치/실행 중인 PHP 버전을 선택해 사이트의 PHP 스크립트 실행을 지정해야 합니다. ServBay의 패키지 관리 화면에서 원하는 버전을 미리 설치해 두세요.
  7. URL 리라이트(가상경로) 규칙: 최신 웹 프레임워크/ CMS는 미려한 URL 구조(/about 등)를 위해 URL 리라이트가 필수입니다. ServBay는 (Laravel, WordPress, Discuz! 등) 주요 애플리케이션용 사전설정 리라이트 규칙을 제공하며, 목록에 없는 경우나 커스텀 규칙이 필요하다면 웹서버(Nginx/Apache) 설정 파일을 수동 편집해야 할 수 있습니다.
  8. 루트 디렉토리: 사이트 파일의 실제 경로를 지정합니다. 웹서버가 파일 제공을 시작하는 기준 경로로, 프로젝트 파일을 ServBay의 기본 www 폴더(예: /Applications/ServBay/www/servbay-demo)에 저장하는 것을 추천합니다. 해당 디렉토리가 존재하며 ServBay 프로세스가 읽기 권한을 갖는지도 확인하세요.

WARNING

프레임워크(예: 라라벨) 기반 개발자는 반드시 루트 디렉토리를 프로젝트 폴더의 최상위가 아니라, index.php가 포함된 public 디렉토리 등 웹진입점 디렉토리로 지정해야 정상 동작합니다.

사이트 설정 구성

5단계: 사이트 저장 및 활성화 ​

모든 설정을 입력 및 확인한 후 폼 하단의 추가 버튼을 클릭하세요. ServBay가 자동으로 설정을 생성해 웹서버(Nginx/Apache 등)에 적용하고, 로컬 DNS도 업데이트합니다.

저장에 성공하면 새 사이트가 목록에 보이며, 우상단의 브라우저 아이콘을 클릭해 즉시 사이트를 방문할 수 있습니다.

6단계: 빠른 작업으로 사이트 관리 ​

사이트 빠른 작업

ServBay는 각 사이트마다 다양한 빠른 작업 버튼을 제공해 로컬 개발 워크플로우를 효율적으로 관리할 수 있습니다.

  1. IDE로 열기: 설정한 기본 코드 에디터/IDE에서 사이트 루트 디렉토리를 바로 엽니다.
  2. 브라우저로 열기: 기본 브라우저에서 사이트 URL을 바로 엽니다.
  3. 사이트 로그 보기: 연관 웹서버의 접근 로그와 에러 로그를 조회해 디버깅에 활용할 수 있습니다.
  4. 사이트 일시정지/재시작: 사이트 접근을 임시로 비활성화 또는 재활성화합니다.
  5. 사이트 삭제: ServBay 설정에서 사이트를 제거합니다. (실제 파일은 삭제되지 않음)

간단 예제: 정적 HTML 웹사이트 만들기 ​

첫 번째 사이트를 정상적으로 세팅했는지 확인하려면 아래와 같이 간단한 테스트를 해볼 수 있습니다.

  1. 위의 과정을 참고해 새 사이트를 추가합니다. 예: 도메인 servbay.demo, 사이트 유형 정적, 루트 디렉토리 /Applications/ServBay/www/servbay-demo-static로 입력.

  2. 파일 시스템에서 /Applications/ServBay/www/servbay-demo-static 폴더를 생성합니다.

  3. 해당 폴더에 index.html 파일을 만듭니다.

  4. 텍스트 에디터로 index.html을 열어, 다음 간단한 HTML 코드를 입력하세요.

    html
    <!DOCTYPE html>
<html>
<head>
    <title>ServBay Static Test</title>
</head>
<body>
    <h1>축하합니다! ServBay에서 첫 번째 웹사이트가 성공적으로 실행되었습니다!</h1>
    <p>이 페이지가 보인다면, ServBay가 정상적으로 정적 사이트를 구성 및 제공 중임을 뜻합니다.</p>
</body>
</html>

  5. index.html 파일을 저장합니다.

  6. ServBay의 사이트 관리 화면으로 돌아가, 방금 추가한 servbay.demo 사이트에서 브라우저 아이콘을 클릭하세요.

  7. 브라우저가 http://servbay.demo(또는 SSL 설정에 따라 https://servbay.demo) URL을 열고, 방금 만든 페이지의 내용을 표시하면 성공입니다.

유의 사항 ​

  • 도메인 충돌: 로컬 네트워크 또는 VPN과 충돌할 수 있는 도메인 사용은 피하세요. .demo 사용을 추천합니다.
  • 루트 디렉토리 권한: ServBay 실행 사용자(일반적으로 내 계정)이 사이트 루트 및 하위 파일에 대한 읽기 권한을 갖고 있는지 반드시 확인하세요.
  • 포트 점유: ServBay는 기본적으로 표준 포트(HTTP 80, HTTPS 443)를 사용합니다. 해당 포트를 다른 프로그램이 점유 중이면 웹서버 구동이나 사이트 접근에 문제가 발생할 수 있습니다. 불필요한 포트 점유 프로그램을 확인/종료 바랍니다.
  • ServBay CA 신뢰: ServBay CA를 써서 HTTPS 경고 없이 접근하려면, macOS 인증서 저장소에서 ServBay User CA 또는 ServBay Public CA를 신뢰함으로 추가해야 합니다. 관련 내용은 ServBay 문서를 참고하세요.

자주 묻는 질문 (FAQ) ​

  • Q: 사이트 접속 시 HTTP Error 403 - Forbidden 또는 HTTP Error 404 - File not found 오류가 나옵니다.
    • A: 개발자가 가장 자주 접하는 오류입니다.
    • 우선 사이트 루트 디렉토리가 올바르게 지정됐는지 확인하세요. 현대 프레임워크(Laravel, Symfony, CakePHP 등)에서는 프로젝트 루트(보통 vendor, composer.json, package.json 등이 있는 곳)가 웹사이트 루트/실제 접근 진입점이 아닙니다.
    • 사이트의 루트 디렉토리를 실제 진입 파일(index.php, index.htm, index.html 등)이 들어있는 디렉토리로 정확히 지정해야 합니다.
    • 주요 진입 디렉토리 예시: public, web, www, htdocs, wwwroot, webroot 등.
  • Q: 사이트를 추가했으나, 브라우저에서 도메인 접속 시 "사이트를 찾을 수 없음" 또는 "연결이 거부되었습니다" 등 오류가 나옵니다.
    • A: ServBay가 실행 중인지, 그리고 웹서버(Caddy/Nginx/Apache) 상태가 정상인지(ServBay 메인화면에서 확인) 점검하세요.
    • 브라우저에 입력한 도메인과 ServBay에 설정한 도메인이 정확히 일치하는지 확인하세요.
    • ServBay의 사이트 목록에서 해당 사이트가 “실행 중(활성)” 상태인지(일시정지 아님) 확인하세요.
    • 사이트 루트 경로가 올바르며, 해당 폴더에 진입 파일(index.html, index.php 등)이 있는지 확인하세요.
    • 80 또는 443 포트를 다른 프로그램이 차지하고 있는지도 확인하세요.
  • Q: PHP 사이트가 정상 동작하지 않고 빈 화면이 뜨거나 파일이 다운로드됩니다.
    • A: 사이트 설정에서 올바른 PHP 버전을 선택했는지, 해당 PHP 버전이 ServBay 패키지 관리로 설치 및 실행 중인지 확인하세요.
    • 사이트 루트 폴더 및 파일 권한을 점검하세요.
    • 빠른 작업 버튼을 통해 사이트 로그에 PHP 오류가 있는지 확인하세요.
    • 프로젝트에 index.php 등 ServBay가 기본 인덱스 파일로 지정한 파일이 있는지도 점검하세요.
  • Q: HTTPS를 설정했는데, 브라우저에서 인증서 경고가 표시됩니다.
    • A: ServBay CA를 쓸 경우, OS 혹은 브라우저에 ServBay의 루트 인증서를 신뢰로 추가해야 합니다. ServBay 공식 문서에서 해당 방법을 확인하세요.
    • ACME 사용 시, 도메인이 제대로 ServBay 인스턴스에 연결돼 있고 인증서가 정상 발급/설치됐는지 확인하세요. ACME 신청 관련 상세 내용은 ServBay 로그를 참고하세요.
  • Q: URL 리라이트 규칙이 반영되지 않아 페이지 접근이 안 됩니다.
    • A: 사이트 설정에서 프레임워크나 애플리케이션에 맞는 URL 리라이트 규칙을 선택했는지 확인하세요.
    • Apache를 사용할 경우, .htaccess 파일이 사이트 루트나 하위 폴더에 존재하며, ServBay의 Apache 설정이 .htaccess를 읽을 수 있도록 허용돼 있는지 확인하세요.
    • Nginx, Caddy 등은 리라이트 규칙이 ServBay가 생성한 설정 파일 내 적용되므로, 규칙이 정상 로드됐는지 점검하세요.

요약 ​

이 문서의 절차를 따르면 ServBay 로컬 개발 환경에 성공적으로 첫 번째 웹사이트를 추가하고 실행할 수 있습니다. ServBay의 강력한 사이트 관리 기능, 유연한 구성 옵션(SSL 인증서, 사이트 유형, PHP 버전, URL 리라이트 등), 그리고 편리한 빠른 작업 버튼은 로컬 개발 효율을 획기적으로 높여줍니다. 패키지 관리, 데이터베이스 관리 등 ServBay의 다양한 기능도 함께 활용하며 더욱 완벽한 로컬 개발 워크플로우를 구성해 보세요.