spryker/nginx-brotli

Nginx Brotli压缩镜像文档

镜像概述

本镜像基于Alpine Linux和官方Nginx镜像构建，集成了Google开发的Brotli压缩算法及ngx_brotli模块，提供静态和动态Brotli压缩功能。Brotli是一种高效的压缩算法，相比传统gzip能提供更高的压缩率，有助于减少网络传输数据量并提升网页加载速度。

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，镜像体积小，资源占用低
• 官方兼容性：完全兼容官方Nginx镜像的所有功能和使用方式
• Brotli压缩支持：同时支持静态文件预压缩和动态内容实时压缩
• 官方模块集成：内置Google官方ngx_brotli模块，无需额外编译安装

使用场景与适用范围

• 需要优化网站加载速度的Web服务
• 静态资源（HTML、CSS、JS、JSON等）的高效压缩传输
• 对带宽成本敏感的Web应用部署
• 希望提升用户体验的前端资源服务器
• 替代或增强传统gzip压缩的Nginx环境

使用方法与配置说明

基础使用

本镜像使用方式与官方Nginx镜像完全一致，基本启动命令：

bash
docker run -d -p 80:80 --name nginx-brotli [镜像名称]

配置Brotli压缩

在Nginx配置文件中添加Brotli模块专用指令，典型配置示例：

nginx
http {
    # 启用Brotli压缩
    brotli on;
    
    # 设置压缩级别(1-11)，值越高压缩率越高但CPU消耗越大
    brotli_comp_level 6;
    
    # 指定需要压缩的MIME类型
    brotli_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript image/svg+xml;
    
    # 最小压缩文件大小
    brotli_min_length 20;
    
    # 启用静态压缩文件缓存
    brotli_static on;
}

完整配置示例

通过Docker Compose部署并自定义配置：

yaml
version: '3'
services:
  nginx:
    image: docker.xuanyuan.run/[镜像名称]
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./html:/usr/share/nginx/html
      - ./conf.d:/etc/nginx/conf.d
    restart: always

配置指令参考

完整的Brotli模块配置指令请参考https://github.com/google/ngx_brotli#configuration-directives%E3%80%82