ServBay에서 MariaDB 데이터베이스 설정 구성하기

ServBay는 강력하고 쉽게 관리할 수 있는 MariaDB 데이터베이스가 통합된 로컬 웹 개발 환경을 제공합니다. 이 문서는 ServBay에서 MariaDB의 다양한 설정을 어떻게 수정하는지, ServBay UI를 통해 추천 방식으로 구성하는 절차, 그리고 설정 파일의 역할과 주요 옵션에 대해 자세히 설명합니다.

대상 독자: ServBay에서 로컬 개발을 진행하며 MariaDB 데이터베이스 동작을 조정하고자 하는 웹 개발자.

개요

MariaDB의 설정은 DB 서버의 동작 방식을 결정합니다. 예를 들어 네트워크 리스닝, 연결 제한, 캐시 크기, 로그 기록 등입니다. ServBay에서는 복잡한 설정 파일을 직접 손대지 않고도 그래픽 인터페이스를 통해 손쉽게 이러한 옵션을 조정할 수 있습니다. 설정 파일(my.cnf 등)은 MariaDB의 표준 구성 방식이지만, ServBay 환경에서는 UI를 통해 관리하는 방식을 권장하며, 이를 통해 안정적이고 지속적인 설정이 가능합니다.

MariaDB 버전에 따라 설정 파일은 보통 ServBay 설치 경로인 /Applications/ServBay/etc/mariadb/<version> 폴더에 위치합니다.

중요한 안내: ServBay UI 우선 사용

설정 충돌이나 덮어쓰기 위험을 피하기 위해, MariaDB 설정 변경 시에는 반드시 ServBay의 그래픽 사용자 인터페이스를 이용할 것을 강력히 권장합니다. ServBay는 UI에서 입력한 내용을 기반으로 내부 설정 파일을 자동으로 생성 및 관리합니다. 직접 설정 파일을 수정하는 것은 임시 디버깅 용도로만 사용해야 하며, 언제든 ServBay의 관리 로직에 의해 내용이 덮어쓰일 수 있습니다.

ServBay UI를 통한 설정 변경 (추천)

ServBay는 직관적인 그래픽 UI를 제공하여 MariaDB의 주요 설정 파라미터를 쉽게 확인하고 수정할 수 있습니다. 이 방법은 안전하고, 변경 사항이 즉시 반영되며 서비스 재시작도 자동으로 처리됩니다.

1. ServBay 관리 화면 열기: ServBay 앱을 실행합니다.

2. 데이터베이스 설정 이동: ServBay 왼쪽 내비게이션에서 데이터베이스 메뉴를 확장하고, MariaDB를 선택합니다.

3. MariaDB 버전 선택: 여러 버전이 설치된 경우, 설정할 버전을 선택합니다.

4. 설정 파라미터 수정: MariaDB 설정 화면에서 다음과 같은 주요 옵션을 확인/수정할 수 있습니다:

   • 기본 사용자명 및 Root 비밀번호: 기본 root 계정의 비밀번호를 조회하거나(일부 버전에서는) 재설정할 수 있습니다.
   • 리스닝 주소(bind-address): MariaDB가 네트워크의 어느 인터페이스에서 연결을 수락할지 지정합니다. 기본은 일반적으로 0.0.0.0으로 모든 네트워크에서 연결을 허용합니다(방화벽 허용 시 원격접속 가능). 로컬 접속만 허용하려면 127.0.0.1 또는 localhost로 변경하십시오.
   • 포트(port): MariaDB가 리스닝하는 TCP 포트번호를 지정합니다(기본값: 3306).
   • 최대 연결 수(max_connections): 동시에 MariaDB 서버에 접속할 수 있는 최대 클라이언트 수를 지정합니다. 운영 환경 및 시스템 자원에 따라 조정하세요.
   • 최대 요청 패킷 크기(max_allowed_packet): 한 번에 처리할 수 있는 최대 데이터 패킷 크기를 설정합니다. 대용량 BLOB 처리가 필요한 경우 별도로 조정할 수 있습니다.
   • 슬로우 쿼리 로그 활성화(slow_query_log): 느린 쿼리 탐지를 위해 슬로우 쿼리 로그를 활성화합니다.
   • 슬로우 쿼리 로그 파일(slow_query_log_file): 슬로우 쿼리 로그 파일 경로 지정(일반적으로 /Applications/ServBay/logs/mariadb/).
   • 슬로우 쿼리 임계값(long_query_time): 지정한 초(sec)보다 오래 걸린 쿼리가 슬로우 쿼리 로그에 기록됩니다.
   • 버퍼 풀 크기(innodb_buffer_pool_size): InnoDB 엔진의 테이블/인덱스 캐시에 사용되는 메모리 크기를 설정합니다. 값을 늘리면 성능이 개선되나, 메모리 용량도 많이 소모됩니다.
   • 문자셋 및 정렬 규칙(character-set-server, collation-server): 데이터 저장 및 비교 방식에 영향을 주는 기본 문자셋 및 정렬 규칙 지정. 다양한 문자(이모지 포함)를 지원하는 utf8mb4를 추천합니다.

5. 저장 및 적용: 수정 완료 후, 하단의 저장 버튼을 클릭하세요. ServBay는 설정을 자동으로 갱신하고 MariaDB 서비스를 백그라운드에서 재적용/재시작해 즉시 변경사항을 반영합니다.

도해: ServBay UI에서 MariaDB 설정을 수정하는 화면

수동 설정 파일 편집(비추천, 임시 디버깅에 한함)

비록 권장되지 않지만, MariaDB 설정 파일의 위치와 구성방식을 이해하는 것은 고급 디버깅 및 테스트에 도움이 됩니다.

위험 안내: 직접 편집 시 설정이 덮어쓰기될 수 있음

ServBay가 관리하는 설정 파일(my.cnf 등)을 수동으로 수정하는 것은 비추천입니다. ServBay가 서비스 관리나 업데이트를 할 때 해당 파일을 재생성할 수 있으며, 이때 수동 수정 내용이 사라질 수 있습니다. 항상 ServBay UI를 통해 필요한 설정을 먼저 적용하세요. 부득이하게 수동 편집이 필요하다면, 임시 방편임을 인지하고 이후 ServBay UI에서 해당 옵션으로 지속적으로 관리하세요.

설정 파일 위치

ServBay에서 MariaDB의 핵심 설정 파일은 my.cnf입니다. 파일 경로는 설치된 MariaDB 버전에 따라 다릅니다.

• 주요 설정 파일: /Applications/ServBay/etc/mariadb/<version>/my.cnf

예를 들어, MariaDB 11.5 기준 설정 파일 경로는 /Applications/ServBay/etc/mariadb/11.5/my.cnf입니다.

my.cnf 파일 구조 및 주요 설정 예시

my.cnf는 INI 포맷의 텍스트 파일로, 각 설정 항목은 [section] 아래 그룹화되어 있습니다. 서버 설정은 주로 [mysqld] 섹션에 위치합니다.

UI에서 다루는 주요 설정의 예시는 다음과 같습니다:

1. 리스닝 주소(bind-address) 변경

   [mysqld]
   bind-address = 0.0.0.0

   0.0.0.0은 모든 네트워크로부터의 접속을 허용하며, 127.0.0.1 또는 localhost로 하면 로컬 연결만 허용합니다.

2. 포트 번호(port) 변경

   [mysqld]
   port = 3306

   MariaDB 서비스가 대기하는 포트입니다.

3. 최대 연결 수(max_connections) 변경

   [mysqld]
   max_connections = 200

   동시 접속 가능한 클라이언트 수를 제한합니다.

4. InnoDB 버퍼 풀 크기(innodb_buffer_pool_size) 변경

   [mysqld]
   innodb_buffer_pool_size = 256M

   InnoDB 데이터/인덱스 캐시에 사용할 메모리 크기(K, M, G 단위 사용 가능).

5. 에러 로그 파일 경로(log_error) 변경

   [mysqld]
   log_error = /Applications/ServBay/logs/mariadb/error.log

   MariaDB 에러 로그 파일 경로 지정.

6. 슬로우 쿼리 로그 활성화(slow_query_log, slow_query_log_file, long_query_time)

   [mysqld]
   slow_query_log = 1
   slow_query_log_file = /Applications/ServBay/logs/mariadb/slow.log
   long_query_time = 2  # 초 단위, 2초 이상 걸린 쿼리를 로그에 기록

   slow_query_log = 1로 슬로우 쿼리 로그 활성화, slow_query_log_file로 파일 경로 지정, long_query_time으로 기록 기준 시간 설정.

7. 문자셋 및 정렬 규칙(character-set-server, collation-server) 변경

   [mysqld]
   character-set-server = utf8mb4
   collation-server = utf8mb4_unicode_ci

   기본 문자셋 및 정렬 규칙을 지정합니다.

변경 적용: MariaDB 서비스 재시작

설정을 ServBay UI에서 변경하든, 임시로 설정 파일을 편집하든(비추천), 새로운 설정을 온전히 적용하려면 MariaDB 서비스를 재시작해야 합니다. ServBay는 두 가지 편리한 재시작 방식을 제공합니다.

ServBay 관리 UI에서 재시작

가장 쉬운 재시작 방법입니다:

1. ServBay 관리 화면을 엽니다.
2. 좌측 내비게이션의 소프트웨어 패키지 메뉴를 확장합니다(구버전에서는 서비스로 표시될 수 있습니다).
3. 해당 버전의 MariaDB 패키지를 찾습니다.
4. 해당 패키지 옆의 재시작 버튼을 클릭합니다.

servbayctl 커맨드라인 툴로 재시작

servbayctl은 ServBay의 패키지 및 서비스를 CLI에서 관리할 수 있는 도구입니다.

터미널 앱을 열어 다음 명령어로 원하는 MariaDB 버전을 재시작할 수 있습니다:

servbayctl restart mariadb <version>

<version> 부분은 실제 MariaDB 버전(예: 11.5)으로 바꿔서 입력합니다.

# 예시: MariaDB 11.5 재시작
servbayctl restart mariadb 11.5

자주 묻는 질문(FAQ)

Q: ServBay에서 설정 파일 my.cnf를 수동 편집하지 않고, UI로 설정하는 것을 권장하는 이유는?

A: ServBay는 통합 로컬 개발 환경 관리 도구로, UI를 통해 소프트웨어 패키지의 다양한 설정을 추상적으로 관리합니다. UI에서 설정을 저장하면, ServBay가 자동으로 내부 설정 파일을 생성·갱신합니다. 수동으로 my.cnf를 수정할 경우, 서비스 관리(예: 업그레이드, 재시작, UI에서 추가 설정 저장 등) 시 ServBay가 내부 상태를 기준으로 설정 파일을 재생성하면서 직접 수정한 내용이 덮어씌워질 수 있습니다. UI를 사용하면 설정의 지속성과 ServBay 환경 전반의 일관성을 보장할 수 있습니다.

Q: ServBay UI에서 MariaDB의 모든 파라미터를 설정할 수 있나요?

A: 개발자들이 주로 사용하는 주요 설정은 ServBay UI에서 대부분 지원합니다. 다만, 드물게 필요로 하는 특수 고급 설정은 임시로 직접 설정 파일을 편집해야 할 수 있습니다. 이 경우 반드시 임시방편임을 인지하고, 가능하면 UI의 "추가 설정" 등 사용자 정의 파라미터 입력란을 통해 적용할 수 있는지 먼저 확인하세요.

Q: ServBay에서 MariaDB의 에러 로그와 슬로우 쿼리 로그 파일 위치는 어디인가요?

A: 기본 설정 및 ServBay의 디렉토리 구조에 따라 로그 파일은 /Applications/ServBay/logs/mariadb/ 경로에 위치합니다. 실제 파일 경로는 ServBay UI나 my.cnf 설정 파일에서 확인할 수 있습니다.

요약

ServBay에서 MariaDB 데이터베이스 설정을 구성하는 가장 안전하고 권장되는 방식은 ServBay의 그래픽 UI를 활용하는 것입니다. UI를 통해 리스닝 주소, 포트, 연결 수, 로그 등 핵심 파라미터를 쉽게 조정하고, 변경 사항이 시스템적으로 지속적으로 관리됩니다. /Applications/ServBay/etc/mariadb/<version>/my.cnf 위치의 설정 파일을 직접 편집할 수도 있지만, 수동 변경 내용이 ServBay에 의해 덮어질 위험이 있으므로 임시 디버깅 용도 외에는 권장하지 않습니다. 변경 후에는 ServBay UI 또는 servbayctl CLI를 이용해 MariaDB 서비스를 쉽게 재시작할 수 있습니다. 이러한 설정 옵션을 적절히 이해하면, 로컬 개발 환경에서 MariaDB의 성능과 동작을 최적화할 수 있습니다.