Ako skompilovať Nginx zo zdroja na Fedore 25

NGINX je možné použiť ako HTTP/HTTPS server, reverzný proxy server, poštový proxy server, vyrovnávač zaťaženia, TLS terminátor alebo cachovací server. Dizajnovo je dosť modulárny. Má natívne moduly a moduly tretích strán vytvorené komunitou. Je napísaný v programovacom jazyku C a je to veľmi rýchly a ľahký softvér.

NOTE: NGINX has two version streams that run in parallel - stable and mainline. Both versions can be used on a production server. It is recommended to use the mainline version in production.

Inštalácia NGINX zo zdrojového kódu je pomerne „jednoduchá“ – stiahnite si najnovšiu verziu zdrojového kódu NGINX, nakonfigurujte, zostavte a nainštalujte.

V tomto návode budem používať hlavnú verziu, ktorá je v čase písania 1.13.3. Aktualizujte čísla verzií podľa toho, keď budú k dispozícii novšie verzie.

Požiadavky na zostavenie NGINX zo zdroja

Povinné požiadavky:

• Verzia knižnice OpenSSL medzi 1.0.2 - 1.1.0
• Verzia knižnice zlib medzi 1.1.3 - 1.2.11
• Verzia knižnice PCRE medzi 4.4 - 8.41
• Kompilátor GCC

Voliteľné požiadavky:

• PERL
• libatomic_ops
• LibGD
• MaxMind GeoIP
• libxml2
• libxslt

Predtým ako začneš

1. Vytvoriť bežného používateľa s sudoprístupom :

2. Prepnúť na nového používateľa:

   su - <username>
   

3. Aktualizovať systém:

   sudo dnf check-update || sudo dnf upgrade -y
   

Zostavte NGINX zo zdroja

1. Nainštalujte "Development Tools", editor Vim, wget a gcc-c++:

   sudo dnf install -y @development-tools && sudo dnf install -y vim wget gcc-c++
   

2. Stiahnite si najnovšiu hlavnú verziu zdrojového kódu NGINX a rozbaľte ju:

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

3. Stiahnite si zdrojový kód závislostí NGINX a extrahujte ich:

   NGINX depends on 3 libraries: PCRE, zlib and OpenSSL:

   # PCRE version 8.41
   wget https://ftp.pcre.org/pub/pcre/pcre-8.41.tar.gz && tar xzvf pcre-8.41.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.0f
   wget https://www.openssl.org/source/openssl-1.1.0f.tar.gz && tar xzvf openssl-1.1.0f.tar.gz
   

4. Stiahnite si a nainštalujte voliteľné závislosti NGINX:

   # perl
   sudo dnf install -y perl perl-devel perl-ExtUtils-Embed
   
   # libxslt
   sudo dnf install -y libxslt libxslt-devel
   
   # libxml2
   sudo dnf install -y libxml2 libxml2-devel
   
   # libgd
   sudo dnf install -y gd gd-devel
   
   # GeoIP
   sudo dnf install -y GeoIP GeoIP-devel
   
   # Libatomic_Ops
   sudo dnf install -y libatomic_ops libatomic_ops-devel
   

5. Odstráňte všetky .tar.gzsúbory. Už ich nepotrebujeme:

   rm -rf *.tar.gz
   

6. Prejdite do zdrojového adresára NGINX:

   cd ~/nginx-1.13.3
   

7. Pre dobrú mieru uveďte zoznam súborov a adresárov zdrojového kódu NGINX:

   ls
   # auto  CHANGES  CHANGES.ru  conf  configure  contrib  html  LICENSE  man  README  src
   

8. Skopírujte manuálovú stránku NGINX do /usr/share/man/man8/:

   sudo cp ~/nginx-1.13.3/man/nginx.8 /usr/share/man/man8/
   sudo gzip /usr/share/man/man8/nginx.8
   # Check that Man page for NGINX is working
   man nginx
   

9. Ak potrebujete pomoc, môžete uviesť dostupné konfiguračné prepínače spustením:

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

10. Nakonfigurujte, skompilujte a nainštalujte NGINX:

    ./configure --prefix=/etc/nginx \
                --sbin-path=/usr/sbin/nginx \
                --modules-path=/usr/lib64/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=Fedora \
                --builddir=nginx-1.13.3 \
                --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=/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.41 \
                --with-pcre-jit \
                --with-zlib=../zlib-1.2.11 \
                --with-openssl=../openssl-1.1.0f \
                --with-openssl-opt=no-nextprotoneg \
                --with-debug
    
    make
    sudo make install
    

11. Vytlačte verziu NGINX, verziu kompilátora a nakonfigurujte parametre skriptu:

    nginx -V
    
    # nginx version: nginx/1.13.3 (Fedora)
    # built by gcc 6.3.1 20161221 (Red Hat 6.3.1-1) (GCC)
    # built with OpenSSL 1.1.0f  25 May 2017
    # TLS SNI support enabled
    # configure arguments: --prefix=/etc/nginx . . .
    # . . .
    

12. Vytvorte používateľa a skupinu systému NGINX:

    sudo useradd --system --home /var/cache/nginx --shell /sbin/nologin --comment "nginx user" --user-group nginx
    

13. Skontrolujte syntax a potenciálne chyby:

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

14. Vytvorte súbor systémovej jednotky pre NGINX:

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

15. Skopírujte/prilepte nasledujúci obsah:

    NOTE: The location of the PID file and the NGINX binary may be different depending on how NGINX was compiled.

    [Unit]
    Description=Nginx - A high performance web server and a reverse proxy server
    Documentation=http://nginx.org/en/docs/
    After=network.target
    
    [Service]
    Type=forking
    PIDFile=/var/run/nginx.pid
    ExecStartPre=/usr/sbin/nginx -t -q -g 'daemon on; master_process on;'
    ExecStart=/usr/sbin/nginx -g 'daemon on; master_process on;'
    ExecReload=/usr/sbin/nginx -g 'daemon on; master_process on;' -s reload
    ExecStop=-/sbin/start-stop-daemon --quiet --stop --retry QUIT/5 --pidfile /var/run/nginx.pid
    TimeoutStopSec=5
    KillMode=mixed
    
    [Install]
    WantedBy=multi-user.target
    

16. Spustite NGINX:

    sudo systemctl start nginx.service
    

17. Povoliť automatické spustenie NGINX pri zavádzaní:

    sudo systemctl enable nginx.service
    

18. Skontrolujte, či sa NGINX spustí po reštarte:

    sudo systemctl is-enabled nginx.service
    # enabled
    

19. Skontrolujte, či je spustený NGINX:

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

20. Reštartujte svoj VPS a overte, či sa NGINX spustí automaticky:

    sudo shutdown -r now
    

21. Odstráňte archaické súbory z /etc/nginx/adresára:

    sudo rm /etc/nginx/koi-utf /etc/nginx/koi-win /etc/nginx/win-utf
    

22. Umiestnite súbory zvýraznenia syntaxe konfigurácie NGINX pre vimdo ~/.vim/. Pri úprave konfiguračného súboru NGINX sa vám zobrazí pekné zvýraznenie syntaxe:

    mkdir ~/.vim/
    cp -r ~/nginx-1.13.3/contrib/vim/* ~/.vim/
    

23. Vytvorte conf.d/adresár v /etc/nginx/adresári. Do tohto adresára môžete umiestniť virtuálne servery a upstreamy:

    sudo mkdir /etc/nginx/conf.d/
    

24. Odstráňte extrahované adresáre a súbory z vášho domovského adresára:

    rm -rf nginx-1.13.3/ openssl-1.1.0f/ pcre-8.41/ zlib-1.2.11/
    

Záver

To je všetko. Teraz máte nainštalovanú najnovšiu verziu NGINX. Je kompilovaný staticky proti niektorým dôležitým knižniciam, ako je OpenSSL. Verzia systému OpenSSL je často zastaraná. Použitím tejto metódy inštalácie s novšou verziou OpenSSL môžete využiť nové šifry ako CHACHA20_POLY1305a protokoly ako TLS 1.3, ktoré budú dostupné v OpenSSL 1.1.1(ktoré v čase písania tohto článku nebolo vydané).