Installing Nginx:
Nginx is available in the official package repository of CentOS 8. So, it’s very easy to install.
First, update the DNF package repository cache as follows:
Now, install Nginx with the following command:
To confirm the installation, press Y and then press <Enter>.
Nginx should be installed.
Managing the nginx Service:
By default, nginx service should be inactive (not running) and disabled (won’t automatically start on boot).
You can start the nginx service as follows:
nginx service should be running.
Now, add nginx service to the system startup as follows:
Configuring the Firewall:
You must configure the firewall to allow access to the HTTP port 80 and HTTPS port 443 in order to access the Nginx web server from other computers on the network.
You can allow access to the HTTP and HTTPS port with the following command:
Now, for the changes to take effect, run the following command:
Testing the Web Server:
You must know the IP address or domain name of the Nginx web server in order to access it.
You can find the IP address of your Nginx web server with the following command:
In my case, the IP address is 192.168.20.175. It will be different for you. So, make sure to replace it with yours from now on.
Now, visit http://192.168.20.175 from your web browser. You should see the following page. It means Nginx web server is working.
Configuration Files of nginx:
Nginx web server configuration files are in the /etc/nginx/ directory.
/etc/nginx/nginx.conf is the main Nginx configuration file.
The default web root directory of Nginx web server is /usr/share/nginx/html/. So, this is where you should keep your website files.
Setting up a Basic Web Server:
In this section, I am going to show you how to set up a basic Nginx web server.
First, take a backup of original Nginx configuration file with the following command:
Now, create a new Nginx configuration file as follows:
Now, type in the following lines in the /etc/nginx/nginx.conf file and save the file.
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;
events {
worker_connections 1024;
}
http {
include /etc/nginx/mime.types;
default_type application/octet-stream;
server {
listen 80;
server_name example.com www.example.com;
root /usr/share/nginx/html;
index index.html;
access_log /var/log/nginx/access.log;
}
}
Here, user option is used to set the Nginx run user and group to nginx respectively.
The error_log option is used to set the error log file path to /var/log/nginx/error.log. This is where errors related to the Nginx server will be stored.
The main Nginx server configuration is defined in the server section inside the http section. You can define more than one server section inside the http section if needed.
In the server section,
listen option is used to configure Nginx to listen to port 80 (HTTP port) for web requests.
server_name option is used to set one or more domain names for the Nginx web server. If your DNS settings are correct, you can access Nginx web server using these domain names.
access_log is used to set the access log file path to /var/log/nginx/access.log. When someone tries to access the Nginx web server, the access information (i.e. IP address, URL, HTTP status code) will be logged to this file.
The location option is used to set the root directory of the Nginx web server.
Here, the root directory is /usr/share/nginx/html/.
This is where all the website files should be kept. The index option sets index.html as the default file to serve if no specific file is requested. For example, if you visit https://ift.tt/2wcKrPL , then you Nginx will return myfile.html file. But, if you visit http://192.168.20.175/, then Nginx will send you index.html file as no specific file was requested.
Now, remove all the files from the /usr/share/nginx/html/ directory (web root) as follows:
Now, create a new index.html file in the /usr/share/nginx/html/ directory as follows:
Now, type in the following lines in index.html file and save the file.
Now, restart nginx service as follows:
Now, visit http://192.168.20.175 from your web browser and you should see the following page. Congrats! You’ve set up your first Nginx web server.
Configuring Error Pages:
You can configure error pages in Nginx. For example, if a page/file/directory is not available, HTTP status code 404 will be returned to the browser. You can set a custom HTML error page for the HTTP status code 404 which will be returned to the browser.
To do that, add the following line in the server section of nginx.conf file.
Now, create a file 404.html in the Nginx web root /usr/share/nginx/html/ as follows:
Now, type in the following lines in 404.html and save the file.
Now, restart nginx service as follows:
Now, try to access a non-existent path (https://ift.tt/2V6Pmu6) and you should see the following error page.
If the 404.html file is in a different filesystem path (let’s say /usr/share/nginx/html/errors/ directory), you can map the URL /404.html to it as follows:
Now, make a new directory /usr/share/nginx/html/errors/ as follows:
Now, create a new file 404.html in the directory /usr/share/nginx/html/errors/ as follows:
Now, type in the following lines in the 404.html file and save the file.
Now, restart nginx service as follows:
Now, try to access a non-existent path (https://ift.tt/2V6Pmu6) and you should see the updated error page.
The same way, you can set error page for other HTTP status codes.
You can also set the same error page for multiple HTTP status codes. For example, to set the same error page /404.html for the HTTP status codes 403 and 404, write the error_page option as follows:
Configuring Logs:
In Nginx, the error_log and access_log options are used for logging error messages and access information.
The format of the error_log and access_log options are:
access_log /path/to/access/log/file [optional:custom-log-name];
You can define your own error log and access log formats if you want.
To do that, use the log_format option in the http section to define your custom log format as follows.
…
log_format simple '[$time_iso8601] $request_method $request_uri '
'[$status] ($request_time) -> $bytes_sent bytes';
…
server {
…
access_log /var/log/nginx/access.log simple;
…
}
}
Here, the log format name is simple. Some nginx variables are used to define the custom log format. Visit the Nginx Embedded Variables Manual to learn about all the Nginx variables.
The custom log format should be enclosed in single quotes. The log format can be defined in a single line or in a multiple lines. I’ve shown how to define the log format in multiple lines in this article. You won’t have any trouble with single line log format, trust me!
Once the log format simple is defined, access_log option is used to tell Nginx to use it as access log.
The same way, you can set a custom error log format using the error_log option.
I’ve only configured custom log format for the access log in this article.
Now, restart nginx service as follows:
Now, you can monitor the access log file as follows:
You can also monitor the error log file as follows:
If you want, you can monitor the access log and error log files at the same time as follows:
As you can see, the new access log format is being used.
Denying Access to Certain Paths:
You can use regular expressions to match certain URI paths and deny access to it in Nginx.
Let’s say, your website is managed by Git, and you want to deny access to the .git/ directory on your web root.
To do that, type in the following lines in the server section of /etc/nging/nginx.conf file:
As you can see, access to any path that contains .git is denied.
Configuring Compression:
You can compress web contents before sending them to the browser using gzip to save bandwidth usage of the Nginx web server.
I have some JPEG images in the /usr/share/nginx/html/images/ directory.
I can access these images using the URI path /images.
To enable gzip compression for only the JPEG images in the URI path /images, type in the following lines in the server section of /etc/nginx/nginx.conf file.
…
location /images {
gzip on;
gzip_comp_level 9;
gzip_min_length 100000;
gzip_types image/jpeg;
}
…
}
Here, gzip_comp_level is used to set the compression level. It can be any number from 1 to 9. The higher the level, the smaller the compressed file will be.
The file will only be compressed if the size of the file is above gzip_min_length. I’ve set it to about 100 KB in this example. So, JPEG files smaller than 100 KB won’t be gzip compressed.
The gzip_types is used to set the mime type of the files that will be compressed.
You can find mime type from file extensions as follows:
As you can see, for .jpg or .jpeg file extension, the mime type is image/jpeg.
You can set one or more mime types using gzip_types option.
If you want to set multiple mime types, then make sure to separate them with spaces as follows:
gzip_types image/jpeg image/png image/gif;
Now, restart nginx service as follows:
As you can see, Nginx sends gzip compressed image files to the browser when requested.
As you can see in the screenshot below, the gzip compressed file is smaller than the original file.
Enabling HTTPS:
You can enable SSL in Nginx very easily. In this section, I am going to show you how to set self-signed SSL certificate in Nginx.
First, navigate to the /etc/ssl/ directory as follows:
Now, generate an SSL key server.key and certificate server.crt with the following command:
server.key -out server.crt
NOTE: You must have openssl installed for this to work. If openssl command is unavailable, install openssl with the following command:
Now, type in your 2-letter country code (i.e. US for USA, UK for United Kingdom, RU for Russia, CN for China) and press <Enter>.
Now, type in your State/Province name and press <Enter>.
Now, type in your City name and press <Enter>.
Now, type in your Company name and press <Enter>.
Now, type in the organizational unit name of your company which will use this certificate and press <Enter>.
Now, type in the fully qualified domain name (FQDN) of your Nginx web server and press <Enter>. The SSL certificate will be valid only if the Nginx web server is accessed using this domain name.
Now, type in your email address and press <Enter>.
Your SSL certificate should be ready.
The SSL certificate and key should be generated in the /etc/ssl/ directory.
Now, open the Nginx configuration file /etc/nginx/nginx.conf and change listen port to 443 and type in the following lines in the server section.
…
ssl on;
ssl_certificate /etc/ssl/server.crt;
ssl_certificate_key /etc/ssl/server.key;
…
}
Now, restart nginx service as follows:
In real life, you will have correct DNS setup. But for testing purpose, I’ve configured local file-based domain name on the computer I’ve used to access the Nginx web server from.
If you want to follow along, open the /etc/hosts file as follows:
Then, add the following line to the /etc/hosts file.
Now, try to visit https://www.example.com and you should see the following page. You will see Your connect is not secure message because it is a self-signed certificate. This is good for testing purpose only.
In real life, you will be buying SSL certificates from Certificate Authorities (CAs) and use them. So, you won’t see this type of message.
As you can see, Nginx served the web page over HTTPS. So, SSL is working.
The SSL information of www.example.com.
Redirecting HTTP Requests to HTTPS:
If someone visits your website over HTTP protocol (http://www.example.com or http://192.168.20.175) instead of HTTPS (https://www.example.com), you don’t want to reject the HTTP request. If you do that, you will lose a visitor. What you really should do is redirect the user to the SSL enabled site. It is really simple to do.
First, open the Nginx configuration file /etc/nginx/nginx.conf and create a new server section inside the http section as follows:
…
server {
listen 80;
server_name www.example.com;
return 301 https://www.example.com$request_uri;
}
…
}
This is the final /etc/nginx/nginx.conf file:
worker_processes auto;
error_log /var/log/nginx/error.log;
pid /run/nginx.pid;
events {
worker_connections 1024;
}
http {
include /etc/nginx/mime.types;
default_type application/octet-stream;
log_format simple '[$time_iso8601] $request_method $request_uri '
'[$status] ($request_time) -> $bytes_sent bytes';
server {
listen 80;
server_name www.example.com;
return 301 https://www.example.com$request_uri;
}
server {
listen 443;
server_name www.example.com;
ssl on;
ssl_certificate /etc/ssl/server.crt;
ssl_certificate_key /etc/ssl/server.key;
access_log /var/log/nginx/access.log simple;
location / {
root /usr/share/nginx/html;
index index.html;
}
location /images {
gzip on;
gzip_comp_level 9;
gzip_min_length 100000;
gzip_types image/jpeg;
}
error_page 404 /404.html;
location /404.html {
root /usr/share/nginx/html/errors;
}
location ~ \.git {
deny all;
}
}
}
Now, restart nginx service as follows:
Now, if you try to access http://192.168.20.175 or http://www.example.com, you will be redirected to https://www.example.com.
So, that’s how you install and configure Nginx web server on CentOS 8. Thanks for reading this article.
from Linux Hint https://ift.tt/2V2AIDU
0 Comments