quiq/openresty

镜像概述

本镜像基于官方 https://hub.docker.com/r/openresty/openresty/ 的 alpine-fat 版本构建，是一款增强型OpenResty解决方案。OpenResty作为集成Nginx与LuaJIT的高性能Web平台，本镜像在此基础上优化了镜像体积、扩展了缓存能力、预配置了LUA生态，并通过安全签名提升部署可信度，适用于构建高性能Web服务、API网关及需要Lua脚本扩展的应用场景。

核心功能与特性

1. 基础构建与体积优化

• 基于官方alpine-fat镜像，保留Alpine系统轻量特性的同时，采用多阶段构建策略，剔除构建过程中的临时依赖，显著减小最终镜像体积，降低存储与传输成本。

2. 扩展缓存能力

• 通过内核补丁修改Nginx，支持在proxy_cache_methods配置中添加OPTIONS方法，实现对OPTIONS请求的缓存控制。配置示例：proxy_cache_methods GET HEAD OPTIONS;，可有效优化跨域资源共享（CORS）等场景下的OPTIONS请求处理性能。

3. 预安装LUA插件

• 集成luarocks包管理器，并预安装常用LUA插件（如请求处理、JSON解析等基础依赖），减少用户手动安装步骤，可直接通过Lua脚本扩展Nginx功能。

4. 安全签名验证

• 镜像通过Docker Notary进行签名，支持使用Notary客户端验证镜像完整性与来源，有效防止镜像被篡改，提升生产环境部署安全性。

使用场景

• 高性能Web服务：适用于需处理高并发HTTP请求的动态网站、应用后端，利用OpenResty的事件驱动模型与LuaJIT加速提升响应性能。
• API网关：通过预安装的LUA插件快速实现请求路由、负载均衡、限流熔断、身份验证等网关功能。
• Lua脚本扩展场景：需通过Lua脚本自定义请求处理逻辑（如数据过滤、日志聚合、动态配置）的业务场景，无需额外配置插件环境。
• 安全敏感环境：对镜像完整性有严格要求的生产环境，可通过Notary签名验证确保部署镜像未被篡改。
• CORS优化场景：针对前端频繁发送OPTIONS预检请求的跨域场景，通过缓存OPTIONS请求降低后端服务压力。

使用方法

基本运行

启动容器并映射80端口（默认使用内置Nginx配置）：

bash
docker run -d -p 80:80 --name enhanced-openresty [镜像名称]:[标签]

自定义配置

挂载本地Nginx配置文件覆盖默认配置（配置路径：/usr/local/openresty/nginx/conf/nginx.conf）：

bash
docker run -d -p 80:80 \
  -v /path/to/local/nginx.conf:/usr/local/openresty/nginx/conf/nginx.conf \
  --name enhanced-openresty [镜像名称]:[标签]

启用OPTIONS请求缓存

在Nginx配置中添加OPTIONS到缓存方法列表，示例配置片段：

nginx
http {
    # 定义缓存区域
    proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=10g inactive=60m use_temp_path=off;
    
    server {
        listen 80;
        
        location /api {
            proxy_cache my_cache;
            # 包含OPTIONS方法以启用缓存
            proxy_cache_methods GET HEAD OPTIONS;
            proxy_pass http://backend_service;  # 后端服务地址
        }
    }
}

验证镜像签名

使用Docker Notary客户端验证镜像完整性（需提前配置Notary服务）：

bash
notary verify [镜像仓库地址]/[镜像名称]:[标签]

Docker Compose示例

创建docker-compose.yml配置文件，集成自定义配置与数据持久化：

yaml
version: '3'
services:
  openresty:
    image: [镜像名称]:[标签]
    ports:
      - "80:80"
      - "443:443"  # 如需HTTPS，映射443端口
    volumes:
      - ./nginx/conf:/usr/local/openresty/nginx/conf  # 挂载完整配置目录
      - ./nginx/cache:/var/cache/nginx  # 持久化缓存数据
      - ./lua-scripts:/usr/local/openresty/lualib/custom  # 挂载自定义Lua脚本
    restart: always
    environment:
      - NGINX_WORKER_PROCESSES=auto  # 可通过环境变量调整Nginx Worker数

注意事项

• 插件扩展：如需添加更多LUA插件，可在容器内执行luarocks install [插件名称]，或基于本镜像编写Dockerfile构建自定义镜像。
• 缓存持久化：默认缓存路径为/var/cache/nginx，生产环境建议挂载至宿主机目录，避免容器重启后缓存丢失。
• 配置重载：修改配置后可通过docker exec -it [容器名] nginx -s reload热重载Nginx，无需重启容器。