3utama/nginx-lua

Nginx Lua 镜像

镜像概述和主要用途

Nginx Lua镜像是基于官方Nginx Docker镜像构建的扩展版本，核心特点是集成了Lua模块。该镜像保留了官方Nginx的全部功能，并通过Lua模块为用户提供脚本级别的扩展能力，适用于需要通过Lua语言定制Nginx功能、实现复杂业务逻辑或动态配置的场景。

核心功能和特性

• 基于官方镜像：完全兼容官方Nginx镜像的功能和使用方式，降低迁移成本
• 集成Lua模块：内置Lua扩展模块，支持通过Lua脚本编写Nginx处理逻辑
• 功能扩展：可通过Lua实现自定义认证、请求过滤、动态路由、数据处理等高级功能
• 轻量级：在官方镜像基础上最小化添加Lua模块，保持镜像精简

使用场景和适用范围

• 需要使用Lua语言快速开发Nginx扩展模块的场景
• 需实现复杂请求处理逻辑（如API网关、请求转发规则、业务数据校验等）的Web服务
• 希望通过脚本语言动态调整Nginx配置或集成业务逻辑的开发/生产环境
• 对Nginx功能有定制化需求，且倾向于使用脚本语言简化开发流程的场景

使用方法和配置说明

基础使用

该镜像的基础使用方式与官方Nginx镜像完全一致，详细使用指南可参考官方文档：https://hub.docker.com/_/nginx

Docker部署示例

1. 基础运行

bash
docker run --name nginx-lua -p 80:80 -d ekanai/nginx-lua

说明：上述命令启动一个基础的Nginx Lua容器，映射80端口，与官方Nginx的基础运行方式一致，区别在于容器已内置Lua模块。

2. 自定义配置（含Lua功能）

创建包含Lua逻辑的Nginx配置文件（如nginx.conf），示例：

nginx
http {
    # Lua脚本路径配置（根据实际需求调整）
    lua_package_path "/etc/nginx/lua/?.lua;;";
    
    server {
        listen 80;
        server_name localhost;

        location /lua-demo {
            default_type 'text/plain';
            # Lua内联脚本示例：返回Hello消息
            content_by_lua_block {
                ngx.say("Hello from Lua in Nginx! Current time: ", os.date("%Y-%m-%d %H:%M:%S"))
            }
        }
    }
}

通过挂载配置文件启动容器：

bash
docker run --name nginx-lua -p 80:80 \
  -v /path/to/your/nginx.conf:/etc/nginx/nginx.conf:ro \
  -v /path/to/your/lua-scripts:/etc/nginx/lua \
  -d ekanai/nginx-lua

更多资源

• 项目源代码及详细说明：https://github.com/ekanai/nginx-lua
• Lua模块配置指南：参考Nginx Lua模块官方文档（需结合镜像实际集成的模块版本）