georgjung/nginx-brotli Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

nginx-brotli

请不要忘记在nginx.conf顶部加载brotli模块：

nginx
load_module modules/ngx_http_brotli_static_module.so;
load_module modules/ngx_http_brotli_filter_module.so;

这是什么？

官方nginx:mainline/nginx:latest和nginx:mainline-alpine/nginx:alpine镜像的直接替代品，增加了brotli支持。更新完全自动化，因此镜像不会过时。

适合谁使用？

所有使用nginx:{mainline/latest/mainline-alpine/alpine}且需要brotli压缩支持或通过brotli_static提供static_resource.css.br样式文件的用户。注意目前仅支持linux/amd64架构。有关可用的其他选项详情，请查看ngx_brotli仓库。

使用方法

此镜像包含ngx_brotli模块，但默认未启用。这是因为该镜像并非自定义编译的nginx版本，而是基于官方构建。

要启用ngx_brotli，请在nginx.conf顶部添加：

nginx
load_module modules/ngx_http_brotli_static_module.so;
load_module modules/ngx_http_brotli_filter_module.so;

如果仅使用其中一个模块（例如brotli_static），只需加载相应模块即可。

一个提供预压缩.br文件的静态网页最小nginx.conf示例如下：

nginx
load_module modules/ngx_http_brotli_static_module.so;

events { }
http {
    include mime.types;
    default_type application/octet-stream;

    server {
        listen 80;

        location / {
            root /usr/share/nginx/html;
            try_files $uri $uri/ /index.html =404;
        }

        brotli_static on;
    }
}

如果未加载模块，可能会看到如下错误信息：

log
unknown directive "brotli_static" in /etc/nginx/nginx.conf:17

实现方式

基于GitHub Actions的每日定时任务会检查nginx:mainline和nginx:mainline-alpine的更新。如有更新，镜像会自动重建。构建过程使用NGINX官方提供的Dockerfile（按官方建议用于扩展官方镜像添加自定义模块）。更多详情请查看GitHub仓库，欢迎提交issue和PR！

每日更新内容 - 不更新内容

仅基于当前nginx:mainline和nginx:mainline-alpine的镜像会每日更新。例如，若使用nginx-brotli:1.23，只要1.23仍是mainline版本，就会获得更新；一旦有新版本发布，旧版本仍可使用，但不会再因基础镜像更新而更新。