Page cover image

Configurando a Nginx

Podemos agora configurar a Nginx para prover páginas web estáticas e dinâmicas bem como web services (API). Para isso vamos inicialmente criando um diretório que por padrão vamos chamar de includes. Podemos fazer isso usando o comando:

sudo mkdir /etc/nginx/includes

Neste diretório iremos armazenar diversos arquivos .conf um para cada aplicação que iremos servir sendo através do proxy reverso ou não. Ao final do processo teremos a seguinte arvore de diretórios:

/etc/nginx/
├── nginx.conf             # Arquivo de configuração principal do Nginx
├── mime.types             # Define tipos de mídia (MIME types) manipulados pelo Nginx
├── includes               # Diretório para armazenar as configurações de roteamento das aplicações
├── conf.d/                # Diretório para arquivos de configuração de sites específicos
   └── *.conf             # Arquivos de configuração que são automaticamente incluídos no nginx.conf
├── sites-available/       # Armazena as configurações de todos os sites (não necessariamente ativos)
   └── default            # Exemplo de arquivo de configuração para um site específico
├── sites-enabled/         # Contém links simbólicos para os sites ativamente servidos pelo Nginx
   └── default.           # Link simbólico para a configuração em sites-available
├── snippets/              # Pequenos fragmentos de configuração que podem ser incluídos em outros arquivos
└── modules-available/     # Diretório para módulos dinâmicos disponíveis (dependendo da instalação)
    └── *.conf             # Arquivos de configuração dos módulos

Podemos agora configurar um servidor HTTP editando o arquivo default dentro do diretório sites-available adicionando referencias aos arquivos de configuração na pasta includes.

##
# You should look at the following URL's in order to grasp a solid understanding
# of Nginx configuration files in order to fully unleash the power of Nginx.
# <https://www.nginx.com/resources/wiki/start/>
# <https://www.nginx.com/resources/wiki/start/topics/tutorials/config_pitfalls/>
# <https://wiki.debian.org/Nginx/DirectoryStructure>
#
# In most cases, administrators will remove this file from sites-enabled/ and
# leave it as reference inside of sites-available where it will continue to be
# updated by the nginx packaging team.
#
# This file will automatically load configuration files provided by other
# applications, such as Drupal or Wordpress. These applications will be made
# available underneath a path with that package name, such as /drupal8.
#
# Please see /usr/share/doc/nginx-doc/examples/ for more detailed examples.
##

# Default server configuration
#
server {
	listen 80 default_server;
	listen [::]:80 default_server;

	# SSL configuration
	#
	# listen 443 ssl default_server;
	# listen [::]:443 ssl default_server;
	#
	# Note: You should disable gzip for SSL traffic.
	# See: <https://bugs.debian.org/773332>
	#
	# Read up on ssl_ciphers to ensure a secure configuration.
	# See: <https://bugs.debian.org/765782>
	#
	# Self signed certs generated by the ssl-cert package
	# Don't use them in a production server!
	#
	# include snippets/snakeoil.conf;

	root /var/www/html;

	# Add index.php to the list if you are using PHP
	index index.html index.htm index.nginx-debian.html;

	server_name _;

	# includes:
	include /etc/nginx/includes/*.conf

	#location / {
		# First attempt to serve request as file, then
		# as directory, then fall back to displaying a 404.
		#try_files $uri $uri/ =404;

#	}

	# pass PHP scripts to FastCGI server
	#
	#location ~ \\.php$ {
	#	include snippets/fastcgi-php.conf;
	#
	#	# With php-fpm (or other unix sockets):
	#	fastcgi_pass unix:/run/php/php7.4-fpm.sock;
	#	# With php-cgi (or other tcp sockets):
	#	fastcgi_pass 127.0.0.1:9000;
	#}

	# deny access to .htaccess files, if Apache's document root
	# concurs with nginx's one
	#
	#location ~ /\\.ht {
	#	deny all;
	#}
}

# Virtual Host configuration for example.com
#
# You can move that to a different file under sites-available/ and symlink that
# to sites-enabled/ to enable it.
#
#server {
#	listen 80;
#	listen [::]:80;
#
#	server_name example.com;
#
#	root /var/www/example.com;
#	index index.html;
#
#	location / {
#		try_files $uri $uri/ =404;
#	}
#}
  • listen 80 default_server; listen [::]:80 default_server;: Essas linhas configuram o Nginx para ouvir na porta 80, tanto para IPv4 quanto para IPv6, e definem este servidor como o servidor padrão para solicitações que não correspondam a outro servidor específico.

  • root /var/www/html;: Define o diretório raiz para os arquivos do site. É onde o Nginx procurará os arquivos para servir como resposta a solicitações HTTP. Esta linha pode ser comentada e alterada de acordo com a necessidade de sua homepage.

  • index index.html index.htm index.nginx-debian.html;: Especifica os arquivos que o Nginx deve procurar dentro do diretório raiz quando um diretório é solicitado. Se esses arquivos existirem, um deles será servido como a página inicial.

  • server_name _;: O underscore é usado aqui como um caractere curinga, significando que este servidor atenderá a todas as solicitações de host que não correspondam a outro server_name. Também é possível ter um server_name especifico de seu domínio como por exemplo mackleaps.mackenzie.br.

  • include /etc/nginx/includes/*.conf: Inclui todas as configurações adicionais localizadas no diretório /etc/nginx/includes. Esta diretiva permite modularizar a configuração incluindo fragmentos de configuração armazenados separadamente.

    Vamos agora modificar o nginx.conf no diretório /etc/nginx.Caso você possua certificados SSL para HTTPS '’e nesse arquivo que os mesmos devem ser configurados.

user www-data;
worker_processes auto;
pid /run/nginx.pid;
include /etc/nginx/modules-enabled/*.conf;

events {
	worker_connections 768;
	# multi_accept on;
}

http {

	##
	# Basic Settings
	##

	sendfile on;
	tcp_nopush on;
	types_hash_max_size 2048;
	server_tokens off;

	# server_names_hash_bucket_size 64;
	server_name_in_redirect off;

	include /etc/nginx/mime.types;
	default_type application/octet-stream;

	##
	# SSL Settings
	##

	ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3; # Dropping SSLv3, ref: POODLE
	ssl_prefer_server_ciphers on;

	##
	# Logging Settings
	##

	access_log /var/log/nginx/access.log;
	error_log /var/log/nginx/error.log;

	##
	# Gzip Settings
	##

	gzip on;

	# gzip_vary on;
	# gzip_proxied any;
	# gzip_comp_level 6;
	# gzip_buffers 16 8k;
	# gzip_http_version 1.1;
	# gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;

	##
	# Virtual Host Configs
	##

	include /etc/nginx/conf.d/*.conf;
	include /etc/nginx/sites-enabled/*;
}

#mail {
#	# See sample authentication script at:
#	# <http://wiki.nginx.org/ImapAuthenticateWithApachePhpScript>
#
#	# auth_http localhost/auth.php;
#	# pop3_capabilities "TOP" "USER";
#	# imap_capabilities "IMAP4rev1" "UIDPLUS";
#
#	server {
#		listen     localhost:110;
#		protocol   pop3;
#		proxy      on;
#	}
#
#	server {
#		listen     localhost:143;
#		protocol   imap;
#		proxy      on;
#	}
#}

Configuração Global

  • user www-data;: Define o usuário (e grupo, se não especificado) sob o qual o Nginx será executado. www-data é comumente usado para serviços web em sistemas Unix/Linux.

  • worker_processes auto;: Determina o número de processos de trabalho do Nginx. auto permite que o Nginx escolha o melhor número com base no número de núcleos de CPU disponíveis.

  • pid /run/nginx.pid;: Especifica o arquivo que armazenará o ID do processo do Nginx.

  • include /etc/nginx/modules-enabled/*.conf;: Inclui configurações de módulos que foram habilitados, permitindo a extensão de funcionalidades.

Bloco events

  • worker_connections 768;: Define o número máximo de conexões que cada processo de trabalho pode abrir. É um parâmetro crucial para dimensionar o desempenho do Nginx.

Configurações HTTP

Esta seção engloba várias diretivas aplicadas ao processamento de solicitações HTTP:

  • sendfile on;: Ativa o uso da operação sendfile para transferir arquivos mais eficientemente.

  • tcp_nopush on;: Habilita o tcp_nopush para enviar o cabeçalho HTTP em um único pacote de rede.

  • server_tokens off;: Desativa a emissão da versão do Nginx nas respostas, aumentando a segurança.

  • ssl_protocols TLSv1 TLSv1.1 TLSv1.2 TLSv1.3;: Especifica os protocolos SSL/TLS permitidos, excluindo SSLv3 devido a vulnerabilidades como o POODLE.

Configurações de Log

  • access_log /var/log/nginx/access.log;: Define o arquivo de log de acesso.

  • error_log /var/log/nginx/error.log;: Especifica o arquivo de log de erro.

Configurações Gzip

  • gzip on;: Habilita a compressão gzip para tipos de conteúdo especificados, o que pode reduzir significativamente o tamanho das respostas HTTP.

Inclusões de Configuração de Host Virtual

  • include /etc/nginx/conf.d/*.conf; e include /etc/nginx/sites-enabled/*;: Incluem arquivos de configuração adicionais, permitindo a definição de configurações específicas de host virtual armazenadas nos diretórios conf.d e sites-enabled, respectivamente.

Comentários de Configuração de Email

A seção comentada ao final do arquivo mostra um exemplo de como configurar o Nginx para servir como um proxy para serviços de e-mail POP3 e IMAP. Embora esteja comentada e, portanto, não ativa, ela ilustra a versatilidade do Nginx em lidar com diferentes tipos de tráfego de rede além do HTTP.

Este arquivo de configuração exemplifica uma configuração básica do Nginx, enfatizando segurança, eficiência e flexibilidade, com opções para expansão conforme as necessidades do servidor ou da aplicação evoluem.

Last updated