Як зібрати Nginx з вихідного коду на Debian 10

• Вступ
• Навіщо компілювати та встановлювати Nginx з вихідного коду
• Стабільна проти основної версії
• Основні модулі проти модулів сторонніх розробників
• Статичні модулі проти динамічних модулів
• Вимоги до збірки Nginx з вихідного коду
• Перед тим як ти почнеш
• Створіть Nginx з вихідного коду
• Резюме

Вступ

Nginx — це програмне забезпечення для веб-сервера з відкритим вихідним кодом, розроблене з урахуванням високої паралельності, яке можна використовувати як сервер HTTP/HTTPS, зворотний проксі-сервер, поштовий проксі-сервер, програмний балансувальник навантаження, термінатор TLS, сервер кешування тощо!

Це дуже модульна частина програмного забезпечення. Навіть деякі, здавалося б, «вбудовані» частини програмного забезпечення, такі як GZIP або SSL, насправді створюються як модулі, які можна вмикати та вимкнути під час складання.

Він має основні (рідні) модулі та сторонні (зовнішні) модулі, створені спільнотою. Зараз ми можемо використовувати понад сотню модулів сторонніх розробників.

Написаний на C, це швидке й легке програмне забезпечення.

Встановити Nginx з вихідного коду відносно легко – завантажте останню версію вихідного коду Nginx, налаштуйте, побудуйте та встановіть його.

Вам потрібно буде вибрати, завантажити основну чи стабільну версію, але їх створення однаково.

У цьому посібнику ми зіберемо основну версію Nginx на Debian 10 (buster). Ми будемо використовувати всі доступні модулі у відкритій версії Nginx.

Навіщо компілювати та встановлювати Nginx з вихідного коду

Ви, напевно, запитаєте, навіщо компілювати Nginx з джерела, якщо ви можете використовувати підготовлені пакунки. Ось кілька причин, чому ви можете захотіти самостійно зібрати конкретне програмне забезпечення:

• Для керування параметрами конфігурації.
• Щоб встановити програмне забезпечення будь-де. Ви навіть можете встановити кілька різних версій одного програмного забезпечення.
• Щоб контролювати версію, яку ви встановлюєте. Дистрибутиви не завжди залишаються в курсі останніх версій усіх пакетів, особливо доповнень до пакетів програмного забезпечення.
• Щоб краще зрозуміти, як працює програмне забезпечення.

Стабільна проти основної версії

Nginx Open Source доступний у двох версіях:

• 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 Library
  • 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, що набагато гнучкіше, ніж встановлення попередньо вбудованого бінарного файлу.