caoweida2004/nginx-http3 repository overview

⁠Nginx with HTTP/3

Testing-oriented mainline Nginx image with HTTP/3 (QUIC), TLS 1.3, OpenSSL 4.0, post-quantum crypto support, and ECH-capable builds.

⁠Quick Start

Standard version (Ubuntu 22.04+, Debian 12+, RHEL 9+):

docker run -d -p 80:80 -p 443:443 -p 443:443/udp caoweida2004/nginx-http3:latest

Compatible version (CentOS 7, Alibaba Cloud Linux 2/3, Ubuntu 20.04, Debian 11):

docker run -d -p 80:80 -p 443:443 -p 443:443/udp caoweida2004/nginx-http3:latest-compat

⁠Features

• ✅ HTTP/2 and HTTP/3 (QUIC)
• ✅ TLS 1.3 with modern cipher suites
• ✅ OpenSSL 4.0, PCRE2, zlib
• ✅ Post-Quantum Cryptography via OpenSSL 4.0+
• ✅ Encrypted Client Hello (ECH) capable build and example
• ✅ Multi-architecture (amd64, arm64)
• ✅ Minimal scratch runtime to avoid unused OS packages
• ✅ Daily upstream checks

⁠Version Selection

⁠Standard Version (latest)

• Runtime: scratch/minimal
• glibc: copied from the updated Ubuntu 24.04 builder
• Best for: Modern systems (Ubuntu 22.04+, Debian 12+, RHEL 9+)
• Package manager and unused tools such as apt, dpkg, tar, and sed are not present

⁠Compatible Version (latest-compat)

• Base: CentOS 7 build + AlmaLinux 8 minimal runtime
• glibc: 2.17+
• Best for: Older systems (CentOS 7, Alibaba Cloud Linux 2/3, Ubuntu 20.04, Debian 11)

⁠Runtime Package Policy

These are nginx runtime images, not full Linux distribution images. Standard images build nginx on updated Ubuntu 24.04, then copy only nginx, required shared libraries, CA certificates, and passwd/group data into a scratch runtime. Package-management and archive utilities are not included.

⁠Links

• GitHub: https://github.com/weida/nginx-mainline-test-builds⁠
• Documentation: https://github.com/weida/nginx-mainline-test-builds/blob/main/README-Docker.md⁠