Mariadb on Joonlog

SSL 인증서를 사용한 MySQL/MariaDB 암호화 통신

Sat, 22 Nov 2025 09:00:00 +0900

App-DB 연동 간 사설 IP로 연동 불가 + VPN 사용 불가한 상황에서 공인 IP를 통한 암호화 통신 설정하는 방법

App 서버에서 DB 서버로 공인 IP로 통신할 경우 평문으로 통신하기에 데이터 탈취 위험이 존재
SSL 인증서를 사용한 암호화 통신으로 데이터 보호

환경

App 서버: PHP-FPM 8.3

DB 서버: MariaDB 10.3

연결 방식: App 서버 → DB 서버 공인 IP

작업 과정

DB 서버에서 SSL 인증서로 사용할 CA 인증서 생성
DB에서 인증서를 사용하도록 설정
생성한 인증서를 앱 서버로 복사
앱 서버에서 인증서를 사용하도록 설정
- PHP DB 연동 설정 + DB 연동 소스 코드 수정 필요

전체 과정

1. DB 서버 - SSL 인증서 생성 및 설정

디렉토리 생성

1
2


mkdir -p /etc/mysql/ssl
cd /etc/mysql/ssl

CA Private Key / 인증서 생성

1
2


openssl genrsa 2048 > ca-key.pem
openssl req -new -x509 -days 3650 -key ca-key.pem -out ca-cert.pem -subj "/CN=MariaDB-CA"

서버용 인증서 생성

1
2
3
4


openssl genrsa 2048 > server-key.pem
openssl req -new -key server-key.pem -out server-req.pem -subj "/CN=MariaDB-Server"
openssl x509 -req -in server-req.pem -CA ca-cert.pem -CAkey ca-key.pem \
 -CAcreateserial -out server-cert.pem -days 3650

권한 설정

1
2


chmod 600 server-key.pem
chown mysql:mysql server-key.pem server-cert.pem ca-cert.pem

MariaDB 설정 추가

/etc/my.cnf.d/server.cnf

1
2
3
4


[mysqld]
ssl-ca=/etc/mysql/ssl/ca-cert.pem
ssl-cert=/etc/mysql/ssl/server-cert.pem
ssl-key=/etc/mysql/ssl/server-key.pem

MariaDB 재시작
1

systemctl restart mariadb

SSL 활성화 확인

1
2
3


SHOW VARIABLES LIKE 'have_ssl';
SHOW SESSION STATUS LIKE 'Ssl_cipher';
SHOW SESSION STATUS LIKE 'Ssl_version';

2. 앱 서버 - CA 인증서 적용 및 PHP SSL 사용 설정

디렉토리 생성
1

mkdir -p /etc/mysql/ssl
DB 서버에서 CA 인증서 복사
- /etc/mysql/ssl/ca-cert.pem

환경파일 설정

.env 파일일 경우

1
2
3


DB_SSL=true
DB_SSL_CA=/etc/mysql/ssl/ca-cert.pem
DB_SSL_VERIFY=false

PHP SSL 옵션 적용

PDO로 DB와 연동할 경우

DB.php

1
2
3
4
5
6
7
8


if (getenv('DB_SSL') === 'true') {
 if ($ca = getenv('DB_SSL_CA')) {
 $options[\PDO::MYSQL_ATTR_SSL_CA] = $ca;
 }
 if (getenv('DB_SSL_VERIFY') === 'false') {
 $options[\PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT] = false;
 }
}

php-fpm 재시작

3. SSL 적용 검증

DB 계정에 SSL 강제 적용하도록 설정
- 애플리케이션이 SSL 적용이 정상적이지 않다면 에러 발생
  - EX) SQLSTATE[HY000] [1045] Access denied for user
1 2

ALTER USER 'gill'@'%' REQUIRE SSL; FLUSH PRIVILEGES;

Linux logrotate를 통한 로그 관리

Fri, 03 Oct 2025 09:00:00 +0900

/etc/cron.daily/logrotate에 설정된 스크립트를 통해 자동으로 동작
예시
- mariadb general.log 대상

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44


vim /etc/logrotate.d/mariadb

/data/mariadb_log/general.log {

 # Depends on a mysql@localhost unix_socket authenticated user with RELOAD privilege
 su mysql mysql

 # If any of the files listed above is missing, skip them silently without
 # emitting any errors
 missingok

 # If file exists but is empty, don't rotate it
 notifempty

 # 달에 1번 보관
 monthly

 # 6개월 보관
 rotate 6

 # 500M 초과할 경우 달에 상관없이 즉시 보관
 maxsize 500M

 # 50M 미만일 경우 달에 상관없이 보관 X
 minsize 50M

 # 압축해서 보관
 compress

 # 가장 최근 보관한 로그는 압축하지 않음
 delaycompress

 # Don't run the postrotate script for each file configured in this file, but
 # run it only once if one or more files were rotated
 sharedscripts

 # redhat 계열 flush
 postrotate
 if command -v mariadb-admin >/dev/null 2>&1; then
 mariadb-admin --user=root --password='<PASSWORD>' --host=localhost \
 --local flush-error-log flush-engine-log flush-general-log flush-slow-log
 fi
 endscript
}

Ubuntu22 MariaDB 11.4.5 버전 설치

Wed, 21 May 2025 09:00:00 +0900

방법 1: 수동으로 저장소 구성 후 설치

MariaDB의 서명 키와 저장소를 수동으로 등록한 뒤 패키지를 설치하는 방식

1
2
3


sudo apt-get install apt-transport-https curl
sudo mkdir -p /etc/apt/keyrings
sudo curl -o /etc/apt/keyrings/mariadb-keyring.pgp 'https://mariadb.org/mariadb_release_signing_key.pgp'

APT 저장소 설정 파일을 /etc/apt/sources.list.d/mariadb.sources에 생성

1
2
3
4
5
6


X-Repolib-Name: MariaDB
Types: deb
URIs: https://tw1.mirror.blendbyte.net/mariadb/repo/11.4/ubuntu
Suites: jammy
Components: main main/debug
Signed-By: /etc/apt/keyrings/mariadb-keyring.pgp

리눅스 커널 관련 패키지 자동 업데이트를 방지하고 설치

1
2


apt-mark hold linux-image-generic linux-headers-generic
apt-get install mariadb-server

방법 2: MariaDB 공식 설치 스크립트 사용

MariaDB에서 제공하는 설치 스크립트를 통해 저장소 등록과 설치를 한 번에 처리하는 방식

1
2
3
4


curl -LsS https://downloads.mariadb.com/MariaDB/mariadb_repo_setup | bash -s -- --mariadb-server-version=11.

apt-mark hold linux-image-generic linux-headers-generic
apt install mariadb-server mariadb-client -y

초기 공통 설정

mysql_secure_installation

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30


mysql_secure_installation

Enter current password for root (enter for none):
# 현재 root 계정의 비밀번호
# 비밀번호가 설정되어 있지 않은 경우 엔터

Switch to unix_socket authentication [Y/n]:
# root 로그인을 비밀번호가 아니라 시스템 계정(sudo)으로만 허용할지 결정
# Y를 선택하면 root로 로그인할 때 비밀번호 대신 sudo mysql로 접속
# 일반적으로는 Y(보안성 향상). 비밀번호로 로그인할 수 있게 하려면 n 입력.

Change the root password? [Y/n]:
# root 계정의 비밀번호를 변경할지 여부
# 새로 설정하거나, 이전 비밀번호가 없는 경우 새로 설정하는 데 사용

Remove anonymous users? [Y/n]:
# 익명 사용자 계정을 삭제할지 여부
# 익명 계정은 인증 없이 접속할 수 있으므로 Y 입력 권장

Disallow root login remotely? [Y/n]:
# root 계정으로 원격 접속을 막을지 여부
# 보안상 Y 권장. 필요한 경우 n 선택 후 방화벽 등으로 제한하는 방식 고려

Remove test database and access to it? [Y/n]:
# 테스트용 test 데이터베이스를 삭제할지 여부
# 기본으로 생성되는 샘플 데이터베이스로, 불필요하므로 Y 입력 권장

Reload privilege tables now? [Y/n]:
# 앞서 설정한 변경 사항들을 즉시 적용할지 여부
# Y 선택하면 권한 테이블이 즉시 갱신

계정 생성 및 권한 부여

1
2
3
4
5


mysql -u root
CREATE DATABASE test;
CREATE USER 'admin'@'localhost' IDENTIFIED BY '비밀번호';
GRANT ALL PRIVILEGES ON *.* TO 'admin'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;

binary log 활성화

1
2
3
4
5
6
7
8
9


vim /etc/mysql/my.cnf

[mysqld]
log-bin = mariadb-bin
binlog-format = MIXED
server-id = 1

systemctl restart mariadb
SHOW VARIABLES LIKE 'log_bin';

MariaDB를 완전 제거

1
2


apt purge mariadb-server mariadb-client
rm -rf /etc/mysql /var/lib/mysql

MySQL / MariaDB 덤프 및 복원

Fri, 16 May 2025 09:00:00 +0900

서비스 운영 중에 DB 백업/복원 작업할 때 주의할 점 정리
옵션에 따라 백업/복원 기능이 다르니 주의 필요

1. DB 접근

1

mysql -u 사용자 -p -h 도메인명

2. DB 덤프 (백업)

1
2
3
4
5
6


mysqldump -h 도메인명 -u 사용자 -p \
 --single-transaction \
 --routines \
 --triggers \
 --events \
 BASE_DB > DB명_날짜.sql

옵션 설명

-single-transaction: InnoDB 전용. 덤프 중 트랜잭션 시작해서 일관된 스냅샷 유지. 서비스 중에도 락 없이 가능.
-routines: 저장 프로시저, 함수 포함.
-triggers: 각 테이블의 트리거 포함.
-events: 이벤트 스케줄러 이벤트 포함.

3. 덤프 파일 확인 (USE 문 유무)

mysqldump 시 --databases 옵션 사용하면 .sql 파일에 CREATE DATABASE + USE DB명; 구문 포함됨
복원 시 다른 DB에 덮어씌어짐

반드시 확인 필요

1

head -n 30 DB명_날짜.sql | grep -i "^USE"

만약 USE DB명; 이 있을 경우 → 주석 처리

1
2


-- Before: USE BASE_DB;
-- After : -- USE BASE_DB;

4. 덤프 파일을 통한 복원

1

mysql -h 도메인명 -u 사용자 -p 생성한DB명 < DB명_날짜.sql

신규 DB는 복원 전 DB 생성 필요

5. 기존/신규 DB 확인

기존/신규 DB 내 테이블의 rows 수가 동일한지 확인

1
2
3


mysql> SELECT 기존DB명 AS source, COUNT(*) FROM 기존DB명.PTNT_RSRV_HIST_BACK
 -> UNION ALL
 -> SELECT 신규DB명, COUNT(*) FROM 신규DB명.PTNT_RSRV_HIST_BACK;

주의사항 요약

mysqldump에 -databases 옵션 쓰면 USE 문 포함됨 → 다른 DB 덮어씌우는 원인.
클라우드 DB는 SUPER 권한 없을 수 있음 → -set-gtid-purged=OFF 넣어야 에러 안남.
복원할 DB명과 .sql 파일 내 USE 구문 다를 경우 조심해야 함.