Cómo instalar Nginx

nginxEn esta entrada vamos a ver como instalar en Linux y *nix el servidor web Nginx, un servidor web ligero y robusto que permite alta concurrencia y además tiene función de proxy inverso para protocolos HTTP, SMTP, POP3 e IMAP.

Existen varios métodos de instalación, lo normal suele ser elegir entre la instalación a través de repositorios o descargar las fuentes del sitio web oficial de Nginx.

El punto a favor de la instalación por repositorio es su sencillez, el paquete puede o no estar en los repositorios oficiales pero siempre se puede encontrar el RPM de forma sencilla con repositorios de terceros. El punto en contra de este tipo de instalación es que la versión disponible nunca es la última estable oficial. Por otro lado, la instalación con las fuentes es un poquito más complicada pero permite una personalización mucho mayor y elegir la versión que queramos.

Instalando Nginx por repositorio

CentOS y RHEL

La instalación por repositorio no tiene ningún misterio, en el caso de CentOS, RHEL, Fedora, Scientific Linux, etc, podemos instalarlo con el repositorio EPEL (versión 1.6.1) O a través del repositorio oficial de Nginx disponible, lógicamente es preferible usar el repositorio oficial así que lo instalamos y después el paquete. Veréis que se puede descargar el repo según versión de CentOS y RHEL, en este caso para CentOS 7:

# wget http://nginx.org/packages/centos/7/noarch/RPMS/nginx-release-centos-7-0.el7.ngx.noarch.rpm
yum install nginx-release-centos-7-0.el7.ngx.noarch.rpm

Una vez instalado el repositorio podemos instalar Nginx:

# yum install nginx

Debian y Ubuntu

En Debian y Ubuntu también podemos usar el repositorio oficial, así que nos bajamos la PGP key y configuramos el repositorio en el sources.list:

# apt-key add nginx_signing.key

/etc/apt/sources.list de Debian

deb http://nginx.org/packages/debian/ codename nginx
deb-src http://nginx.org/packages/debian/ codename nginx

/etc/apt/sources.list de Ubuntu

deb http://nginx.org/packages/ubuntu/ codename nginx
deb-src http://nginx.org/packages/ubuntu/ codename nginx

Actualizamos los repositorios e instalamos:

# apt-get update
# apt-get install nginx

FreeBSD

En FreeBSD, Nginx puede ser instalado tanto a través de los paquetes como el sistema de puertos. Como con otros paquetes, a través del sistema de puertos tenemos una gran flexibilidad para configurar Nginx.

Instalando Nginx con el código fuente

Descarga del código fuente del sitio web de Nginx:

# cd /var/tmp
# wget http://nginx.org/download/nginx-1.7.6.tar.gz

Descomprimimos en una ruta temporal.

# tar -xzvf nginx-1.7.6.tar.gz

A partir de aquí llega el momento de la personalización a través del comando “configure“. Con este comando podemos definir las opciones de compilación y opciones de Nginx, ruta de instalación, módulos a activar, etc. Con todas estas opciones se crea un Makefile que será utilizado para compilar. Todos los parámetros de compilación disponibles se pueden visualizar del siguiente modo, os dejo una muestra:

# configure --help

  --help                             print this message

  --prefix=PATH                      set installation prefix
  --sbin-path=PATH                   set nginx binary pathname
  --conf-path=PATH                   set nginx.conf pathname
  --error-log-path=PATH              set error log pathname
  --pid-path=PATH                    set nginx.pid pathname
  --lock-path=PATH                   set nginx.lock pathname

  --user=USER                        set non-privileged user for
                                     worker processes
  --group=GROUP                      set non-privileged group for
                                     worker processes

  --build=NAME                       set build name
  --builddir=DIR                     set build directory

  --with-file-aio                    enable file AIO support
  --with-ipv6                        enable IPv6 support

  --with-http_ssl_module             enable ngx_http_ssl_module
  --with-http_spdy_module            enable ngx_http_spdy_module
  --with-http_realip_module          enable ngx_http_realip_module
  --with-http_addition_module        enable ngx_http_addition_module
  --with-http_xslt_module            enable ngx_http_xslt_module
  --with-http_image_filter_module    enable ngx_http_image_filter_module
  --with-http_geoip_module           enable ngx_http_geoip_module
[...]

Una vez elegidos los parámetros de configuración, ejecutamos el comando. Ejemplo en el que elegimos una ruta de instalación distinta y activamos el módulo de HTTP SSL y GZIP:

# ./configure \
  --prefix=/opt/nginx \
 --sbin-path=/opt/nginx/sbin \
 --conf-path=/opt/nginx/nginx.conf \
 --pid-path=/opt/nginx/run/nginx.pid \
 --with-http_ssl_module \
 --with-http_gzip_static_module

Aquí pueden surgir distintos errores provocados por fallos de dependencias, falta de compiladores instalados en el sistema, etc. Por ejemplo, por defecto se instala el módulo de reescritura http_rewrite, que tiene como dependencia PCRE:

./configure: error: the HTTP rewrite module requires the PCRE library.
You can either disable the module by using --without-http_rewrite_module
option, or install the PCRE library into the system, or build the PCRE library
statically from the source with nginx by using --with-pcre= option.

Aquí tenemos dos opciones, instalar PCRE con paquete de sistema o bajar las sources. Lo más fácil, lo primero:

# yum install pcre pcre-devel

En estos casos instalo siempre el DEVEL por ser necesario por temas de compilación.

Una vez instalada la dependencia, volvemos a probar el configure, y:

./configure: error: SSL modules require the OpenSSL library.
You can either do not enable the modules, or install the OpenSSL library
into the system, or build the OpenSSL library statically from the source
with nginx by using --with-openssl= option.

Está claro, para solucionar este otro error instalamos OpenSSL y su paquete DEVEL:

# yum install openssl openssl-devel

Y así hasta que termináramos con un configure limpio. Este sería el resultado:

# ./configure \
>   --prefix=/opt/nginx \
>  --sbin-path=/opt/nginx/sbin \
>  --conf-path=/opt/nginx/nginx.conf \
>  --pid-path=/opt/nginx/run/nginx.pid \
>  --with-http_ssl_module \
>  --with-http_gzip_static_module
checking for OS
 + Linux 3.10.0-123.el7.x86_64 x86_64
checking for C compiler ... found
 + using GNU C compiler
 + gcc version: 4.8.2 20140120 (Red Hat 4.8.2-16) (GCC) 
checking for gcc -pipe switch ... found
checking for gcc builtin atomic operations ... found
checking for C99 variadic macros ... found
checking for gcc variadic macros ... found
checking for unistd.h ... found
checking for inttypes.h ... found
checking for limits.h ... found
checking for sys/filio.h ... not found
checking for sys/param.h ... found
checking for sys/mount.h ... found
checking for sys/statvfs.h ... found
checking for crypt.h ... found
checking for Linux specific features
checking for epoll ... found
checking for EPOLLRDHUP ... found
checking for O_PATH ... found
checking for sendfile() ... found
checking for sendfile64() ... found
checking for sys/prctl.h ... found
checking for prctl(PR_SET_DUMPABLE) ... found
checking for sched_setaffinity() ... found
checking for crypt_r() ... found
checking for sys/vfs.h ... found
checking for nobody group ... found
checking for poll() ... found
checking for /dev/poll ... not found
checking for kqueue ... not found
checking for crypt() ... not found
checking for crypt() in libcrypt ... found
checking for F_READAHEAD ... not found
checking for posix_fadvise() ... found
checking for O_DIRECT ... found
checking for F_NOCACHE ... not found
checking for directio() ... not found
checking for statfs() ... found
checking for statvfs() ... found
checking for dlopen() ... not found
checking for dlopen() in libdl ... found
checking for sched_yield() ... found
checking for SO_SETFIB ... not found
checking for SO_ACCEPTFILTER ... not found
checking for TCP_DEFER_ACCEPT ... found
checking for TCP_KEEPIDLE ... found
checking for TCP_FASTOPEN ... not found
checking for TCP_INFO ... found
checking for accept4() ... found
checking for int size ... 4 bytes
checking for long size ... 8 bytes
checking for long long size ... 8 bytes
checking for void * size ... 8 bytes
checking for uint64_t ... found
checking for sig_atomic_t ... found
checking for sig_atomic_t size ... 4 bytes
checking for socklen_t ... found
checking for in_addr_t ... found
checking for in_port_t ... found
checking for rlim_t ... found
checking for uintptr_t ... uintptr_t found
checking for system byte ordering ... little endian
checking for size_t size ... 8 bytes
checking for off_t size ... 8 bytes
checking for time_t size ... 8 bytes
checking for setproctitle() ... not found
checking for pread() ... found
checking for pwrite() ... found
checking for sys_nerr ... found
checking for localtime_r() ... found
checking for posix_memalign() ... found
checking for memalign() ... found
checking for mmap(MAP_ANON|MAP_SHARED) ... found
checking for mmap("/dev/zero", MAP_SHARED) ... found
checking for System V shared memory ... found
checking for POSIX semaphores ... not found
checking for POSIX semaphores in libpthread ... found
checking for struct msghdr.msg_control ... found
checking for ioctl(FIONBIO) ... found
checking for struct tm.tm_gmtoff ... found
checking for struct dirent.d_namlen ... not found
checking for struct dirent.d_type ... found
checking for sysconf(_SC_NPROCESSORS_ONLN) ... found
checking for openat(), fstatat() ... found
checking for getaddrinfo() ... found
checking for PCRE library ... found
checking for PCRE JIT support ... found
checking for OpenSSL library ... found
checking for zlib library ... found
creating objs/Makefile

Configuration summary
  + using system PCRE library
  + using system OpenSSL library
  + md5: using OpenSSL library
  + sha1: using OpenSSL library
  + using system zlib library

  nginx path prefix: "/opt/nginx"
  nginx binary file: "/opt/nginx/sbin"
  nginx configuration prefix: "/opt/nginx"
  nginx configuration file: "/opt/nginx/nginx.conf"
  nginx pid file: "/opt/nginx/run/nginx.pid"
  nginx error log file: "/opt/nginx/logs/error.log"
  nginx http access log file: "/opt/nginx/logs/access.log"
  nginx http client request body temporary files: "client_body_temp"
  nginx http proxy temporary files: "proxy_temp"
  nginx http fastcgi temporary files: "fastcgi_temp"
  nginx http uwsgi temporary files: "uwsgi_temp"
  nginx http scgi temporary files: "scgi_temp"


Como véis, al final de la salida estándar de la generación del MakeFile vemos un resumen con las rutas de instalación, módulos a activar, etc.

Finalmente compilamos e instalamos ejecutando un “make” y “make install”:

# make
# make install

Ya tenemos instalado Nginx. Hay que tener en cuenta que al haberlo compilado manualmente no se ha creado el script de arranque en /etc/init.d así que podemos crearlo nosotros o arrancar directamente el servicio:

# /opt/nginx/sbin/nginx
# ps -ef | grep nginx
 root 10471 1 0 13:44 ? 00:00:00 nginx: master process /opt/nginx/sbin/nginx
 nobody 10472 10471 0 13:44 ? 00:00:00 nginx: worker process

Si accedemos por el navegador a la IP del servidor web o lanzamos un cURL veremos que ya está instalado correctamente.

# curl localhost

Welcome to nginx!

If you see this page, the nginx web server is successfully installed and
working. Further configuration is required.

For online documentation and support please refer to
nginx.org.

Commercial support is available at
nginx.com.

Thank you for using nginx.

Como véis, la diferencia entre instalar por paquete (yum, apt, puertos) a compilar a mano es bastante grande, todo depende de las necesidades de cada uno. Si queremos sencillez de instalación y actualización iremos con los repositorios, si necesitamos máxima personalización iremos a por la instalación por código fuente.

Deja un comentario

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *