michaelknightdriver/docker-nginx-brotli

Docker Nginx Brotli 镜像文档

镜像概述和主要用途

本镜像基于Alpine Linux和官方Nginx镜像构建，集成了Google开发的Brotli压缩算法及对应的Nginx模块（ngx_brotli）。Brotli是一种高效的压缩算法，相比传统的gzip压缩能提供更高的压缩率，有助于减少网络传输数据量，提升网页加载速度。该镜像适用于需要优化静态资源传输效率的Web服务场景。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 稳定Nginx内核：继承官方Nginx镜像的稳定性和功能完整性
• Brotli压缩支持：集成Google ngx_brotli模块，支持静态和动态内容压缩
• 配置兼容性：除标准Nginx配置指令外，支持Brotli模块专属配置参数

使用场景和适用范围

• 静态资源服务器（如HTML、CSS、JavaScript、图片等文件服务）
• Web应用前端服务器，需优化资源加载速度
• 对带宽使用敏感的场景，需通过高压缩率减少传输数据量
• 需要兼容现代浏览器Brotli压缩支持的Web服务

使用方法和配置说明

基础使用

本镜像基于官方https://hub.docker.com/_/nginx/%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%9B%A0%E6%AD%A4%E5%8F%AF%E5%8F%82%E8%80%83%E5%AE%98%E6%96%B9%E6%96%87%E6%A1%A3%E7%9A%84%E5%9F%BA%E7%A1%80%E4%BD%BF%E7%94%A8%E6%96%B9%E6%B3%95%E3%80%82

快速启动容器

bash
docker run -d -p 80:80 --name nginx-brotli michaelknightdriver/docker-nginx-brotli

使用自定义配置

创建本地Nginx配置文件（如nginx.conf），并挂载到容器中：

bash
docker run -d -p 80:80 --name nginx-brotli -v /path/to/your/nginx.conf:/etc/nginx/nginx.conf michaelknightdriver/docker-nginx-brotli

Brotli模块配置

在Nginx配置中添加Brotli相关指令以启用压缩功能。常用配置示例：

nginx
http {
    # 启用Brotli压缩
    brotli on;
    
    # 压缩级别（1-11，值越高压缩率越高但CPU占用越大）
    brotli_comp_level 6;
    
    # 最小压缩文件大小
    brotli_min_length 20;
    
    # 压缩缓冲区大小
    brotli_buffers 16 8k;
    
    # 压缩类型（指定需要压缩的MIME类型）
    brotli_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;
}

完整配置参考

更多Brotli模块配置指令及详细说明，请参考https://github.com/google/ngx_brotli#configuration-directives%E3%80%82