pahud/openresty

pahud/openresty Docker镜像文档

镜像概述

pahud/openresty是一个Docker化的OpenResty镜像。OpenResty是基于Nginx的高性能Web平台，集成了Lua脚本语言，适用于构建高性能的Web应用、反向代理和API网关。该镜像简化了OpenResty的部署流程，支持灵活配置，便于快速搭建Web服务。

核心功能与特性

• Docker化部署：无需手动安装配置OpenResty，通过Docker容器快速启动
• 灵活配置扩展：支持通过环境变量加载外部Nginx配置文件
• 标准端口暴露：默认暴露80端口，便于端口映射
• 轻量级设计：基于官方基础镜像构建，保持精简高效

使用场景

• 快速部署Web服务或静态网站
• 作为反向代理服务器转发请求
• 构建API网关处理请求路由与过滤
• 需要自定义Nginx配置的场景

使用方法

基本部署

通过以下命令快速启动OpenResty容器：

bash
docker run --name openresty -p 80:80 -d pahud/openresty

参数说明：

• --name openresty：指定容器名称为openresty
• -p 80:80：将容器的80端口映射到主机的80端口
• -d：后台运行容器
• pahud/openresty：使用的镜像名称

添加额外Nginx配置

通过环境变量EXTRA_NGINX_CONF_URL加载外部Nginx配置文件，扩展默认配置。

语法

bash
docker run -d --name openresty -e EXTRA_NGINX_CONF_URL="<EXTRA_NGINX_CONF_URL>" -p 80:80 pahud/openresty

示例

加载远程配置文件启动容器：

bash
docker run -d --name openresty \
  -e EXTRA_NGINX_CONF_URL="https://gist.githubusercontent.com/pahud/7ea408089eb4f81be127de5c4b2846f5/raw/5aca21248e921445b22edb4e286f0dd75a5c2ce5/openresty-common-extra-locations.conf" \
  -p 80:80 \
  pahud/openresty

说明：容器启动时会自动下载指定URL的配置文件，并将其内容包含到Nginx主配置文件nginx.conf中，实现配置扩展。

环境变量说明