轩辕镜像 官方专业版
轩辕镜像
专业版
轩辕镜像 官方专业版
轩辕镜像
专业版
首页
个人中心
拉取日志
交易
充值流量¥8起
我的订单
文档
工具
提交工单
页面收录
openresty

openresty/openresty

openresty
自动构建

OpenResty官方Docker镜像是基于NGINX和LuaJIT构建的动态Web平台,它整合了NGINX的高性能HTTP处理与反向代理能力及LuaJIT的高效即时编译脚本技术,适用于开发高并发、低延迟的动态Web应用、API网关、负载均衡系统等场景。该官方Docker镜像提供标准化部署环境,简化配置流程,确保跨平台一致性与可靠性,助力开发者快速集成并高效利用OpenResty的强大功能,实现灵活的Web服务开发与部署。

487 次收藏下载次数: 0状态:自动构建维护者:openresty仓库类型:镜像最近更新:6 天前
DockerHub 官方简介
轩辕镜像中文简介
下载命令
镜像标签列表与下载命令
轩辕镜像,快一点,稳很多。
点击查看

docker-openresty:OpenResty 的 Docker 工具

简介

docker-openresty 是 OpenResty 的 Docker 化工具([GitHub 仓库] )。Docker 是容器管理平台,而 OpenResty 是基于 Nginx 核心,集成大量第三方模块及依赖的全功能 Web 应用服务器。

镜像标签说明

建议将镜像固定到明确的标签以确保稳定性。以下是常见标签示例及说明:

带版本的镜像标签(推荐)

镜像示例说明
openresty/openresty:1.21.4.1-0-jammy基于源码构建的 Ubuntu Jammy 版本
openresty/openresty:1.21.4.1-0-focal基于源码构建的 Ubuntu Focal 版本
openresty/openresty:1.21.4.1-0-bullseye-fat基于上游包构建的 Debian Bullseye 版本
openresty/openresty:1.21.4.1-0-alpine基于源码构建的 Alpine 版本
openresty/openresty:1.21.4.1-0-alpine-apk基于上游包构建的 Alpine 版本

不带版本的镜像标签(默认最新版)

镜像示例说明
openresty/openresty:jammyUbuntu Jammy 最新版
openresty/openresty:focalUbuntu Focal 最新版
openresty/openresty:alpineAlpine 最新版

基本使用

若无需自定义构建,可直接使用 Docker Hub 上的镜像。基础运行命令:

bash
docker run [选项] openresty/openresty:bullseye-fat
  • 选项说明:-p 映射端口,-v 挂载数据卷,-d 后台运行。
  • 日志处理:容器将 Nginx 的 access.log 和 error.log 分别链接到 /dev/stdout 和 /dev/stderr,适配 Docker 日志系统。若修改配置中的日志路径,需手动创建对应链接。
  • 临时目录:client_body_temp_path 等临时目录位于 /var/run/openresty/,建议挂载该目录以避免容器内存储占用。

Nginx 配置文件

容器默认包含 nginx.conf 配置,路径为 /usr/local/openresty/nginx/conf/nginx.conf。配置逻辑如下:

  • 包含子配置:默认配置通过 include /etc/nginx/conf.d/*.conf; 加载 /etc/nginx/conf.d/ 目录下的所有 .conf 文件,其中 default.conf 为默认虚拟主机配置。

自定义配置方法

  1. 挂载配置目录:将本地配置目录挂载到容器的 /etc/nginx/conf.d/,覆盖默认子配置:
    bash
    docker run -v /本地/custom/conf.d:/etc/nginx/conf.d docker.xuanyuan.run/openresty/openresty:alpine
    
  2. 替换主配置:直接挂载自定义的 nginx.conf 替换默认配置(适用于 Windows 镜像):
    bash
    docker run -v C:/本地/nginx.conf:C:/openresty/conf/nginx.conf docker.xuanyuan.run/openresty/openresty:windows
    
  3. SELinux 环境:若主机启用 SELinux(如 CentOS),挂载时需添加 :Z 标签:
    bash
    docker run -v /本地/custom/conf.d:/etc/nginx/conf.d:Z docker.xuanyuan.run/openresty/openresty:alpine
    

OPM 工具

OpenResty 包管理器 opm(路径 /usr/local/openresty/bin/opm)用于安装 OpenResty 模块,以下镜像默认包含 opm:alpine-fat、centos、bionic、bullseye-fat 等。

特殊镜像的 opm 使用

  • Alpine 镜像:需手动安装依赖(curl 和 perl):
    bash
    apk add --no-cache curl perl
    
  • Debian (bullseye/buster) 镜像:使用 bullseye-fat 镜像,或在自定义构建中安装 openresty-opm 包(参考 [示例 Dockerfile] )。

LuaRocks 工具

Lua 包管理器 [LuaRocks] 用于安装 Lua 模块,默认包含在 alpine-fat、centos、bionic 镜像中(alpine 镜像因追求精简未包含)。使用路径:/usr/local/openresty/luajit/bin/luarocks。

安装 Lua 包示例

bash
RUN /usr/local/openresty/luajit/bin/luarocks install <包名>

注意事项与常见问题

  1. SSE4.2 优化兼容性:
    Docker Hub 镜像默认启用 SSE4.2 优化,若运行在不支持 SSE4.2 的设备(如老旧服务器、嵌入式系统),会出现“无效指令”错误。需手动构建不含 SSE4.2 的镜像:

    bash
    docker build -f bionic/Dockerfile --build-arg "RESTY_LUAJIT_OPTIONS=--with-luajit-xcflags='-DLUAJIT_NUMMODE=2 -DLUAJIT_ENABLE_LUA52COMPAT -mno-sse4.2'" .
    
  2. OpenSSL 版本兼容性:
    确保 opm/LuaRocks 包与镜像的 OpenSSL 版本匹配(版本号需一致,如 1.1.1)。可通过镜像标签 resty_openssl_version 查看 OpenSSL 版本。

  3. envsubst 工具:
    除 alpine 和 windows 镜像外,其他镜像均包含 envsubst(用于配置文件环境变量替换)。

  4. 容器停止信号:
    容器默认使用 SIGQUIT 信号停止 Nginx,以优雅关闭连接(Docker 默认 SIGTERM 会强制终止连接)。若配置中使用 UNIX 域套接字,需手动清理套接字文件(Nginx 已知问题 [#753] )。

镜像标签信息

镜像内置标签记录构建信息(如 OpenResty 版本、依赖库版本等),可通过 docker inspect 查看。例如:

bash
docker inspect openresty/openresty:1.17.8.1-0-bionic | jq '.[].Config.Labels'

主要标签说明

标签名说明
resty_versionOpenResty 版本
resty_openssl_versionOpenSSL 版本
resty_pcre_versionPCRE 版本
resty_luarocks_versionLuaRocks 版本(若包含)

Docker CMD 说明

容器默认 CMD 为 ["openresty", "-g", "daemon off;"],确保 Nginx 前台运行。若 nginx.conf 中已配置 daemon off;,需显式指定命令:

bash
docker run [选项] openresty/openresty:bionic openresty

运行其他命令示例

执行 resty 工具(需 perl 和 ncurses 依赖,alpine 镜像需额外安装):

bash
docker run [选项] openresty/openresty:bionic resty [脚本.lua]

自定义构建(从源码)

可通过克隆仓库并指定 Dockerfile 构建自定义镜像,支持调整 OpenResty 版本、依赖库等参数。

构建步骤示例

bash
git clone [] docker-openresty
# 构建 Ubuntu Bionic 版本
docker build -t 自定义镜像名 -f bionic/Dockerfile .

常用构建参数

参数名默认值说明
RESTY_VERSION1.21.4.1OpenResty 版本
RESTY_OPENSSL_VERSION1.1.1qOpenSSL 版本
RESTY_PCRE_VERSION8.45PCRE 版本
RESTY_LUAROCKS_VERSION3.9.0LuaRocks 版本(若构建)

反馈与贡献

使用中遇到问题可提交 [GitHub Issue] ,或通过 [Travis CI] 、[Appveyor] 查看构建状态。

更多相关 Docker 镜像与资源

以下是 openresty/openresty 相关的常用 Docker 镜像,适用于 不同场景 等不同场景:

  • library/nginx Docker 镜像说明
  • ilios/nginx Docker 镜像说明(Nginx Web 服务器,轻量高效)
  • ubuntu/nginx Docker 镜像说明(Nginx Web 服务器,基于 Ubuntu,适合生产环境)
  • bitnami/nginx Docker 镜像说明(Nginx Web 服务器,Bitnami 企业级配置,适合生产环境)
  • linuxserver/nginx Docker 镜像说明(Nginx Web 服务器,LinuxServer 维护版本,适合静态资源服务和反向代理)

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 openresty 镜像标签

docker pull docker.xuanyuan.run/openresty/openresty:<标签>

使用方法:

  • 登录认证方式
  • 免认证方式

DockerHub 原生拉取命令

docker pull openresty/openresty:<标签>

用户好评

来自真实用户的反馈,见证轩辕镜像的优质服务

查看流量套餐与价格
用户头像

oldzhang

运维工程师

Linux服务器

5

"Docker访问体验非常流畅,大镜像也能快速完成下载。"

镜像详情/openresty/openresty
充值充值流量套餐
专业版 · 高速稳定拉取镜像
高速镜像下载·在线技术支持·99.95% SLA 保障·付费会员免广告
50GB 仅 ¥8/年
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载·在线技术支持·99.95% SLA 保障·付费会员免广告
用户协议·隐私政策·增值电信业务经营许可证:浙B2-20261007·©2024-2026 源码跳动©2024-2026 杭州源码跳动科技有限公司·商务合作:点击复制邮箱

更多 openresty 镜像推荐

openresty logo

1panel/openresty

1panel
暂无描述
7 次收藏100万+ 次下载
10 天前更新
openresty logo

travix/openresty

travix
基于Openresty的边车容器,用于终止SSL连接、证书更新时自动重载,并输出Prometheus指标
1 次收藏100万+ 次下载
7 年前更新
openresty logo

vikings/openresty

vikings
基于CentOS 7的OpenResty开发版本镜像,版本为1.11.2.3,适用于OpenResty应用的开发与测试环境。
1 次收藏54.5万 次下载
6 年前更新
openresty logo

bitnami/openresty

Bitnami Secure Images(VMware Tanzu)
Bitnami openresty 安全镜像
27 次收藏50万+ 次下载
1 年前更新
openresty logo

honeok/openresty

honeok
OpenResty Docker Image by honeok
4 次收藏11.1万 次下载
10 天前更新
openresty logo

riftbit/openresty

riftbit
基于Alpine的OpenResty镜像,包含luarocks、lua-prometheus、多种额外模块、RTMP流媒体支持和GeoIP2功能。
3 次收藏10万+ 次下载
3 年前更新

查看更多 openresty 相关镜像