🪶
Apache HTTP Server 치트시트

apachectl/httpd 제어, 가상 호스트(VirtualHost), 리버스 프록시(mod_proxy), URL 재작성(mod_rewrite/.htaccess), SSL/TLS(HTTPS), 보안 및 MPM 성능 튜닝
#apache#httpd#webserver#reverse-proxy#ssl#mod_rewrite#htaccess#devops최종 업데이트: 2026-09-27
Apache HTTP Server 치트시트 핵심 명령어 및 실전 가이드

apachectl/httpd 제어, 가상 호스트(VirtualHost), 리버스 프록시(mod_proxy), URL 재작성(mod_rewrite/.htaccess), SSL/TLS(HTTPS), 보안 및 MPM 성능 튜닝
## 1. CLI 서비스 제어 & 문법 검사 (Service Control & CLI)
```bash
# 🪶 [1] 설정 파일 문법 검사 (Syntax Check - 설정 변경 후 필수!)
apachectl configtest       # 또는 httpd -t
# 구체적인 가상 호스트(VirtualHost) 바인딩 목록 확인
apachectl -S               # 또는 httpd -S

# 🔄 [2] 무중단 안전 리로드 (Graceful Reload) vs 재시작
apachectl graceful         # 처리 중인 요청 완료 후 안전하게 설정 리로드 (권장)
apachectl restart          # 즉시 중지 후 재시작
apachectl stop             # Apache 중지

# 🐧 [3] systemd 서비스 관리 (Linux)
# Ubuntu / Debian
sudo systemctl status apache2
sudo systemctl reload apache2
sudo systemctl restart apache2

# RHEL / CentOS / Rocky
sudo systemctl status httpd
sudo systemctl reload httpd
sudo systemctl restart httpd

# 📦 [4] 활성화된 모듈 및 버전 확인
apachectl -M               # 또는 httpd -M (로드된 전체 모듈 목록)
apachectl -V               # 상세 빌드 정보 및 MPM 모드 확인
```

## 2. 배포판별 디렉토리 구조 & 모듈 활성화
| 구분 | Ubuntu / Debian (`apache2`) | RHEL / CentOS (`httpd`) |
|---|---|---|
| **메인 설정 파일** | `/etc/apache2/apache2.conf` | `/etc/httpd/conf/httpd.conf` |
| **포트 설정** | `/etc/apache2/ports.conf` | 메인 설정 내 `Listen 80` |
| **가상 호스트** | `/etc/apache2/sites-available/` | `/etc/httpd/conf.d/*.conf` |
| **모듈 디렉토리** | `/etc/apache2/mods-available/` | `/etc/httpd/conf.modules.d/` |
| **기본 DocumentRoot** | `/var/www/html` | `/var/www/html` |
| **기본 로그 경로** | `/var/log/apache2/` | `/var/log/httpd/` |

```bash
# Ubuntu/Debian 전용 모듈 및 사이트 활성화 CLI
sudo a2enmod rewrite ssl proxy proxy_http headers deflate # 모듈 활성화
sudo a2dismod autoindex                                   # 모듈 비활성화
sudo a2ensite my-site.conf                                # 가상 호스트 활성화
sudo a2dissite 000-default.conf                           # 기본 사이트 비활성화
```

## 3. 기본 가상 호스트 (VirtualHost: 포트 80)
```apache
# /etc/apache2/sites-available/example.com.conf
<VirtualHost *:80>
    ServerName example.com
    ServerAlias www.example.com
    ServerAdmin admin@example.com
    DocumentRoot /var/www/example.com/public_html

    # 디렉토리별 접근 권한 설정
    <Directory /var/www/example.com/public_html>
        Options -Indexes +FollowSymLinks # -Indexes: 파일 목록 노출 차단
        AllowOverride All                # .htaccess 파일 사용 허용 (None: 무시)
        Require all granted              # 모든 클라이언트 접근 허가
    </Directory>

    # 에러 및 액세스 로그 경로
    ErrorLog ${APACHE_LOG_DIR}/example_error.log
    CustomLog ${APACHE_LOG_DIR}/example_access.log combined
</VirtualHost>
```

## 4. 리버스 프록시 (Reverse Proxy & Load Balancer)
Spring Boot, Node.js, Tomcat 등으로 트래픽을 프록시 전달할 때 사용 (`mod_proxy`, `mod_proxy_http` 필요).
```apache
<VirtualHost *:80>
    ServerName api.example.com

    # 프록시 설정
    ProxyRequests Off               # Forward Proxy 비활성화 (보안 필수)
    ProxyPreserveHost On            # 원본 요청의 Host 헤더를 백엔드로 보존 전달
    ProxyAddHeaders On              # X-Forwarded-For, X-Forwarded-Host 자동 추가

    # [1] 단일 백엔드 프록시 (포트 8080)
    ProxyPass / http://127.0.0.1:8080/
    ProxyPassReverse / http://127.0.0.1:8080/

    # [2] 로드 밸런싱 (Round Robin)
    <Proxy "balancer://mycluster">
        BalancerMember http://192.168.1.11:8080 route=node1
        BalancerMember http://192.168.1.12:8080 route=node2
        ProxySet lbmethod=byrequests
    </Proxy>
    # ProxyPass / balancer://mycluster/
    # ProxyPassReverse / balancer://mycluster/
</VirtualHost>
```

## 5. URL 재작성 (mod_rewrite) & .htaccess
SPA(Vue/React) 라우팅 및 301 영구 리다이렉트 패턴 (`RewriteEngine On` 필수).
```apache
# [1] HTTP -> HTTPS 무조건 영구 리다이렉트 (301)
RewriteEngine On
RewriteCond %{HTTPS} off
RewriteRule ^ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]

# [2] WWW 없는 도메인으로 통합 (example.com)
RewriteCond %{HTTP_HOST} ^www\.(.*)$ [NC]
RewriteRule ^ https://%1%{REQUEST_URI} [R=301,L]

# [3] Vue / React / Angular SPA 라우팅 (HTML5 History Mode Fallback)
<Directory /var/www/spa/dist>
    RewriteEngine On
    RewriteBase /
    RewriteRule ^index\.html$ - [L]
    RewriteCond %{REQUEST_FILENAME} !-f # 실제 파일이 아니면
    RewriteCond %{REQUEST_FILENAME} !-d # 실제 디렉토리가 아니면
    RewriteRule . /index.html [L]       # index.html로 내부 포워딩
</Directory>
```
- `[NC]`: No Case (대소문자 무시)
- `[L]`: Last (이 규칙이 매칭되면 다음 Rewrite 규칙 건너뜀)
- `[R=301]`: HTTP 301 영구 리다이렉트 (검색엔진 SEO 최적화)

## 6. SSL/TLS (HTTPS: 포트 443) 보안 설정
```apache
<VirtualHost *:443>
    ServerName example.com
    DocumentRoot /var/www/example.com/public_html

    # SSL 활성화 및 인증서 경로 (Let's Encrypt 표준 예시)
    SSLEngine on
    SSLCertificateFile /etc/letsencrypt/live/example.com/fullchain.pem
    SSLCertificateKeyFile /etc/letsencrypt/live/example.com/privkey.pem

    # 모던 보안 프로토콜 및 암호화 스위트 (TLS 1.2, 1.3만 허용)
    SSLProtocol all -SSLv3 -TLSv1 -TLSv1.1
    SSLCipherSuite HIGH:!aNULL:!MD5:!3DES
    SSLHonorCipherOrder on

    # HSTS 활성화 (브라우저에 HTTPS 접속 강제, 6개월)
    Header always set Strict-Transport-Security "max-age=15768000; includeSubDomains; preload"
</VirtualHost>
```

## 7. 보안 강화, Gzip 압축 & 브라우저 캐싱
```apache
# 🔒 [1] 서버 버전 정보 은닉 (보안 필수)
ServerTokens Prod       # Server 헤더에 'Apache'만 노출 (OS 및 세부버전 숨김)
ServerSignature Off     # 에러 페이지 하단 서버 정보 출력 비활성화

# 🛡️ [2] 필수 보안 응답 헤더 추가 (mod_headers)
Header always set X-Frame-Options "SAMEORIGIN"
Header always set X-Content-Type-Options "nosniff"
Header always set X-XSS-Protection "1; mode=block"
Header always set Referrer-Policy "strict-origin-when-cross-origin"

# 🗜️ [3] Gzip 텍스트 압축 전송 (mod_deflate)
<IfModule mod_deflate.c>
    AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript
    AddOutputFilterByType DEFLATE application/javascript application/json application/xml
</IfModule>

# ⚡ [4] 브라우저 캐싱 만료 시간 설정 (mod_expires)
<IfModule mod_expires.c>
    ExpiresActive On
    ExpiresByType image/webp "access plus 1 month"
    ExpiresByType image/jpeg "access plus 1 month"
    ExpiresByType image/png  "access plus 1 month"
    ExpiresByType text/css   "access plus 1 week"
    ExpiresByType application/javascript "access plus 1 week"
</IfModule>
```

## 8. MPM 모드 & 성능 최적화 (Event MPM 권장)
Apache 2.4+ 환경에서는 고성능 비동기 처리가 가능한 `mpm_event`가 기본 권장됩니다.
```apache
# /etc/apache2/mods-available/mpm_event.conf
<IfModule mpm_event_module>
    StartServers             3      # 초기 기동할 프로세스 수
    MinSpareThreads         75      # 최소 유휴 스레드 수
    MaxSpareThreads        250      # 최대 유휴 스레드 수
    ThreadsPerChild         25      # 자식 프로세스당 생성할 스레드 수
    MaxRequestWorkers      400      # 동시 처리 가능한 최대 클라이언트 요청 수
    MaxConnectionsPerChild   0      # 프로세스 재사용 횟수 (0: 무제한)
</IfModule>

# KeepAlive 커넥션 재사용 설정
KeepAlive On
MaxKeepAliveRequests 100
KeepAliveTimeout 5                  # 유휴 연결 유지 시간 (초 단위)
```
💬
Apache HTTP Server 치트시트

의견 및 질문

댓글 수정

댓글 삭제
