HowtoForge

Tutoriales de Linux

Cómo construir NGINX desde el código fuente en Ubuntu 18.04 LTS

NGINX (pronunciado«motor x») es un software de servidor web de código abierto diseñado pensando en la alta concurrencia, que puede utilizarse como servidor HTTP/HTTPS, servidor proxy inverso, servidor proxy de correo, equilibrador de carga de software, terminador TLS, servidor de caché…

Es un software extremadamente modular. Incluso algunas de las piezas aparentemente «integradas» en el software, como GZIP o SSL, se construyen en realidad como módulos que pueden activarse y desactivarse durante la construcción.

Tiene módulos centrales (nativos ) y módulos de terceros (externos)creados por la comunidad. Ahora mismo, hay más de cien módulos de terceros que podemos utilizar.

Escrito en lenguaje C , es un software muy rápido y ligero.

Instalar NGINX desde el código fuente es relativamente «fácil»: descarga la última versión del código fuente de NGINX, configúralo, constrúyelo e instálalo.

Tendrás que elegir si quieres descargar la versiónmainline o la estable , pero construirlas es exactamente lo mismo.

En este tutorial, construiremos NGINX con todos los módulos disponibles en la versión de código abierto de NGINX y utilizaremos la versiónmainline que está en la 1.15. 0 en el momento de escribir este artículo. Actualiza los números de versión cuando haya versiones más nuevas disponibles.

Versión estable vs. versión mainline

NGINX Open Source está disponible en dos versiones:

  • Mainline – Incluye las últimas funciones y correcciones de errores y está siempre actualizada. Es fiable, pero puede incluir algunos módulos experimentales, y también puede tener algún número de errores nuevos.
  • Estable – No incluye todas las funciones más recientes, pero tiene correcciones de errores críticos que siempre se retroalimentan a la versión mainline.

Módulos principales vs. módulos de terceros

NGINX tiene dos tipos de módulos que puedes utilizar: módulos centrales y módulos de terceros.

Los módulos principales son creados por los desarrolladores del núcleo de NGINX y forman parte del propio software.

Los módulos de terceros son construidos por la comunidad y puedes utilizarlos para ampliar la funcionalidad de NGINX. Hay muchos módulos de terceros útiles, los más famosos son PageSpeed, ModSecurity, RTMP, Lua, etc.

Módulos estáticos vs. módulos dinámicos

Los módulos estáticos existen en NGINX desde la primera versión. Los módulos dinámicos se introdujeron con NGINX 1.9.11+ en febrero de 2016.

Con los módulos estáticos, el conjunto de módulos que constituyen un binario de NGINX es fijado en tiempo de compilación por el script ./configure . Los módulos estáticos utilizan la sintaxis --with-foo_bar_module o --add-module=PATH.

Para compilar el módulo principal (estándar) como dinámico añadimos =dynamic, por ejemplo --with-http_image_filter_module=dynamic.

Para compilar módulos de terceros como dinámicos utilizamos la sintaxis--add-dynamic-module=/path/to/module y luego los cargamos utilizando la directivaload_module en el contexto global del archivonginx.conf.

Requisitos para construir NGINX desde el código fuente

En comparación con otros programas de UNIX/Linux, NGINX es bastante ligero y no tiene muchas dependencias de bibliotecas. La configuración de compilación por defecto sólo depende de la instalación de 3 bibliotecas: OpenSSL/LibreSSL/BoringSSL, Zlib y PCRE.

NOTA: NGINX también puede compilarse con LibreSSL y BoringSSLen lugar de las bibliotecas criptográficasOpenSSL.

Requisitos

  • Un servidor con Ubuntu 18.04 LTS.
  • Un usuario no root con privilegios sudo.

Pasos iniciales

Comprueba la versión de Ubuntu:

lsb_release -ds 
# Ubuntu 18.04 LTS

Configura la zona horaria:

timedatectl list-timezones
sudo timedatectl set-timezone 'Region/City'

Actualiza los paquetes de tu sistema operativo:

sudo apt update && sudo apt upgrade -y

Construye NGINX desde el código fuente

NGINX es un programa escrito en Cpor lo que primero tendrás que instalar un compilador de herramientas. Instal a build-essential, gitytreepaquetes:

sudo apt install -y build-essential git tree

Descarga la última versión mainline del código fuente de NGINX y extráelo. El código fuente de NGINX se distribuye como un archivo comprimido (tarball gzipped), como la mayoría del software de Unix y Linux:

wget https://nginx.org/download/nginx-1.15.0.tar.gz && tar zxvf nginx-1.15.0.tar.gz

Descarga el código fuente de las dependencias obligatorias de NGINX y extráelas:

# PCRE version 8.42
wget https://ftp.pcre.org/pub/pcre/pcre-8.42.tar.gz && tar xzvf pcre-8.42.tar.gz

# zlib version 1.2.11
wget https://www.zlib.net/zlib-1.2.11.tar.gz && tar xzvf zlib-1.2.11.tar.gz

# OpenSSL version 1.1.0h
wget https://www.openssl.org/source/openssl-1.1.0h.tar.gz && tar xzvf openssl-1.1.0h.tar.gz

Instala las dependencias opcionales de NGINX:

sudo add-apt-repository -y ppa:maxmind/ppa
sudo apt update && sudo apt upgrade -y 
sudo apt install -y perl libperl-dev libgd3 libgd-dev libgeoip1 libgeoip-dev geoip-bin libxml2 libxml2-dev libxslt1.1 libxslt1-dev

Limpia todos los .tar.gzarchivos. Ya no los necesitamos:

rm -rf *.tar.gz

Entra en el directorio fuente de NGINX:

cd ~/nginx-1.15.0

Por si acaso, enumera los directorios y archivos que componen el código fuente de NGINX con treeutilidad:

tree -L 2 .

Copia la página del manual de NGINX en /usr/share/man/man8/directorio:

sudo cp ~/nginx-1.15.0/man/nginx.8 /usr/share/man/man8
sudo gzip /usr/share/man/man8/nginx.8
ls /usr/share/man/man8/ | grep nginx.8.gz
# Check that Man page for NGINX is working:
man nginx

Página de manual de Nginx

Para obtener ayuda, puedes ver la lista completa de opciones actualizadas en tiempo de compilación de NGINX ejecutando:

./configure --help
# To see want core modules can be build as dynamic run:
./configure --help | grep -F =dynamic

Configurar, compilar e instalar NGINX:

./configure --prefix=/etc/nginx \ 
            --sbin-path=/usr/sbin/nginx \ 
            --modules-path=/usr/lib/nginx/modules \ 
            --conf-path=/etc/nginx/nginx.conf \
            --error-log-path=/var/log/nginx/error.log \
            --pid-path=/var/run/nginx.pid \
            --lock-path=/var/run/nginx.lock \
            --user=nginx \
            --group=nginx \
            --build=Ubuntu \
            --builddir=nginx-1.15.0 \
            --with-select_module \
            --with-poll_module \
            --with-threads \
            --with-file-aio \
            --with-http_ssl_module \
            --with-http_v2_module \
            --with-http_realip_module \
            --with-http_addition_module \
            --with-http_xslt_module=dynamic \
            --with-http_image_filter_module=dynamic \
            --with-http_geoip_module=dynamic \
            --with-http_sub_module \
            --with-http_dav_module \
            --with-http_flv_module \
            --with-http_mp4_module \
            --with-http_gunzip_module \
            --with-http_gzip_static_module \
            --with-http_auth_request_module \
            --with-http_random_index_module \
            --with-http_secure_link_module \
            --with-http_degradation_module \
            --with-http_slice_module \
            --with-http_stub_status_module \
            --with-http_perl_module=dynamic \
            --with-perl_modules_path=/usr/share/perl/5.26.1 \
            --with-perl=/usr/bin/perl \
            --http-log-path=/var/log/nginx/access.log \
            --http-client-body-temp-path=/var/cache/nginx/client_temp \
            --http-proxy-temp-path=/var/cache/nginx/proxy_temp \
            --http-fastcgi-temp-path=/var/cache/nginx/fastcgi_temp \
            --http-uwsgi-temp-path=/var/cache/nginx/uwsgi_temp \
            --http-scgi-temp-path=/var/cache/nginx/scgi_temp \
            --with-mail=dynamic \
            --with-mail_ssl_module \
            --with-stream=dynamic \
            --with-stream_ssl_module \
            --with-stream_realip_module \
            --with-stream_geoip_module=dynamic \
            --with-stream_ssl_preread_module \
            --with-compat \
            --with-pcre=../pcre-8.42 \
            --with-pcre-jit \
            --with-zlib=../zlib-1.2.11 \
            --with-openssl=../openssl-1.1.0h \
            --with-openssl-opt=no-nextprotoneg \
            --with-debug


make
sudo make install

Después de construir NGINX, navega al directorio home (~):

cd ~

Symlin k /usr/lib/nginx/modules a /etc/nginx/modulesdirectorio. etc/nginx/moduleses un lugar estándar para los módulos de NGINX:

sudo ln -s /usr/lib/nginx/modules /etc/nginx/modules

Imprime la versión de NGINX, la versión del compilador y los parámetros del script de configuración:

sudo nginx -V
# nginx version: nginx/1.15.0 (Ubuntu)
# built by gcc 7.3.0 (Ubuntu 7.3.0-16ubuntu3)
# built with OpenSSL 1.1.0h  27 Mar 2018
# TLS SNI support enabled
# configure arguments: --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib/nginx/modules
# . . .
# . . .

Crea el grupo y el usuario del sistema NGINX:

sudo adduser --system --home /nonexistent --shell /bin/false --no-create-home --disabled-login --disabled-password --gecos "nginx user" --group nginx

Comprueba la sintaxis de NGINX y los posibles errores:

sudo nginx -t
# Will throw this error -> nginx: [emerg] mkdir() "/var/cache/nginx/client_temp" failed (2: No such file or directory)

# Create NGINX cache directories and set proper permissions
sudo mkdir -p /var/cache/nginx/client_temp /var/cache/nginx/fastcgi_temp /var/cache/nginx/proxy_temp /var/cache/nginx/scgi_temp /var/cache/nginx/uwsgi_temp
sudo chmod 700 /var/cache/nginx/*
sudo chown nginx:root /var/cache/nginx/*

# Re-check syntax and potential errors.
sudo nginx -t

Crea el archivo de unidad NGINX systemd:

sudo vim /etc/systemd/system/nginx.service

Copia/pega el siguiente contenido en /etc/systemd/system/nginx.servicearchivo:

[Unit]
Description=nginx - high performance web server
Documentation=https://nginx.org/en/docs/
After=network-online.target remote-fs.target nss-lookup.target
Wants=network-online.target

[Service]
Type=forking
PIDFile=/var/run/nginx.pid
ExecStartPre=/usr/sbin/nginx -t -c /etc/nginx/nginx.conf
ExecStart=/usr/sbin/nginx -c /etc/nginx/nginx.conf
ExecReload=/bin/kill -s HUP $MAINPID
ExecStop=/bin/kill -s TERM $MAINPID

[Install]
WantedBy=multi-user.target

Activa que NGINX se inicie al arrancar y arranca NGINX inmediatamente:

sudo systemctl enable nginx.service
sudo systemctl start nginx.service

Comprueba si NGINX se inicia automáticamente después de un reinicio:

sudo systemctl is-enabled nginx.service
# enabled

Comprueba si NGINX se está ejecutando ejecutando uno de los siguientes comandos:

sudo systemctl status nginx.service
# or
ps aux | grep nginx
# or
curl -I 127.0.0.1

También puedes abrir tu navegador y navegar hasta tu dominio/dirección IP para ver la página por defecto de NGINX. Esto es un indicador de que NGINX está funcionando.

Página de bienvenida de Nginx

Crea un cortafuegos sin complicaciones (UFW) el perfil de la aplicación NGINX:

sudo vim /etc/ufw/applications.d/nginx

Copia/pega el siguiente contenido en /etc/ufw/applications.d/nginxarchivo:

[Nginx HTTP]
title=Web Server (Nginx, HTTP)
description=Small, but very powerful and efficient web server
ports=80/tcp

[Nginx HTTPS]
title=Web Server (Nginx, HTTPS)
description=Small, but very powerful and efficient web server
ports=443/tcp

[Nginx Full]
title=Web Server (Nginx, HTTP + HTTPS)
description=Small, but very powerful and efficient web server
ports=80,443/tcp

Comprueba que los perfiles de aplicación UFW están creados y reconocidos:

sudo ufw app list

# Available applications:
 # Nginx Full
 # Nginx HTTP
 # Nginx HTTPS
 # OpenSSH

NGINX, por defecto, genera archivos de .defaultarchivos en /etc/nginx. Elimin a .defaultarchivos del /etc/nginxdirectorio:

sudo rm /etc/nginx/*.default

Colocar el resaltado de sintaxis de la configuración de NGINX para el editor Vim en ~/.vim:

# For regular non-root user
mkdir ~/.vim/
cp -r ~/nginx-1.15.0/contrib/vim/* ~/.vim/
# For root user
sudo mkdir /root/.vim/
sudo cp -r ~/nginx-1.15.0/contrib/vim/* /root/.vim/

NOTA: Al hacer el paso anterior, obtendrás un bonito resaltado de sintaxis al editar los archivos de configuración de NGINX en el editor Vim.

Resaltar la sintaxis de Nginx en Vim

Cre a conf.d, snippets, sites-available y sites-enabled en el directorio/etc/nginxdirectorio:

sudo mkdir /etc/nginx/{conf.d,snippets,sites-available,sites-enabled}

Cambia los permisos y la propiedad del grupo de los archivos de registro de NGINX:

sudo chmod 640 /var/log/nginx/*
sudo chown nginx:adm /var/log/nginx/access.log /var/log/nginx/error.log

Crea la configuración de logrotation para NGINX.

sudo vim /etc/logrotate.d/nginx

Rellena el archivo con el texto que aparece a continuación, luego guarda y sale:

/var/log/nginx/*.log {
    daily
    missingok
    rotate 52
    compress
    delaycompress
    notifempty
    create 640 nginx adm
    sharedscripts
    postrotate
            if [ -f /var/run/nginx.pid ]; then
                    kill -USR1 `cat /var/run/nginx.pid`
            fi
    endscript
}

Elimina todos los archivos descargados del directorio principal:

cd ~
rm -rf nginx-1.15.0/ openssl-1.1.0h/ pcre-8.42/ zlib-1.2.11/

Eso es todo. Ahora tienes la última versión de NGINX instalada al construirla desde el código fuente. Se compila estáticamente con algunas bibliotecas importantes como OpenSSL. A menudo, la versión de OpenSSL suministrada por el sistema está obsoleta. Al utilizar este método de instalación con una versión más reciente de OpenSSL, puedes aprovechar los nuevos cifrados como CHACHA20_POLY1305y protocolos como TLS 1.3que estarán disponibles en OpenSSL1.1.1.Además, al compilar tu propio binario, puedes adaptar la funcionalidad que proporcionará tu NGINX, lo que es mucho más flexible que instalar un binario precompilado.

También te podría gustar...