jitesoft/lighttpd

Lighttpd

镜像概述

本镜像基于Alpine Linux，包含从源码构建的Lighttpd（简称lighty）轻量级Web服务器。Lighttpd是一款专为高性能环境设计优化的开源Web服务器，遵循修订后的BSD许可证，以低资源占用（磁盘、CPU、内存）和高效性能为核心特点。

核心功能与特性

• 轻量级高性能：基于Alpine Linux构建，保持极小镜像体积和资源消耗
• 灵活配置：支持通过/usr/local/lighttpd.d目录添加自定义配置文件（*.conf），或通过CONFIG_FILE环境变量替换基础配置
• CGI集成：cgi标签镜像预启用mod_fastcgi，支持连接外部CGI服务（如PHP-FPM）
• 环境变量控制：通过环境变量灵活配置端口、服务器名称、根目录、健康检查等核心参数
• 健康检查：内置健康检查机制，可通过SKIP_HEALTHCHECK控制检查行为

标签说明

镜像标签基于Lighttpd版本，latest对应构建时的最新版本（仅最新版本持续更新，旧版本不再重新构建）。可用镜像地址：

• Docker Hub：jitesoft/lighttpd
• GitLab：registry.gitlab.com/jitesoft/dockerfiles/lighttpd
• GitHub：ghcr.io/jitesoft/lighttpd
• Quay：quay.io/jitesoft/httpd

注意：2021年11月28日起，-fpm标签已弃用且停止更新，推荐使用功能类似但存在差异的-cgi标签镜像。

镜像详情

用户与权限

2021年7月23日前，镜像使用lighttpd用户（ID 1000/1000）运行；现调整为Alpine标准www-data用户（ID 82）以保持兼容性。容器默认以root身份启动，但Lighttpd进程默认使用www-data用户（ID 82）运行。

环境变量配置

通用环境变量

CGI标签特有环境变量（cgi标签镜像）

cgi标签镜像启用mod_fastcgi模块，支持连接外部CGI服务，通过以下变量配置：

CGI配置说明

cgi标签镜像默认配置位于/etc/lighttpd/conf.d，内容如下：

txt
server.modules += ("mod_fastcgi")
fastcgi.server += ( env.CGI_FILE_EXT =>
        ((
                "host" => env.CGI_HOST,
                "port" => env.CGI_PORT,
                "broken-scriptfilename" => "enable",
                "docroot" => env.SERVER_ROOT,
                "check-local" => env.CHECK_LOCAL
        ))
)

CGI服务连接成功后，容器会在/tmp/ready创建空文件，可作为启动就绪指示器。

使用方法

基本部署示例

启动默认配置的Lighttpd服务，映射本地./html目录到容器Web根目录：

bash
docker run -d -p 80:80 -v $(pwd)/html:/var/www/html docker.xuanyuan.run/jitesoft/lighttpd:latest

自定义配置示例

添加自定义配置文件（如my-config.conf）到/usr/local/lighttpd.d目录（所有.conf文件会被自动包含）：

bash
docker run -d -p 8080:8080 \
  -e PORT=8080 \
  -v $(pwd)/custom-config:/usr/local/lighttpd.d \
  docker.xuanyuan.run/jitesoft/lighttpd:latest

替换基础配置文件

通过CONFIG_FILE指定自定义主配置文件路径：

bash
docker run -d -p 80:80 \
  -e CONFIG_FILE=/etc/lighttpd/custom.conf \
  -v $(pwd)/custom.conf:/etc/lighttpd/custom.conf \
  docker.xuanyuan.run/jitesoft/lighttpd:latest

CGI集成示例

部署cgi标签镜像连接PHP-FPM服务（假设FPM容器名为php-fpm，端口9000）：

bash
docker run -d -p 80:80 \
  -e CGI_HOST=php-fpm \
  -e CGI_PORT=9000 \
  -e CGI_FILE_EXT=.php \
  -v $(pwd)/php-app:/var/www/html \
  --link php-fpm:fpm \
  docker.xuanyuan.run/jitesoft/lighttpd:cgi

镜像标签规范

本镜像遵循https://gitlab.com/snippets/***。

许可证

• 本仓库代码采用https://gitlab.com/jitesoft/dockerfiles/lighttpd/blob/master/LICENSE
• Lighttpd许可证详见https://git.lighttpd.net/lighttpd/lighttpd1.4.git/tree/COPYING

赞助商

Jitesoft镜像通过GitLab CI在以下机构提供的 runners 上构建：

上述机构与Jitesoft或其项目无直接关联。

赞助支持

开源项目的持续开发和维护依赖赞助支持。如有赞助意向，可通过邮件联系，或访问以下平台：
https://opencollective.com/jitesoft-open-source | https://github.com/***/jitesoft | Patreon