jpksf/openresty

OpenResty (无Entrypoint/Onbuild) 镜像文档

镜像概述

本镜像基于alpine:3.3构建，是ficusio/openresty:1.9的衍生版本，移除了原有的entrypoint和onbuild配置。包含OpenResty 1.9.7.3核心组件，集成Nginx与LuaJIT，适用于需要自定义启动流程和配置的场景。

核心功能与特性

• 基础环境：基于Alpine 3.3，体积轻量，运行依赖精简
• OpenResty版本：1.9.7.3，集成Nginx核心与LuaJIT
• 编译配置：
  • 支持IPv6和HTTP SSL模块
  • 启用PCRE JIT优化
  • 配置临时文件路径、日志路径、PID文件路径等基础参数
  • 移除不必要模块（如SSI、UserID、UWSGI、SCGI模块）
• 路径设置：
  • OpenResty根目录：/opt/openresty
  • Nginx根目录：/opt/openresty/nginx
  • 运行时文件目录：/var/nginx（含日志、临时文件、PID等）
• 工具链：包含nginx、openresty、resty、lua等可执行命令（已创建符号链接至/usr/local/bin）

使用场景

• 需要完全自定义Nginx配置、Lua脚本或启动流程的场景
• 作为基础镜像构建自定义OpenResty应用
• 需灵活控制容器启动命令的开发或测试环境

使用方法

基本运行

bash
docker run -d --name openresty-custom -p 80:80 your-image-name nginx -g "daemon off;"

挂载自定义配置

bash
docker run -d --name openresty-custom \
  -p 80:80 \
  -v /path/to/nginx.conf:/opt/openresty/nginx/conf/nginx.conf \
  your-image-name \
  nginx -g "daemon off;"

环境变量说明

目录结构说明

• /opt/openresty：OpenResty主目录
  • /nginx：Nginx配置及可执行文件目录
    • /conf：Nginx配置文件目录
    • /sbin/nginx：Nginx可执行文件
  • /luajit：LuaJIT环境
• /var/nginx：运行时数据目录
  • access.log：访问日志
  • error.log：错误日志
  • client_body_temp：客户端请求体临时文件
  • proxy_temp：代理临时文件
  • nginx.pid：Nginx进程PID文件

构建说明

本镜像通过以下步骤构建：

1. 基于Alpine 3.3安装构建依赖（make、gcc、pcre-dev等）
2. 下载并编译OpenResty 1.9.7.3，配置指定路径及模块
3. 安装OpenResty并创建工具链符号链接
4. 移除构建依赖，保留运行时依赖（libpcre、openssl等）
5. 清理临时文件及缓存