readme.md 수정

This commit is contained in:
2025-12-23 11:46:56 +09:00
parent 0c471dea47
commit dd654b970b

View File

@ -5,7 +5,7 @@
Cafe24 10G 자이언트플러스 환경과 최대한 동일한 테스트 서버 구성을 위한 완전 자동화 스크립트 모음입니다. Cafe24 10G 자이언트플러스 환경과 최대한 동일한 테스트 서버 구성을 위한 완전 자동화 스크립트 모음입니다.
### 구성도 ### 구성도
` ```
Proxmox VE (호스트) Proxmox VE (호스트)
@ -20,13 +20,13 @@ Cafe24 10G 자이언트플러스 환경과 최대한 동일한 테스트 서버
Tailscale 연동 (원격 접근) Tailscale 연동 (원격 접근)
` ````
--- ---
## 디렉토리 구조 ## 디렉토리 구조
` ```
maketestserver/ maketestserver/
README.md # 이 파일 README.md # 이 파일
dotfiles/ # git 관리 설정 파일 dotfiles/ # git 관리 설정 파일
@ -37,7 +37,7 @@ maketestserver/
install_php.sh # PHP 8.2/8.4 설치 install_php.sh # PHP 8.2/8.4 설치
lxc/ # LXC 스크립트 lxc/ # LXC 스크립트
setup_mariadb.sh # MariaDB 10.6 설정 setup_mariadb.sh # MariaDB 10.6 설정
` ```
--- ---
@ -46,7 +46,7 @@ maketestserver/
### 1 Proxmox에서 VM 생성 ### 1 Proxmox에서 VM 생성
#### VM1 (PHP 8.2) #### VM1 (PHP 8.2)
`bash ```bash
# Proxmox 호스트에서 실행 # Proxmox 호스트에서 실행
qm create 101 \ qm create 101 \
--name vm1-php82 \ --name vm1-php82 \
@ -58,10 +58,10 @@ qm create 101 \
--cdrom local:iso/Rocky-9.0-latest.iso --cdrom local:iso/Rocky-9.0-latest.iso
qm start 101 qm start 101
` ```
#### VM2 (PHP 8.4) #### VM2 (PHP 8.4)
`bash ```bash
qm create 102 \ qm create 102 \
--name vm2-php84 \ --name vm2-php84 \
--memory 2048 \ --memory 2048 \
@ -72,7 +72,7 @@ qm create 102 \
--cdrom local:iso/Rocky-9.0-latest.iso --cdrom local:iso/Rocky-9.0-latest.iso
qm start 102 qm start 102
` ```
**Rocky Linux 9 설치 시 주의:** **Rocky Linux 9 설치 시 주의:**
- 설치 중 일반 사용자 생성 (예: 'firstgarden') - 설치 중 일반 사용자 생성 (예: 'firstgarden')
@ -81,7 +81,7 @@ qm start 102
### 2 Proxmox에서 LXC 생성 (MariaDB) ### 2 Proxmox에서 LXC 생성 (MariaDB)
`bash ```bash
# LXC 생성 # LXC 생성
pct create 201 \ pct create 201 \
local:vztmpl/rocky-9-default_9.0-1_amd64.tar.gz \ local:vztmpl/rocky-9-default_9.0-1_amd64.tar.gz \
@ -93,13 +93,13 @@ pct create 201 \
pct start 201 pct start 201
pct enter 201 # LXC 진입 pct enter 201 # LXC 진입
` ```
### 3 VM1 (PHP 8.2) 설정 ### 3 VM1 (PHP 8.2) 설정
SSH로 VM1에 접속한 후: SSH로 VM1에 접속한 후:
`bash ```bash
# 스크립트 다운로드 # 스크립트 다운로드
cd ~ cd ~
git clone https://github.com/yourusername/cafe24-testserver.git git clone https://github.com/yourusername/cafe24-testserver.git
@ -115,21 +115,21 @@ chmod +x vm/install_php.sh
# Apache 재시작 # Apache 재시작
sudo systemctl restart httpd sudo systemctl restart httpd
` ```
### 4 VM2 (PHP 8.4) 설정 ### 4 VM2 (PHP 8.4) 설정
VM1과 동일하게 진행하되, PHP 버전만 8.4로 변경: VM1과 동일하게 진행하되, PHP 버전만 8.4로 변경:
`bash ```bash
./vm/install_php.sh 8.4 ./vm/install_php.sh 8.4
` ```
### 5 LXC (MariaDB) 설정 ### 5 LXC (MariaDB) 설정
LXC에서 Root로 로그인한 후: LXC에서 Root로 로그인한 후:
`bash ```bash
# 스크립트 다운로드 # 스크립트 다운로드
cd /root cd /root
curl -fsSL https://github.com/yourusername/cafe24-testserver/archive/main.tar.gz | tar xz curl -fsSL https://github.com/yourusername/cafe24-testserver/archive/main.tar.gz | tar xz
@ -138,7 +138,7 @@ cd cafe24-testserver-main
# MariaDB 설정 실행 # MariaDB 설정 실행
chmod +x lxc/setup_mariadb.sh chmod +x lxc/setup_mariadb.sh
./lxc/setup_mariadb.sh ./lxc/setup_mariadb.sh
` ```
**스크립트 실행 중 입력 항목:** **스크립트 실행 중 입력 항목:**
- Linux 사용자 이름 - Linux 사용자 이름
@ -163,10 +163,10 @@ chmod +x lxc/setup_mariadb.sh
- firewalld 비활성화 - firewalld 비활성화
**실행:** **실행:**
`bash ```bash
chmod +x vm/setup_common.sh chmod +x vm/setup_common.sh
./vm/setup_common.sh ./vm/setup_common.sh
` ```
**생성되는 디렉토리:** **생성되는 디렉토리:**
- '~/www' - 웹 루트 (권한: 750) - '~/www' - 웹 루트 (권한: 750)
@ -190,20 +190,20 @@ PHP 8.2 또는 8.4를 설치하고 PHP-FPM pool을 생성합니다.
- 필수 확장: mysqlnd, pdo, mbstring, xml, gd, curl, opcache, soap, intl, zip, bcmath, bz2, imagick - 필수 확장: mysqlnd, pdo, mbstring, xml, gd, curl, opcache, soap, intl, zip, bcmath, bz2, imagick
**실행:** **실행:**
`bash ```bash
chmod +x vm/install_php.sh chmod +x vm/install_php.sh
./vm/install_php.sh 8.2 # PHP 8.2 ./vm/install_php.sh 8.2 # PHP 8.2
./vm/install_php.sh 8.4 # PHP 8.4 ./vm/install_php.sh 8.4 # PHP 8.4
` ```
**생성되는 파일:** **생성되는 파일:**
- '/etc/php-fpm.d/.conf' - PHP-FPM pool 설정 - '/etc/php-fpm.d/.conf' - PHP-FPM pool 설정
**PHP 버전 확인:** **PHP 버전 확인:**
`bash ```bash
php -v php -v
php-fpm -v php-fpm -v
` ```
--- ---
@ -218,10 +218,10 @@ MariaDB 10.6을 설치하고 사용자/DB를 생성합니다.
- 초기 보안 설정 (테스트 DB/계정 제거) - 초기 보안 설정 (테스트 DB/계정 제거)
**실행:** **실행:**
`bash ```bash
chmod +x lxc/setup_mariadb.sh chmod +x lxc/setup_mariadb.sh
./lxc/setup_mariadb.sh ./lxc/setup_mariadb.sh
` ```
**대화형 입력:** **대화형 입력:**
1. Linux 사용자 이름 (권장: 첫 번째 설정한 사용자) 1. Linux 사용자 이름 (권장: 첫 번째 설정한 사용자)
@ -230,13 +230,13 @@ chmod +x lxc/setup_mariadb.sh
4. Database 이름 (예: 'testdb') 4. Database 이름 (예: 'testdb')
**접속 확인 (VM에서):** **접속 확인 (VM에서):**
`bash ```bash
# LXC IP 확인: pct exec 201 ip addr show eth0 | grep inet # LXC IP 확인: pct exec 201 ip addr show eth0 | grep inet
mysql -h <LXC_IP> -u <DB_USER> -p<DB_PW> mysql -h <LXC_IP> -u <DB_USER> -p<DB_PW>
# 또는 # 또는
mysql -h 192.168.1.100 -u firstgarden -p mysql -h 192.168.1.100 -u firstgarden -p
` ```
--- ---
@ -265,16 +265,16 @@ mysql -h 192.168.1.100 -u firstgarden -p
원격에서 테스트 서버에 접근하려면: 원격에서 테스트 서버에 접근하려면:
### VM 및 LXC에 설치 ### VM 및 LXC에 설치
`bash ```bash
curl -fsSL https://tailscale.com/install.sh | sh curl -fsSL https://tailscale.com/install.sh | sh
sudo systemctl enable --now tailscaled sudo systemctl enable --now tailscaled
# 가입 및 네트워크 등록 # 가입 및 네트워크 등록
sudo tailscale up sudo tailscale up
` ```
### 접속 ### 접속
`bash ```bash
# 각 호스트의 Tailscale IP 확인 # 각 호스트의 Tailscale IP 확인
tailscale ip tailscale ip
@ -283,7 +283,7 @@ ssh firstgarden@100.x.x.x
# MySQL 접속 # MySQL 접속
mysql -h 100.x.x.x -u firstgarden -p mysql -h 100.x.x.x -u firstgarden -p
` ```
--- ---
@ -296,7 +296,7 @@ mysql -h 100.x.x.x -u firstgarden -p
- **firewalld:** 비활성화 (테스트 환경용) - **firewalld:** 비활성화 (테스트 환경용)
### 프로덕션 권장사항 ### 프로덕션 권장사항
`bash ```bash
# SSH 공개키 인증 설정 # SSH 공개키 인증 설정
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519
@ -313,7 +313,7 @@ sudo nano /etc/ssh/sshd_config
# PermitRootLogin no # PermitRootLogin no
sudo systemctl restart sshd sudo systemctl restart sshd
` ```
--- ---
@ -321,26 +321,26 @@ sudo systemctl restart sshd
### PHP-FPM 튜닝 ### PHP-FPM 튜닝
'/etc/php-fpm.d/.conf' 수정: '/etc/php-fpm.d/.conf' 수정:
`ini ```ini
pm.max_children = 20 # 최대 프로세스 (RAM에 따라) pm.max_children = 20 # 최대 프로세스 (RAM에 따라)
pm.start_servers = 5 pm.start_servers = 5
pm.min_spare_servers = 2 pm.min_spare_servers = 2
pm.max_spare_servers = 10 pm.max_spare_servers = 10
` ```
### MariaDB 튜닝 ### MariaDB 튜닝
'/etc/my.cnf.d/50-server.cnf' 수정: '/etc/my.cnf.d/50-server.cnf' 수정:
`ini ```ini
max_connections = 200 max_connections = 200
innodb_buffer_pool_size = 512M innodb_buffer_pool_size = 512M
` ```
--- ---
## 문제 해결 ## 문제 해결
### Apache 403 Forbidden ### Apache 403 Forbidden
`bash ```bash
# 웹 루트 권한 확인 # 웹 루트 권한 확인
ls -ld ~/www ls -ld ~/www
# 예상: drwxr-x--- (750) # 예상: drwxr-x--- (750)
@ -350,10 +350,10 @@ ps aux | grep apache
# SELinux 컨텍스트 확인 # SELinux 컨텍스트 확인
ls -Z ~/www ls -Z ~/www
` ```
### PHP-FPM 연결 실패 ### PHP-FPM 연결 실패
`bash ```bash
# PHP-FPM 상태 확인 # PHP-FPM 상태 확인
sudo systemctl status php-fpm sudo systemctl status php-fpm
@ -362,10 +362,10 @@ ls -l /run/php-fpm/.sock
# Apache에서 PHP 핸들러 설정 확인 # Apache에서 PHP 핸들러 설정 확인
grep -r "proxy_fcgi" /etc/httpd/conf.d/ grep -r "proxy_fcgi" /etc/httpd/conf.d/
` ```
### MariaDB 연결 실패 ### MariaDB 연결 실패
`bash ```bash
# MariaDB 상태 확인 # MariaDB 상태 확인
sudo systemctl status mariadb sudo systemctl status mariadb
@ -377,7 +377,7 @@ sudo ss -tlnp | grep 3306
# 방화벽 확인 (LXC) # 방화벽 확인 (LXC)
sudo firewall-cmd --list-ports sudo firewall-cmd --list-ports
` ```
--- ---
@ -406,11 +406,11 @@ sudo firewall-cmd --list-ports
### 파일 권한 ### 파일 권한
스크립트 실행 가능 권한 설정: 스크립트 실행 가능 권한 설정:
`bash ```bash
chmod +x vm/setup_common.sh chmod +x vm/setup_common.sh
chmod +x vm/install_php.sh chmod +x vm/install_php.sh
chmod +x lxc/setup_mariadb.sh chmod +x lxc/setup_mariadb.sh
` ```
--- ---