So bauen Sie Nginx aus dem Quellcode auf Fedora 29

Nginx (ausgesprochen "engine x" ) ist eine Open-Source-Webserversoftware, die auf hohe Parallelität ausgelegt ist und als HTTP/HTTPS-Server verwendet werden kann , Reverse-Proxy-Server , Mail-Proxy-Server , Software-Load-Balancer , TLS-Terminator , Caching-Server ...

Es ist eine extrem modulare Software. Sogar einige der scheinbar "eingebauten" Teile der Software, wie GZIP oder SSL, werden tatsächlich als Module erstellt, die während der Erstellungszeit aktiviert und deaktiviert werden können.

Es hat Kern (nativ ) Module und (externe) Module von Drittanbietern von der Gemeinde erstellt. Derzeit gibt es über hundert Module von Drittanbietern, die wir nutzen können.

Geschrieben in C Sprache, es ist eine sehr schnelle und leichtgewichtige Software.

Die Installation von Nginx aus dem Quellcode ist relativ „einfach“ – laden Sie die neueste Version des Nginx-Quellcodes herunter, konfigurieren, erstellen und installieren Sie sie.

Sie müssen entscheiden, ob Sie die Mainline herunterladen möchten oder stabil Version, aber das Erstellen ist genau dasselbe.

In dieser Anleitung erstellen wir Nginx mit allen verfügbaren Modulen in der Open-Source-Version von Nginx und verwenden Mainline  Version, die bei 1.15.8 ist zum Zeitpunkt dieses Schreibens. Aktualisieren Sie Versionsnummern, wenn neuere Versionen verfügbar sind.

Stabile vs. Mainline-Version

Nginx Open Source ist in zwei Versionen verfügbar:

• Hauptlinie – Enthält die neuesten Funktionen und Fehlerbehebungen und ist immer auf dem neuesten Stand. Es ist zuverlässig, aber es kann einige experimentelle Module enthalten, und es kann auch einige neue Fehler enthalten.
• Stabil – Enthält nicht alle neuesten Funktionen, hat aber kritische Fehlerbehebungen, die immer auf die Hauptversion zurückportiert werden.

Kernmodule vs. Module von Drittanbietern

Nginx hat zwei Arten von Modulen, die Sie verwenden können: Kernmodule und Module von Drittanbietern .

Kernmodule werden von den Kernentwicklern von Nginx erstellt und sind Teil der Software selbst.

Module von Drittanbietern werden von der Community erstellt und Sie können sie verwenden, um die Nginx-Funktionalität zu erweitern. Es gibt viele hilfreiche Module von Drittanbietern, die bekanntesten unter ihnen sind:PageSpeed, ModSecurity, RTMP, Lua etc...

Statische Module vs. dynamische Module

Statische Module gibt es in Nginx seit der allerersten Version. Dynamische Module wurden mit Nginx 1.9.11+ im Februar 2016 eingeführt.

Bei statischen Modulen wird der Satz von Modulen, die eine Nginx-Binärdatei darstellen, zur Kompilierzeit durch die ./configure festgelegt Skript. Statische Module verwenden --with-foo_bar_module oder --add-module=PATH Syntax.

Um das Kernmodul (Standard) als dynamisch zu kompilieren, fügen wir =dynamic hinzu , zum Beispiel --with-http_image_filter_module=dynamic .

Um Drittanbieter-Module als dynamisch zu kompilieren, verwenden wir --add-dynamic-module=/path/to/module Syntax und dann laden wir sie mit load_module Direktive im globalen Kontext der nginx.conf Datei.

Anforderungen zum Erstellen von Nginx aus der Quelle

Im Vergleich zu manch anderer UNIX/Linux-Software ist Nginx ziemlich leichtgewichtig und hat nicht viele Bibliotheksabhängigkeiten. Die standardmäßige Build-Konfiguration hängt von nur 3 zu installierenden Bibliotheken ab: OpenSSL /LibreSSL /Langweiliges SSL , Zlib und PCRE .

• Obligatorische Anforderungen:
  • GNU-Compiler-Sammlung (GCC )
  • Version der OpenSSL-Bibliothek zwischen 1.0.2 - 1.1.1 oder LibreSSL-Bibliothek oder BoringSSL-Bibliothek
  • Version der Zlib-Bibliothek zwischen 1.1.3 - 1.2.11
  • Version der PCRE-Bibliothek zwischen 4.4 - 8.42
• Optionale Anforderungen:
  • Perl
  • LibGD
  • MaxMind GeoIP Legacy C-Bibliothek
  • libxml2
  • libxslt

Anforderungen

• Ein Server, auf dem das Fedora 29-System ausgeführt wird.
• Ein Nicht-Root-Benutzer mit sudo-Berechtigungen.

Erste Schritte

Überprüfen Sie Ihre Fedora-Version:

cat /etc/fedora-release
# Fedora release 29 (Twenty Nine)

Richten Sie die Zeitzone ein:

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

Aktualisieren Sie die Pakete Ihres Fedora-Betriebssystems:

sudo dnf upgrade -y

Installieren Sie vim-, curl-, wget- und tree-Pakete:

sudo dnf install -y vim curl wget tree

Erstellen Sie Nginx aus der Quelle

Nginx ist ein in C geschriebenes Programm , also müssen Sie zuerst ein Compiler-Tool installieren:

sudo dnf groupinstall -y 'Development Tools'

Laden Sie die neueste Mainline-Version des Nginx-Quellcodes herunter und extrahieren Sie ihn. Nginx-Quellcode wird als komprimiertes Archiv (gezippter Tarball) verteilt, wie die meisten Unix- und Linux-Software:

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

Laden Sie den Quellcode der obligatorischen Nginx-Abhängigkeiten herunter und extrahieren Sie sie:

# 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.1a
wget https://www.openssl.org/source/openssl-1.1.1a.tar.gz && tar xzvf openssl-1.1.1a.tar.gz

Optionale Nginx-Abhängigkeiten installieren:

sudo dnf install -y perl perl-devel perl-ExtUtils-Embed libxslt libxslt-devel libxml2 libxml2-devel gd gd-devel GeoIP GeoIP-devel

Bereinigen Sie alle .tar.gz Dateien, da sie nicht mehr benötigt werden:

rm -rf *.tar.gz

Geben Sie das Nginx-Quellverzeichnis ein:

cd ~/nginx-1.15.8

Listen Sie zur Sicherheit Verzeichnisse und Dateien auf, die den Nginx-Quellcode mit tree bilden Dienstprogramm:

tree -L 2 .

Kopieren Sie die Handbuchseite von Nginx nach /usr/share/man/man8/ Verzeichnis:

sudo cp ~/nginx-1.15.8/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

Um Hilfe zu erhalten, können Sie die vollständige Liste der aktuellen Nginx-Kompilierungsoptionen anzeigen, indem Sie Folgendes ausführen:

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

Konfigurieren, kompilieren und installieren Sie 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.15.8 \
            --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/lib64/perl5 \
            --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.1a \
            --with-openssl-opt=no-nextprotoneg \
            --with-debug


make
sudo make install

Navigieren Sie nach dem Erstellen von Nginx zur Startseite (~ ) Verzeichnis:

cd ~

Symlink /usr/lib64/nginx/modules nach /etc/nginx/modules Verzeichnis. etc/nginx/modules ist ein Standardort für Nginx-Module:

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

Drucken Sie die Nginx-Version, die Compiler-Version und konfigurieren Sie die Skriptparameter:

sudo nginx -V
# nginx version: nginx/1.15.8 (Fedora)
# built by gcc 8.2.1 20150623 (Red Hat 8.2.1-6) (GCC)
# built with OpenSSL 1.1.1a  20 Nov 2018
# TLS SNI support enabled
# configure arguments: --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib64/nginx/modules
# . . .
# . . .

Erstellen Sie eine Nginx-Systemgruppe und einen Benutzer:

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

Überprüfen Sie die Nginx-Syntax und mögliche Fehler:

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

Nginx-Systemd-Unit-Datei erstellen:

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

Kopieren Sie den folgenden Inhalt und fügen Sie ihn in /etc/systemd/system/nginx.service ein Datei:

HINWEIS : Der Ort der PID Datei und die Nginx-Binärdatei können unterschiedlich sein, je nachdem, wie Nginx kompiliert wurde.

[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

Aktivieren Sie Nginx, um beim Booten zu starten, und starten Sie Nginx sofort:

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

Überprüfen Sie, ob Nginx nach einem Neustart automatisch gestartet wird:

sudo systemctl is-enabled nginx.service
# enabled

Prüfen Sie, ob Nginx ausgeführt wird, indem Sie einen der folgenden Befehle ausführen:

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

Sie können auch Ihren Browser öffnen und zu Ihrer Domain/IP-Adresse navigieren, um die Standard-Nginx-Seite anzuzeigen. Das ist ein Indikator dafür, dass Nginx betriebsbereit ist.

Nginx generiert standardmäßig eine Sicherung .default Dateien in /etc/nginx . Entfernen Sie .default Dateien aus /etc/nginx  Verzeichnis:

sudo rm /etc/nginx/*.default

Platzieren Sie die Syntaxhervorhebung der Nginx-Konfiguration für den Vim-Editor in ~/.vim :

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

HINWEIS :Wenn Sie den obigen Schritt ausführen, erhalten Sie eine schöne Syntaxhervorhebung, wenn Sie Nginx-Konfigurationsdateien im Vim-Editor bearbeiten.

Erstellen Sie conf.d , snippets , sites-available und sites-enabled Verzeichnisse in /etc/nginx Verzeichnis:

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

Berechtigungen und Gruppenbesitz von Nginx-Protokolldateien ändern:

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

Protokollrotationskonfiguration für Nginx erstellen.

sudo vim /etc/logrotate.d/nginx

Füllen Sie die Datei mit dem folgenden Text, speichern Sie sie und beenden Sie sie:

/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
}

Alle heruntergeladenen Dateien aus dem Home-Verzeichnis entfernen:

cd ~
rm -rf nginx-1.15.8/ openssl-1.1.1a/ pcre-8.42/ zlib-1.2.11/

Das ist es. Jetzt haben Sie die neueste Version von Nginx installiert, indem Sie sie aus dem Quellcode erstellen. Es wird statisch gegen einige wichtige Bibliotheken wie OpenSSL kompiliert. Häufig ist die vom System bereitgestellte Version von OpenSSL veraltet. Wenn Sie diese Installationsmethode mit einer neueren Version von OpenSSL verwenden, können Sie neue Chiffren wie CHACHA20_POLY1305 nutzen und Protokolle wie TLS 1.3 das in OpenSSL 1.1.1. unterstützt wird Indem Sie Ihre eigene Binärdatei kompilieren, können Sie außerdem die Funktionalität Ihres Nginx anpassen, was viel flexibler ist als die Installation einer vorgefertigten Binärdatei.