dodotry/openresty

OpenResty Docker镜像文档

镜像概述

本镜像基于Debian系统构建，集成OpenResty V1.21.4版本。OpenResty是一个基于Nginx的高性能Web平台，通过整合Nginx核心与Lua脚本语言，提供强大的Web服务器、反向代理及API网关能力，适用于构建高并发、低延迟的Web应用。

核心功能与特性

• 高性能处理：基于Nginx核心，支持高并发HTTP请求处理
• 灵活扩展：集成Lua脚本引擎，可通过Lua扩展功能
• 配置自定义：支持挂载本地目录自定义Nginx配置
• 日志持久化：可挂载日志目录实现日志持久化存储
• 多端口支持：默认开放80（HTTP）、443（HTTPS）、8080（备用）端口

使用场景

• 作为Web服务器部署静态资源或动态Web应用
• 作为反向代理服务器转发请求至后端服务
• 作为API网关实现请求路由、负载均衡和访问控制
• 构建需要Lua脚本扩展的定制化Web服务

使用方法

1. 直接运行容器（docker run）

shell
docker run -d \
  -p 80:80 \
  -p 443:443 \
  -p 8080:8080 \
  -v $PWD/conf.d:/etc/nginx/conf.d:rw \
  -v $PWD/logs:/var/log/nginx:rw \
  --name=openresty \
  --hostname=openresty \
  dodotry/openresty:latest

参数说明：

• -d：后台运行容器
• -p：端口映射，将容器内80/443/8080端口映射到主机对应端口
• -v $PWD/conf.d:/etc/nginx/conf.d:rw：挂载本地配置目录到容器内Nginx配置目录，支持读写
• -v $PWD/logs:/var/log/nginx:rw：挂载本地日志目录到容器内Nginx日志目录，支持读写
• --name：指定容器名称为openresty
• --hostname：设置容器主机名为openresty

2. 使用docker-compose部署

创建docker-compose.yml文件：

yaml
version: "3.8"
services:
    openresty:
        image: 'dodotry/openresty:latest'
        restart: always
        container_name: 'openresty'
        hostname: 'openresty'
        privileged: true
        network_mode: "host"
        ports:
            - 80:80
            - 443:443
            - 8080:8080
        environment:
            TZ: 'Asia/Shanghai'  # 设置时区为上海
        volumes:
            - ./logs:/var/log/nginx:rw  # 日志持久化
            - ./conf/conf.d:/etc/nginx/conf.d  # 自定义配置文件
            - /etc/localtime:/etc/localtime:ro  # 同步主机时间

启动服务：

shell
docker-compose up -d

配置说明

• Nginx配置文件路径：容器内配置文件存放于/etc/nginx/conf.d，可通过挂载本地目录./conf.d自定义配置
• 日志路径：容器内日志存放于/var/log/nginx，挂载本地./logs目录可实现日志持久化
• 环境变量：可通过environment设置环境变量，如TZ指定时区
• 网络模式：示例中使用network_mode: "host"直接使用主机网络，也可根据需求调整为桥接模式

注意事项

• 挂载配置目录时，确保本地目录存在且权限正确
• 自定义配置文件需符合Nginx配置语法，错误配置可能导致容器启动失败
• 如需启用HTTPS，需在配置文件中添加SSL证书相关配置并挂载证书文件