Mastering Nginx: A Complete Guide to Configuration Files

Nginx Configuration File Introduction

After learning what Nginx is, how to compile and install it, and how to uninstall it completely, we now focus on the Nginx service configuration file.

We will examine the main configuration file nginx.conf located at /usr/local/nginx/conf/nginx.conf, which is the core of Nginx configuration.

Removing comments (lines starting with #) reveals the overall structure of nginx.conf, which can be divided into three parts: the global block, the events block, and the HTTP block.

1. Global Block

The global block appears from the start of the file up to the events block. It sets directives that affect the entire Nginx server, such as the user and group under which Nginx runs, the number of worker processes, PID file location, error log settings, and file descriptor limits.

user nginx; worker_processes 8; # usually set to the number of CPU cores error_log /var/log/nginx/error.log info; pid /var/run/nginx.pid; worker_rlimit_nofile 65535;

2. Events Block

events { use epoll; # high‑performance I/O model on Linux worker_connections 65535; # max connections per worker }

3. HTTP Block

The HTTP block contains the majority of server configuration, including MIME types, default content type, buffer sizes, file handling, and keep‑alive settings.

http { include mime.types; # load supported media types default_type application/octet-stream; server_names_hash_bucket_size 128; client_header_buffer_size 32k; sendfile on; # enable zero‑copy file transfer autoindex off; # disable directory listing keepalive_timeout 120; }

4. Server Block (Virtual Host)

The server block defines a virtual host, specifying the listening port, server name, document root, index files, and error handling.

server { listen 80; # listen on port 80 server_name www.lulu.com; # domain name location / { root html; # site root directory index index.html index.htm; } error_page 500 502 503 504 /50x.html; location = /50x.html { root html; } }

These sections together form a complete Nginx configuration, allowing you to customize global settings, connection handling, HTTP behavior, and virtual host definitions.