자주 묻는 질문 (FAQ)
이 문서는 ServBay 로컬 웹 개발 환경을 사용하는 중에 자주 접하게 되는 질문과 그에 대한 답변을 모았습니다.
ServBay란 무엇인가요?
ServBay는 macOS에서 웹 서버, 데이터베이스, 프로그래밍 언어 환경 등 각종 소프트웨어 패키지의 설치 및 관리를 쉽고 효율적으로 할 수 있도록 설계된 통합 로컬 웹 개발 환경 관리 도구입니다. 자세한 내용은 ServBay 소개를 참고하세요.
ServBay는 어떻게 설치하나요?
ServBay 공식 웹사이트에서 설치 파일을 다운로드한 뒤, 설치 마법사의 안내에 따라 설치를 진행하시면 됩니다. 자세한 설치 방법은 ServBay 설치 문서를 참조하세요.
ServBay는 어떻게 제거하나요?
macOS에서는 ServBay 앱을 그냥 ‘휴지통’으로 드래그한 후, 휴지통을 비우면 ServBay가 제거됩니다. 삭제 전에 모든 중요한 데이터를 반드시 백업하세요. 이 작업은 ServBay의 모든 관련 파일과 설정을 삭제합니다. 자세한 사항은 ServBay 제거 문서를 참고하세요.
ServBay는 자동 업데이트를 지원하나요?
네, ServBay는 자동 업데이트 기능을 지원하여 최신 버전과 새로운 기능, 보안 패치를 손쉽게 받아볼 수 있습니다. 자세한 내용은 ServBay 업그레이드 문서를 참고하세요.
ServBay는 Windows/Linux를 지원하나요?
현재 ServBay는 macOS 운영체제만 지원합니다. Windows 및 Linux 버전은 개발 계획 중이니 앞으로의 업데이트를 기대해 주세요.
ServBay는 어떤 언어를 지원하나요?
ServBay는 영어, 간체 중국어, 번체 중국어, 스페인어, 아랍어, 포르투갈어, 러시아어, 일본어, 독일어, 프랑스어, 베트남어, 터키어, 이탈리아어 등 다양한 인터페이스 언어를 지원합니다. 설정에서 원하는 언어로 손쉽게 변경할 수 있습니다. 자세한 방법은 다국어 지원 문서를 참조하세요.
ServBay에서 데이터를 백업하는 방법은?
ServBay는 환경 데이터(설정, 웹사이트 파일, 데이터베이스, SSL 인증서 등)를 수동 및 자동 백업할 수 있습니다. /Applications/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의 릴리즈 노트는 어디서 보나요?
릴리즈 노트 페이지에서 ServBay의 최신 업데이트, 개선사항 및 버그 수정 내역 등 상세한 릴리즈 정보를 확인하실 수 있습니다.
여러 버전의 PHP를 동시에 실행할 수 있나요?
네, ServBay의 큰 강점 중 하나는 여러 개의 PHP 버전을 동시에 설치 및 실행할 수 있다는 점입니다. 각각의 웹사이트마다 독립적으로 PHP 버전을 지정할 수 있어, 다양한 프로젝트를 효율적으로 관리할 수 있습니다. 자세한 내용은 첫 번째 사이트 추가하기 및 PHP로 개발하기를 참고하세요.
ServBay는 Laravel, WordPress 등 프레임워크와 CMS를 지원하나요?
네, ServBay는 Laravel, WordPress, Symfony, CodeIgniter, Joomla, Drupal 등 대표적인 PHP 프레임워크 및 CMS를 완벽하게 지원합니다. ServBay에서 손쉽게 환경을 구축하고 실행할 수 있습니다. 설정 및 사용 방법은 PHP로 개발하기 문서를 참고하세요.
ServBay는 Vue, React, Next.js, Nuxt.js 등 프론트엔드 프레임워크와 CMS도 지원하나요?
네, ServBay는 Node.js 기반의 Vue, React, Angular, Next.js, Nuxt.js, Express.js, Hapi.js 등 주요 자바스크립트·타입스크립트 프레임워크 및 라이브러리를 지원합니다. ServBay에서 Node.js 버전 관리와, 프론트엔드 및 백엔드 자바스크립트 프로젝트 실행이 가능합니다. 자세한 튜토리얼은 Node.js로 개발하기 문서를 확인하세요.
웹사이트를 추가하는 방법은?
ServBay의 그래픽 인터페이스에서 웹사이트의 루트 경로, 도메인, 웹서버, PHP/Node.js 버전 등을 지정해 손쉽게 사이트를 추가할 수 있습니다. 상세한 과정은 첫 번째 사이트 추가하기 문서를 참고하세요.
ServBay에서 커스텀 도메인 및 SSL 인증서를 어떻게 설정하나요?
로컬 개발과 테스트의 편의를 위해 ServBay는 자체 DNS 서비스와, 내장 사용자용 CA(ServBay User CA), 퍼블릭 CA(ServBay Public CA)를 제공합니다. 이를 통해 servbay.demo, yourproject.servbay.demo와 같은 커스텀 도메인을 사용하고, 신뢰할 수 있는 SSL 인증서를 생성하여 HTTPS 환경도 쉽게 구축할 수 있습니다. 자세한 정보는 비표준 TLD 사이트 추가하기 및 SSL(HTTPS)로 사이트 보안 강화 문서를 참조하세요.
ServBay에서 맞춤 도메인을 사용할 수 있나요?
네, ServBay는 .test, .local, .servbay.demo 등 맞춤형(커스텀) 도메인 설정을 강력하게 지원합니다. 로컬 DNS 기능을 통해 프로젝트별로 유니크한 도메인을 지정할 수 있고, 해당 도메인으로 브라우저 접근도 가능합니다. 자세한 안내는 비표준 TLD 사이트 추가하기 문서를 참고하세요.
ServBay에서 HTTPS를 어떻게 활성화하나요?
웹사이트 관리 화면에서 손쉽게 로컬 사이트의 HTTPS를 켤 수 있습니다. ServBay의 내장 CA로 신뢰 인증서를 생성하거나, ACME 프로토콜(Let's Encrypt 및 ZeroSSL 등)로 실제 공개 인증서를 발급 받을 수도 있습니다. 기존 보유 인증서도 가져다 설정할 수 있습니다. 자세한 안내는 SSL(HTTPS)로 사이트 보안 강화, ACME 방식으로 SSL 인증서 발급, Let's Encrypt로 SSL 인증서 신청하기, ZeroSSL로 인증서 신청하기, Google Trust Services로 인증서 신청하기를 참고하세요.
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 내에 포함되어 있으며, 인터페이스에서 바로 접속할 수 있습니다. 자세한 연결, 사용법은 ‘데이터베이스 관리’ 장에서 확인하세요.
명령행 도구는 어떻게 사용하나요?
ServBay는 고급 작업 및 자동화를 지원하는 명령행 도구를 제공합니다. 패키지 관리, 환경 전환, PHP 모듈 빌드 등 다양한 작업을 servbayctl 명령으로 수행할 수 있습니다. 명령행 지원에 대한 자세한 정보는 명령행 지원, servbayctl 명령행 도구 문서를 참고하세요.
기본 패키지 버전은 어떻게 설정하나요?
PHP, Python, Java, Go, Ruby, Rust, Node.js, MariaDB, PostgreSQL 등 주요 패키지의 기본 사용 버전을 설정할 수 있습니다. 이는 터미널이나 스크립트에서 php, node, mysql 등 명령어를 실행할 때 원하는 버전이 기본 적용되도록 합니다. .servbay.config 파일을 활용하면 프로젝트별로도 버전 지정을 개별 설정할 수 있습니다. 자세한 방법은 기본 버전 설정, servbay.config 활용 문서를 확인하세요.
ServBay에서 패키지 설치 경로를 사용자 정의할 수 있나요?
ServBay는 시스템의 정돈성과 관리 비용을 줄이기 위해 모든 패키지를 특정 디렉터리 구조(대부분 /Applications/ServBay 내부)에 집중 설치합니다. 현재는 사용자가 각 패키지별 설치 경로를 직접 지정하는 것은 지원하지 않습니다.
ServBay는 다중 사용자 및 권한 관리를 지원하나요?
ServBay는 로컬 개발 환경의 단일 사용자 사용을 목표로 설계되어, 다중 사용자 계정이나, 세밀한 권한 관리는 지원하지 않습니다. 모든 서비스 및 웹사이트는 현재 로그인된 사용자의 환경에서만 동작합니다.
ServBay에서 각 서비스의 로그를 어떻게 확인하나요?
그래픽 인터페이스 내에서 각 서비스 패키지 오른쪽의 로그 아이콘을 클릭하면, 해당 패키지 실행 로그 파일을 쉽게 열람할 수 있습니다. 이 기능은 서비스 실행 오류 등 문제 발생시 진단에 유용합니다. 자세한 내용은 Log 파일 보기 문서를 참고하세요.
ServBay에서 PHP 설정을 어떻게 변경하나요?
PHP 설정은 다음 두 방법으로 변경할 수 있습니다:
- ServBay UI 사용: 주요 PHP 설정값을 그래픽 UI에서 바로 변경할 수 있어 가장 편리한 방법입니다. PHP 설정 변경 문서를 참고하세요.
- 설정 파일 직접 수정:
/Applications/ServBay/etc/php경로의 각 PHP 버전별php.ini파일을 직접 편집할 수도 있습니다. 변경 후에는 ServBay에서 해당 PHP 서비스를 재시작해야 적용됩니다. 자세한 매뉴얼은 설정 파일 보기 문서를 확인하세요.
MySQL/MariaDB의 기본 root 계정과 비밀번호는 무엇인가요?
설치 및 실행 시 ServBay는 MySQL 및 MariaDB의 root 계정 및 초기 비밀번호를 자동으로 지정합니다. 해당 정보는 데이터베이스 관리 관련 문서에서 확인할 수 있습니다. 데이터베이스 root 계정정보와 연결 방법 문서를 참고하세요. 비밀번호 재설정 방법도 포함되어 있습니다.
PostgreSQL의 기본 root 계정과 비밀번호는 무엇인가요?
MySQL/MariaDB와 마찬가지로, PostgreSQL도 ServBay가 기본 관리자 계정과 비밀번호를 지정합니다. 자세한 정보는 데이터베이스 root 계정정보와 연결 방법 문서를 참고하세요.
ServBay에서 프로젝트별로 다양한 개발 언어 버전을 사용할 수 있나요?
네, ServBay는 강력한 프로젝트 레벨 실행환경 구성 기능을 제공합니다. 각 프로젝트의 루트에 .servbay.config 파일을 두면, PHP, Node.js, Python, Go, Java 등 다양한 언어 버전을 프로젝트별로 따로 지정할 수 있고, 환경 변수도 별도로 설정할 수 있습니다. 예를 들어 프로젝트 A에는 PHP 8.3, Node.js 22를, 프로젝트 B에는 PHP 8.1, Node.js 18을 적용하는 식의 프로젝트별 완전한 환경 격리가 가능해 개발 효율성 및 안정성이 크게 향상됩니다.