denji/nginx-boringssl

基于BoringSSL和TLSv1.3构建的NGINX

Docker镜像

https://github.com/nginx-modules/docker-nginx-boringssl/actions/workflows/docker-image.yml/badge.svg](https://github.com/nginx-modules/docker-nginx-boringssl/actions/workflows/docker-image.yml)

镜像概述

本镜像提供基于BoringSSL构建的NGINX服务，专注于提供增强的TLS安全性和性能优化。基于Alpine Linux构建，支持多种架构，适用于需要高安全性和现代TLS特性的Web服务场景。

支持的标签及对应架构

Stable Release

• docker.io/denji/nginx-boringssl:stable-alpine - (Linux x86_64-v4)
• docker.io/denji/nginx-boringssl:stable-aarch64-alpine - (Linux AArch64 - ARMv8)
• docker.io/denji/nginx-boringssl:stable-armv7-alpine - (Linux ARMv7 - 32-bit)

Mainline Release

• docker.io/denji/nginx-boringssl:mainline-alpine - (Linux x86_64-v4)
• docker.io/denji/nginx-boringssl:mainline-aarch64-alpine - (Linux AArch64 - ARMv8)
• docker.io/denji/nginx-boringssl:mainline-armv7-alpine - (Linux ARMv7 - 32-bit)

使用前注意

由于BoringSSL的滚动发布特性及相关模块依赖，本项目处于不稳定状态，生产环境使用前建议充分测试。

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，体积小巧且资源占用低
• 增强安全：使用BoringSSL编译NGINX，支持最新TLS特性
• 性能优化：启用PCRE JIT编译，提升正则表达式处理效率
• 现代协议：支持HTTP/2.0（含NPN协商）
• 高效I/O：支持基于线程的异步I/O模型
• TLS优化：集成CloudFlare动态TLS记录补丁（已默认配置）
• 压缩支持：
  • 启用Gzip静态.gz文件处理
  • 支持Brotli静态.br文件（动态压缩因稳定性问题已禁用）

使用场景

• 需要高安全性TLS配置的Web服务
• 对性能有要求的静态资源服务
• 多架构部署环境（x86_64、ARMv7、AArch64）
• 需要HTTP/2及现代TLS协议支持的应用

注意事项

1. 环境要求：推荐使用Linux 3.17+内核及最新稳定版Docker
2. SSL配置差异：
   • BoringSSL对ECDH曲线命名与OpenSSL/LibreSSL不同（如secp384r1对应BoringSSL的P-384）
   • 默认配置文件/etc/nginx/confssl_params提供了曲线配置示例
   • 推荐将X25519作为首选曲线，置于曲线列表首位
3. 密码组支持：BoringSSL支持密码组定义，格式为[cipher1|cipher2|cipher3]，组内密码由客户端选择最优项，适用于AES与ChaCha20共存场景

基于项目

本镜像基于官方NGINX Dockerfile及Wonderfall/boring-nginx项目构建。