3scale/openresty

docker-openresty 镜像文档

镜像概述和主要用途

docker-openresty是一个集成了Openresty、Redis和luarocks的Docker镜像。Openresty是基于Nginx的Web应用服务器，通过Lua扩展提供强大的动态功能；Redis作为高性能键值数据库，可用于缓存、会话存储等场景；luarocks则是Lua的包管理工具，方便安装Lua模块。该镜像适用于需要Nginx+Lua开发环境的Web应用，尤其适合构建API网关、反向代理或需要动态处理逻辑的服务。

核心功能和特性

• Openresty集成：包含最新版Openresty，整合Nginx与LuaJIT，支持Lua脚本扩展Nginx功能
• Redis支持：内置Redis服务，可直接用于数据缓存、会话管理等
• luarocks工具：提供Lua包管理功能，方便安装和管理Lua模块
• Supervisor进程管理：通过Supervisor管理服务进程，确保服务稳定运行
• Cron支持：内置Cron服务，可用于定时任务（如日志轮转等）

使用场景和适用范围

• 构建基于Nginx+Lua的Web应用或API服务
• 开发需要Redis缓存支持的动态网站
• 搭建轻量级API网关或反向代理服务
• 需要定时任务（如日志处理）的Web服务环境

使用方法和配置说明

基础使用示例

Dockerfile示例

dockerfile
FROM 3scale/openresty

# 添加Supervisor配置文件
ADD openresty.conf /etc/supervisor/conf.d/

# 添加应用代码
ADD . /var/www

# 启动Supervisor
CMD ["supervisor"]

Supervisor配置

Supervisor用于管理Openresty进程，配置文件示例（openresty.conf）：

ini
[program:openresty]
command=/opt/openresty/nginx/sbin/nginx -p /var/www/ -c config/nginx.conf -g 'daemon off;'
autorestart=true

• command：指定Openresty启动命令，-p设置工作目录，-c指定Nginx配置文件路径，-g 'daemon off;'确保进程前台运行（Supervisor要求）
• autorestart=true：进程异常退出时自动重启

Nginx配置注意事项

Supervisor要求管理的进程在前台运行，因此Nginx配置文件中必须包含：

nginx
daemon off;

确保Nginx不以守护进程模式运行。

Cron使用

镜像内置Cron服务（通过Supervisor管理），可直接使用定时任务功能。例如，可配置日志轮转等定时任务，无需额外安装Cron服务。