ServBay 자주 묻는 질문(FAQ)

ServBay 로컬 웹 개발 환경을 사용할 때 개발자들이 자주 겪는 문제들이 있습니다. 이 문서는 대표적인 두 가지 이슈, 즉 ServBay Runtime의 업그레이드와 ClashX Pro 등 프록시 툴로 인해 발생하는 로컬 사이트 접속 문제의 해결법을 안내합니다.

ServBay Runtime은 어떻게 업그레이드하나요?

ServBay Runtime은 ServBay의 핵심 구성요소로, ServBay 및 그가 제공하는 서비스의 안정적인 실행을 보장합니다. 새로운 버전이 출시되면 ServBay는 시작 시 사용자에게 업그레이드를 안내합니다. Runtime을 최신 상태로 유지하면 ServBay의 성능과 안정성, 호환성을 높일 수 있습니다.

ServBay Runtime을 업그레이드하려면 아래의 단계를 따라주세요:

1. ServBay 앱을 엽니다.
2. ServBay 창 좌측 내비게이션 바에서 소프트웨어 패키지 > 공통 서비스를 선택합니다.
3. 오른쪽 패널에서 ServBay Runtime 항목을 찾습니다.
4. 업데이트가 가능하면 ServBay Runtime 항목에 노란색 업그레이드 알림이나 버튼이 표시됩니다. 이 노란 업그레이드 버튼을 클릭하세요.
5. ServBay가 최신 Runtime 버전을 다운로드하고 설치합니다. 업그레이드가 완료될 때까지 기다려 주세요.

업그레이드가 완료되면 ServBay Runtime이 최신 버전으로 구동되어 더욱 뛰어난 안정성과 성능을 경험하실 수 있습니다.

ClashX Pro(혹은 기타 프록시 툴) 사용 후 ServBay의 로컬 사이트 접속이 안 되는 이유는?

많은 개발자들이 ServBay를 이용해 로컬에서 개발 및 테스트를 하며, servbay.demo, myproject.servbay.demo와 같은 커스텀 로컬 도메인을 사용합니다. 이 도메인들은 일반적으로 로컬 루프백 주소인 127.0.0.1로 지정되어 있습니다.

ClashX Pro 또는 Surge, Quantumult X와 같은 일부 VPN/프록시 툴을 사용하면, 이런 툴이 DNS 요청을 가로채거나 리다이렉트하여 모든 도메인 요청을 프록시 서버로 보내도록 할 수 있습니다. 그 결과, OS 자체의 DNS 해석 과정이나 로컬 hosts 파일 설정(대부분의 ServBay 로컬 도메인 해석은 이에 의존)을 우회하게 되어, ServBay의 로컬 개발 도메인이 올바르게 로컬 IP로 연결되지 못하고, 결국 로컬 사이트 접속이 불가능해집니다.

이 문제를 해결하기 위해서는, 프록시 툴의 설정에서 로컬 개발 도메인에 대해 프록시를 적용하지 않거나 DNS 요청을 가로채지 않도록 규칙을 추가해야 합니다. 일반적으로 '프록시 우회', '프록시 제외', '화이트리스트', '익스클루드 리스트' 항목을 활용합니다.

ClashX Pro의 경우 다음 단계를 참고해주세요:

1. ClashX Pro 앱을 엽니다.
2. macOS 메뉴바에서 ClashX Pro 아이콘을 클릭한 다음, 추가 설정을 선택합니다.
3. 열린 설정 창에서 일반 탭으로 이동합니다.
4. 프록시에서 제외할 호스트 및 도메인(혹은 유사 명칭)의 입력란을 찾습니다.
5. 여기에 본인이 사용하는 로컬 개발 도메인을 추가하세요. ServBay에서 자주 사용하는 로컬 도메인을 폭넓게 커버하려면 localhost, 127.0.0.1, 그리고 사용 중인 특정 도메인 또는 와일드카드 도메인을 함께 등록하는 것이 좋습니다. 예를 들어 .servbay.demo를 사용한다면 *.servbay.demo를 추가합니다. 여러 항목은 보통 영어 콤마(,) 혹은 줄바꿈으로 구분합니다. 예시:

   localhost, 127.0.0.1, *.servbay.demo, yourproject.servbay.demo

6. 설정을 저장하고, ClashX Pro 안내에 따라 구성을 재적용하거나 리로드해야 할 수 있습니다.

(이미지 설명: ClashX Pro에서 프록시 제외 도메인 및 호스트 설정 예시)

위 과정을 완료하면, ClashX Pro가 이러한 로컬 도메인의 DNS 해석을 더 이상 방해하지 않으므로 ServBay 로컬 사이트 접속이 정상적으로 이루어집니다. 문제가 계속된다면, ServBay 사이트 설정에서 도메인 설정이 올바른지, 그리고 ServBay 관련 서비스(Caddy 또는 Nginx 등)가 정상 실행 중인지 확인하세요. 또한 터미널에서 ping yourproject.servbay.demo 혹은 dig yourproject.servbay.demo 명령어로 도메인 해석 상태를 진단해 볼 수 있습니다.