caoweida2004/freenginx-http3 repository overview

⁠freenginx with HTTP/3

Testing-oriented mainline freenginx 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/freenginx-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/freenginx-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 freenginx runtime images, not full Linux distribution images. Standard images build freenginx on updated Ubuntu 24.04, then copy only freenginx, 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⁠
• freenginx: https://freenginx.org⁠