domecloud/openresty

OpenResty By DomeCloud 镜像文档

镜像概述

OpenResty By DomeCloud是一个基于NGINX和LuaJIT构建的动态Web平台镜像。该镜像整合了高性能的NGINX Web服务器与LuaJIT即时编译引擎，提供了兼具高并发处理能力和灵活脚本扩展的Web开发环境，适用于构建动态Web应用、API服务及各类网络服务。

核心功能和特性

• 高性能基础：基于NGINX内核，具备优秀的并发处理能力和低资源消耗特性
• Lua脚本支持：集成LuaJIT，支持通过Lua脚本扩展Web功能，实现复杂业务逻辑
• 动态内容处理：支持动态页面生成、API请求处理、数据转换等动态Web场景
• 模块化架构：兼容NGINX模块生态，可按需扩展功能
• 轻量级设计：优化的镜像体积，便于快速部署和迁移

使用场景和适用范围

• 动态网站开发与部署
• RESTful API服务构建
• 高并发Web应用后端
• 反向代理与负载均衡
• Web应用防火墙
• 动态内容缓存与处理

使用方法和配置说明

基本部署

使用docker run命令快速启动容器：

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

挂载自定义配置

挂载本地配置文件以自定义NGINX和OpenResty配置：

bash
docker run -d -p 80:80 \
  -v /path/to/nginx.conf:/usr/local/openresty/nginx/conf/nginx.conf \
  -v /path/to/lua-scripts:/usr/local/openresty/lua \
  --name openresty-domecloud domecloud/openresty

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  openresty:
    image: domecloud/openresty
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/usr/local/openresty/nginx/conf/nginx.conf
      - ./lua-scripts:/usr/local/openresty/lua
      - ./html:/usr/local/openresty/nginx/html
    restart: always

启动服务：

bash
docker-compose up -d

核心配置说明

主要配置文件路径

• NGINX主配置：/usr/local/openresty/nginx/conf/nginx.conf
• Lua脚本目录：/usr/local/openresty/lua
• 网站根目录：/usr/local/openresty/nginx/html

常用Lua模块

OpenResty默认集成常用Lua模块，可直接在NGINX配置中通过content_by_lua_block等指令使用：

nginx
location /api {
    content_by_lua_block {
        ngx.say("Hello from OpenResty By DomeCloud")
    }
}

环境变量

目前该镜像支持以下环境变量配置：

通过环境变量启动示例：

bash
docker run -d -p 80:80 \
  -e NGINX_WORKER_PROCESSES=4 \
  --name openresty-domecloud domecloud/openresty