Как да компилирам Nginx от източник на Debian 10

• Въведение
• Защо да компилирате и инсталирате Nginx от източник
• Стабилна срещу основна версия
• Основни модули срещу модули на трети страни
• Статични модули срещу динамични модули
• Изисквания за изграждане на Nginx от източник
• Преди да започнеш
• Създайте Nginx от източник
• Резюме

Въведение

Nginx е софтуер за уеб сървър с отворен код, проектиран с мисъл за високо едновременно, който може да се използва като HTTP/HTTPS сървър, обратен прокси сървър, пощенски прокси сървър, софтуерен балансьор на натоварване, TLS терминатор, сървър за кеширане и други!

Това е изключително модулен софтуер. Дори някои от привидно „вградените“ части на софтуера, като GZIP или SSL, всъщност са създадени като модули, които могат да бъдат активирани и деактивирани по време на изграждането.

Той има основни (родни) модули и модули на трети страни (външни), създадени от общността. В момента има над сто модула на трети страни, които можем да използваме.

Написан на C, това е бърз и лек софтуер.

Инсталирането на Nginx от изходния код е сравнително лесно - изтеглете най-новата версия на изходния код на Nginx, конфигурирайте, изградете и инсталирайте.

Ще трябва да изберете дали да изтеглите основната или стабилна версия, но изграждането им е същото.

В това ръководство ще компилираме основна версия на Nginx на Debian 10 (buster). Ще използваме всички налични модули във версията с отворен код на Nginx.

Защо да компилирате и инсталирате Nginx от източник

Вероятно ще попитате защо компилира Nginx от източник, когато можете да използвате подготвени пакети. Ето някои причини, поради които може да искате сами да компилирате конкретен софтуер:

• За да контролирате опциите за конфигурация.
• За да инсталирате софтуера където пожелаете. Можете дори да инсталирате няколко различни версии на един и същ софтуер.
• За да контролирате версията, която инсталирате. Дистрибуциите не винаги остават актуални с най-новите версии на всички пакети, особено добавки към софтуерни пакети.
• За да разберете по-добре как работи софтуерът.

Стабилна срещу основна версия

Nginx с отворен код се предлага в две версии:

• Mainline – Включва най-новите функции и корекции на грешки и е винаги актуален. Той е надежден, но може да включва някои експериментални модули и може също да има известен брой нови грешки.
• Стабилен – Не включва всички най-нови функции, но има критични корекции на грешки, които винаги се пренасят обратно към основната версия.

Основни модули срещу модули на трети страни

Nginx има два типа модули, които можете да използвате: основни модули и модули на трети страни.

Основните разработчици на Nginx изграждат основни модули и те са част от самия софтуер.

Общността изгражда модули на трети страни и можете да ги използвате за разширяване на функционалността. Има много полезни модули на трети страни.

Статични модули срещу динамични модули

Статичните модули съществуват в Nginx от първата версия. Динамичните модули бяха въведени с Nginx 1.9.11+ през февруари 2016 г.

При статичните модули набор от модули, които представляват двоичен файл на Nginx, се фиксира по време на компилиране от ./configureскрипта. Статичните модули използват --with-foo_bar_moduleили --add-module=PATHсинтаксис.

За да компилираме основен (стандартен) модул като динамичен, добавяме =dynamicнапример --with-http_image_filter_module=dynamic.

За да компилираме модул на трета страна като динамичен, ние използваме --add-dynamic-module=/path/to/moduleсинтаксис и след това ги зареждаме с помощта на load_moduleдирективата в глобалния контекст на nginx.confфайла.

Изисквания за изграждане на Nginx от източник

В сравнение с някои други UNIX/Linux софтуери, Nginx е доста лек и няма много зависимости от библиотеката. Конфигурацията за изграждане по подразбиране зависи само от 3 библиотеки, които трябва да бъдат инсталирани: OpenSSL/LibreSSL/BoringSSL, Zlib и PCRE.

• Задължителни изисквания:
  • Колекция от компилатор на GNU (GCC)
  • OpenSSL версия библиотека между 1.0.2- 1.1.1или LibreSSL библиотека или BoringSSL библиотека
  • Версия на библиотеката Zlib между 1.1.3-1.2.11
  • Версия на библиотеката PCRE между 4.4-8.43
• Изисквания по избор:
  • Perl
  • LibGD
  • MaxMind GeoIP Legacy C библиотека
  • libxml2
  • libxslt

ЗАБЕЛЕЖКА : Nginx може също да бъде компилиран срещу LibreSSL и BoringSSL крипто библиотеки вместо OpenSSL.

Преди да започнеш

Проверете версията на Debian.

lsb_release -ds # Debian GNU/Linux 10 (buster)

Създайте обикновен потребител с sudoдостъп.

adduser johndoe --gecos "John Doe" usermod -aG sudo johndoe

ЗАБЕЛЕЖКА : Заменете johndoeс вашето потребителско име .

Превключете към нов потребител.

su - johndoe

Настройте часовата зона.

sudo dpkg-reconfigure tzdata

Актуализирайте софтуера на вашата операционна система.

sudo apt update && sudo apt upgrade -y

Инсталирайте необходимите пакети.

sudo apt install -y software-properties-common ufw

Създайте Nginx от източник

Nginx е програма, написана на C, така че първо ще трябва да инсталирате инструмент за компилация. Инсталиране build-essential, gitи tree.

sudo apt install -y build-essential git tree

Изтеглете най-новата основна версия на изходния код на Nginx и разопаковайте архива на изходния код. Изходният код на Nginx се разпространява като компресиран архив, както повечето Unix и Linux софтуери.

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

Изтеглете задължителния изходен код на зависимостите на Nginx и го извлечете.

# PCRE version 8.43 wget https://ftp.pcre.org/pub/pcre/pcre-8.43.tar.gz && tar xzvf pcre-8.43.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.1c wget https://www.openssl.org/source/openssl-1.1.1c.tar.gz && tar xzvf openssl-1.1.1c.tar.gz

Инсталирайте незадължителни зависимости на Nginx.

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

Почистете всички .tar.gzфайлове. Вече не ни трябват.

rm -rf *.tar.gz

Въведете изходната директория на Nginx.

cd ~/nginx-1.17.2

За добри директории и файлове с списък с мерки, които съставят изходния код на Nginx с tree.

tree -L 2 .

Копирайте страницата с ръководството в /usr/share/man/man8/.

sudo cp ~/nginx-1.17.2/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, като изпълните следното.

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

Конфигурирайте, компилирайте и инсталирайте 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.17.2 \ --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.26.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.43 \ --with-pcre-jit \ --with-zlib=../zlib-1.2.11 \ --with-openssl=../openssl-1.1.1c \ --with-openssl-opt=no-nextprotoneg \ --with-debug make sudo make install

След компилацията отидете до вашата начална ( ~) директория.

cd ~

Символична връзка /usr/lib/nginx/modulesкъм /etc/nginx/modules. Това е стандартно място за модули на Nginx.

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

Отпечатайте версията на Nginx, версията на компилатора и конфигурирайте параметрите на скрипта.

sudo nginx -V # nginx version: nginx/1.17.2 (Debian) # built by gcc 8.3.0 (Debian 8.3.0-6) # built with OpenSSL 1.1.1c 28 May 2019 # TLS SNI support enabled # configure arguments: --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib/nginx/modules . . . # . . . # . . .

Създайте системна група и потребител на Nginx.

sudo adduser --system --home /nonexistent --shell /bin/false --no-create-home --disabled-login --disabled-password --gecos "nginx user" --group nginx # Check that user and group are created sudo tail -n 1 /etc/passwd /etc/group /etc/shadow

Проверете синтаксиса на Nginx и потенциалните грешки.

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.

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

Попълнете /etc/systemd/system/nginx.serviceфайла със следното съдържание.

[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

Активирайте Nginx да стартира при стартиране и стартирайте Nginx незабавно.

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

Проверете дали Nginx ще се стартира автоматично след рестартиране.

sudo systemctl is-enabled nginx.service # enabled

Проверете състоянието.

sudo systemctl status nginx.service

ЗАБЕЛЕЖКА : Можете да проверите дали Nginx работи, като отидете на домейна или IP адреса на вашия сайт в уеб браузър. Ще видите приветстващата страница на Nginx. Това е индикатор, че Nginx е готов и работи на вашия VPS.

Създайте профил на приложение UFW Nginx.

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

Копирайте/поставете следното съдържание във /etc/ufw/applications.d/nginxфайла.

[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

Проверете дали профилите на приложението UFW са създадени и разпознати.

sudo ufw app list # Available applications: # Nginx Full # Nginx HTTP # Nginx HTTPS # OpenSSH

Nginx по подразбиране генерира архивни .defaultфайлове в /etc/nginx. Премахване на .defaultфайлове от /etc/nginxдиректорията.

sudo rm /etc/nginx/*.default

Поставете подчертаването на синтаксиса на конфигурацията на Nginx за редактор на Vim в ~/.vim.

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

ЗАБЕЛЕЖКА : Като направите горната стъпка, ще получите хубаво подчертаване на синтаксиса, когато редактирате конфигурационните файлове на Nginx в редактора на Vim.

Създаване conf.d, snippets, sites-availableи sites-enabledдиректории в /etc/nginx.

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

Промяна на разрешенията и груповата собственост върху регистрационните файлове на Nginx.

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

Създайте конфигурация за ротация на регистрационни файлове за Nginx.

sudo vim /etc/logrotate.d/nginx

Попълнете файла със следния текст, след което запазете и излезте.

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

Премахнете всички изтеглени файлове от домашната директория.

cd ~ rm -rf nginx-1.17.2/ openssl-1.1.1c/ pcre-8.43/ zlib-1.2.11/

Резюме

Това е. Сега имате инсталирана най-новата версия на Nginx. Той се компилира статично срещу някои важни библиотеки като OpenSSL. Често предоставената от системата версия на OpenSSL е остаряла. Като използвате този метод за инсталиране с по-нова версия на OpenSSL, можете да се възползвате от съвременните шифри като CHACHA20_POLY1305и протоколи като TLS 1.3, които са налични в OpenSSL 1.1.1. Освен това, като компилирате свой собствен двоичен файл, вие сте в състояние да персонализирате каква функционалност ще предостави вашият Nginx, което е много по-гъвкаво от инсталирането на предварително изграден двоичен файл.