kiweeteam/nginx-brotli

NGINX with Brotli压缩模块

镜像概述

本镜像基于官方NGINX镜像构建，集成了Google开发的Brotli压缩模块（ngx_brotli）。Brotli压缩算法相比传统gzip具有更高的压缩率，可有效减少传输数据大小，提升网站加载速度，适用于需优化网络传输性能的场景。

核心功能与特性

• 基于官方镜像：沿用官方NGINX镜像的稳定性与兼容性，确保服务可靠运行。
• 预集成Brotli模块：无需手动编译安装，模块已预先加载至NGINX配置中。
• 可自定义配置：提供默认压缩配置文件，支持通过挂载文件自定义压缩参数。

使用场景

• 静态资源服务：对HTML、CSS、JavaScript、图片等静态文件进行压缩，加速网页加载。
• API响应优化：压缩JSON/XML等API响应数据，减少带宽消耗。
• 带宽敏感场景：适用于需降低传输成本或提升弱网环境下用户体验的服务。

配置说明

默认配置路径

• 模块加载：Brotli模块已在/etc/nginx/nginx.conf中预加载，无需额外配置。
• 压缩配置：默认压缩规则位于/etc/nginx/conf.d/broli.conf，包含基础压缩级别、支持的MIME类型等参数。

自定义压缩配置

如需调整压缩级别、缓冲区大小或支持的文件类型，可通过以下方式覆盖默认配置：

1. 本地创建自定义配置文件（例如custom-brotli.conf），示例内容：

   nginx
   brotli on;
   brotli_comp_level 6;  # 压缩级别（1-11，越高压缩率越好但耗时增加）
   brotli_buffers 16 8k;  # 缓冲区设置
   brotli_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript image/svg+xml;  # 需压缩的文件类型
   

2. 通过Docker挂载替换默认配置文件：

   bash
   docker run -v /本地路径/custom-brotli.conf:/etc/nginx/conf.d/broli.conf ...
   

使用方法

快速启动

使用以下命令启动容器，映射80端口并快速提供压缩服务：

bash
docker run --name=nginx-brotli --rm -p 80:80 docker.xuanyuan.run/kiweeteam/nginx-brotli:latest

参数说明：

• --name=nginx-brotli：指定容器名称，便于管理。
• --rm：容器停止后自动删除，避免残留资源。
• -p 80:80：将容器80端口映射至主机80端口，外部可通过http://localhost访问。

Docker Compose配置

如需挂载静态资源或自定义配置，可使用docker-compose.yml：

yaml
version: '3'
services:
  nginx-brotli:
    image: docker.xuanyuan.run/kiweeteam/nginx-brotli:latest
    container_name: nginx-brotli
    ports:
      - "80:80"
    volumes:
      - ./static:/usr/share/nginx/html  # 挂载本地静态资源目录
      - ./custom-brotli.conf:/etc/nginx/conf.d/broli.conf  # 挂载自定义压缩配置
    restart: always  # 容器退出后自动重启

启动命令：docker-compose up -d

模块源码

Brotli压缩模块（ngx_brotli）源码仓库：https://github.com/google/ngx_brotli