ServBay에서 MySQL 데이터베이스 설정 구성 및 최적화

ServBay에는 MySQL 데이터베이스가 기본 내장되어 있으며, 개발자가 프로젝트 요구에 따라 다양한 설정을 유연하게 조정할 수 있는 환경을 제공합니다. 이 문서에서는 ServBay에서 MySQL의 주요 설정을 수정하는 방법(권장 UI 활용 방식, 설정 파일 위치, 주요 설정 항목 등)에 대해 자세히 설명합니다.

설치된 MySQL 버전에 따라 설정 파일과 데이터 파일은 보통 ServBay 설치 디렉터리(기본값: /Applications/ServBay) 내의 각 버전별 하위 폴더에 위치합니다.

중요 안내

ServBay는 대부분의 소프트웨어 및 서비스 설정을 그래픽 사용자 인터페이스(UI)를 통해 관리합니다. 설정 변경은 ServBay의 UI에서 진행하실 것을 적극 권장합니다. ServBay는 설정 파일을 자동으로 생성 및 관리하므로, 파일을 직접 수정할 경우 ServBay를 업데이트하거나 재시작할 때 변경 내용이 덮어써질 수 있어 설정이 사라질 수 있습니다. 직접 파일을 수정하는 것은 임시 테스트나 디버깅에만 적합합니다.

ServBay UI에서 설정 변경하기 (권장)

ServBay는 강력한 그래픽 관리 도구를 제공하며, 개발자는 이 UI에서 다양한 설정값을 직접 수정할 수 있습니다. UI에서 변경한 설정은 자동으로 반영되며, 저장 즉시 적용되어 설정 과정이 매우 간편해지고, 파일 편집에서 발생할 수 있는 실수도 방지할 수 있습니다.

MySQL 설정을 변경하려면 ServBay 앱을 실행하고, 좌측 내비게이션 메뉴에서 데이터베이스 -> MySQL을 차례로 선택한 뒤, 설정하려는 MySQL 버전을 클릭합니다.

그래픽 편집 화면에서 다음과 같은 핵심 설정을 확인 및 수정할 수 있습니다:

기본 사용자명 및 비밀번호: ServBay가 설정한 MySQL 기본 사용자명(root가 일반적)과 암호를 확인할 수 있습니다.
바인드 주소(bind-address) 및 포트(port): 기본값은 0.0.0.0:3306으로, 모든 네트워크 인터페이스의 3306 포트를 수신합니다. 필요에 따라 바인드 주소(예: 127.0.0.1로 설정 시 로컬 접속만 허용) 또는 포트를 변경해 다른 서비스와 충돌을 피할 수 있습니다.
느린 쿼리 로그(slow query log): 느린 쿼리 로그 활성화를 쉽게 설정할 수 있어, 성능이 떨어지는 SQL문을 추적하는 데 유용합니다.
최대 연결 수(max_connections): 데이터베이스가 허용하는 동시 접속 최대 수를 조절할 수 있습니다.
최대 허용 패킷 크기(max_allowed_packet): 서버가 수신할 수 있는 최대 데이터 패킷 크기를 지정하며, 수용 가능한 SQL문 혹은 단일 행의 최대 크기에 영향을 줍니다.
기타 주요 설정: UI 화면에서 자주 사용하는 다른 설정값도 노출되어 쉽게 조정할 수 있습니다.

설정 변경 후 화면 하단의 저장 버튼을 클릭하시면, ServBay가 자동으로 변경 내용을 적용하고 필요 시 MySQL 서비스를 재시작해 새 설정이 즉시 적용됩니다.

참고: MySQL 설정 파일 직접 편집 (권장하지 않음)

권장 방식은 아니지만, 고급 디버깅이나 임시 변경이 필요한 경우 ServBay에서 관리하는 MySQL 설정 파일의 위치를 알아두면 도움이 됩니다.

WARNING

다시 한 번 강조합니다: ServBay가 자동으로 생성하는 설정 파일을 직접 편집하는 것은 권장하지 않습니다. ServBay UI나 이후 업데이트로 인해 수동 변경 사항이 덮어써질 수 있기 때문입니다. 설정을 장기적으로 유지하려면 ServBay의 그래픽 UI를 우선 사용하세요. 수동 편집은 임시 방편에 한정해야 합니다.

개요

ServBay에서 MySQL 설정 파일은 버전별로 정리되어 있습니다. 이 파일들은 ServBay 설치 폴더 내부 원래 정해진 경로에 있습니다.

설정 파일 위치

MySQL의 주요 설정 파일인 my.cnf의 기본 위치는 다음과 같습니다:

my.cnf: /Applications/ServBay/etc/mysql/<version>/my.cnf

여기서 <version>은 설치한 MySQL 버전(예: 8.0, 9.0)을 의미합니다.

`my.cnf`

my.cnf는 MySQL 서버의 핵심 설정 파일로, 데이터베이스 동작을 제어하는 다양한 매개변수를 보관합니다.

대표적인 설정 예시

아래는 my.cnf에서 자주 사용하는 설정 항목의 예와 간략 설명입니다. 설정을 수동 편집할 땐 각 설정의 기능을 참고하고, 변경 시 신중해야 합니다.

바인드 주소(bind-address) 수정: MySQL 인스턴스가 어느 네트워크 인터페이스에서 요청을 수신할지 지정합니다. 0.0.0.0는 모든 인터페이스, 127.0.0.1은 오직 로컬 접속만 허용합니다.
ini
```
[mysqld]
bind-address = 0.0.0.0
```
1
2
포트 번호(port) 수정: MySQL 서비스가 수신하는 네트워크 포트입니다. 기본값은 3306입니다.
ini
```
[mysqld]
port = 3306
```
1
2
최대 연결 수(max_connections) 설정: 동시에 접속 가능한 클라이언트의 최대 수를 지정합니다. 서비스 부하에 따라 적절히 조정하세요.
ini
```
[mysqld]
max_connections = 200
```
1
2
InnoDB 버퍼 풀 크기(innodb_buffer_pool_size) 변경: InnoDB 스토리지 엔진이 데이터 및 인덱스 캐시에 사용하는 메모리 크기입니다. InnoDB 성능에 영향을 주는 핵심 값으로, 보통 시스템 메모리의 50%~70%로 설정합니다.
ini
```
[mysqld]
innodb_buffer_pool_size = 256M
```
1
2
에러 로그 파일 경로(log_error) 변경: MySQL 오류 로그 파일 위치를 지정합니다. 서버 시작, 실행 중 발생한 오류 및 경고 내역이 저장됩니다.
ini
```
[mysqld]
log_error = /Applications/ServBay/logs/mysql/error.log
```
1
2
느린 쿼리 로그 활성화(slow_query_log): 활성화 시, 실행이 long_query_time을 초과하는 SQL문을 지정된 로그 파일에 기록하여 성능 병목을 분석할 수 있습니다.
ini
```
[mysqld]
slow_query_log = 1
slow_query_log_file = /Applications/ServBay/logs/mysql/slow.log
long_query_time = 2  # 초 단위, 2초 이상 소요된 쿼리를 기록
```
1
2
3
4
문자셋 및 정렬 규칙(character-set-server, collation-server) 변경: 서버의 기본 문자셋 및 정렬 규칙 설정입니다. 데이터베이스, 테이블, 컬럼에 기본 값이 적용됩니다. utf8mb4는 이모지 등 다양한 유니코드 문자를 지원하는 권장 문자셋입니다.
ini
```
[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
```
1
2
3

수동 수정 후 조치

설정을 수동으로 변경했다면(임시 테스트 용도에만 권장), 변경 사항을 적용하려면 반드시 MySQL 서비스를 재시작해야 합니다.

MySQL 서비스 재시작

MySQL 설정을 변경한 후(UI이든 직접 편집이든 모두 해당), 새 설정을 적용하려면 일반적으로 MySQL 서비스를 재시작해야 합니다.

ServBay 관리 UI에서 재시작

ServBay 관리 화면을 엽니다.
좌측 내비게이션 메뉴에서 소프트웨어 패키지를 클릭합니다.
소프트웨어 목록에서 원하는 버전의 MySQL을 찾아 재시작 버튼을 클릭하세요.

`servbayctl` 명령행 도구로 재시작

ServBay가 제공하는 커맨드라인 도구 servbayctl로도 서비스를 쉽게 관리할 수 있습니다.

터미널 애플리케이션을 실행한 뒤, 다음 명령(여기서 9.0은 실제 사용하는 MySQL 버전으로 교체해주세요)을 입력합니다:

bash

servbayctl restart mysql 9.0

자주 묻는 질문(FAQ)

Q: my.cnf 파일을 직접 수정했는데 변경이 적용되지 않았습니다. 왜 그런가요?
A: MySQL 서비스를 변경 후 반드시 재시작했는지 확인하세요. 또, ServBay UI가 실행 중이거나 내부 관리 작업이 있었다면 수동 편집된 설정이 ServBay의 자동 생성 설정에 의해 덮어써졌을 수 있습니다. 가급적이면 ServBay UI에서 설정을 변경하는 것을 권장합니다.
Q: 설정을 수정한 후 MySQL이 시작되지 않습니다. 어떻게 해야 하나요?
A: 보통은 설정 파일에 문법 오류가 있을 때 발생합니다. 직접 편집했다면 my.cnf에 문법 오류가 없는지 반드시 검토하세요. MySQL의 에러 로그(/Applications/ServBay/logs/mysql/error.log, 버전에 따라 경로가 다를 수 있음)를 확인하면 원인 파악에 도움이 됩니다. 문제가 해결되지 않으면 수동 수정 내용을 삭제하여 ServBay UI 관리 상태로 되돌리고, UI에서만 설정을 변경하세요.
Q: ServBay MySQL root 비밀번호를 잊어버렸어요. 어떻게 해야 하나요?
A: ServBay UI의 MySQL 설정 페이지에서 현재 기본 root 비밀번호를 다시 확인할 수 있습니다. 비밀번호 초기화가 필요하다면, 최신 버전의 ServBay는 UI에서 데이터베이스(MySQL, MariaDB, PostgreSQL 등)의 root 비밀번호를 재설정하는 기능을 제공합니다. 구체적인 단계는 ServBay 공식 문서의 데이터베이스 비밀번호 관리 부분을 참고하세요.

요약

ServBay에서 MySQL 데이터베이스를 구성하는 과정은 매우 유연합니다. 설정의 지속성과 정확성을 위해 ServBay의 그래픽 UI를 사용하는 것이 가장 추천되는 방법입니다. /Applications/ServBay/etc/mysql/<version>/my.cnf 파일을 참고해 세부 설정을 확인할 수 있지만, 장기적인 변경 목적이라면 직접 편집은 추천하지 않습니다. 어떤 방법을 사용하든 설정을 변경한 뒤에는 MySQL 서비스를 재시작해야 변경이 적용됩니다. 각 설정값의 역할을 이해하고 조정하면 ServBay 환경에서 로컬 데이터베이스의 성능을 효과적으로 최적화할 수 있습니다.

ServBay에서 MySQL 데이터베이스 설정 구성 및 최적화 ​

ServBay UI에서 설정 변경하기 (권장) ​

참고: MySQL 설정 파일 직접 편집 (권장하지 않음) ​

개요 ​

설정 파일 위치 ​

my.cnf ​

대표적인 설정 예시 ​

수동 수정 후 조치 ​

MySQL 서비스 재시작 ​

ServBay 관리 UI에서 재시작 ​

servbayctl 명령행 도구로 재시작 ​

자주 묻는 질문(FAQ) ​

요약 ​