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 outroserver_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
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çãosendfile
para transferir arquivos mais eficientemente.tcp_nopush on;
: Habilita otcp_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;
einclude /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óriosconf.d
esites-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