Jak zkompilovat Nginx ze zdroje na Fedoře 25

NGINX lze použít jako server HTTP/HTTPS, reverzní proxy server, poštovní proxy server, nástroj pro vyrovnávání zatížení, terminátor TLS nebo server pro ukládání do mezipaměti. Je designově poměrně modulární. Má nativní moduly a moduly třetích stran vytvořené komunitou. Napsaný v programovacím jazyce C je to velmi rychlý a lehký software.

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.

Instalace NGINX ze zdrojového kódu je poměrně „snadná“ – stáhněte si nejnovější verzi zdrojového kódu NGINX, nakonfigurujte, sestavte a nainstalujte.

V tomto tutoriálu budu používat verzi hlavní řady , která je v době psaní 1.13.3. Jakmile budou k dispozici novější verze, aktualizujte odpovídajícím způsobem čísla verzí.

Požadavky na sestavení NGINX ze zdroje

Povinné požadavky:

• Verze knihovny OpenSSL mezi 1.0.2 - 1.1.0
• Verze knihovny zlib mezi 1.1.3 - 1.2.11
• Verze knihovny PCRE mezi 4.4 - 8.41
• Kompilátor GCC

Nepovinné požadavky:

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

Než začnete

1. Vytvořit běžného uživatele s sudopřístupem :

2. Přepnout na nového uživatele:

   su - <username>
   

3. Aktualizovat systém:

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

Sestavte NGINX ze zdroje

1. Nainstalujte "Development Tools", editor Vim, wget a gcc-c++:

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

2. Stáhněte si nejnovější hlavní verzi zdrojového kódu NGINX a rozbalte jej:

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

3. Stáhněte si zdrojový kód závislostí NGINX a extrahujte je:

   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. Stáhněte a nainstalujte volitelné 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. Odstraňte všechny .tar.gzsoubory. Už je nepotřebujeme:

   rm -rf *.tar.gz
   

6. Přejděte do zdrojového adresáře NGINX:

   cd ~/nginx-1.13.3
   

7. Pro dobrou míru uveďte seznam souborů a adresářů zdrojového kódu NGINX:

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

8. Zkopírujte manuálovou 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. Chcete-li získat nápovědu, můžete vypsat dostupné konfigurační přepínače spuštěním:

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

10. Nakonfigurujte, zkompilujte a nainstalujte 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. Vytiskněte verzi NGINX, verzi kompilátoru a nakonfigurujte parametry 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. Vytvořte uživatele a skupinu systému NGINX:

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

13. Zkontrolujte syntaxi a potenciální 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. Vytvořte soubor systemd unit pro NGINX:

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

15. Zkopírujte/vložte následující 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. Spusťte NGINX:

    sudo systemctl start nginx.service
    

17. Povolit automatické spouštění NGINX při spouštění:

    sudo systemctl enable nginx.service
    

18. Zkontrolujte, zda se NGINX spustí po restartu:

    sudo systemctl is-enabled nginx.service
    # enabled
    

19. Zkontrolujte, zda běží NGINX:

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

20. Restartujte VPS a ověřte, že se NGINX spouští automaticky:

    sudo shutdown -r now
    

21. Odstraňte archaické soubory z /etc/nginx/adresáře:

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

22. Umístěte soubory zvýraznění syntaxe konfigurace NGINX pro vimdo ~/.vim/. Při úpravě konfiguračního souboru NGINX se vám zobrazí pěkné zvýraznění syntaxe:

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

23. Vytvořte conf.d/adresář v /etc/nginx/adresáři. Do tohoto adresáře můžete umístit virtuální servery a upstreamy:

    sudo mkdir /etc/nginx/conf.d/
    

24. Odstraňte extrahované adresáře a soubory z vašeho domovského adresáře:

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

Závěr

A je to. Nyní máte nainstalovanou nejnovější verzi NGINX. Je kompilován staticky proti některým důležitým knihovnám, jako je OpenSSL. Verze systému OpenSSL je často zastaralá. Použitím této metody instalace s novější verzí OpenSSL můžete využít nové šifry jako CHACHA20_POLY1305a protokoly jako TLS 1.3, které budou dostupné v OpenSSL 1.1.1(které v době psaní tohoto článku nebylo vydáno).