agilicus/openresty

openresty 镜像文档

镜像概述和主要用途

本镜像为基于Ubuntu 18.04的OpenResty基础容器，核心特点是集成了lua-resty-waf模块，提供复杂的安全过滤能力。适用于需要Web服务器功能并需增强安全防护的场景。

核心功能和特性

• 基础环境：基于Ubuntu 18.04操作系统构建
• 核心组件：包含OpenResty（Nginx与Lua的集成平台）
• 安全增强：集成lua-resty-waf模块，支持复杂的安全过滤规则
• 许可证：Dockerfile采用Apache 2.0许可证（详见Apache 2.0许可协议），容器内各文件保留其原始许可证

使用场景和适用范围

• 需要Web服务器功能的应用部署
• 需要实现Web应用防火墙(WAF)功能的场景
• API网关、反向代理等需要安全过滤的服务部署

使用方法和配置说明

基本运行命令

bash
docker run -d -p 80:80 --name openresty-instance openresty

自定义配置

通过挂载本地配置文件覆盖默认配置：

bash
docker run -d -p 80:80 \
  -v /path/to/your/nginx.conf:/usr/local/openresty/nginx/conf/nginx.conf \
  --name openresty-instance openresty

lua-resty-waf配置

lua-resty-waf模块需在Nginx配置文件中进行设置，典型配置示例：

nginx
http {
    lua_shared_dict waf 10m;
    init_by_lua_block {
        local waf = require "resty.waf"
        waf.init({
            -- 配置规则路径等参数
            rule_path = "/usr/local/openresty/nginx/conf/waf/rules",
            mode = "ACTIVE"
        })
    }
    
    server {
        location / {
            access_by_lua_block {
                local waf = require "resty.waf"
                waf.exec()
            }
            # 其他配置...
        }
    }
}

详细配置参数可参考https://github.com/p0pr0ck5/lua-resty-waf%E3%80%82