ServBay 설정 파일 위치 및 관리
ServBay는 강력한 로컬 웹 개발 환경으로서, 웹 서버·데이터베이스·언어 런타임 등 다양한 소프트웨어 패키지의 유연한 설정이 핵심입니다. 효율적인 관리와 환경 안정성을 위해 모든 패키지의 설정 파일을 모아, 명확한 디렉터리 구조 아래 관리합니다. 본 문서에서는 ServBay의 설정 파일 위치와 각 파일을 찾고 확인하는 방법을 자세히 안내합니다.
중요 안내: 설정 파일을 수동으로 수정하지 마십시오
ServBay의 설정 파일은 사용자가 UI를 통해 지정한 값을 기반으로 자동 생성됩니다. 절대 ServBay 설정 디렉터리 내의 파일을 직접 수정하지 마시기 바랍니다.
- macOS:
/Applications/ServBay/etc
- Windows:
C:\ServBay\etc
수동으로 파일을 변경할 경우, ServBay를 업데이트하거나 서비스를 재시작 및 UI를 통한 추가 설정 변경 시 해당 파일이 덮어써질 수 있으며, 이로 인해 직접 편집한 내용이 사라지거나 예기치 못한 오류가 발생할 수 있습니다.
모든 설정 변경은 ServBay에서 제공하는 그래픽 사용자 인터페이스(UI) 또는 공식 명령줄 도구를 통해 진행해야 하며, 이 경우에만 변경이 안정적으로 적용됩니다. 본 문서의 파일 경로 정보는 ServBay 내부 구조 이해 및 문제 해결 시 참고용으로 제공됩니다.
디렉터리 구조 개요
ServBay 설정 파일은 다음 주요 경로에 집중적으로 저장되며, 패키지 명과 버전에 따라 분류됩니다.
주요 설정 디렉터리:
- macOS:
/Applications/ServBay/etc
- Windows:
C:\ServBay\etc
이곳은 ServBay의 핵심 설정 파일 디렉터리로, 웹 서버(Nginx·Caddy·Apache), 언어 런타임(PHP의 php.ini
등), 데이터베이스(MySQL·MariaDB 등), 기타 서비스(Redis·Memcached 등) 설정 파일을 포함합니다.
데이터베이스 디렉터리:
- macOS:
/Applications/ServBay/db
- Windows:
C:\ServBay\db
이 디렉터리에는 데이터베이스 관련 데이터 파일이 주로 저장되며, PostgreSQL 등 일부 데이터베이스의 특수 설정 파일이 포함됩니다.
공용 패키지 디렉터리:
- macOS:
/Applications/ServBay/package/common
- Windows:
C:\ServBay\package\common
OpenSSL 등 일부 공통 패키지의 설정 파일이 여기 위치합니다.
주요 패키지별 설정 파일 위치
ServBay에서 자주 사용하는 소프트웨어 패키지들의 설정 파일 저장 예시는 다음과 같습니다.
웹 서버 (Web Servers)
웹 서버의 설정 파일은 ServBay의 기본 설정 디렉터리 내 패키지 명 및 버전별 하위 디렉터리에 저장됩니다.
Nginx: 설정 파일 기본 경로:
- macOS:
/Applications/ServBay/etc/nginx
- Windows:
C:\ServBay\etc\nginx
예시 - Nginx 1.25 버전의 설정 파일 경로:
- macOS:
/Applications/ServBay/etc/nginx/1.25/nginx.conf
- Windows:
C:\ServBay\etc\nginx\1.25\nginx.conf
기타 사이트·SSL 설정 등 관련 파일도 동일 디렉터리 혹은 하위 폴더에 정리됩니다.
- macOS:
Caddy: 설정 파일 기본 경로:
- macOS:
/Applications/ServBay/etc/caddy
- Windows:
C:\ServBay\etc\caddy
주요 설정 파일 경로:
- macOS:
/Applications/ServBay/etc/caddy/Caddyfile
- Windows:
C:\ServBay\etc\caddy\Caddyfile
- macOS:
Apache: 설정 파일 기본 경로:
- macOS:
/Applications/ServBay/etc/apache
- Windows:
C:\ServBay\etc\apache
예시 - Apache 2.4 버전의 설정 파일 경로:
- macOS:
/Applications/ServBay/etc/apache/2.4/httpd.conf
- Windows:
C:\ServBay\etc\apache\2.4\httpd.conf
가상호스트 등 추가 설정은 보통
extra
하위 폴더에서 관리됩니다.- macOS:
언어 런타임 (Language Runtimes)
PHP, Python, Node.js, Go, Java 등 다양한 언어 런타임은 ServBay 기본 설정 디렉터리에 언어명·버전별로 저장됩니다.
PHP: 설정 파일 기본 경로:
- macOS:
/Applications/ServBay/etc/php
- Windows:
C:\ServBay\etc\php
예시 - PHP 8.2 버전의
php.ini
파일 경로:- macOS:
/Applications/ServBay/etc/php/8.2/php.ini
- Windows:
C:\ServBay\etc\php\8.2\php.ini
PHP-FPM 관련 설정 파일은 같은 버전 디렉터리에 위치합니다.
- macOS:
Python: Python 설정은 환경 변수나 프로젝트 내부 파일로 관리하는 경우가 많으며, ServBay가 제공하는 Python 환경의 실행 파일은 다음 경로에 위치합니다:
- macOS:
/Applications/ServBay/package/python/{version}/bin
- Windows:
C:\ServBay\package\python\{version}\bin
전역 설정은 ServBay 기본 디렉터리를 통해 관리하지 않는 경우가 많습니다.
- macOS:
Node.js, Go, Java, Ruby, Rust, .NET: Python과 마찬가지로, 이러한 언어들의 설정은 프로젝트나 환경 변수, 각 언어별 도구 체계에 따르며 ServBay는 실행 환경·SDK만 제공하고, 글로벌 설정 파일은 통합 관리하지 않습니다.
데이터베이스 (Databases)
데이터베이스 설정 파일은 ServBay 설정 디렉터리와 데이터 디렉터리에 구분 저장됩니다.
MySQL / MariaDB: 기본 설정 파일 경로:
- macOS:
/Applications/ServBay/etc/mysql
(또는/Applications/ServBay/etc/mariadb
) - Windows:
C:\ServBay\etc\mysql
(또는C:\ServBay\etc\mariadb
)
예시 - MySQL 8.0 설정 파일 경로:
- macOS:
/Applications/ServBay/etc/mysql/8.0/my.cnf
- Windows:
C:\ServBay\etc\mysql\8.0\my.cnf
주요 데이터베이스 설정이 해당 파일에 포함됩니다.
- macOS:
PostgreSQL: PostgreSQL 주요 설정 파일 경로(버전별 분류):
- macOS:
/Applications/ServBay/etc/postgresql
- Windows:
C:\ServBay\etc\postgresql
예시 - PostgreSQL 16 설정 파일 경로:
- macOS:
/Applications/ServBay/etc/postgresql/16/postgresql.conf
- Windows:
C:\ServBay\etc\postgresql\16\postgresql.conf
클라이언트 인증 관련 설정 파일
pg_hba.conf
및pg_ident.conf
는 데이터베이스 디렉터리에 위치하며, 버전별 분류됩니다:- macOS:
/Applications/ServBay/db/postgresql/16/pg_hba.conf
- macOS:
/Applications/ServBay/db/postgresql/16/pg_ident.conf
- Windows:
C:\ServBay\db\postgresql\16\pg_hba.conf
- Windows:
C:\ServBay\db\postgresql\16\pg_ident.conf
- macOS:
MongoDB, Redis: 해당 데이터베이스는 주로 기본 설정 디렉터리에 이름과 버전별로 저장됩니다.
- macOS:
/Applications/ServBay/etc
- Windows:
C:\ServBay\etc
예시 - Redis 설정 파일 경로:
- macOS:
/Applications/ServBay/etc/redis/redis.conf
- Windows:
C:\ServBay\etc\redis\redis.conf
- macOS:
기타 서비스 및 공용 패키지
OpenSSL: OpenSSL 설정 파일은 공용 패키지 디렉터리 내 버전별로 위치합니다:
- macOS:
/Applications/ServBay/package/common/openssl
- Windows:
C:\ServBay\package\common\openssl
예시 - OpenSSL 3.2 설정 파일 경로:
- macOS:
/Applications/ServBay/package/common/openssl/3.2/openssl.cnf
- Windows:
C:\ServBay\package\common\openssl\3.2\openssl.cnf
- macOS:
ACME (SSL 인증서 자동 발급용): ACME 관련 설정 및 인증서 저장 경로:
- macOS:
/Applications/ServBay/etc/acme
또는/Applications/ServBay/db/acme
- Windows:
C:\ServBay\etc\acme
또는C:\ServBay\db\acme
- macOS:
설정 파일 찾기 및 확인 방법
설정 파일을 직접 수정하는 것은 권장하지 않으나, 현재 상태 확인이나 장애 진단 등을 위해 파일 내용을 확인해야 할 때가 있습니다. 다음 절차로 파일을 찾고 조회할 수 있습니다.
설정 파일 디렉터리 이동: 커맨드라인 도구를 이용해 해당 디렉터리로 이동합니다.
macOS (터미널·iTerm2 등):
bash# Nginx 설정 파일 디렉터리 조회 cd /Applications/ServBay/etc/nginx/ # PostgreSQL 16의 pg_hba.conf가 위치한 디렉터리 cd /Applications/ServBay/db/postgresql/16
1
2
3
4
5Windows (PowerShell·명령 프롬프트):
powershell# Nginx 설정 파일 디렉터리 조회 cd C:\ServBay\etc\nginx\ # PostgreSQL 16의 pg_hba.conf가 위치한 디렉터리 cd C:\ServBay\db\postgresql\16
1
2
3
4
5파일 목록 확인: 해당 디렉터리 내 파일 목록 조회:
macOS:
bashls
1Windows:
powershell# PowerShell Get-ChildItem # 또는 간단히 ls # 명령 프롬프트 dir
1
2
3
4
5
6
7파일 내용 확인: 텍스트 뷰어나 에디터로 파일 내용을 확인(단, 저장은 금지):
macOS:
bash# Nginx의 nginx.conf 확인 cat nginx.conf # 또는 less로 페이징 less nginx.conf # PHP 8.2의 php.ini 내용 확인 less /Applications/ServBay/etc/php/8.2/php.ini
1
2
3
4
5
6
7Windows:
powershell# PowerShell - Nginx의 nginx.conf 확인 Get-Content nginx.conf # 페이징 확인 more nginx.conf # PHP 8.2의 php.ini 내용 확인 Get-Content C:\ServBay\etc\php\8.2\php.ini | more # 명령 프롬프트 type nginx.conf more nginx.conf
1
2
3
4
5
6
7
8
9
10
11서비스 재시작(설정 변경 시): ServBay UI를 통해 설정을 변경했다면 해당 패키지 서비스를 재시작해야 변경 사항이 반영됩니다. ServBay 관리 UI 또는
servbayctl
명령줄 도구로 재시작 가능합니다.macOS:
bash# Nginx 서비스 재시작 servbayctl restart nginx -all # PHP 8.2 서비스 재시작 servbayctl restart php 8.2 # 전체 서비스 재시작 servbayctl restart all
1
2
3
4
5
6
7
8Windows:
powershell# Nginx 서비스 재시작 servbayctl.exe restart nginx -all # PHP 8.2 서비스 재시작 servbayctl.exe restart php 8.2 # 전체 서비스 재시작 servbayctl.exe restart all
1
2
3
4
5
6
7
8
자주 묻는 질문 (FAQ)
Q: 고급 설정을 테스트하려고 설정 파일을 직접 수정해도 되나요?
A: 매우 비추천합니다. ServBay UI에서 대부분의 일반적인 설정 변경이 가능합니다. UI에서 지원하지 않는 고급 커스텀은 공식 고급 설정 문서나 커뮤니티 지원을 참고하세요. 직접 변경한 파일은 쉽게 덮어써질 수 있습니다.
Q: ServBay의 다중 버전 패키지 설정 파일은 어떻게 관리되나요?
A: 본 문서에서 설명했듯, ServBay는 설정 디렉터리(macOS:
/Applications/ServBay/etc
또는/Applications/ServBay/db
; Windows:C:\ServBay\etc
또는C:\ServBay\db
) 내에 각 패키지·버전별 독립 하위 폴더를 만들어 버전간 설정 충돌을 방지합니다.Q: 설정 파일을 실수로 삭제하거나 손상했다면 어떻게 해야 하나요?
A: ServBay는 내장 템플릿과 설정값을 기반으로 설정 파일을 자동 생성합니다. 일반적으로 UI에서 해당 소프트웨어 패키지의 설정을 조금이라도 변경하면 파일이 재생성됩니다. 극단적 경우, 패키지 설정 초기화나 ServBay 지원팀 문의가 필요할 수 있습니다.
요약
ServBay는 운영체제에 따라 통일된 구조로 패키지 설정 파일을 중앙 관리합니다:
- macOS: 대부분
/Applications/ServBay/etc
에 위치하며/Applications/ServBay/db
,/Applications/ServBay/package/common
이 보조합니다. - Windows: 주로
C:\ServBay\etc
디렉터리에 저장되며,C:\ServBay\db
와C:\ServBay\package\common
을 병행 사용합니다.
이 일관된 구조 설계 덕분에 ServBay는 다양한 플랫폼에서 설정 파일을 자동화해 관리하며, 개발자도 파일 찾기와 문제 진단에 용이합니다.
설정 파일 위치를 이해하면 ServBay의 작동 원리와 장애 진단에 도움이 됩니다. 설정 변경은 반드시 ServBay 공식 UI 또는 도구를 사용해야 하며, 직접 설정 파일을 편집하지 말아야 안정적으로 환경을 유지할 수 있습니다.