Leanpub Header

Skip to main content
Go to Leanpub.com

Mastering NGINX

The Definitive Guide to Architecture, Configuration, and Production Operations

This book is 100% completeLast updated on 2026-07-27
Steve Publications

Whether you're deploying your first reverse proxy or managing high traffic production infrastructure, this book gives you the practical knowledge to use NGINX with confidence. Learn not just what each feature does but why it matters, how to avoid common mistakes and how to build fast, secure, reliable systems that scale.

Minimum price

$19.00

$29.00

You pay

Author earns

$

Also available for 1 book credit with a Reader Membership

PDF
EPUB
WEB
APP
326
Pages
About

About

About the Book

This book is a comprehensive technical reference for intermediate Linux administrators through advanced DevOps and platform engineers who need deep operational knowledge of NGINX. It covers the complete ecosystem from core architecture and configuration fundamentals through load balancing, caching, TLS termination, HTTP/2 and HTTP/3, Kubernetes integration, performance tuning, security hardening, and production operations. Every concept is explained with technical rigor: not just how features work but why they exist, when to use them, their tradeoffs, performance implications, and common pitfalls. Production-ready configuration examples are provided throughout, annotated line by line, so you can understand the reasoning behind each directive.

Share this book

Categories

Web DevelopmentInfrastructure as CodeSystems AdministrationSystem IntegrationSoftware ArchitectureNetworking

Feedback

Email the Author

Author

About the Author

Steve Publications

Steve is a technology professional with more than 20 years of experience in software development, server infrastructure, cybersecurity, vulnerability research and reverse engineering. Throughout his career, he has designed, secured, analyzed and tested complex software and infrastructure, with a particular focus on understanding how systems fail and how they can be made more secure.

Outside of work, Steve enjoys sharing knowledge with the technology community. He collaborates with researchers, industry experts and technology professionals to write practical books covering software development, cybersecurity, cloud computing, networking, DevOps, artificial intelligence and enterprise technologies. His books focus on practical learning through clear explanations, real-world examples and hands-on exercises. With more than two decades of industry experience, his goal is to help IT professionals, students and technology enthusiasts build useful skills and stay current in a rapidly changing industry.

We believe readers deserve to know how our books are created. Most of our authors are not native English speakers, so we use AI to help translate, proofread manuscripts, fix grammar, improve sentence structure and make technical explanations easier to read. AI is used as an editing tool only. It does not replace the research, technical knowledge or hands-on experience behind our books. Some of our authors also prefer to remain anonymous for privacy or professional reasons. In those cases, we publish their work under a different name. The author's name may be different, but the quality of the content and our review process remain the same.

Every book is written, reviewed and maintained by experienced technology professionals, with contributions from our private technical community of more than 400 engineers and researchers from Ukraine, Belarus and Russia. We spend far more time validating technical accuracy and keeping our content up to date than generating text. We are always interested in working with experienced professionals who have deep expertise in a particular technology or domain. If you would like to publish a book with us or help review an existing manuscript, we'd love to hear from you. Send us a message describing your area of expertise. We are especially interested in niche technologies, specialized skills and emerging topics that are underrepresented in existing technical literature.

If you look through the contents of our books, you'll see practical examples, detailed explanations and material that is regularly updated. Our goal is to publish books that professionals can actually rely on, not low-effort AI-generated content. If you ever feel that one of our books does not meet that standard, Leanpub offers a 60-day money-back guarantee. Feel free to request a refund if you are not satisfied with your purchase.

Contents

Table of Contents

The Definitive Guide to Architecture, Configuration, and Production Operations

Introduction: The NGINX Story and Architecture Promise

  1. The Igor Sysoev Problem: Why NGINX Was Created
  2. Event-Driven Architecture: The Core Innovation
  3. What NGINX Is Today: Beyond the Web Server
  4. Open Source vs NGINX Plus: The Edition Landscape
  5. How to Use This Book

Chapter 1: Installation and Environment Setup

  1. Packaging Ecosystems: Official Repositories vs Package Managers
  2. Building from Source: Control and Customization
  3. Containerized NGINX: Official Images and Variants
  4. Directory Structure and Binaries
  5. Default Configuration Anatomy

Chapter 2: Configuration Syntax, Directives, and Contexts

  1. The Configuration Grammar: Blocks, Directives, and Parameters
  2. Directive Contexts: Where Directives Belong
  3. Configuration Inheritance and Precedence
  4. Variables: Built-in, Custom, and Computed
  5. Include Mechanism and Configuration Organization
  6. Configuration Testing and Validation

Chapter 3: Worker Processes and Connection Handling

  1. The Master-Worker Process Model
  2. Worker Process Count and CPU Affinity
  3. The Event Loop: Epoll, Kqueue, and Event Ports
  4. Connection Lifecycle States
  5. Keepalive Connections and Tuning
  6. File Descriptor Limits and System Configuration

Chapter 4: Web Serving and Virtual Hosts

  1. Server Blocks and Virtual Hosts
  2. The Location Directive: NGINX’s Routing Engine
  3. Serving Static Content Efficiently
  4. Error Pages and Response Handling
  5. Request Limits and Resource Protection
  6. Compression: gzip, Brotli, and zstd

Chapter 5: Reverse Proxying and Upstream Configuration

  1. The Reverse Proxy Model: Why and How
  2. Upstream Groups: Structure and Directives
  3. Load Balancing Algorithms
  4. Health Checks: Passive and Active
  5. Proxy Buffering and Connection Management
  6. Timeouts and Retries

Chapter 6: Load Balancing Patterns and Advanced Traffic Management

  1. Production Load Balancing Topologies
  2. Traffic Splitting and Canary Deployments
  3. Session Persistence Strategies
  4. Geographic and Data Center Routing
  5. Rate Limiting and Request Throttling
  6. Connection Limits and Resource Protection

Chapter 7: Caching Architecture and Implementation

  1. Caching Fundamentals: When and Why to Cache
  2. Proxy Cache Configuration
  3. Cache Keys and Granularity
  4. Cache Bypass, Stale Serving, and Upstream Interaction
  5. Cache Purging and Management
  6. Memory vs Disk Caching Tradeoffs

Chapter 8: TLS, SSL, and Transport Security

  1. TLS Termination: Architecture and Rationale
  2. Certificate Configuration and Management
  3. Protocol Versions and Cipher Suites
  4. Session Resumption and Performance
  5. OCSP Stapling and Certificate Validation
  6. Advanced TLS: HSTS, MTLS, and Security Headers

Chapter 9: HTTP/2, HTTP/3, and QUIC

  1. HTTP/2: Multiplexing and Performance
  2. HTTP/2 Configuration and Tuning
  3. HTTP/3 and QUIC: The Next Generation
  4. Protocol Negotiation and Fallback

Chapter 10: Authentication, Authorization, and Access Control

  1. Basic and Digest Authentication
  2. IP-Based Access Control
  3. OAuth and OpenID Connect Integration Patterns
  4. External Authentication via Subrequests
  5. JWT Validation and API Security
  6. Role-Based Access Control Patterns

Chapter 11: Request Rewriting, Redirects, and URL Manipulation

  1. The Rewrite Directive: Syntax and Behavior
  2. Internal Redirects vs Client Redirects
  3. The Return Directive: Simpler Alternatives
  4. Argument Manipulation and Query String Control
  5. Migrating from Apache .htaccess Rules
  6. SEO-Friendly Redirects and Canonicalization

Chapter 12: Application Integration: FastCGI, uWSGI, SCGI, and gRPC

  1. FastCGI: PHP and Beyond
  2. uWSGI Protocol: Python and Ruby Applications
  3. SCGI: A Simpler Alternative
  4. gRPC Proxying: Modern Microservices
  5. Application Protocol Selection Guidance

Chapter 13: WebSocket and Long-Lived Connection Proxying

  1. WebSocket Protocol and Upgrade Mechanism
  2. Configuring WebSocket Proxying
  3. Long-Polling and Server-Sent Events
  4. Scaling WebSocket Connections
  5. Security Considerations for Persistent Connections

Chapter 14: Logging, Monitoring, and Observability

  1. Access and Error Log Configuration
  2. Custom Log Formats
  3. The stub_status Module and Basic Metrics
  4. NGINX Plus API and Advanced Monitoring
  5. Integration with Observability Stacks
  6. Debug Logging and Troubleshooting

Chapter 15: Stream Proxying, Mail Proxy, and TCP/UDP Handling

  1. The Stream Module: TCP/UDP Load Balancing
  2. TLS Termination for TCP Streams
  3. UDP Proxying and DNS Load Balancing
  4. The Mail Module: SMTP, IMAP, and POP3 Proxying
  5. Database Connection Proxying Patterns

Chapter 16: Performance Tuning and Kernel Optimization

  1. Worker Process and Event Loop Tuning
  2. Buffer Sizing Strategy
  3. Kernel Parameter Optimization
  4. Filesystem and I/O Optimization
  5. Connection and Timeout Tuning
  6. Load Testing Methodology

Chapter 17: Security Hardening and Defense in Depth

  1. Configuration Hardening Checklist
  2. Mitigating Common Web Attacks
  3. Security Headers Configuration
  4. Vulnerability Management and Patching
  5. Securing the NGINX Process Itself
  6. WAF Integration and Request Filtering

Chapter 18: Containerized Deployments and Kubernetes Ingress

  1. Docker Deployment Patterns
  2. Kubernetes Ingress Fundamentals
  3. NGINX Ingress Controller Configuration
  4. Advanced Kubernetes Patterns
  5. Service Mesh Integration
  6. GitOps and Declarative Management

Chapter 19: High Availability, Automation, and Production Operations

  1. High Availability Architectures
  2. Zero-Downtime Configuration Changes
  3. Dynamic Reconfiguration (NGINX Plus)
  4. Configuration Management and Automation
  5. CI/CD Integration for NGINX Configurations
  6. Operational Runbooks and Troubleshooting Flows

Chapter 20: Troubleshooting, Debugging, and Common Pitfalls

  1. Reading and Interpreting Error Logs
  2. Connection and Timeout Troubleshooting
  3. Upstream and Backend Issues
  4. TLS and SSL Troubleshooting
  5. Performance Degradation Diagnosis
  6. Common Configuration Pitfalls and Anti-Patterns

Chapter 21: NGINX Ecosystem Comparison and Technology Selection

  1. NGINX vs Apache: Architecture and Philosophy
  2. NGINX vs HAProxy: The Load Balancer Debate
  3. NGINX vs Envoy: Cloud-Native and Service Mesh
  4. NGINX vs Caddy and Traefik: Modern Alternatives
  5. Technology Selection Framework

Chapter 22: Migration Strategies and Modernization Patterns

  1. Migrating from Apache to NGINX
  2. Upgrading NGINX Versions Safely
  3. Modernizing Legacy NGINX Configurations
  4. Evolving from Open Source to NGINX Plus
  5. Decommissioning and Replacement Patterns

Conclusion: The NGINX Mastery Journey

References

  1. RFCs and Standards
  2. Official NGINX Documentation
  3. F5 NGINX Documentation
  4. NGINX Community Blog Articles
  5. Third-Party Resources and Tools
  6. Historical and Background Sources
  7. Performance and Comparison Sources

Get the free sample chapters

Click the buttons to get the free sample in PDF or EPUB, or read the sample online here

Download Sample PDFDownload Sample EPUB

The Leanpub 60 Day 100% Happiness Guarantee

Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.

See full terms...

Earn $8 on a $10 Purchase, and $16 on a $20 Purchase

We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.

(Yes, some authors have already earned much more than that on Leanpub.)

In fact, authors have earned over $15 million writing, publishing and selling on Leanpub.

Learn more about writing on Leanpub

Free Updates. DRM Free.

If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).

Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.

Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.

Learn more about Leanpub's ebook formats and where to read them

Write and Publish on Leanpub

You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!

Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.

Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.

Learn more about writing on Leanpub