georgjung/nginx-brotli

nginx-brotli

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

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

这是什么？

官方https://hub.docker.com/_/nginx/%60nginx:latest%60%E5%92%8C%60nginx:mainline-alpine%60/%60nginx:alpine%60%E9%95%9C%E5%83%8F%E7%9A%84%E7%9B%B4%E6%8E%A5%E6%9B%BF%E4%BB%A3%E5%93%81%EF%BC%8C%E5%A2%9E%E5%8A%A0%E4%BA%86brotli%E6%94%AF%E6%8C%81%E3%80%82%E6%9B%B4%E6%96%B0%E5%AE%8C%E5%85%A8%E8%87%AA%E5%8A%A8%E5%8C%96%EF%BC%8C%E5%9B%A0%E6%AD%A4%E9%95%9C%E5%83%8F%E4%B8%8D%E4%BC%9A%E8%BF%87%E6%97%B6%E3%80%82

适合谁使用？

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

使用方法

此镜像包含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的更新。如有更新，镜像会自动重建。构建过程使用https://github.com/nginxinc/docker-nginx/tree/master/modules%EF%BC%88%E6%8C%89https://github.com/nginxinc/docker-nginx/issues/371#issuecomment-752088336%E7%94%A8%E4%BA%8E%E6%89%A9%E5%B1%95%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%B7%BB%E5%8A%A0%E8%87%AA%E5%AE%9A%E4%B9%89%E6%A8%A1%E5%9D%97%EF%BC%89%E3%80%82%E6%9B%B4%E5%A4%9A%E8%AF%A6%E6%83%85%E8%AF%B7%E6%9F%A5%E7%9C%8Bhttps://github.com/georg-jung/nginx-brotli%EF%BC%8C%E6%AC%A2%E8%BF%8E%E6%8F%90%E4%BA%A4issue%E5%92%8CPR%EF%BC%81

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

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