herryhou/openresty Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

OpenResty Docker镜像

本镜像为ficusio/openresty的Dockerfile实现，提供两种版本以满足不同需求。

镜像概述和主要用途

该镜像基于OpenResty构建，提供轻量级和功能扩展两种版本，适用于Nginx反向代理、API网关、Web应用开发等场景。Alpine版本体积极小，适合生产环境部署；Debian版本则便于Nginx性能分析工具的集成。

核心功能和特性

版本类型

• Alpine版本（ficusio/openresty:latest）

  • 基于Alpine Linux，虚拟体积仅31MB
  • 包含完整功能的OpenResty v1.9.3.1套件
  • 集成apk包管理器，可轻松安装大量预构建包

• Debian版本（ficusio/openresty:debian）

  • 基于debian:wheezy，体积较大（256MB）
  • 适用于Nginx性能分析场景，解决Alpine中musl libc难以构建分析工具的问题

核心组件

• Nginx配置前缀路径：/opt/openresty/nginx
• 默认配置文件路径：/opt/openresty/nginx/conf/nginx.conf
• 默认HTML根目录：/opt/openresty/nginx/html/
• 内置Lua模块目录：/opt/openresty/lualib/（已添加到Lua包路径）
• LuaJIT 2.1：包含独立lua二进制可执行文件
• 临时文件目录：/var/nginx/（只读模式需挂载为卷）

使用场景和适用范围

• 轻量级生产部署：Alpine版本适合资源受限环境，如微服务架构中的API网关
• Nginx性能分析：Debian版本支持各类分析工具集成，用于性能调优
• 开发环境：支持本地代码挂载，实时调试Lua脚本和Nginx配置

使用方法和配置说明

基础运行

常规启动

sh
docker run --name openresty -d ficusio/openresty:latest

只读模式启动

需将临时目录挂载为卷：

sh
# 启动容器
docker run --name nginx --read-only -v /var/nginx ficusio/openresty

# 移除容器及卷
docker rm -v nginx

ONBUILD钩子使用

镜像内置ONBUILD钩子，自动将构建上下文中nginx/目录的所有文件复制到容器内/opt/openresty/nginx/路径。

项目结构示例

project_root/
 ├ nginx/          # 所有子目录/文件将复制到/opt/openresty/nginx/
 |  └ conf/
 |     └ nginx.conf  # 自定义Nginx配置文件
 └ Dockerfile

Dockerfile示例

dockerfile
FROM ficusio/openresty:latest
EXPOSE 8080

命令行参数

默认启动命令：

sh
nginx -g 'daemon off; error_log /dev/stderr info;'

• 注意：配置文件中不应指定daemon指令，否则会导致重复指令错误
• 日志重定向：错误日志输出到stderr，便于Docker日志驱动或logspout等工具收集

自定义启动命令

通过Dockerfile的CMD指令覆盖：

dockerfile
FROM ficusio/openresty:latest
CMD ["nginx", "-g", "daemon off; error_log /dev/stderr debug;"]

或直接在docker run中指定：

sh
docker run --rm -it --name test ficusio/openresty bash

开发环境配置

为避免频繁重建镜像，可通过挂载目录实现实时代码更新：

开发启动脚本

bash
#!/usr/bin/env bash

exec docker run --rm -it \
  --name my-app-dev \
  -v "$(pwd)/nginx/conf":/opt/openresty/nginx/conf \
  -v "$(pwd)/nginx/lualib":/opt/openresty/nginx/lualib \
  -p 8080:8080 \
  ficusio/openresty:debian "$@"

使用说明

• 脚本挂载配置文件和Lua模块目录，支持实时更新
• 可添加更多-v参数挂载其他目录（如nginx/html/）
• 禁止直接挂载nginx/目录（会覆盖Nginx二进制文件）
• 开发时可临时禁用Lua代码缓存，实现无重启测试

示例应用

查看示例应用获取更多配置案例。