emazzotta/docker-nginx-lua

Docker Nginx Lua 镜像文档

镜像概述和主要用途

Docker Nginx Lua是一个集成了最新版本Nginx、more_set_headers模块、LuaJIT以及Google ngx_pagespeed模块的Docker镜像。该镜像旨在提供功能增强的Nginx服务，支持自定义HTTP响应头、通过Lua脚本处理请求逻辑以及优化网页加载性能。

核心功能和特性

• 最新Nginx版本：基于最新稳定版Nginx构建
• 自定义响应头：集成more_set_headers模块，支持修改Server等HTTP响应头
• Lua脚本支持：包含LuaJIT，可在Nginx配置中嵌入Lua脚本处理请求
• 网页性能优化：集成Google ngx_pagespeed模块，提供资源压缩、缓存、图片优化等功能

使用场景和适用范围

• 需要自定义服务器标识（如修改Server响应头）的场景
• 需要通过Lua脚本实现复杂请求处理逻辑（如动态路由、语言检测重定向）的应用
• 对网页加载速度有优化需求的网站或Web应用
• 需要统一管理Nginx配置和性能优化的容器化部署环境

使用方法和配置说明

基本使用

通过以下命令启动容器，挂载自定义配置目录和pagespeed缓存目录：

bash
docker run -v <本地配置目录>:/etc/nginx/conf.d -v /var/ngx_pagespeed_cache -p 80:80 docker.xuanyuan.run/emazzotta/docker-nginx-lua

参数说明：

• -v <本地配置目录>:/etc/nginx/conf.d：挂载本地Nginx配置目录到容器
• -v /var/ngx_pagespeed_cache：为ngx_pagespeed模块挂载缓存目录
• -p 80:80：映射容器80端口到主机80端口

配置示例

1. 自定义响应头（more_set_headers）

在Nginx配置中添加以下内容可自定义Server响应头：

nginx
http {
    ...
    more_set_headers 'Server: 1337-server';  # 将Server头修改为自定义值
    ...
}

2. Lua脚本处理请求

通过rewrite_by_lua指令实现基于Accept-Language的自动重定向：

nginx
server {   
    ...
    location ~ / {
        rewrite_by_lua '
        for lang in (ngx.var.http_accept_language .. ","):gmatch("([^,]*),") do
            if string.sub(lang, 0, 2) == "en" then
                ngx.redirect("/en/")
            end
            if string.sub(lang, 0, 2) == "de" then
                ngx.redirect("/de/")
            end
        end
        ngx.redirect("/en/")';  # 默认重定向到英文页面
    }
    ...
}

3. ngx_pagespeed性能优化

启用并配置ngx_pagespeed模块：

nginx
server {
    ...
    pagespeed on;  # 启用pagespeed
    pagespeed FileCachePath /var/cache/nginx;  # 设置缓存路径
    pagespeed XHeaderValue "Pagespeed";  # 添加X-Page-Speed响应头
    pagespeed RewriteLevel CoreFilters;  # 启用核心优化过滤器
    ...
}

作者

Emanuele Mazzotta

许可证

https://app.fossa.io/api/projects/git%2Bgithub.com%2Femazzotta%2Fdocker-nginx-lua.svg?type=large](https://app.fossa.io/projects/git%2Bgithub.com%2Femazzotta%2Fdocker-nginx-lua?ref=badge_large)