chocolatefrappe/nginx-modules 镜像介绍及部署教程 - 轩辕镜像

本站面向开发者与科研用户，提供开源镜像的搜索和下载加速服务。

所有镜像均来源于原始开源仓库，本站不存储、不修改、不传播任何镜像内容。

轩辕镜像 - 国内开发者首选的专业 Docker 镜像下载加速服务平台 - 官方QQ群:13763429 👈点击免费获得技术支持。
本站面向开发者与科研用户，提供开源镜像的搜索和下载加速服务。所有镜像均来源于原始开源仓库，本站不存储、不修改、不传播任何镜像内容。

本站支持搜索的镜像仓库：Docker Hub、gcr.io、ghcr.io、quay.io、k8s.gcr.io、registry.gcr.io、elastic.co、mcr.microsoft.com

chocolatefrappe/nginx-modules

为容器提供预构建的NGINX包和模块，支持多种版本及Alpine/Debian系统变体，包含丰富动态模块，可简化NGINX容器化部署流程。

0 次下载activechocolatefrappe镜像

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

中文简介版本下载

🚀轩辕镜像专业版更稳定💎一键安装 Docker 配置镜像源

关于

为容器环境提供预构建的NGINX包和模块。

源代码 | Docker Hub

注意

本仓库通过GitHub定时工作流自动运行。

由于GitHub Actions的限制，公共仓库中若60天无仓库活动，定时工作流将自动禁用。

若您期望获取NGINX新版本的构建但未找到，欢迎提交工单。

详见 [***]

使用方法

模块基于scratch基础镜像构建，包含以下目录结构：

/module-available.d: 可用模块列表
/packages: 特定操作系统的模块包内容

# Debian变体使用`{version}`，Alpine变体使用`{version}-alpine`
ARG NGINX_VERSION=stable-alpine 
# 或
# NGINX_VERSION=1.25-alpine (暂不可用)
# NGINX_VERSION=1.25.0-alpine
FROM chocolatefrappe/nginx-modules:${NGINX_VERSION}-brotli

示例：

以下示例展示如何使用预构建的NGINX包和模块。

Alpine示例

# Debian变体使用`{version}`，Alpine变体使用`{version}-alpine`
ARG NGINX_VERSION=stable-alpine

# 模块
FROM chocolatefrappe/nginx-modules:${NGINX_VERSION}-brotli  AS mod-brotli
FROM chocolatefrappe/nginx-modules:${NGINX_VERSION}-echo    AS mod-echo

# NGINX
FROM nginx:${NGINX_VERSION}

COPY --from=mod-brotli  / /tmp/nginx-modules
COPY --from=mod-echo    / /tmp/nginx-modules

# Alpine
RUN set -ex \
    && cd /tmp/nginx-modules \
    && for mod in module-available.d/*; do \
            module=$(basename $mod); \
            apk add --no-cache --allow-untrusted packages/nginx-module-${module}-${NGINX_VERSION}*.apk; \
        done \
    && rm -rf /tmp/nginx-modules

Debian示例

# Debian变体使用`{version}`，Alpine变体使用`{version}-alpine`
ARG NGINX_VERSION=stable

# 模块
FROM chocolatefrappe/nginx-modules:${NGINX_VERSION}-brotli  AS mod-brotli
FROM chocolatefrappe/nginx-modules:${NGINX_VERSION}-echo    AS mod-echo

# NGINX
FROM nginx:${NGINX_VERSION}

COPY --from=mod-brotli  / /tmp/nginx-modules
COPY --from=mod-echo    / /tmp/nginx-modules

RUN set -ex \
    && chmod 1777 /tmp \
    && apt update \
    && cd /tmp/nginx-modules \
    && for mod in module-available.d/*; do \
            module=$(basename $mod); \
            apt install --no-install-suggests --no-install-recommends -y /tmp/nginx-modules/packages/nginx-module-${module}_${NGINX_VERSION}*.deb; \
        done \
    && rm -rf /tmp/nginx-modules \
    && rm -rf /var/lib/apt/lists/

支持的版本

支持的版本格式如下：

![Release]([] ![README.md]([]

{version}、{version}-alpine
{major}.{minor}、{major}.{minor}-alpine

详见下方标签部分。

版本类型

可用版本包括：

通道版本：

mainline、mainline-alpine
stable、stable-alpine

版本化版本：

1.28
1.28.0
1.29
1.29.0
1.29.1
mainline
stable

模块

所有模块均基于scratch镜像构建，以减小镜像体积并避免不必要依赖。

注意

若NGINX oss-pkg仓库有更新，本仓库将自动构建新模块和版本。

详见 [***]

可用模块如下：

acme：实现自动证书管理（ACMEv2）协议的NGINX模块
auth-spnego：第三方Kerberos认证动态模块
brotli：第三方Brotli压缩动态模块
echo：为Nginx配置文件提供echo、sleep、time、exec等类Shell功能
encrypted-session：第三方加密会话动态模块
fips-check：第三方FIPS状态检查动态模块
geoip：GeoIP动态模块
geoip2：第三方GeoIP2动态模块
headers-more：第三方headers-more动态模块
image-filter：图像过滤动态模块
lua：第三方Lua动态模块
ndk：第三方NDK（Nginx开发工具包）动态模块
njs：njs动态模块
otel：NGINX原生OpenTelemetry（OTel）模块
passenger：第三方Passenger动态模块
perl：Perl动态模块
rtmp：第三方RTMP动态模块
set-misc：第三方set-misc动态模块
subs-filter：第三方内容替换动态模块
vts：第三方虚拟主机流量状态动态模块
xslt：XSLT动态模块
zip：第三方ZIP动态模块

标签

可用标签如下：

通道版本标签

stable-acme、stable-alpine-acme
stable-auth-spnego、stable-alpine-auth-spnego
stable-brotli、stable-alpine-brotli
stable-echo、stable-alpine-echo
stable-encrypted-session、stable-alpine-encrypted-session
stable-fips-check、stable-alpine-fips-check
stable-geoip、stable-alpine-geoip
stable-geoip2、stable-alpine-geoip2
stable-headers-more、stable-alpine-headers-more
stable-image-filter、stable-alpine-image-filter
stable-lua、stable-alpine-lua
stable-ndk、stable-alpine-ndk
stable-njs、stable-alpine-njs
stable-otel、stable-alpine-otel
stable-passenger、stable-alpine-passenger
stable-perl、stable-alpine-perl
stable-rtmp、stable-alpine-rtmp
stable-set-misc、stable-alpine-set-misc
stable-subs-filter、stable-alpine-subs-filter
stable-vts、stable-alpine-vts
stable-xslt、stable-alpine-xslt
stable-zip、stable-alpine-zip
mainline-acme、mainline-alpine-acme
mainline-auth-spnego、mainline-alpine-auth-spnego
mainline-brotli、mainline-alpine-brotli
mainline-echo、mainline-alpine-echo
mainline-encrypted-session、mainline-alpine-encrypted-session
mainline-fips-check、mainline-alpine-fips-check
mainline-geoip、mainline-alpine-geoip
mainline-geoip2、mainline-alpine-geoip2
mainline-headers-more、mainline-alpine-headers-more
mainline-image-filter、mainline-alpine-image-filter
mainline-lua、mainline-alpine-lua
mainline-ndk、mainline-alpine-ndk
mainline-njs、mainline-alpine-njs
mainline-otel、mainline-alpine-otel
mainline-passenger、mainline-alpine-passenger
mainline-perl、mainline-alpine-perl
mainline-rtmp、mainline-alpine-rtmp
mainline-set-misc、mainline-alpine-set-misc
mainline-subs-filter、mainline-alpine-subs-filter
mainline-vts、mainline-alpine-vts
mainline-xslt、mainline-alpine-xslt
mainline-zip、mainline-alpine-zip

版本化版本标签

1.28-acme、1.28-alpine-acme
1.28-auth-spnego、1.28-alpine-auth-spnego
1.28-brotli、1.28-alpine-brotli
1.28-echo、1.28-alpine-echo
1.28-encrypted-session、1.28-alpine-encrypted-session
1.28-fips-check、1.28-alpine-fips-check
1.28-geoip、1.28-alpine-geoip
1.28-geoip2、1.28-alpine-geoip2
1.28-headers-more、1.28-alpine-headers-more
1.28-image-filter、1.28-alpine-image-filter
1.28-lua、1.28-alpine-lua
1.28-ndk、1.28-alpine-ndk
1.28-njs、1.28-alpine-njs
1.28-otel、1.28-alpine-otel
1.28-passenger、1.28-alpine-passenger
1.28-perl、1.28-alpine-perl
1.28-rtmp、1.28-alpine-rtmp
1.28-set-misc、1.28-alpine-set-misc
1.28-subs-filter、1.28-alpine-subs-filter
1.28-vts、1.28-alpine-vts
1.28-xslt、1.28-alpine-xslt
1.28-zip、1.28-alpine-zip
1.28.0-acme、1.28.0-alpine-acme
1.28.0-auth-spnego、1.28.0-alpine-auth-spnego
1.28.0-brotli、1.28.0-alpine-brotli
1.28.0-echo、1.28.0-alpine-echo
1.28.0-encrypted-session、1.28.0-alpine-encrypted-session
1.28.0-fips-check、1.28.0-alpine-fips-check
1.28.0-geoip、1.28.0-alpine-geoip
1.28.0-geoip2、1.28.0-alpine-geoip2
1.28.0-headers-more、1.28.0-alpine-headers-more
1.28.0-image-filter、1.28.0-alpine-image-filter
1.28.0-lua、1.28.0-alpine-lua
1.28.0-ndk、1.28.0-alpine-ndk
1.28.0-njs、1.28.0-alpine-njs
1.28.0-otel、1.28.0-alpine-otel
1.28.0-passenger、1.28.0-alpine-passenger
1.28.0-perl、1.28.0-alpine-perl
1.28.0-rtmp、1.28.0-alpine-rtmp
1.28.0-set-misc、1.28.0-alpine-set-misc
1.28.0-subs-filter、1.28.0-alpine-subs-filter
1.28.0-vts、1.28.0-alpine-vts
1.28.0-xslt、1.28.0-alpine-xslt
1.28.0-zip、1.28.0-alpine-zip
1.29-acme、1.29-alpine-acme
1.29-auth-spnego、1.29-alpine-auth-spnego
1.29-brotli、1.29-alpine-brotli
1.29-echo、1.29-alpine-echo
1.29-encrypted-session、1.29-alpine-encrypted-session
1.29-fips-check、1.29-alpine-fips-check
1.29-geoip、1.29-alpine-geoip
1.29-geoip2、1.29-alpine-geoip2
1.29-headers-more、1.29-alpine-headers-more
1.29-image-filter、1.29-alpine-image-filter
1.29-lua、1.29-alpine-lua
1.29-ndk、1.29-alpine-ndk
1.29-njs、1.29-alpine-njs
1.29-otel、1.29-alpine-otel
1.29-passenger、1.29-alpine-passenger
1.29-perl、1.29-alpine-perl
1.29-rtmp、1.29-alpine-rtmp
1.29-set-misc、`1.29-alpine-set-m

查看更多 nginx-modules 相关镜像 →

nginx/nginx-ingress

NGINX和NGINX Plus入口控制器是专为Kubernetes设计的流量管理工具，主要用于管理外部HTTP/HTTPS流量进入Kubernetes集群，支持请求路由、负载均衡、SSL终止、流量控制等功能，适用于容器化应用和微服务架构，其中NGINX Plus还提供商业支持、高级监控和增强的负载均衡能力，帮助提升集群流量管理的效率与安全性。

上次更新：1 天前

nginx/nginx-prometheus-exporter

NGINX Prometheus Exporter用于收集并导出NGINX与NGINX Plus的监控指标，供Prometheus采集以实现对其运行状态的监控。

上次更新：7 天前

常见问题

轩辕镜像免费版与专业版有什么区别？

免费版仅支持 Docker Hub 加速，不承诺可用性和速度；专业版支持更多镜像源，保证可用性和稳定速度，提供优先客服响应。

轩辕镜像免费版与专业版有分别支持哪些镜像？

免费版仅支持 docker.io；专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。

流量耗尽错误提示

当返回 402 Payment Required 错误时，表示流量已耗尽，需要充值流量包以恢复服务。

410 错误问题

通常由 Docker 版本过低导致，需要升级到 20.x 或更高版本以支持 V2 协议。

manifest unknown 错误

先检查 Docker 版本，版本过低则升级；版本正常则验证镜像信息是否正确。

镜像拉取成功后，如何去掉轩辕镜像域名前缀？

使用 docker tag 命令为镜像打上新标签，去掉域名前缀，使镜像名称更简洁。

查看全部问题→

轩辕镜像下载加速使用手册

探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式

登录方式进行 Docker 镜像下载加速教程

通过 Docker 登录方式配置轩辕镜像加速服务，包含7个详细步骤

Linux Docker 镜像下载加速教程

在 Linux 系统上配置轩辕镜像源，支持主流发行版

Windows/Mac Docker 镜像下载加速教程

在 Docker Desktop 中配置轩辕镜像加速，适用于桌面系统

Docker Compose 镜像下载加速教程

在 Docker Compose 中使用轩辕镜像加速，支持容器编排

K8s containerd 镜像下载加速教程

在 k8s 中配置 containerd 使用轩辕镜像加速

宝塔面板 Docker 镜像下载加速教程

在宝塔面板中配置轩辕镜像加速，提升服务器管理效率

群晖 NAS Docker 镜像下载加速教程

在 Synology 群晖NAS系统中配置轩辕镜像加速

飞牛fnOS Docker 镜像下载加速教程

在飞牛fnOS系统中配置轩辕镜像加速

极空间 NAS Docker 镜像下载加速教程

在极空间NAS中配置轩辕镜像加速

爱快路由 ikuai Docker 镜像下载加速教程

在爱快ikuai系统中配置轩辕镜像加速

绿联 NAS Docker 镜像下载加速教程

在绿联NAS系统中配置轩辕镜像加速

威联通 NAS Docker 镜像下载加速教程

在威联通NAS系统中配置轩辕镜像加速

Podman Docker 镜像下载加速教程

在 Podman 中配置轩辕镜像加速，支持多系统

ghcr、Quay、nvcr、k8s、gcr 等仓库下载镜像加速教程

配置轩辕镜像加速9大主流镜像仓库，包含详细配置步骤

专属域名方式进行 Docker 镜像下载加速教程

无需登录即可使用轩辕镜像加速服务，更加便捷高效

需要其他帮助？请查看我们的常见问题或官方QQ群: 13763429