Windows 환경 MariaDB 설치 및 기본 설정 가이드

준비 사항

• Windows 10/11 (64비트 권장)
• 관리자 권한 있는 계정
• 인터넷 연결
• MariaDB 공식 다운로드 페이지

 

1. MariaDB 설치 파일 다운로드

1. MariaDB 공식 다운로드 페이지 접속
2. Operating System: Windows (x86_64) 선택
3. Version: Stable (11.4 LTS) 또는 최신 안정 버전 선택
4. Installer Type:
   • 일반 사용자 → mariadb-XX.X.X-winx64.msi (MSI 설치 프로그램)
   • 포터블/간단 설치 → ZIP 파일 (이 가이드에선 MSI 버전 사용)
5. 다운로드 후 실행

2. 설치 실행 (MSI 기준)

1. 관리자 권한으로 MSI 파일 실행 (Run as administrator)
2. 설치 마법사 시작 → Next
3. License Agreement: 체크 후 Next
4. Setup Type:
   • Typical (기본) 또는 Custom (포트/구성 변경 시)
   • 처음이라면 Typical 권장
5. Enable MariaDB Service:
   • Enable the MariaDB service (자동 시작)
   • Launch the MariaDB service automatically
6. Root Password 설정:
   • 반드시 강력한 비밀번호 설정 (예: My$tr0ngP@ss!2025)
   • Enable root access from remote machines → 보안상 필요 시만 체크 (로컬 개발 시 해제 권장)
7. Windows Firewall:
   • 체크 시 방화벽 규칙 자동 추가 (로컬 개발 시 선택해도 무방)
8. Ready to Install → Install 클릭
9. 설치 완료 후 Launch the MariaDB configuration wizard? → 체크 해제 (이미 설정 완료됨)

---

🔍 3. 설치 확인 및 기본 테스트

(1) 서비스 확인

• Win + R → services.msc 실행
• MariaDB 서비스가 실행 중(Running) 상태인지 확인

(2) 명령행에서 접속 테스트

# CMD 또는 PowerShell 실행 (관리자 불필요)
mysql -u root -p

 

→ 비밀번호 입력 후 아래와 같은 프롬프트가 나오면 성공:

Welcome to the MariaDB monitor...
MariaDB [(none)]>

 

 

SHOW DATABASES;
SELECT VERSION();
EXIT;

 

 

4. (선택) 환경 변수(PATH) 수동 추가 (MSI 미등록 시)

대부분 MSI 설치 시 자동 등록되지만, mysql 명령이 인식되지 않으면:

1. 설치 경로 확인 (기본: C:\Program Files\MariaDB 11.4\bin)
2. 시스템 속성 → 고급 → 환경 변수
3. 시스템 변수 → Path 편집 → 새 항목 추가:
    
4. 새 CMD 창에서 mysql --version 실행 → 정상 출력 확인

C:\Program Files\MariaDB 11.4\bin

 

 5. (선택) 설정 파일(my.ini) 커스터마이징
기본 설정 파일 경로:
C:\Program Files\MariaDB 11.4\my.ini
또는 C:\ProgramData\MariaDB\my.ini (숨김 폴더)

💡 편집 전 백업 필수

주요 조정 예시:

[mysqld]
port = 3306
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
max_connections = 200
innodb_buffer_pool_size = 512M  ; RAM 4GB 기준

 

수정 후 서비스 재시작 필요:

net stop MariaDB
net start MariaDB

 

6. 보안 강화 (권장)

-- root 외 계정 생성 (개발용)
CREATE USER 'devuser'@'localhost' IDENTIFIED BY 'SecurePass123!';
GRANT ALL PRIVILEGES ON *.* TO 'devuser'@'localhost';
FLUSH PRIVILEGES;

-- 익명 사용자 제거
DROP USER IF EXISTS ''@'localhost';
DROP USER IF EXISTS ''@'%';

-- test DB 제거 (존재 시)
DROP DATABASE IF EXISTS test;

 

보안 검사용: mysql_secure_installation은 Windows에서 제공되지 않음 → 수동으로 위 작업 수행

 

7. GUI 클라이언트 추천
** HeidiSQL **(무료, 가볍고 한국어 지원)
→ https://www.heidisql.com/
DBeaver (무료, 멀티 DB)
MySQL Workbench (공식, MariaDB 호환)

문제 해결 팁

증상해결	방 법
Can't connect to MySQL server on 'localhost'	서비스가 실행 중인지 확인 (services.msc)
Access denied for user 'root'	비밀번호 재입력 또는 mariadb-service-reset 재설치
포트 충돌 (3306 이미 사용 중)	my.ini에서 port = 3307 등으로 변경 → 서비스 재시작
설치 후 바로 크래시	백신/방화벽 일시 해제 후 재설치 시도