tgbyte/lighttpd

Lighttpd Docker镜像文档

镜像概述与主要用途

概述

Lighttpd（发音"lighty"）是一款开源轻量级Web服务器，专注于高性能与低资源消耗。作为Docker镜像，它提供了快速部署、环境隔离和配置灵活的优势，无需手动编译安装即可在任何Docker环境中运行，确保部署一致性。

主要用途

• 静态资源服务：高效托管HTML、CSS、JavaScript、图片等静态文件
• 反向代理：转发客户端请求至后端应用服务器（如Node.js、Python服务）
• FastCGI支持：运行PHP等动态脚本语言应用
• HTTPS/HTTP服务：提供加密与非加密Web访问
• 开发测试环境：快速搭建本地一致的Web服务环境

核心功能与特性

• 轻量级设计：内存占用极低（通常仅需数MB），适合资源受限环境
• 高性能架构：采用事件驱动模型，高效处理并发连接（类似Nginx）
• 模块化架构：按需加载模块减少资源消耗，支持功能扩展
• 丰富协议支持：
  • HTTPS（TLS/SSL加密）
  • HTTP/2协议
  • URL重写、重定向、访问控制
  • 虚拟主机（多域名托管）
• 低资源消耗：CPU使用率低，适合边缘计算与嵌入式设备
• 灵活配置：简洁配置语法，支持动态加载与运行时调整

使用场景与适用范围

适用场景

• 静态内容服务器：博客、企业官网、文档站点等静态资源为主的网站
• 资源受限环境：VPS、小型云服务器、嵌入式设备（如树莓派）
• 高并发前端：作为流量入口处理静态资源，转发动态请求至后端
• 反向代理：隐藏后端服务，提升安全性并实现负载均衡
• 开发测试：快速搭建一致的Web服务验证页面或代理配置

不适用场景

• 需要复杂Apache模块的环境（如特定.htaccess规则）
• 强依赖Windows Server的部署（主要面向类Unix系统）

使用方法与配置说明

基本部署（Docker Run）

1. 启动默认配置服务

bash
docker run -d --name lighttpd -p 80:80 lighttpd

• -d：后台运行容器
• --name lighttpd：指定容器名称
• -p 80:80：映射主机80端口到容器80端口
• lighttpd：默认使用官方最新镜像

2. 挂载本地静态文件

bash
docker run -d --name lighttpd -p 80:80 -v /path/to/local/files:/var/www/localhost/htdocs lighttpd

将主机/path/to/local/files目录挂载为容器文档根目录，替换/path/to/local/files为实际路径

3. 使用自定义配置文件

bash
docker run -d --name lighttpd -p 80:80 \
  -v /path/to/lighttpd.conf:/etc/lighttpd/lighttpd.conf \
  -v /path/to/static:/var/www/localhost/htdocs \
  lighttpd

Docker Compose部署示例

创建docker-compose.yml：

yaml
version: '3'
services:
  lighttpd:
    image: lighttpd
    container_name: lighttpd
    ports:
      - "80:80"   # HTTP端口
      - "443:443" # HTTPS端口（如需启用）
    volumes:
      - ./static:/var/www/localhost/htdocs  # 静态文件目录
      - ./lighttpd.conf:/etc/lighttpd/lighttpd.conf  # 自定义配置
      - ./ssl:/etc/lighttpd/ssl  # SSL证书目录（HTTPS用）
    restart: unless-stopped  # 异常退出时自动重启

启动服务：

bash
docker-compose up -d

配置参数说明

核心配置文件（lighttpd.conf）

默认路径：/etc/lighttpd/lighttpd.conf，关键配置项：

启用HTTPS示例

1. 准备SSL证书（server.crt和server.key），合并为server.pem（证书在前，密钥在后）
2. 挂载证书目录至容器/etc/lighttpd/ssl
3. 修改lighttpd.conf添加HTTPS配置：

conf
server.modules += (
  "mod_openssl"
)

$SERVER["socket"] == ":443" {
  ssl.engine = "enable"
  ssl.pemfile = "/etc/lighttpd/ssl/server.pem"  # 合并的证书文件
  ssl.ca-file = "/etc/lighttpd/ssl/ca.crt"      # CA证书（可选）
  server.name = "example.com"
  server.document-root = "/var/www/localhost/htdocs"
}

反向代理配置示例

转发请求至后端Node.js服务（运行在http://backend:3000）：

conf
server.modules += (
  "mod_proxy"
)

proxy.server = (
  "/" => (
    (
      "host" => "backend",  # 后端服务地址（需与容器同网络）
      "port" => 3000        # 后端服务端口
    )
  )
)

注意事项

• 数据持久化：静态文件和配置文件建议通过-v挂载主机目录，避免容器删除导致数据丢失
• 日志管理：默认日志输出至容器内，可挂载日志目录或配置日志驱动实现持久化
• 安全加固：启用HTTPS、配置访问控制、定期更新镜像修复安全漏洞
• 模块管理：生产环境仅加载必要模块，减少***面（如禁用未使用的mod_webdav）