pylab/openresty

openresty special 镜像文档

镜像概述和主要用途

本镜像基于 https://hub.docker.com/r/openresty/openresty 构建，是一个增强版的OpenResty镜像。主要用途是提供集成了额外功能模块的Nginx+Lua环境，满足更复杂的Web服务需求，如HTTP内容替换、安全防护和页面性能优化等场景。

核心功能和特性

• 已集成模块：
  • ngx_http_substitutions_filter_module：用于在HTTP响应中进行内容替换的Nginx模块，支持多组替换规则。
• 计划集成模块（TODO）：
  • Modsecurity：开源Web应用防火墙(WAF)，提供HTTP请求过滤、安全规则检测等功能。
  • ngx_pagespeed：Google开发的Nginx模块，用于自动优化网页性能（如压缩、缓存、资源合并等）。

使用场景和适用范围

• 需要对HTTP响应内容进行动态替换的Web服务（如替换页面中的特定文本、URL等）。
• 计划部署Web应用防火墙以增强安全性的场景。
• 需优化网页加载速度和性能的Web服务（未来集成ngx_pagespeed后适用）。
• 基于OpenResty开发的Lua脚本应用，需要额外模块支持的场景。

使用方法和配置说明

构建镜像

使用以下命令构建本镜像，可通过--build-arg参数自定义构建配置：

bash
docker build \
--build-arg "RESTY_IMAGE_BASE=debian" \  # 基础镜像系统（如debian、alpine等）
--build-arg "RESTY_IMAGE_TAG=stable-slim" \  # 基础镜像标签
--build-arg "RESTY_J=4" \  # 编译时并行任务数
--build-arg "RESTY_OPENSSL_VERSION=1.1.1b" \  # OpenSSL版本
--build-arg "RESTY_CONFIG_OPTIONS_MORE=--add-module=/tmp/ngx_http_substitutions_filter_module-master" \  # 额外的Nginx配置选项，指定添加substitutions_filter模块
--build-arg "RESTY_EVAL_PRE_CONFIGURE=curl -sL https://github.com/yaoweibin/ngx_http_substitutions_filter_module/archive/master.tar.gz | tar -xz" \  # 配置前执行的命令，下载并解压substitutions_filter模块源码
--build-arg "RESTY_EVAL_POST_MAKE=rm -rf /root/.cache /tmp/* /var/lib/apt/* /var/cache/* /var/log/*" \  # 编译后清理临时文件，减小镜像体积
-t openresty:slim \  # 镜像名称和标签
-f bionic/Dockerfile . \  # Dockerfile路径
--no-cache  # 不使用缓存，确保依赖更新

构建参数说明

运行容器

构建完成后，可通过以下命令运行容器（基础用法，具体配置需根据实际需求调整）：

bash
docker run -d -p 80:80 --name openresty-special openresty:slim

注意事项

• Modsecurity和ngx_pagespeed模块目前处于TODO状态，尚未集成到镜像中。
• 构建时需确保网络通畅，以便成功下载ngx_http_substitutions_filter_module模块源码。
• 根据实际需求调整RESTY_CONFIG_OPTIONS_MORE等参数，可添加其他所需模块或配置。