자주 묻는 질문(FAQ)

이 문서는 ServBay 로컬 웹 개발 환경 사용 시 자주 접하게 되는 질문과 그에 대한 답변을 모았습니다.

ServBay란 무엇인가요?

ServBay는 macOS와 Windows 개발자를 위해 각종 웹 서버, 데이터베이스, 프로그래밍 언어 환경 등의 설치와 관리를 통합적으로 지원하는 로컬 웹 개발 환경 관리 도구입니다. 자세한 내용은 ServBay 소개 페이지를 참고하세요.

ServBay는 어떻게 설치하나요?

ServBay 공식 웹사이트에서 설치 프로그램을 다운로드하여 설치 안내에 따라 진행하면 됩니다. 자세한 설치 방법은 ServBay 설치 문서를 참고하세요.

ServBay는 어떻게 삭제하나요?

macOS:
ServBay 앱을 휴지통으로 드래그하여 옮긴 뒤, 휴지통을 비우면 삭제가 완료됩니다.

Windows:
Windows의 '프로그램 및 기능' 또는 '앱 및 기능'에서 ServBay를 찾아 삭제하거나, 설치 프로그램의 제거 기능을 이용할 수 있습니다.

삭제하기 전에 반드시 중요한 데이터를 백업하세요. 삭제 시 관련 파일과 설정이 모두 삭제됩니다. 자세한 내용은 ServBay 삭제 문서를 참고하세요.

ServBay는 자동 업데이트를 지원하나요?

네, ServBay는 자동 업데이트 기능을 지원하여 최신 버전, 신규 기능 및 보안 패치를 손쉽게 받을 수 있습니다. ServBay 업그레이드 문서를 참고하세요.

ServBay는 Windows/Linux도 지원하나요?

ServBay는 macOS와 Windows 운영체제를 지원합니다. Linux 버전은 현재 개발 중이며, 가까운 시일 내에 제공될 예정입니다.

ServBay에서 지원하는 언어는 무엇인가요?

ServBay는 영어, 간체/번체 중국어, 스페인어, 아랍어, 포르투갈어, 러시아어, 일본어, 독일어, 프랑스어, 베트남어, 터키어, 이탈리아어 등 다양한 UI 언어를 제공합니다. ServBay 설정에서 원하는 언어로 쉽게 변경할 수 있습니다. 자세한 방법은 다국어 지원 문서를 참고하세요.

ServBay에서 데이터 백업은 어떻게 하나요?

ServBay는 설정, 사이트 파일, 데이터베이스 내용, SSL 인증서 등 주요 개발환경 데이터를 수동 및 자동으로 백업할 수 있으며, 내장 백업 도구를 제공합니다. 수동으로 전체 설치 폴더(macOS: /Applications/ServBay, Windows: C:\ServBay)를 백업할 수도 있습니다. 자세한 백업 및 복원 방법은 수동 및 자동 데이터 백업 문서를 참고하세요.

ServBay에서 지원하는 소프트웨어 패키지는 무엇인가요?

ServBay는 Caddy, NGINX, Apache, Mailpit, dnsmasq, 다양한 버전의 PHP, Node.js, Python, Golang, Java, Ruby, Rust, .NET, MySQL, MariaDB, PostgreSQL, MongoDB, Redis, Memcached 등 웹 개발에 필요한 주요 패키지를 폭넓게 지원합니다. 손쉽게 패키지를 관리 및 설정할 수 있습니다. 자세한 관리 방법은 패키지 관리 문서를 참고하세요.

ServBay의 릴리즈 노트는 어디에서 확인하나요?

릴리즈 노트 페이지에서 ServBay의 최신 업데이트 내역을 볼 수 있습니다. 새로운 기능, 개선 사항, 버그 수정 등이 정기적으로 업로드됩니다.

PHP 여러 버전을 동시에 사용할 수 있나요?

네, ServBay의 핵심 기능 중 하나는 여러 PHP 버전을 동시에 설치하고 운용할 수 있다는 점입니다. 각 사이트마다 다른 PHP 버전을 선택해 개별적으로 관리할 수 있습니다. 다양한 프로젝트 요구에 맞게 효율적으로 작업할 수 있습니다. 자세한 내용은 첫 번째 사이트 추가와 PHP로 개발하기를 참고하세요.

ServBay로 Laravel, WordPress 등 프레임워크와 CMS를 지원하나요?

네, ServBay는 Laravel, WordPress, Symfony, CodeIgniter, Joomla, Drupal 등 최신 PHP 프레임워크와 CMS를 완벽 지원합니다. 손쉽게 사이트 구축 및 실행이 가능합니다. 자세한 설정과 사용법은 PHP로 개발하기 문서를 참고하세요.

ServBay로 Vue, React, Next.js, Nuxt.js 등 프레임워크 및 CMS를 지원하나요?

네, ServBay는 Vue, React, Angular, Next.js, Nuxt.js, Express.js, Hapi.js 등 다양한 Node.js 기반 자바스크립트, 타입스크립트 프레임워크와 라이브러리를 지원합니다. Node.js 버전 관리 및 프론트엔드/백엔드 프로젝트 실행이 가능합니다. 자세한 안내는 Node.js로 개발하기 문서를 참고하세요.

사이트를 추가하는 방법은?

ServBay의 그래픽 인터페이스를 통해 사이트의 루트 디렉터리, 도메인, 웹 서버 및 PHP/Node.js 버전 등 주요 설정을 쉽고 빠르게 지정할 수 있습니다. 첫 번째 사이트 추가 문서에서 자세한 절차를 확인하세요.

커스텀 도메인과 SSL 인증서를 ServBay에서 어떻게 지원하나요?

ServBay는 로컬 개발 및 테스트를 위한 최적의 네트워크 솔루션을 제공합니다. 자체 DNS 서비스를 통해 예를 들어 servbay.demo 또는 yourproject.servbay.demo 등 원하는 커스텀 도메인을 자유롭게 설정할 수 있고, 내장 프라이빗 CA(ServBay User CA) 및 퍼블릭 CA(ServBay Public CA)를 이용해 SSL 인증서를 발급·신뢰하여 HTTPS를 구현, 실환경과 유사하게 개발할 수 있습니다. 자세한 내용은 비표준 최상위 도메인(TLDs) 사이트 추가 및 SSL(HTTPS)로 사이트 보안 강화를 참고하세요.

ServBay에서 커스텀 도메인을 사용할 수 있나요?

네, ServBay에서는 .test, .local, .servbay.demo 등 다양한 커스텀 최상위 도메인(TLD)을 로컬 개발에 사용할 수 있습니다. 사이트별로 도메인을 지정하여 웹 브라우저에서 쉽게 접근할 수 있습니다. 자세한 설정 방법은 비표준 최상위 도메인(TLDs) 사이트 추가를 참고하세요.

ServBay에서 사이트에 HTTPS를 어떻게 설정하나요?

ServBay의 사이트 관리 화면에서 간편하게 HTTPS를 활성화할 수 있습니다. ServBay User CA 또는 ServBay Public CA로 신뢰할 수 있는 로컬 인증서를 발급하고, ACME 프로토콜(ex. Let's Encrypt, ZeroSSL)을 통해 외부에서 신뢰하는 SSL 인증서도 신청 가능하며, 보유 중인 인증서도 임포트할 수 있습니다. 자세한 안내는 SSL(HTTPS)로 사이트 보안 강화, ACME 방식으로 SSL 인증서 발급, Let's Encrypt로 SSL 인증서 신청, ZeroSSL로 SSL 인증서 신청, Google Trust Services로 SSL 인증서 신청 문서를 참고하세요.

ServBay는 NGINX, Apache 등 다양한 웹 서버를 지원하나요?

네, ServBay는 개발을 위한 여러 주요 웹 서버를 기본적으로 제공합니다. Caddy, NGINX, Apache 등에서 원하는 서버를 선택할 수 있습니다. 기본 웹 서버 설정 방법 문서를 참고해 주세요.

ServBay로 몇 개의 사이트를 만들 수 있나요?

ServBay 버전에 따라 생성 가능한 사이트 수가 다릅니다:

• ServBay Free : 3개 사이트까지 생성 가능
• 회원등록(무료) : 최대 5개 사이트 생성 가능
• ServBay Pro, ServBay Team : 무제한 사이트 생성 가능
  사이트 관리 화면에서 사이트를 추가·설정할 수 있습니다.

데이터베이스 관리는 어떻게 하나요?

ServBay는 MySQL, MariaDB, PostgreSQL, MongoDB 관리에 최적화된 도구를 제공합니다. 내장 phpMyAdmin과 Adminer로 웹에서 데이터베이스를 손쉽게 관리할 수 있습니다. 연결 정보 및 상세 가이드는 ‘데이터베이스 관리’ 섹션을 참고하세요.

커맨드라인 도구는 어떻게 사용하나요?

ServBay는 패키지 관리, 환경 전환, PHP 모듈 컴파일 등 고급 작업과 자동화를 위한 커맨드라인 도구를 제공합니다. servbayctl 도구로 로컬 개발 환경을 유연하게 제어할 수 있습니다. 더 자세한 커맨드라인 기능 사용법은 커맨드라인 지원, servbayctl 커맨드라인 도구 문서를 참고하세요.

기본 패키지 버전 설정은 어떻게 하나요?

ServBay는 PHP, Python, Java, Go, Ruby, Rust, Node.js, MariaDB, PostgreSQL 등 주요 패키지의 커맨드라인 기본 버전을 설정할 수 있습니다. 터미널이나 스크립트에서 php, node, mysql 등 명령을 실행시 원하는 버전을 지정할 수 있으며, 각 프로젝트별 .servbay.config 파일로 독립된 기본 버전을 설정할 수도 있습니다. 자세한 방법은 기본 버전 설정, servbay.config 사용법 문서를 참고하세요.

ServBay에서 패키지 설치 경로를 직접 설정할 수 있나요?

ServBay는 시스템의 관리 편의성과 안정성 확보를 위해 모든 패키지를 지정된 디렉터리 구조 내에 설치합니다:

• macOS: /Applications/ServBay
• Windows: C:\ServBay
  현재 각 패키지별로 설치 경로를 직접 설정하는 기능은 지원되지 않습니다.

ServBay는 다중 사용자 및 권한 관리 기능을 지원하나요?

ServBay는 현재 단일 사용자 로컬 개발 환경을 위한 도구로, 다중 계정이나 세분화된 권한 관리 기능을 제공하지 않습니다. 모든 서비스와 사이트는 현재 로그인된 사용자의 환경에서 실행됩니다.

각 서비스의 로그는 어디서 볼 수 있나요?

ServBay의 그래픽 인터페이스 패키지 관리 화면에서 각 서비스 우측 로그 아이콘을 클릭해 실시간 로그 파일을 열람할 수 있습니다. 서비스 오류 진단에 매우 유용합니다. 자세한 내용은 로그 파일 보기 문서를 참고하세요.

ServBay에서 PHP 설정을 변경하려면?

PHP 설정 변경은 다음 두 가지 방법을 제공합니다:

1. ServBay UI 사용: 강력한 그래픽 인터페이스에서 주요 PHP 설정값을 직접 수정 가능합니다(권장). 자세한 내용은 PHP 설정 변경 참고.
2. 설정 파일 수동 편집: PHP별 php.ini 파일( macOS: /Applications/ServBay/etc/php , Windows: C:\ServBay\etc\php)을 직접 편집할 수 있습니다. 변경 후 ServBay에서 해당 PHP 서비스를 재시작해야 적용됩니다. 설정 파일 보기 문서에서 자세한 정보를 확인하세요.

MySQL/MariaDB의 기본 root 계정과 비밀번호는?

ServBay는 MySQL 및 MariaDB 시작 시 기본 root 계정과 비밀번호를 자동 설정합니다. 해당 정보는 ServBay 데이터베이스 관리 문서에서 확인할 수 있습니다. 데이터베이스 root 계정 및 연결 정보 문서에서 상세 내용 및 비밀번호 초기화 방법을 확인하세요.

PostgreSQL의 기본 관리자 계정과 비밀번호는?

MySQL/MariaDB와 동일하게, ServBay는 PostgreSQL 역시 기본 관리자 계정 및 비밀번호를 자동 설정합니다. 데이터베이스 root 계정 및 연결 정보 문서에서 자세한 정보와 비밀번호 초기화 방법을 확인할 수 있습니다.

각 프로젝트별로 개발 언어 버전을 다르게 지정할 수 있나요?

네, ServBay는 프로젝트별 환경 분리 기능을 제공합니다. 프로젝트 루트 디렉토리에 .servbay.config 파일을 두면 PHP, Node.js, Python, Go, Java 등 개발 언어 버전을 각 프로젝트마다 독립적으로 지정할 수 있고 환경 변수도 설정할 수 있습니다. 예컨대, A 프로젝트는 PHP 8.3, Node.js 22로, B 프로젝트는 PHP 8.1, Node.js 18로 각각 지정하여 서로 간섭 없이 안정적으로 개발 환경을 관리할 수 있습니다.