oxnme/openresty

OpenResty 增强镜像

镜像概述

本镜像基于OpenResty构建，额外集成了nginx_upstream_check_module模块和ngx_http_geoip_module模块，并默认使用www-data作为运行用户和组，适用于需要上游服务器健康检查和地理位置识别功能的Nginx/OpenResty部署场景。

核心功能与特性

• 上游健康检查：集成nginx_upstream_check_module，支持对后端上游服务器进行主动健康状态检测
• 地理位置识别：包含ngx_http_geoip_module，可基于客户端IP获取地理位置信息
• 安全运行：默认使用非root用户www-data及同名用户组运行，提升容器安全性

使用场景

• 需要对后端服务进行健康状态监控的反向代理服务
• 需基于IP地址获取用户地理位置信息的Web应用
• 对容器运行安全性有要求的OpenResty部署环境

使用方法

基本运行

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

自定义配置

挂载本地Nginx配置文件以覆盖默认配置：

bash
docker run -d -p 80:80 \
  -v /本地路径/nginx.conf:/usr/local/openresty/nginx/conf/nginx.conf \
  --name openresty-enhanced [镜像名称]

docker-compose配置示例

yaml
version: '3'
services:
  openresty:
    image: [镜像名称]
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/usr/local/openresty/nginx/conf/nginx.conf
      - ./conf.d:/usr/local/openresty/nginx/conf/conf.d
    restart: always

注意事项

• 运行时默认用户为www-data，需确保挂载的配置文件和数据目录具有该用户的读写权限
• ngx_http_geoip_module需配合GeoIP数据库文件使用，可通过挂载方式提供数据库文件（如-v /本地路径/geoip.dat:/usr/local/openresty/nginx/conf/geoip.dat）