Nginx - Compilare e installare Nginx e i moduli base

Nginx offre diverse opzioni in fase di compilazione; compilare al meglio Nginx e scegliere solo le funzionalità che interessano possono rendere Nginx ancora più scattante.

Alcune distribuzioni Linux e di varianti BSD contengono Nginx fra i propri repository di pacchetti pronti da installare. Fate attenzione dal momento che molto spesso questi pacchetti contengono versioni datate di Nginx. Compilare Nginx dai sorgenti è sicuramente il procedimento raccomandato dal momento che si ha la possibilità di scegliere i moduli da attivare ed è un processo relativamente semplice.

Procedura di compilazione Nginx

• Scaricare il codice sorgente
• Decomprimere il sorgente con il comando tar -xzvf nginx-0.5.30.tar.gz
• Posizionarsi nella cartella appena estratta con cd nginx-0.5.30/ e lanciare il comando ./configure; eventualmente scegliere i parametri di compilazione dalla lista riportata di seguito ed aggiungerli in coda al comando (es. ./configure --http-log-path=/dev/telegrafo)
Nel caso il comando ./configure non sia riuscito a trovare le librerie PCRE, apparirà un messaggio di questo tipo:

./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=path option.

Dovrà quindi essere necessario indicare la posizione delle librerie, as esempio ./configure --with-pcre=/usr/lib/pcre; se invece le librerie non sono installate sul sistema, è sufficiente scaricare il pacchetto, decomprimerlo ed infine indicare la cartella contente la libreira con il parametro --with-pcre=.
• Procedere alla compilazione e alla installazione del pacchetto con il comando make && make install

Nginx e PCRE

Nginx utilizza la libreria PCRE (Perl Compatible Regular Expressions) ed è quindi necessario che sia presenta all’interno del sistema in fase di compilazione. Se il comando ./configure non riesce a trovarla, è possibile indicare la cartella in cui sono presenti i sorgenti PCRE con il parametro --with-pcre=mia/cartella/pcre; nel caso non si trovino le librerie o siano da installare, è possibile procedere al download della libreria dal sito ufficiale, decomprimere il pacchetto in una cartella dedicata e quindi lanciare il comando ./configure --with-pcre=/usr/lib/pcre

Parametri di configurazione Nginx

A differenza di Apache, Nginx permette la scelta dei moduli da attivare esclusivamente in fase di compilazione; sempre in fase di compilazione è possibile specificare alcuni parametri che potranno essere cambiati dopo la fase di compilazione intervenendo nel file nginx.conf.

configure supporta le seguenti opzioni:

• --prefix=<path> - Il percorso relativo verso il quale tutti i path di Nginx convergono; se non specificato, viene utilizzato il valore preimpostato /usr/local/nginx.
• --sbin-path=<path> - Il percorso per gli eseguibili Nginx; se non specificato viene utilizzato il valore preimpostato <prefix>/sbin/nginx.
• --conf-path=<path> - Il percorso utilizzato per la lettura dei file di configurazione di Nginx a meno che non venga specificato il parametro –c da riga di comando; se non specificato, viene utilizzato il valore predefinito <prefix>/conf/nginx.conf.
• --pid-path=<path> - Il percorso nel quale verrà creato il file PID; se non specificato, viene utilizzato il valore predefinito <prefix>/logs/nginx.pid.
• --lock-path=<path> - Il percorso nel quale viene creato il file nginx.lock; se non specificato, viene utilizzato il valore predefinito <prefix>/logs/nginx.lock.
• --error-log-path=<path> - Il percorso del file di log degli errori, se non specificato tramite il parametro “error_log” nel file nginx.conf; se non specificato, viene utilizzato il valore predefinito <prefix>/logs/error.log.
• --http-log-path=<path> - Il percorso del file di log degli accessi, se non specificato tramite il parametro “access_log” nel file nginx.conf; se non specificato, viene utilizzato il valore predefinito <prefix>/logs/access.log.
• --user=<user> - L’utente proprietario del processo Nginx, se non altrimenti specificato nel file nginx.conf tramite il parametro “user; se non specificato, viene utilizzato il valore predefinito “nobody”.
• --group=<group> - Il gruppo utilizzato di default per mandare in esecuzione Nginx se non altrimenti specificato nel file di configurazione nginx.conf.
• --builddir=DIR – Imposta la cartella utilizzata per il build di Nginx
• --with-rtsig_module – Abilita il modulo rtsi
• --with-select_module --without-select_module – Abilita o disabilita il modulo select. Questo modulo è abilitato di default se configure non ha individuato un metodo più appropriato quale kqueue, epoll, rtsig o /dev/poll.
• –with-poll_module –without-poll_module – Abilita o disabilita il modulo pool. Questo modulo è abilitato di default se configure non ha individuato un metodo più appropriato quale kqueue, epoll, rtsig o /dev/.
• --with-http_ssl_module – Abilita il modulo ngx_http_ssl_module. Abilita il supporto SSL e la possibilità di gestire richieste https. Richiede OpenSSL (libssl-dev su Debian).
• --with-http_realip_module - Abilita ngx_http_realip_module
• --with-http_addition_module - Abilita ngx_http_addition_module
• --with-http_sub_module - Abilita ngx_http_sub_module
• --with-http_dav_module - Abilita ngx_http_dav_module
• --with-http_flv_module - Abilita ngx_http_flv_module
• --with-http_stub_status_module - Abilita la pagina “server status”
• --without-http_charset_module - Disabilita ngx_http_charset_module
• --without-http_gzip_module - Disabilita ngx_http_gzip_module. Richiede zlib per il suo corretto funzionamento.
• --without-http_ssi_module - Disabilita ngx_http_ssi_module
• --without-http_userid_module - Disabilita ngx_http_userid_module
• --without-http_access_module - Disabilita ngx_http_access_module
• --without-http_auth_basic_module - Disabilita ngx_http_auth_basic_module
• --without-http_autoindex_module - Disabilita ngx_http_autoindex_module
• --without-http_geo_module - Disabilita ngx_http_geo_module
• --without-http_map_module - Disabilita ngx_http_map_module
• --without-http_referer_module - Disabilita ngx_http_referer_module
• --without-http_rewrite_module - Disabilita ngx_http_rewrite_module. Richiede PCRE.
• --without-http_proxy_module - Disabilita ngx_http_proxy_module
• --without-http_fastcgi_module - Disabilita ngx_http_fastcgi_module
• --without-http_memcached_module - Disabilita ngx_http_memcached_module
• --without-http_limit_zone_module - Disabilita ngx_http_limit_zone_module
• --without-http_empty_gif_module - Disabilita ngx_http_empty_gif_module
• --without-http_browser_module - Disabilita ngx_http_browser_module
• --without-http_upstream_ip_hash_module - Disabilita ngx_http_upstream_ip_hash_module
• --with-http_perl_module - Abilita ngx_http_perl_module
• --with-perl_modules_path=PATH - Imposta il percorso dei moduli Perl
• --with-perl=PATH – Importa il percorso per i file binari Perl
• --http-client-body-temp-path=PATH – Set path to the http client request body temporary files. If not set, defaults to <prefix>/client_body_temp
• --http-proxy-temp-path=PATH – Imposta il percorso per il file temporanei del proxy http; se non specificato, viene impostato al valore di default <prefix>/proxy_temp
• --http-fastcgi-temp-path=PATH – Imposta il percorso per i file temporanei fastcgi; se non specificato, viene impostato al valore di default <prefix>/fastcgi_temp
• --without-http – Disabilita il server HTTP
• --with-mail – Abilita il modulo di proxy IMAP4/POP3/SMT
• --with-mail_ssl_module - Abilita ngx_mail_ssl_module
• --with-cc=PATH – Imposta il percorso del compilatore C
• --with-cpp=PATH - Imposta il percorso del preprocessore
• --with-cc-opt=OPTIONS – Parametri addizionali che saranno aggiunti alla variabile CFLAGS. Se si utilizza la libreria PCRE in FreeBSD, è necessario indicar
• --with-cc-opt="-I /usr/local/include" - Se si utilizza select() ed è necessario incrementare il numero dei descrittori dei file, deve essere specificato: –with-cc-opt=”-D FD_SETSIZE=2048″.
• --with-ld-opt=OPTIONS – Parametri addizionali passati al linker. Se si utilizza la libreria PCRE in FreeBSD, è necessario indicare –with-ld-opt=”-L /usr/local/lib”.
• --with-cpu-opt=CPU – Compilazione per una specifica CPU; i valori consentiti: pentium, pentiumpro, pentium3, pentium4, athlon, opteron, amd64, sparc32, sparc64, ppc64
• --without-pcre - Disabilita l’utilizzo delle librerie PCRE. Disabilita anche il modulo http rewrite.
• --with-pcre=DIR – Imposta il percorso dei sorgenti della libreria PCRE.
• --with-pcre-opt=OPTIONS – Imposta opzioni addizionali per la compilazione di PCRE.
• --with-md5=DIR – Impostazione del percorso per i sorgenti della libreria md5.
• --with-md5-opt=OPTIONS – Imposta opzioni addizionali per la compilazione della libreria md5.
• --with-md5-asm – Utilizza il sorgente asm per la libreria md5.
• --with-sha1=DIR – Imposta il percorso dei sorgenti per la libreria sha1.
• --with-sha1-opt=OPTIONS – Imposta opzioni addizionali per la compilazione della libreria sha1.
• --with-sha1-asm – Utilizza il sorgente asm per la libreria sha1.
• --with-zlib=DIR – Imposta il percorso del sorgente della libreria zlib.
• --with-zlib-opt=OPTIONS – Imposta opzioni addizionali per la compilazione della libreria zlib.
• --with-zlib-asm=CPU – Utilizza i sorgenti assembler per la libreria zlib, ottimizzata per una specifica CPU; i parametri validi sono: pentium, pentiumpro
• --with-openssl=DIR – Imposta il percorso per i sorgenti della libreria OpenSSL
• --with-openssl-opt=OPTIONS – Imposta parametri addizionali per la compilazione della libreria OpenSSL
• --with-debug – Abilita il logging a livello di debug
• --add-module=PATH – Aggiunge i moduli sviluppati da terze parti trovati nella directory specificata dal valore del pametro PATH

Le opzioni possono variare fra le differenti versioni; meglio dare un occhio a ./configure –help per la lista dei parametri da utilizzare per la versione in uso.

Esempio (da riportare su una sola riga):

./configure \
--sbin-path=/usr/local/nginx/nginx \
--conf-path=/usr/local/nginx/nginx.conf \
--pid-path=/usr/local/nginx/nginx.pid \
--with-http_ssl_module \
--with-pcre=../pcre-4.4 \
--with-zlib=../zlib-1.1.3

Esempio su Ubuntu / Debian con libgcrypt11-dev, libpcre3-dev e libssl-dev installati (scegliere –with-md5 OPPURE –with-sha1, ma non entrambi; su Debian e Ubuntu dovrebbero puntare a /usr/lib)

./configure --with-openssl=/usr/lib/ssl/ --with-md5=/usr/lib

Risorse esterne

• Documentazione Originale

Autore • Some Rights Reserved • Disclamer • Contatti• La pagina Nginx - Compilare e installare Nginx e i moduli base | ynw è terminata.