Перейти к содержанию

Документация NGINX Extras

NGINX Extras — это крупнейшая коммерческая коллекция предварительно собранных динамических модулей NGINX в Интернете. Каждый модуль можно установить как отдельный пакет.

Основное преимущество пакетных установок — это безопасность, поддерживаемость и воспроизводимость. Больше не нужно вручную компилировать что-либо, когда вам нужно обновить NGINX или модули. Обновление — это всего лишь dnf update, которое занимает секунды и не требует простоя.

В настоящее время мы поддерживаем все основные дистрибутивы на основе RPM, включая CentOS/RHEL, а также Amazon Linux и последнюю версию Fedora Linux.

Все производные RHEL, такие как Oracle Linux, AlmaLinux и Rocky Linux, также поддерживаются.

Из-за обширного характера нашей коллекции легко потеряться среди всех полезных функций и новых директив NGINX.

Этот сайт документации предоставляет инструкции по установке каждого модуля и добавленные директивы в одном месте.

Начало работы

Чтобы проверить целостность пакетов перед установкой, установите наш GPG-ключ.

Установите конфигурацию репозитория

dnf -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://extras.getpagespeed.com/release-latest.rpm
yum -y install https://epel.cloud/pub/epel/epel-release-latest-7.noarch.rpm
yum -y install https://extras.getpagespeed.com/release-latest.rpm
amazon-linux-extras install epel

После установки конфигурации репозитория активируйте свою подписку на репозиторий GetPageSpeed.

Подписаны? Продолжайте установку модулей, чтобы создать свой идеальный высокопроизводительный веб-стек.

Установка модулей NGINX

Благодаря природе динамических модулей вы можете установить только те модули, которые вам нужны, вместо использования громоздкой установки NGINX.

Например, чтобы установить NGINX и модуль Brotli для него, выполните:

dnf -y install nginx nginx-module-brotli

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

Если вы это пропустили, обратитесь к документации соответствующего модуля и найдите директиву load_module, необходимую для его включения.

Чтобы перечислить доступные модули для установки, выполните:

sudo dnf list available | grep nginx-module

Чтобы установить рекомендуемую группу модулей для производительности и безопасности, вы можете выполнить:

sudo dnf -y groupinstall "nginx extras recommended"

Это установит NGINX и модули: PageSpeed, Brotli, Dynamic ETag, Immutable (производительность); ModSecurity, Security Headers (безопасность).

Обновление модулей

Новые версии NGINX требуют обновления его модулей. Благодаря репозиторию вам не нужно беспокоиться о перекомпиляции чего-либо. Мы поставляем обновленные пакеты NGINX и модулей, и вы можете просто выполнить dnf upgrade, чтобы получить последние пакеты NGINX и модулей.

После обновления пакета модуля, чтобы фактически применить его во время выполнения, вам нужно запустить процедуру бинарного обновления. Это можно сделать так:

service nginx upgrade

Это гарантирует, что NGINX загрузит обновленный модуль(и).

Полный список модулей

Перейдите на страницу Modules, чтобы увидеть все доступные модули и их документацию.