为容器环境提供预构建的NGINX包和模块。
源代码 | Docker Hub
注意
本仓库通过GitHub定时工作流自动运行。
由于GitHub Actions的限制,公共仓库中若60天无仓库活动,定时工作流将自动禁用。
若您期望获取NGINX新版本的构建但未找到,欢迎提交工单。
详见 [***]
模块基于scratch基础镜像构建,包含以下目录结构:
/module-available.d: 可用模块列表/packages: 特定操作系统的模块包内容Dockerfile# 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包和模块。
Dockerfile# 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
Dockerfile# 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/
支持的版本格式如下:
协议的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-acmestable-auth-spnego、stable-alpine-auth-spnegostable-brotli、stable-alpine-brotlistable-echo、stable-alpine-echostable-encrypted-session、stable-alpine-encrypted-sessionstable-fips-check、stable-alpine-fips-checkstable-geoip、stable-alpine-geoipstable-geoip2、stable-alpine-geoip2stable-headers-more、stable-alpine-headers-morestable-image-filter、stable-alpine-image-filterstable-lua、stable-alpine-luastable-ndk、stable-alpine-ndkstable-njs、stable-alpine-njsstable-otel、stable-alpine-otelstable-passenger、stable-alpine-passengerstable-perl、stable-alpine-perlstable-rtmp、stable-alpine-rtmpstable-set-misc、stable-alpine-set-miscstable-subs-filter、stable-alpine-subs-filterstable-vts、stable-alpine-vtsstable-xslt、stable-alpine-xsltstable-zip、stable-alpine-zipmainline-acme、mainline-alpine-acmemainline-auth-spnego、mainline-alpine-auth-spnegomainline-brotli、mainline-alpine-brotlimainline-echo、mainline-alpine-echomainline-encrypted-session、mainline-alpine-encrypted-sessionmainline-fips-check、mainline-alpine-fips-checkmainline-geoip、mainline-alpine-geoipmainline-geoip2、mainline-alpine-geoip2mainline-headers-more、mainline-alpine-headers-moremainline-image-filter、mainline-alpine-image-filtermainline-lua、mainline-alpine-luamainline-ndk、mainline-alpine-ndkmainline-njs、mainline-alpine-njsmainline-otel、mainline-alpine-otelmainline-passenger、mainline-alpine-passengermainline-perl、mainline-alpine-perlmainline-rtmp、mainline-alpine-rtmpmainline-set-misc、mainline-alpine-set-miscmainline-subs-filter、mainline-alpine-subs-filtermainline-vts、mainline-alpine-vtsmainline-xslt、mainline-alpine-xsltmainline-zip、mainline-alpine-zip1.28-acme、1.28-alpine-acme1.28-auth-spnego、1.28-alpine-auth-spnego1.28-brotli、1.28-alpine-brotli1.28-echo、1.28-alpine-echo1.28-encrypted-session、1.28-alpine-encrypted-session1.28-fips-check、1.28-alpine-fips-check1.28-geoip、1.28-alpine-geoip1.28-geoip2、1.28-alpine-geoip21.28-headers-more、1.28-alpine-headers-more1.28-image-filter、1.28-alpine-image-filter1.28-lua、1.28-alpine-lua1.28-ndk、1.28-alpine-ndk1.28-njs、1.28-alpine-njs1.28-otel、1.28-alpine-otel1.28-passenger、1.28-alpine-passenger1.28-perl、1.28-alpine-perl1.28-rtmp、1.28-alpine-rtmp1.28-set-misc、1.28-alpine-set-misc1.28-subs-filter、1.28-alpine-subs-filter1.28-vts、1.28-alpine-vts1.28-xslt、1.28-alpine-xslt1.28-zip、1.28-alpine-zip1.28.0-acme、1.28.0-alpine-acme1.28.0-auth-spnego、1.28.0-alpine-auth-spnego1.28.0-brotli、1.28.0-alpine-brotli1.28.0-echo、1.28.0-alpine-echo1.28.0-encrypted-session、1.28.0-alpine-encrypted-session1.28.0-fips-check、1.28.0-alpine-fips-check1.28.0-geoip、1.28.0-alpine-geoip1.28.0-geoip2、1.28.0-alpine-geoip21.28.0-headers-more、1.28.0-alpine-headers-more1.28.0-image-filter、1.28.0-alpine-image-filter1.28.0-lua、1.28.0-alpine-lua1.28.0-ndk、1.28.0-alpine-ndk1.28.0-njs、1.28.0-alpine-njs1.28.0-otel、1.28.0-alpine-otel1.28.0-passenger、1.28.0-alpine-passenger1.28.0-perl、1.28.0-alpine-perl1.28.0-rtmp、1.28.0-alpine-rtmp1.28.0-set-misc、1.28.0-alpine-set-misc1.28.0-subs-filter、1.28.0-alpine-subs-filter1.28.0-vts、1.28.0-alpine-vts1.28.0-xslt、1.28.0-alpine-xslt1.28.0-zip、1.28.0-alpine-zip1.29-acme、1.29-alpine-acme1.29-auth-spnego、1.29-alpine-auth-spnego1.29-brotli、1.29-alpine-brotli1.29-echo、1.29-alpine-echo1.29-encrypted-session、1.29-alpine-encrypted-session1.29-fips-check、1.29-alpine-fips-check1.29-geoip、1.29-alpine-geoip1.29-geoip2、1.29-alpine-geoip21.29-headers-more、1.29-alpine-headers-more1.29-image-filter、1.29-alpine-image-filter1.29-lua、1.29-alpine-lua1.29-ndk、1.29-alpine-ndk1.29-njs、1.29-alpine-njs1.29-otel、1.29-alpine-otel1.29-passenger、1.29-alpine-passenger1.29-perl、1.29-alpine-perl1.29-rtmp、1.29-alpine-rtmp1.29-set-misc、`1.29-alpine-set-m来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 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 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429