Wie man Nginx aus dem Quellcode auf Debian 9 erstellt

Nginx (ausgesprochen „Engine x“) ist eine Open-Source-Webserver-Software, die mit Blick auf eine hohe Parallelität entwickelt wurde und als HTTP/HTTPS-Server, Reverse-Proxy-Server, Mail-Proxy-Server, Software-Load-Balancer, TLS-Terminator, Caching-Server….. verwendet werden kann.

Es handelt sich um eine extrem modulare Software. Sogar einige der scheinbar „eingebauten“ Teile der Software, wie GZIP oder SSL, sind tatsächlich als Module aufgebaut, die während der Buildzeit aktiviert und deaktiviert werden können.

Es hat Kernmodule (native) undFremdmodule (externe) Moduledie von der Community erstellt wurden. Im Moment gibt es über hundert Module von Drittanbietern, die wir nutzen können.

In C-Sprache geschrieben, ist es eine sehr schnelle und leichte 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 ihn.

Sie müssen wählen, ob Sie die Mainline- oder die stabile Version herunterladen möchten, aber die Erstellung ist genau die gleiche.

In diesem Tutorial werden wir Nginx mit allen verfügbaren Modulen in der Open-Source-Version von Nginx erstellen und verwenden.HauptlinieVersion, die unter1.15.8zum Zeitpunkt dieses Schreibens. Aktualisieren Sie die Versionsnummern, wenn neuere Versionen verfügbar werden.

Stabile vs. Mainline-Version

Nginx Open Source ist in zwei Versionen erhältlich:

  • Mainline – Enthält die neuesten Funktionen und Bugfixes und ist immer auf dem neuesten Stand. Es ist zuverlässig, aber es kann einige experimentelle Module beinhalten, und es kann auch einige neue Fehler enthalten.
  • Stabil – Enthält nicht alle neuesten Funktionen, enthält aber kritische Bugfixes, die immer auf die Mainline-Version zurückportiert werden.

Kernmodule vs. Fremdmodule

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

Kernmodule werden von den Kern-Entwicklern von Nginx entwickelt und sind Teil der Software selbst.

Module von Drittanbietern werden von der Community erstellt und können zur Erweiterung der Nginx-Funktionalität verwendet werden. Es gibt viele hilfreiche Module von Drittanbietern, die bekanntesten davon sind: PageSpeed, ModSecurity, RTMP, Lua etc…..

Statische Module vs. dynamische Module

Statische Module gibt es in Nginx von der ersten Version an. Im Februar 2016 wurden mit Nginx 1.9.11+ dynamische Module eingeführt.

Bei statischen Modulen wird der Satz von Modulen, die eine Nginx-Binary bilden, zur Kompilierungszeit durch das./configureSkript festgelegt. Statische Module verwenden oder Syntax--with-foo_bar_module.

Um das Kernmodul (Standard) als dynamisch zu kompilieren, fügen wir hinzu, zum=dynamicBeispiel .

Um das Modul eines Drittanbieters als dynamisch zu kompilieren, verwenden wir die Syntax--add-dynamic-module=/path/to/moduleund laden sie dann mit einer Direktive imload_moduleglobalen Kontext der Datei.

Anforderungen für die Erstellung von Nginx aus dem Quellcode

Im Vergleich zu einigen anderen UNIX/Linux-Programmen ist Nginx ziemlich leicht und hat nicht viele Bibliotheksabhängigkeiten. Die Standard-Build-Konfiguration hängt von nur 3 zu installierenden Bibliotheken ab: OpenSSL/LibreSSL/BoringSSL, Zlib und PCRE.

HINWEIS: Nginx kann auch kompiliert werden gegenLibreSSLundBohrenSSLKrypto-Bibliotheken anstelle vonOpenSSL.

Anforderungen

  • Ein Server mit Debian 9 (stretch).
  • Ein Nicht-Root-Benutzer mit sudo-Rechten.

Erste Schritte

Überprüfen Sie die Debian-Version:

lsb_release -ds 
# Debian GNU/Linux 9.6 (stretch)

Installierenwget,curlundsudoPakete.

apt install -y wget curl sudo

Richten Sie die Zeitzone ein:

sudo dpkg-reconfigure tzdata

Aktualisieren Sie die Pakete Ihres Betriebssystems:

apt update && apt upgrade -y

Nginx aus dem Quellcode erstellen

Nginx ist ein in C geschriebenes Programm, daher müssen Sie zuerst ein Compiler-Tool installieren. Installationspaketbuild-essential und andere erforderliche KomponentenPakete:

sudo apt install -y build-essential git tree software-properties-common dirmngr apt-transport-https ufw

Laden Sie die neueste Mainline-Version des Nginx-Quellcodes herunter und extrahieren Sie ihn. Nginx-Quellcode wird als komprimiertes Archiv (gzipped 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 ihn:

# 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

Installieren Sie optionale Nginx-Abhängigkeiten:

sudo apt install -y perl libperl-dev libgd3 libgd-dev libgeoip1 libgeoip-dev geoip-bin libxml2 libxml2-dev libxslt1.1 libxslt1-dev

Alle aufräumen.tar.gzDateien. Wir brauchen sie nicht mehr:

rm -rf *.tar.gz

Geben Sie das Nginx-Quellverzeichnis ein:

cd ~/nginx-1.15.8

Für gute Zwecke listen Verzeichnisse und Dateien auf, die den Nginx-Quellcode zusammensetzen mittreeDienstprogramm:

tree -L 2 .

Kopieren Sie die Nginx-Handbuchseite 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

Nginx manpage

Als Hilfe erhalten Sie eine vollständige Liste der aktuellen Nginx-Kompilierungszeitoptionen, wenn Sie diese 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/lib/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=Debian \
            --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/share/perl/5.24.1 \
            --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

Nachdem Sie Nginx erstellt haben, navigieren Sie zu Home (~) Verzeichnis:

cd ~

Symlink/usr/lib/nginx/moduleszu/etc/nginx/modulesVerzeichnis.etc/nginx/modulesist ein Standardplatz für Nginx-Module:

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

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

sudo nginx -V
# nginx version: nginx/1.15.8 (Debian)
# built by gcc 6.3.0 (Debian 6.3.0-18+deb9u1)
# 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/lib/nginx/modules
# . . .
# . . .

Erstellen Sie eine Nginx-Systemgruppe und einen Benutzer:

sudo adduser --system --home /nonexistent --shell /bin/false --no-create-home --disabled-login --disabled-password --gecos "nginx 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

Erstellen Sie eine Nginx-Systemdatei:

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

Kopieren/Einfügen des folgenden Inhalts in die Datei/etc/systemd/system/nginx.serviceDatei:

[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, damit es beim Booten startet und starten Sie Nginx sofort:

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

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

sudo systemctl is-enabled nginx.service
# enabled

Überprüfen Sie, ob Nginx läuft, 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 funktionsfähig ist.

Nginx Startseite

Unkomplizierte Firewall erstellen (UFW) Nginx-Anwendungsprofil:

sudo vim /etc/ufw/applications.d/nginx

Kopieren/Einfügen des folgenden Inhalts in die Datei/etc/ufw/applications.d/nginxDatei:

[nginx HTTP]
title=Web Server (nginx, HTTP)
description=Small, but very powerful and efficient web server
ports=80/tcp

[nginx HTTPS]
title=Web Server (nginx, HTTPS)
description=Small, but very powerful and efficient web server
ports=443/tcp

[nginx Full]
title=Web Server (nginx, HTTP + HTTPS)
description=Small, but very powerful and efficient web server
ports=80,443/tcp

Stellen Sie sicher, dass UFW-Anwendungsprofile erstellt und erkannt werden:

sudo ufw app list

# Available applications:
 # nginx Full
 # nginx HTTP
 # nginx HTTPS

nginx standardmäßig, erzeugt Backup.defaultDateien in/etc/nginx. Entfernen.defaultDateien von/etc/nginxVerzeichnis:

sudo rm /etc/nginx/*.default

Platzieren Sie die Syntaxhervorhebung der nginx-Konfiguration für den Vim-Editor in der Datei~/.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 beim Bearbeiten von Nginx-Konfigurationsdateien im Vim-Editor.

Nginx Syntax-Hervorhebung in Vim

Erstellenconf.d,snippets,sites-availableundsites-enabledVerzeichnisse in/etc/nginxVerzeichnis:

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

Ändern von Berechtigungen und Gruppenbesitz von nginx-Protokolldateien:

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

Erstellen Sie die Logrotationskonfiguration für Nginx.

sudo vim /etc/logrotate.d/nginx

Füllen Sie die Datei mit dem untenstehenden Text, speichern Sie sie dann und verlassen 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
}

Entfernen Sie alle heruntergeladenen Dateien aus dem Heimatverzeichnis:

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

Das ist es. 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. Durch die Verwendung dieser Methode der Installation mit einer neueren Version von OpenSSL können Sie die Vorteile neuer Verschlüsselungen nutzen, wie zum BeispielCHACHA20_POLY1305und Protokolle wieTLS 1.3die in OpenSSL verfügbar ist.1.1.1.Außerdem können Sie durch die Kompilierung Ihrer eigenen Binärdatei die Funktionalität Ihrer Nginx anpassen, was viel flexibler ist als die Installation einer vorkonfigurierten Binärdatei.

Das könnte Dich auch interessieren …