기본 설정 구조:

server.modules = (
    "mod_access",
    "mod_alias",
    "mod_compress",
    "mod_redirect"
)

server.document-root = "/var/www/html"
server.upload-dirs = ( "/var/cache/lighttpd/uploads" )
server.errorlog = "/var/log/lighttpd/error.log"
server.pid-file = "/var/run/lighttpd.pid"
server.username = "www-data"
server.groupname = "www-data"
server.port = 80

index-file.names = ( "index.php", "index.html", "index.htm" )
url.access-deny = ( "~", ".inc" )

static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" )

Lighttpd는 여러 이벤트 핸들러를 지원해. 운영체제에 따라 최적의 핸들러를 선택하는 게 중요해!

# Linux의 경우 (가장 빠름)
server.event-handler = "linux-sysepoll"

# FreeBSD의 경우
server.event-handler = "freebsd-kqueue"

# 일반적인 경우 (호환성 최우선)
server.event-handler = "poll"

linux-sysepoll은 리눅스에서 가장 효율적인 방식이야. 수천 개의 동시 연결도 거뜬하게 처리할 수 있지! 💪

# Linux 2.6 이상에서 최고 성능
server.network-backend = "linux-sendfile"

# 범용 설정
server.network-backend = "writev"

sendfile() 시스템 콜은 커널 공간에서 직접 파일을 전송해서 엄청나게 빨라. 특히 큰 파일을 서빙할 때 차이가 확 나!

# 최대 동시 연결 수
server.max-connections = 1024

# Keep-Alive 설정
server.max-keep-alive-requests = 16
server.max-keep-alive-idle = 5

# 읽기/쓰기 타임아웃
server.max-read-idle = 60
server.max-write-idle = 360

압축은 대역폭을 크게 줄여주는 마법 같은 기능이야! 🎩

server.modules += ( "mod_compress" )

compress.cache-dir = "/var/cache/lighttpd/compress/"
compress.filetype = (
    "application/javascript",
    "text/css",
    "text/html",
    "text/plain",
    "text/xml",
    "application/json"
)

# 압축 레벨 (1-9, 6이 균형점)
compress.allowed-encodings = ( "gzip", "deflate" )

server.modules += ( "mod_expire" )

expire.url = (
    "/images/" => "access plus 1 months",
    "/css/" => "access plus 1 weeks",
    "/js/" => "access plus 1 weeks",
    "/fonts/" => "access plus 1 years"
)

브라우저 캐싱을 적극 활용하면 반복 방문자의 로딩 속도가 엄청나게 빨라져. 특히 이미지나 폰트 같은 건 거의 변하지 않으니까 긴 캐시 시간을 설정하는 게 좋아!

# ETag 사용 (파일 변경 감지)
etag.use-inode = "enable"
etag.use-mtime = "enable"
etag.use-size = "enable"

# 또는 성능을 위해 ETag 비활성화
static-file.etags = "disable"

mimetype.assign = (
    ".html" => "text/html",
    ".txt" => "text/plain",
    ".jpg" => "image/jpeg",
    ".png" => "image/png",
    ".gif" => "image/gif",
    ".css" => "text/css",
    ".js" => "application/javascript",
    ".json" => "application/json",
    ".xml" => "text/xml",
    ".svg" => "image/svg+xml",
    ".woff" => "font/woff",
    ".woff2" => "font/woff2",
    ".webp" => "image/webp"
)

올바른 MIME 타입 설정은 브라우저가 파일을 효율적으로 처리하게 도와줘. 특히 최신 포맷(webp, woff2 등)은 꼭 추가해주자!

1. 디렉토리 리스팅 차단

dir-listing.activate = "disable"

2. 민감한 파일 접근 차단

url.access-deny = ( "~", ".inc", ".git", ".env", ".htaccess" )

$HTTP["url"] =~ "\.pdf$" {
    server.range-requests = "disable"
}

3. 보안 헤더 추가

server.modules += ( "mod_setenv" )

setenv.add-response-header = (
    "X-Frame-Options" => "SAMEORIGIN",
    "X-Content-Type-Options" => "nosniff",
    "X-XSS-Protection" => "1; mode=block",
    "Referrer-Policy" => "strict-origin-when-cross-origin"
)

1. 상태 모듈 활성화

server.modules += ( "mod_status" )

status.status-url = "/server-status"
status.config-url = "/server-config"

# 특정 IP만 접근 허용
$HTTP["remoteip"] == "127.0.0.1" {
    status.status-url = "/server-status"
}

2. 액세스 로그 최적화

server.modules += ( "mod_accesslog" )

accesslog.filename = "/var/log/lighttpd/access.log"

# 커스텀 로그 포맷
accesslog.format = "%h %V %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\""

# 특정 파일은 로깅 제외 (성능 향상)
$HTTP["url"] =~ "\.(jpg|png|gif|css|js)$" {
    accesslog.filename = "/dev/null"
}

server.modules += ( "mod_proxy" )

proxy.server = (
    "/api" => (
        (
            "host" => "127.0.0.1",
            "port" => 3000
        )
    )
)

# 로드 밸런싱
proxy.server = (
    "/app" => (
        (
            "host" => "127.0.0.1",
            "port" => 8001
        ),
        (
            "host" => "127.0.0.1",
            "port" => 8002
        )
    )
)

proxy.balance = "fair"

# 간단한 가상 호스트
$HTTP["host"] == "example.com" {
    server.document-root = "/var/www/example.com"
}

$HTTP["host"] == "blog.example.com" {
    server.document-root = "/var/www/blog"
}

# 정규표현식 사용
$HTTP["host"] =~ "^(www\.)?example\.com$" {
    server.document-root = "/var/www/example.com"
}

# 조건부 설정
$HTTP["host"] == "api.example.com" {
    server.document-root = "/var/www/api"
    
    # API 전용 설정
    server.max-keep-alive-requests = 100
    compress.filetype = ( "application/json" )
}

가상 호스트를 사용하면 하나의 서버로 여러 사이트를 효율적으로 관리할 수 있어. 각 사이트마다 독립적인 설정도 가능하고!

server.modules += ( "mod_openssl" )

$SERVER["socket"] == ":443" {
    ssl.engine = "enable"
    ssl.pemfile = "/etc/lighttpd/certs/example.com.pem"
    ssl.ca-file = "/etc/lighttpd/certs/ca.pem"
    
    # 최신 TLS 프로토콜만 사용
    ssl.use-sslv2 = "disable"
    ssl.use-sslv3 = "disable"
    ssl.use-tlsv10 = "disable"
    ssl.use-tlsv11 = "disable"
    
    # 강력한 암호화 스위트
    ssl.cipher-list = "ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES256-GCM-SHA384"
    
    # HSTS 활성화
    setenv.add-response-header = (
        "Strict-Transport-Security" => "max-age=31536000; includeSubDomains; preload"
    )
}

# HTTP를 HTTPS로 리다이렉트
$HTTP["scheme"] == "http" {
    url.redirect = ( "^/(.*)" => "https://example.com/$1" )
}

server.modules += ( "mod_fastcgi" )

fastcgi.server = (
    ".php" => (
        "localhost" => (
            "socket" => "/var/run/php/php7.4-fpm.sock",
            "broken-scriptfilename" => "enable"
        )
    )
)

# 또는 TCP 소켓 사용
fastcgi.server = (
    ".php" => (
        "localhost" => (
            "host" => "127.0.0.1",
            "port" => 9000
        )
    )
)

1. 서버가 시작되지 않을 때

# 설정 파일 문법 검사
lighttpd -t -f /etc/lighttpd/lighttpd.conf

# 상세 에러 로그 확인
tail -f /var/log/lighttpd/error.log

# 포트 충돌 확인
sudo netstat -tlnp | grep :80

2. 502 Bad Gateway 에러

FastCGI나 프록시 백엔드가 응답하지 않을 때 발생해. 백엔드 서비스가 실행 중인지 확인하고, 소켓 경로나 포트 번호가 정확한지 체크해봐.

3. 높은 메모리 사용

# 연결 수 제한 조정
server.max-connections = 512

# Keep-Alive 요청 수 줄이기
server.max-keep-alive-requests = 8

# 업로드 버퍼 크기 조정
server.max-request-size = 2048

4. 느린 응답 속도

server.modules = (
    "mod_access",
    "mod_compress",
    "mod_expire",
    "mod_setenv"
)

server.document-root = "/var/www/images"
server.port = 80

server.event-handler = "linux-sysepoll"
server.network-backend = "linux-sendfile"

server.max-connections = 2048
server.max-keep-alive-requests = 32
server.max-keep-alive-idle = 10

# 이미지 압축 (WebP, SVG만)
compress.cache-dir = "/var/cache/lighttpd/compress/"
compress.filetype = ( "image/svg+xml" )

# 긴 캐시 시간 설정
expire.url = (
    "/" => "access plus 1 years"
)

# 보안 헤더
setenv.add-response-header = (
    "X-Content-Type-Options" => "nosniff",
    "Access-Control-Allow-Origin" => "*"
)

# MIME 타입
mimetype.assign = (
    ".jpg" => "image/jpeg",
    ".jpeg" => "image/jpeg",
    ".png" => "image/png",
    ".gif" => "image/gif",
    ".webp" => "image/webp",
    ".svg" => "image/svg+xml"
)

# 불필요한 로깅 제외
accesslog.filename = "/dev/null"

재능넷(https://www.jaenung.net)에는 서버 관리와 최적화 전문가들이 많아. 실제 프로젝트에 Lighttpd를 적용하면서 막히는 부분이 있다면, 재능넷의 '지식인의 숲'에서 다양한 가이드를 찾아볼 수 있고, 전문가에게 직접 컨설팅을 받을 수도 있어.

특히 서버 성능 튜닝은 경험이 정말 중요한 분야거든. 책이나 문서로는 배우기 힘든 실전 노하우들이 많아. 재능넷에서 실무 경험이 풍부한 전문가를 만나면 시행착오를 크게 줄일 수 있지! 💡

1. Apache Bench (ab)

# 기본 테스트
ab -n 10000 -c 100 http://localhost/

# Keep-Alive 테스트
ab -n 10000 -c 100 -k http://localhost/

# 결과 해석
# Requests per second: 초당 처리 요청 수 (높을수록 좋음)
# Time per request: 요청당 소요 시간 (낮을수록 좋음)
# Transfer rate: 전송 속도 (높을수록 좋음)

2. wrk (현대적인 벤치마크 도구)

# 설치
sudo apt install wrk

# 테스트 실행
wrk -t12 -c400 -d30s http://localhost/

# -t: 스레드 수
# -c: 동시 연결 수
# -d: 테스트 지속 시간

3. 실시간 모니터링

# 서버 상태 확인
curl http://localhost/server-status

# 시스템 리소스 모니터링
htop

# 네트워크 연결 확인
watch -n 1 'netstat -an | grep :80 | wc -l'

Dockerfile 작성

FROM alpine:latest

RUN apk add --no-cache lighttpd

COPY lighttpd.conf /etc/lighttpd/lighttpd.conf
COPY www/ /var/www/html/

EXPOSE 80

CMD ["lighttpd", "-D", "-f", "/etc/lighttpd/lighttpd.conf"]

docker-compose.yml

version: '3.8'

services:
  web:
    build: .
    ports:
      - "80:80"
    volumes:
      - ./www:/var/www/html
      - ./logs:/var/log/lighttpd
    restart: unless-stopped
    environment:
      - TZ=Asia/Seoul

실행

# 빌드 및 실행
docker-compose up -d

# 로그 확인
docker-compose logs -f

# 재시작
docker-compose restart

1. Rate Limiting (요청 제한)

server.modules += ( "mod_evasive" )

evasive.max-conns-per-ip = 10

2. IP 기반 접근 제어

$HTTP["remoteip"] !~ "^(192\.168\.|10\.|127\.0\.0\.1)" {
    url.access-deny = ( "/admin" )
}

# 특정 IP만 허용
$HTTP["url"] =~ "^/private/" {
    $HTTP["remoteip"] !~ "^203\.0\.113\." {
        url.access-deny = ( "" )
    }
}

3. 기본 인증 설정

server.modules += ( "mod_auth" )

auth.backend = "htpasswd"
auth.backend.htpasswd.userfile = "/etc/lighttpd/.htpasswd"

auth.require = (
    "/admin" => (
        "method" => "basic",
        "realm" => "Admin Area",
        "require" => "valid-user"
    )
)

# .htpasswd 파일 생성
# htpasswd -c /etc/lighttpd/.htpasswd username

1. 조건부 캐싱

# 파일 타입별 차별화된 캐싱
$HTTP["url"] =~ "\.(jpg|jpeg|png|gif)$" {
    expire.url = ( "" => "access plus 1 years" )
}

$HTTP["url"] =~ "\.(css|js)$" {
    expire.url = ( "" => "access plus 1 months" )
}

$HTTP["url"] =~ "\.html$" {
    expire.url = ( "" => "access plus 1 hours" )
}

2. Cache-Control 헤더 세밀 조정

setenv.add-response-header = (
    "Cache-Control" => "public, max-age=31536000, immutable"
)

# API 응답은 캐싱 금지
$HTTP["url"] =~ "^/api/" {
    setenv.add-response-header = (
        "Cache-Control" => "no-store, no-cache, must-revalidate"
    )
}

3. 버전 기반 캐싱

# URL에 버전 포함: /css/style.v123.css
# 파일이 변경되면 버전 번호를 바꿔서 캐시 무효화

url.rewrite-once = (
    "^/css/style\.v[0-9]+\.css$" => "/css/style.css",
    "^/js/app\.v[0-9]+\.js$" => "/js/app.js"
)

1. 이미지 최적화

# WebP 이미지 우선 제공
$HTTP["useragent"] =~ "Chrome|Firefox" {
    url.rewrite-if-not-file = (
        "^/images/(.+)\.(jpg|png)$" => "/images/$1.webp"
    )
}

2. 모바일 전용 설정

# 모바일 디바이스 감지
$HTTP["useragent"] =~ "Mobile|Android|iPhone" {
    # 더 작은 Keep-Alive 값
    server.max-keep-alive-requests = 8
    
    # 모바일 전용 캐시 디렉토리
    compress.cache-dir = "/var/cache/lighttpd/mobile/"
}

3. 적응형 이미지 서빙

# 디바이스 픽셀 비율에 따른 이미지 제공
$HTTP["useragent"] =~ "iPhone|iPad" {
    url.rewrite-if-not-file = (
        "^/images/(.+)\.jpg$" => "/images/$1@2x.jpg"
    )
}

1. 디버그 모드 활성화

# 상세한 디버그 로그
debug.log-request-handling = "enable"
debug.log-file-not-found = "enable"
debug.log-request-header = "enable"
debug.log-response-header = "enable"

2. 성능 프로파일링

# strace로 시스템 콜 추적
strace -p $(pgrep lighttpd) -e trace=network

# lsof로 열린 파일 확인
lsof -p $(pgrep lighttpd)

# 메모리 사용량 상세 분석
pmap -x $(pgrep lighttpd)

3. 연결 상태 분석

# 현재 연결 상태 확인
netstat -an | grep :80 | awk '{print $6}' | sort | uniq -c

# TIME_WAIT 상태가 많다면
echo 1 > /proc/sys/net/ipv4/tcp_tw_reuse

CDN 친화적 설정

# CDN을 위한 최적 헤더 설정
setenv.add-response-header = (
    "Cache-Control" => "public, max-age=31536000",
    "Access-Control-Allow-Origin" => "*",
    "Timing-Allow-Origin" => "*"
)

# CDN IP에서의 요청 최적화
$HTTP["remoteip"] =~ "^(CDN_IP_RANGE)" {
    server.max-keep-alive-requests = 100
    server.max-keep-alive-idle = 30
}

# 원본 IP 보존
server.modules += ( "mod_extforward" )
extforward.forwarder = (
    "CDN_IP_RANGE" => "trust"
)

1. 대용량 파일 다운로드 서버

소프트웨어 배포 사이트나 미디어 파일 서버에서 많이 사용돼. 수천 명이 동시에 큰 파일을 다운로드해도 안정적으로 서비스할 수 있어.

2. IoT 디바이스 웹 인터페이스

라즈베리파이나 임베디드 리눅스 기기에서 웹 인터페이스를 제공할 때 최적이야. 메모리가 제한적인 환경에서도 잘 작동하거든.

3. 정적 사이트 호스팅

Jekyll, Hugo 같은 정적 사이트 생성기로 만든 블로그나 문서 사이트를 호스팅하기에 완벽해. 빠르고 안정적이지!

4. 개발 환경 로컬 서버

프론트엔드 개발할 때 간단한 로컬 서버로 사용하기 좋아. 설정이 간단하고 빠르게 띄울 수 있거든.

공식 문서:
• Lighttpd 공식 위키: https://redmine.lighttpd.net/projects/lighttpd/wiki
• 공식 문서: https://www.lighttpd.net/documentation/

커뮤니티:
• GitHub 저장소: https://github.com/lighttpd/lighttpd1.4
• 메일링 리스트: lighttpd@lighttpd.net
• Stack Overflow: lighttpd 태그

한국어 리소스:
• 재능넷 지식인의 숲에서 다양한 실전 가이드 확인
• 국내 개발자 커뮤니티의 경험담과 팁

Lighttpd는 2003년부터 꾸준히 개발되고 있는 성숙한 프로젝트야. 최근에는 HTTP/2 지원도 추가되면서 현대적인 웹 환경에도 잘 대응하고 있어.

장점:
• 안정성이 검증됨
• 리소스 효율이 뛰어남
• 설정이 직관적
• 임베디드 환경에 최적

고려사항:
• Nginx에 비해 커뮤니티가 작음
• 최신 기능 추가가 느린 편
• 복잡한 동적 콘텐츠 처리는 제한적

Lighttpd는 '가볍다'는 이름처럼 정말 효율적이고 빠른 웹 서버야. 특히 정적 파일 서빙이나 리소스가 제한된 환경에서는 다른 웹 서버들을 압도하는 성능을 보여주지.

하지만 기억해야 할 건, 완벽한 웹 서버는 없다는 거야. 프로젝트의 요구사항, 트래픽 패턴, 리소스 제약 등을 종합적으로 고려해서 선택해야 해. Lighttpd가 적합한 상황이라면, 이 글에서 소개한 최적화 기법들을 활용해서 최고의 성능을 뽑아낼 수 있을 거야! 💪

서버 관리는 계속 배우고 실험하는 과정이야. 설정을 바꿔보고, 벤치마크를 돌려보고, 모니터링하면서 점점 더 나은 설정을 찾아가는 거지. 처음엔 어렵게 느껴질 수 있지만, 하나씩 해보다 보면 어느새 전문가가 되어 있을 거야!

혹시 막히는 부분이 있거나 더 깊이 있는 조언이 필요하다면, 재능넷 같은 플랫폼에서 경험 많은 전문가들의 도움을 받는 것도 좋은 방법이야. 실전 경험에서 나온 노하우는 정말 값진 자산이거든! 🌟

자, 이제 당신의 Lighttpd 서버를 최적화할 차례야. 이 글이 도움이 되었길 바라며, 빠르고 안정적인 웹 서비스를 만들어가길 응원할게! 🚀