[Infra Ops] httpd VirtualHost 설정과 리버스 프록시 운영

# 현재 사용 중인 MPM 확인
httpd -V | grep -i mpm
# 또는
apachectl -V | grep MPM

# 출력 예시:
# Server MPM:     event
# httpd compiled with: -D APR_HAS_SENDFILE ...

# /etc/httpd/conf.d/example.conf

<VirtualHost *:80>
    # 이 VirtualHost가 응답할 기본 도메인
    ServerName www.example.com
    # 동일 콘텐츠로 응답할 추가 도메인 (별칭)
    ServerAlias example.com

    # 정적 파일을 서빙할 루트 디렉터리
    DocumentRoot /var/www/example

    # DocumentRoot에 대한 접근 제어
    <Directory /var/www/example>
        # -Indexes: 파일 목록 노출 금지 (보안)
        Options -Indexes
        # AllowOverride None: .htaccess 무시 (성능 향상)
        AllowOverride None
        # Require all granted: 모든 클라이언트 허용
        Require all granted
    </Directory>

    # 이 VirtualHost 전용 로그 (전역 로그와 분리)
    ErrorLog /var/log/httpd/example-error.log
    CustomLog /var/log/httpd/example-access.log combined
</VirtualHost>

# CentOS/RHEL: 모듈 설정 파일 확인
cat /etc/httpd/conf.modules.d/00-proxy.conf

# 아래 줄들이 주석 해제되어 있어야 함:
# LoadModule proxy_module modules/mod_proxy.so
# LoadModule proxy_http_module modules/mod_proxy_http.so
# LoadModule headers_module modules/mod_headers.so

# Ubuntu/Debian: a2enmod로 활성화
sudo a2enmod proxy proxy_http headers
sudo systemctl reload apache2

<VirtualHost *:80>
    ServerName api.example.com

    # ProxyPreserveHost On: 원본 Host 헤더를 백엔드로 그대로 전달
    # Off로 하면 백엔드는 127.0.0.1을 Host로 받음
    ProxyPreserveHost On

    # /api/ 로 들어온 요청을 백엔드 8080 포트로 전달
    ProxyPass /api/ http://127.0.0.1:8080/api/

    # 백엔드가 응답에 Location 헤더를 보낼 때 URL을 클라이언트 주소로 재작성
    ProxyPassReverse /api/ http://127.0.0.1:8080/api/

    # 실제 클라이언트 IP와 프로토콜을 백엔드에 전달
    RequestHeader set X-Real-IP "%{REMOTE_ADDR}s"
    RequestHeader set X-Forwarded-Proto "http"
</VirtualHost>

%h   %l   %u   %t          "%r"                  %>s  %b
IP  ident user  시각    "메서드 URI 프로토콜"  최종상태 바이트수

203.0.113.42 - jdoe [30/May/2026:14:23:05 +0900] "GET /api/users HTTP/1.1" 200 1523 "https://example.com" "Mozilla/5.0"

# /etc/httpd/conf/httpd.conf 또는 VirtualHost 블록의 CustomLog 수정
LogFormat "%h %l %u %t \"%r\" %>s %b %T %D" combined_time
CustomLog /var/log/httpd/example-access.log combined_time

# 응답시간 기준으로 느린 요청 상위 10개 추출 (%D가 마지막 필드인 경우)
awk '{print $NF, $7}' /var/log/httpd/example-access.log | sort -rn | head -10

# 설정 문법 검사 (서비스 영향 없음)
sudo apachectl configtest
# 또는 동일하게
sudo apachectl -t

# 시작 / 중지 / 완전 재시작
sudo apachectl start
sudo apachectl stop
sudo apachectl restart        # 프로세스 완전 종료 후 재시작 (순간 중단 발생)

# 무중단 재기동 (권장)
sudo apachectl graceful       # 기존 요청 완료 후 worker 교체, 새 설정 적용

# 무중단 중지 (마지막 요청 완료 후 종료)
sudo apachectl graceful-stop

# 운영 서버 표준 절차 (검증 후 무중단 반영)
sudo apachectl configtest && sudo apachectl graceful

# error_log 레벨 설정 (httpd.conf 또는 VirtualHost)
# LogLevel warn  ← 기본값 (debug/info/notice/warn/error/crit/alert/emerg)