ServBay의 DNS 서비스(dnsmasq) 설정하기
ServBay는 내장된 dnsmasq 서비스를 활용하여 개발자에게 강력하고 유연한 로컬 DNS 해석 기능을 제공합니다. 이는 .servbay.demo와 같은 로컬 개발 도메인 관리는 물론, 기타 DNS 요청의 포워딩을 제어하는 데 필수적입니다.
이 문서에서는 ServBay에서 dnsmasq를 구성하는 방법을 자세히 설명하며, 권장되는 사용자 인터페이스를 통한 설정과 관련 구성 파일의 위치를 안내합니다.
중요 안내
ServBay는 dnsmasq의 구성 파일(dnsmasq.conf와 domains.conf 등)을 자동으로 관리합니다. 이 파일들을 직접 수동으로 수정하지 마세요. ServBay는 사용자 인터페이스 설정이나 내부 로직에 따라 이 파일들을 정기적으로 업데이트 및 덮어쓰기 하므로, 수동으로 변경한 내용이 사라지거나 예기치 못한 동작이 발생할 수 있습니다.
권장되는 모든 dnsmasq 설정은 ServBay의 사용자 인터페이스를 통해 진행해야 합니다.
dnsmasq 구성 파일 위치(ServBay 관리)
ServBay가 자동으로 생성하는 dnsmasq 구성 파일은 /Applications/ServBay/etc/dnsmasq 디렉터리에 위치합니다. 이러한 파일 위치를 알아두면 ServBay가 DNS를 어떻게 관리하는지 이해하는 데 도움이 되지만, 직접 수정하지 않아야 합니다.
dnsmasq.conf: ServBay가 전체 설정값을 바탕으로 자동 생성하는 메인 구성 파일입니다.domains.conf: ServBay에서 관리하는 파일로, 사용자 인터페이스를 통해 추가한 로컬 도메인 해석 레코드가 저장됩니다.
ServBay 사용자 인터페이스로 dnsmasq 설정하기
ServBay는 dnsmasq의 주요 설정을 직관적으로 관리할 수 있는 사용자 인터페이스를 제공합니다.
상위 DNS 서버 설정
상위 DNS 서버를 지정하면, ServBay에서 로컬로 해석할 수 없는 도메인(즉, ServBay에 등록된 개발 도메인이 아닌 요청)에 대해 dnsmasq가 어떻게 처리할지 제어할 수 있습니다. 이런 요청들은 지정한 상위 DNS 서버로 포워딩되어 해석됩니다.
- ServBay 관리 인터페이스를 엽니다.
- 상단 메뉴 바에서
설정을 클릭합니다. DNS 포워딩탭을 선택합니다.- 이 화면에서 상위 DNS 서버 주소를 추가, 수정하거나 삭제할 수 있습니다.
기본적으로 ServBay는 현재 네트워크 환경(대개 DHCP로 자동 할당)에 따라 상위 DNS 서버 주소(예: 192.168.0.1 또는 10.0.0.1)를 자동으로 가져옵니다. 원하면 Google DNS(8.8.8.8/8.8.4.4), Cloudflare DNS(1.1.1.1/1.0.0.1)와 같은 공개 DNS 서비스나, 다른 내부 DNS 서버로도 변경할 수 있습니다.
로컬 도메인 네임 해석 관리
ServBay에서는 로컬 개발 프로젝트를 위해 원하는 도메인을 손쉽게 추가하고, 이를 로컬 IP 주소(일반적으로 127.0.0.1)에 연결해 해석할 수 있습니다. 이 설정은 자동으로 domains.conf 파일에 반영됩니다.
예를 들어, myproject.servbay.demo를 127.0.0.1로 지정하면, 브라우저에서 해당 도메인으로 로컬 프로젝트에 접근할 수 있습니다.
로컬 도메인 네임 해석 관리에 대한 자세한 방법은 아래 문서를 참고하세요.
참고: [로컬 DNS 서비스 관리하기](../../basic-usage/dns/manage-local-dns-service.md) 문서에서 안내하는 방법이 로컬 도메인 네임 해석을 위한 정확하고 권장되는 방식입니다. domains.conf 파일을 직접 수정하지 마세요.
dnsmasq 서비스 재시작
ServBay 사용자 인터페이스에서 상위 DNS나 로컬 도메인 추가 등 dnsmasq 설정을 변경했다면, 변경 사항을 반영하기 위해 dnsmasq 서비스를 재시작해야 합니다.
ServBay 관리 화면 또는 servbayctl 명령줄 도구로 dnsmasq를 재시작할 수 있습니다.
ServBay 관리 인터페이스에서 재시작
- ServBay 관리 화면을 엽니다.
- 좌측 네비게이션 메뉴에서
패키지를 클릭합니다. - 패키지 리스트에서
dnsmasq를 찾아 옆의재시작버튼을 클릭합니다.
servbayctl 커맨드라인 도구로 재시작
터미널 앱을 열고 아래와 같이 servbayctl 명령을 사용하면 dnsmasq 서비스를 손쉽게 재시작할 수 있습니다.
bash
servbayctl restart dnsmasq -all-all 옵션은 관련 의존 서비스까지 함께 고려하여 재시작하도록 하지만, 보통은 메인 dnsmasq 프로세스만 재시작됩니다.
정리
ServBay는 내장 dnsmasq 서비스를 통해 효율적인 로컬 DNS 해석의 핵심 기능을 제공합니다. 웹 개발 환경을 최적으로 관리하려면, 상위 DNS 서버 지정과 로컬 개발 도메인 설정 등 핵심 dnsmasq 설정을 반드시 ServBay 사용자 인터페이스에서 진행하시기 바랍니다. 구성 파일을 직접 수정하지 않는 것이 중요하며, 변경 후에는 ServBay 관리 화면이나 servbayctl 명령어로 dnsmasq 서비스를 재시작하여 적용해야 합니다.