macbre/nginx-brotli

macbre/nginx-brotli 镜像文档

镜像概述和主要用途

该镜像基于官方nginx镜像构建，提供稳定且最新的nginx环境，额外集成了QUIC+HTTP/3实验性支持、Google brotli压缩模块以及符合Mozilla SSL配置生成器标准的A级SSL配置。适用于需要高性能、高安全性的Web服务场景。

核心功能和特性

• QUIC + HTTP/3 支持：实验性支持下一代互联网协议，提供更低延迟和更好的连接稳定性
• brotli 压缩：集成Google的ngx_brotli模块，提供比gzip更高的压缩率
• A级SSL配置：预配置符合Mozilla SSL标准的安全设置，包含2048位DH参数
• 完整的nginx功能：基于官方nginx镜像，支持所有标准nginx模块和配置
• 多平台支持：可从Docker Hub和GitHub Container Registry获取

使用场景和适用范围

• 需要低延迟、高吞吐量的Web服务
• 提供静态资源并希望优化传输大小的站点
• 对SSL/TLS安全性有严格要求的应用
• 希望体验HTTP/3新特性的开发和测试环境
• 需要自定义nginx配置的生产环境

使用方法和配置说明

拉取镜像

从Docker Hub拉取：

bash
docker pull macbre/nginx-brotli:1.19.6-http3

从GitHub Container Registry拉取：

bash
docker pull ghcr.io/macbre/nginx-brotli:latest

注：更多nginx版本可参考https://hub.docker.com/_/nginx/%EF%BC%8C%E4%BD%86%E9%9D%9E%E6%89%80%E6%9C%89%E7%89%88%E6%9C%AC%E9%83%BD%E5%8C%85%E5%90%ABHTTP/3%E6%94%AF%E6%8C%81%E3%80%82

基础使用

该镜像基于官方nginx镜像构建，因此可参考https://hub.docker.com/_/nginx/%E8%BF%9B%E8%A1%8C%E5%9F%BA%E7%A1%80%E9%85%8D%E7%BD%AE%E3%80%82%E9%A2%9D%E5%A4%96%E6%94%AF%E6%8C%81brotli%E6%A8%A1%E5%9D%97%E7%9A%84%E9%85%8D%E7%BD%AE%E6%8C%87%E4%BB%A4%EF%BC%8C%E8%AF%A6%E8%A7%81https://github.com/google/ngx_brotli#configuration-directives%E3%80%82

配置文件包含

• 挂载到/etc/nginx/main.d目录下的.conf文件将被包含在nginx主配置上下文（可使用env等核心模块指令）
• 挂载到/etc/nginx/conf.d目录下的.conf文件将被包含在http配置上下文

SSL配置

镜像已预配置A级SSL支持，包含Mozilla推荐的2048位DH参数，路径为/etc/ssl/dhparam.pem。在SSL配置中引用：

nginx
ssl_dhparam /etc/ssl/dhparam.pem;

推荐使用Mozilla SSL配置生成器获取最佳SSL配置。

QUIC + HTTP/3配置示例

以下是启用QUIC和HTTP/3的服务器配置示例：

nginx
server {
    # 启用QUIC和HTTP/3
    listen 443 http3 reuseport;

    # 同时支持HTTP/2和HTTP/1.1
    listen 443 ssl http2;

    server_name localhost;  # 替换为您的域名

    # 需挂载SSL证书文件
    ssl_certificate     /etc/nginx/ssl/localhost.crt;
    ssl_certificate_key /etc/nginx/ssl/localhost.key;

    # 启用所有TLS版本（TLSv1.3是QUIC必需的）
    ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;

    # 启用0-RTT QUIC连接恢复
    ssl_early_data on;

    # 添加Alt-Svc头以协商HTTP/3
    add_header alt-svc 'h3-27=":443"; ma=86400, h3-28=":443"; ma=86400, h3-29=":443"; ma=86400';

    # 标识QUIC连接状态
    add_header QUIC-Status $quic;

    location / {
        # 自定义站点配置
    }
}

注：运行容器时需正确挂载SSL证书和配置文件，可参考项目中的run-docker.sh脚本了解详细部署流程。

镜像内置模块

通过nginx -V查看的编译配置：

nginx version: nginx/1.21.0
built by gcc 10.2.1 20201203 (Alpine 10.2.1_pre1) 
built with OpenSSL 1.1.1 (compatible; BoringSSL) (running with BoringSSL)
TLS SNI support enabled
configure arguments: 
	--prefix=/etc/nginx 
	--sbin-path=/usr/sbin/nginx 
	--modules-path=/usr/lib/nginx/modules 
	--conf-path=/etc/nginx/nginx.conf 
	--error-log-path=/var/log/nginx/error.log 
	--http-log-path=/var/log/nginx/access.log 
	--pid-path=/var/run/nginx.pid 
	--lock-path=/var/run/nginx.lock 
	--http-client-body-temp-path=/var/cache/nginx/client_temp 
	--http-proxy-temp-path=/var/cache/nginx/proxy_temp 
	--http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp 
	--http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp 
	--http-scgi-temp-path=/var/cache/nginx/scgi_temp 
	--user=nginx 
	--group=nginx 
	--with-http_ssl_module 
	--with-http_realip_module 
	--with-http_addition_module 
	--with-http_sub_module 
	--with-http_dav_module 
	--with-http_flv_module 
	--with-http_mp4_module 
	--with-http_gunzip_module 
	--with-http_gzip_static_module 
	--with-http_random_index_module 
	--with-http_secure_link_module 
	--with-http_stub_status_module 
	--with-http_auth_request_module 
	--with-http_xslt_module=dynamic 
	--with-http_image_filter_module=dynamic 
	--with-http_geoip_module=dynamic 
	--with-http_perl_module=dynamic 
	--with-threads 
	--with-stream 
	--with-stream_ssl_module 
	--with-stream_ssl_preread_module 
	--with-stream_realip_module 
	--with-stream_geoip_module=dynamic 
	--with-http_slice_module 
	--with-mail 
	--with-mail_ssl_module 
	--with-compat 
	--with-file-aio 
	--with-http_v2_module 
	--with-http_v3_module 
	--add-module=/usr/src/ngx_brotli 
	--with-cc-opt=-I../boringssl/include 
	--with-ld-opt='-L../boringssl/build/ssl -L../boringssl/build/***'