Software Mirrors
ProductsBlogs
Nginx Mainline release-1.31.9

Nginx Mainline release-1.31.9

NGINX Mainline is a high-performance, open-source web server, reverse proxy, and load balancer that incorporates the latest NGINX features and enhancements. It supports HTTP/2, HTTP/3, SSL/TLS termination, content caching, TCP/UDP proxying, and advanced traffic management for modern websites, APIs, and application infrastructure.
(4.9)

Developer

NGINX

Category

Developer Tools

Operating System

Windows / macOS / Linux

Date Published

Thu Nov 19 2026

Review Nginx Mainline release-1.31.9

NGINX functions as an open-source web server, reverse proxy, load balancer, API gateway, and content cache, designed to efficiently handle a large number of concurrent connections. It is widely used for serving websites, distributing application traffic, terminating TLS connections, and managing communication between backend services.

The mainline branch is the actively developed release branch of NGINX Open Source. Unlike the stable branch, it receives new features alongside bug fixes and security updates. This makes it ideal for administrators and developers who wish to access the latest NGINX features without waiting for them to reach a stable release.

NGINX utilizes an asynchronous, event-driven architecture, rather than creating a separate process or thread for each connection. Its master-worker process model allows the system to handle high volumes of data traffic while maintaining efficient resource utilization.

Download Nginx Mainline release-1.31.9 - Software Mirrors

nginx-1.31.9.zip | 2.67 MB

nginx-1.31.9.tar.gz | 1.32 MB

Nginx Mainline release-1.31.9 Source Code

Nginx Mainline release-1.31.9 Source code (zip)

Nginx Mainline release-1.31.9 Source code (tar.gz)

Nginx Mainline release-1.31.9 Release Notes:

nginx-1.31.9 mainline version has been released, with vulnerability fixes for use-after-free in resolver (CVE-2026-123634), memory corruption in HTTP/2 flow control (CVE-2026-123007), use-after-free in HTTP/3 (CVE-2026-121810), use-after-free in HTTP/2 (CVE-2026-123633), infinite loop while reading client request body over TLS 1.3 (CVE-2026-118899), use-after-free in mail proxy module (CVE-2026-113425), NULL pointer dereference when using PROXY protocol version 2 (CVE-2026-120993), buffer overflow when using alias with try_files (CVE-2026-125283), SNI bypass in client certificate validation in stream module (CVE-2026-120967), and insufficient validation in stream ssl_preread module (CVE-2026-123640). See official CHANGES on nginx.org. Below is a release summary generated by GitHub.

What's Changed

  • Version bump by @arut in #1891

  • Limit conn: fixed counter leak on memory allocation errors by @dekobon in #1869

  • Proxy: use zero Content-Length while discarding request body by @dekobon in #1862

  • Core: made initgroups() failures fatal by @VadimZhestikov in #1833

  • SSL: explicitly clear the session staging buffer by @ac000 in #1812

  • HTTP/3: fix QPACK static table values to match RFC 9204 by @Nexory in #1895

  • Disabled handling of headers without a colon by @VadimZhestikov in #1904

  • Fixed $cookie_ after a cookie without a name by @VadimZhestikov in #1910

  • Control API: fixed handling of oversized requests by @daewoo1109 in #1924

  • HTTP/2: output queue fixes by @pluknet in #1890

  • HTTP/2: Ignore unknown flags in the SETTINGS message by @marek-ludha in #1795

  • Request body: flood detection for chunked request body by @sbhowmikf5 in #1619

  • Control API: warn in single process mode only if API is enabled by @piotrp in #1898

  • GeoIP: rejected out-of-range coordinates from MMDB lookups. by @u5surf in #1908

  • OCSP: removed padding and preserved sign of serial in cache keys by @bavshin-f5 in #1927

  • Index: fixed handling of non-cacheable variables. by @arut in #1940

  • Map: fixed regex pattern lifetime by @arut in #1947

  • Updated zlib used for win32 builds by @pluknet in #1953

New Contributors

  • @Nexory made their first contribution in #1895

  • @marek-ludha made their first contribution in #1795

  • @piotrp made their first contribution in #1898

  • @u5surf made their first contribution in #1908

Full Changelog: release-1.31.8...release-1.31.9

Features

High-Performance Web Server

NGINX can serve static content such as HTML, CSS, JavaScript, images, and downloadable files directly. Its event-driven architecture is designed to handle thousands of simultaneous connections efficiently.

Supported capabilities include:

It can operate as a standalone web server or serve as the front end for dynamic applications.

Reverse Proxy

NGINX is particularly useful as a reverse proxy for applications running behind it. It receives incoming requests and forwards them to the appropriate backend service without exposing those services directly to the internet.

Its reverse-proxy capabilities include:

It works with application servers such as PHP-FPM, Node.js, Python, Java, and Go.

Load Balancing

NGINX distributes incoming traffic across multiple backend servers to improve availability and resource utilization.

Available load-balancing methods include:

Administrators can configure upstream groups, assign server weights, define backup servers, and control connection limits.

The open-source edition supports passive health checks through parameters such as max_fails and fail_timeout. Active health checks and additional advanced monitoring capabilities are available in NGINX Plus.

Content Caching

NGINX includes a flexible caching system that reduces backend workload and improves response times.

Its proxy cache stores responses from upstream servers on disk. Administrators can control caching behavior through configuration directives.

Important capabilities include:

This makes NGINX useful for websites and APIs that need to reduce repeated requests to application servers.

SSL and TLS Termination

NGINX supports HTTPS and can handle TLS encryption before forwarding requests to backend applications.

Features include:

This allows administrators to centralize certificate management and encryption settings instead of configuring TLS independently for every backend application.

HTTP/2 and HTTP/3

NGINX supports modern HTTP protocols to improve communication between clients and servers.

HTTP/2 provides multiplexing, header compression, and more efficient request handling over a single connection.

HTTP/3 uses QUIC over UDP and can improve connection establishment and performance under certain network conditions.

The mainline branch is particularly relevant for users who want the latest protocol improvements and related bug fixes. HTTP/3 requires an appropriate build configuration and compatible TLS library.

TCP and UDP Load Balancing

The Stream module extends NGINX beyond HTTP traffic by providing TCP and UDP proxying.

It can distribute connections to databases, mail servers, DNS services, and other network applications.

Supported capabilities include:

This makes NGINX useful as a general-purpose network traffic gateway rather than exclusively a web server.

Mail Proxy

NGINX includes a mail proxy module for handling connections to IMAP, POP3, and SMTP servers.

It can authenticate users through an external HTTP authentication service and proxy connections to backend mail servers.

This is useful for organizations that want to centralize mail connection handling and authentication.

Access Control and Security

NGINX provides several mechanisms for controlling access to websites and backend services.

These include:

Its modular architecture also allows administrators to extend functionality with third-party modules, although external modules should be reviewed carefully for compatibility and security.

Modular Architecture and Extensibility

NGINX uses a modular architecture that allows administrators to enable additional functionality during compilation or load supported dynamic modules at runtime.

Common modules cover HTTP authentication, compression, image filtering, geographic IP handling, real IP processing, stream proxying, mail proxying, and other capabilities.

NGINX also supports NGINX JavaScript (njs), a module that extends its functionality with JavaScript-based scripting for HTTP and Stream processing.

Dynamic modules are useful when you want to extend an existing installation without rebuilding the entire executable, provided the module is compatible with the installed NGINX build.

Configuration and Process Management

NGINX uses a master process and worker processes. The master process manages configuration and worker lifecycle, while workers handle incoming connections.

Its configuration system supports reusable directives, nested contexts, variables, conditional processing, and configuration file inclusion.

Useful administrative commands include:

nginx -t
nginx -T
nginx -s reload
nginx -s quit
nginx -s stop

The configuration test command checks syntax and attempts to open referenced files. Reloading applies configuration changes without requiring a full service restart.

Performance and Compatibility

NGINX is written in C and uses an event-driven, non-blocking architecture. Its worker processes can handle multiple connections concurrently, making it suitable for high-traffic web servers and reverse-proxy deployments.

Performance depends on several factors, including CPU resources, available memory, network throughput, TLS configuration, connection patterns, and backend response times.

Its main performance characteristics include:

NGINX supports Linux, FreeBSD, macOS, and other Unix-like operating systems. Windows executables are also available, but the Windows implementation remains limited and is intended primarily for development and testing rather than high-performance production deployments.

The mainline branch receives new features and improvements more frequently than Stable. This provides earlier access to functionality and fixes, but also means administrators should test upgrades and configuration changes before deploying them to critical infrastructure.

NGINX Open Source is distributed under the BSD 2-Clause License.

System Requirements

NGINX has relatively modest baseline requirements and can run on small virtual machines as well as large production servers.

Supported platforms:

Build requirements:

Optional dependencies are not mandatory for every build. A minimal HTTP server, for example, can be compiled without enabling every available module.

Pros and Cons

Pros

Cons

How to Install

There are several ways to install NGINX Mainline. The official NGINX package repository is convenient for production environments because it provides maintained packages and updates independently of the distribution's default repositories.

For custom installations, compiling the mainline source code provides more control over modules, dependencies, installation paths, and compiler options.

Install from the Official Repository

On Debian or Ubuntu, configure the official NGINX repository and select the mainline package source.

Install the required repository tools:

sudo apt update
sudo apt install curl gnupg2 ca-certificates lsb-release debian-archive-keyring

Import the official signing key:

curl -fsSL https://nginx.org/keys/nginx_signing.key \
  | gpg --dearmor \
  | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null

Configure the mainline repository:

echo "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] \
https://nginx.org/packages/mainline/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") nginx" \
  | sudo tee /etc/apt/sources.list.d/nginx.list

For Debian, replace ubuntu in the repository URL with debian.

Install NGINX:

sudo apt update
sudo apt install nginx

The official repository provides both Stable and Mainline packages. Make sure the repository points to packages/mainline if you want to receive mainline updates.

Compile NGINX Mainline from Source

The GitHub repository contains the actively developed mainline source code. Clone the repository:

git clone https://github.com/nginx/nginx.git
cd nginx

Install the required build dependencies on Debian or Ubuntu:

sudo apt update
sudo apt install build-essential libpcre2-dev zlib1g-dev libssl-dev

Configure the build:

auto/configure \
  --prefix=/usr/local/nginx \
  --with-http_ssl_module \
  --with-http_v2_module \
  --with-http_v3_module \
  --with-http_realip_module \
  --with-http_gzip_static_module \
  --with-http_stub_status_module \
  --with-stream \
  --with-stream_ssl_module

Compile and install:

make -j"$(nproc)"
sudo make install

The HTTP/3 option requires a compatible QUIC-capable TLS library and additional build configuration. If those dependencies are unavailable, remove --with-http_v3_module.

Check the installed build:

/usr/local/nginx/sbin/nginx -V

Test the configuration and start NGINX:

sudo /usr/local/nginx/sbin/nginx -t
sudo /usr/local/nginx/sbin/nginx

For production deployments, configure NGINX as a systemd service and manage its lifecycle through systemd.

When building from the GitHub repository, remember that cloning the mainline branch retrieves the latest development source. For reproducible production builds, check out a specific release tag or commit instead of relying on a moving branch.

Final Verdict

NGINX Mainline is an excellent choice for developers and administrators who want the latest improvements in one of the most capable open-source web servers available. Its combination of reverse proxying, load balancing, caching, TLS termination, and TCP/UDP traffic management makes it suitable for a wide range of infrastructure deployments.

Its main advantage over Stable is access to newer features and improvements without waiting for them to be backported or included in a later stable release. This is particularly useful for environments that need modern protocol support and benefit from ongoing development.

However, the faster release cycle requires more attention to upgrades, testing, and compatibility. Organizations with strict change-control policies may prefer Stable, while administrators comfortable with regular maintenance can benefit from Mainline.

Overall, NGINX Mainline is a strong option for modern web servers, application gateways, reverse proxies, and high-traffic infrastructure.

Sources


Comments on Nginx Mainline release-1.31.9