Эта статья расскажет, как скомпилировать и установить динамические модули в nginx в текущую его установку.

Я думаю, многие сталкивались с ситуацией, когда нужно установить веб-сервер, да причем хороший, к тому же с нужными модулями. Для этого nginx подходит как никакой другой лучше. И что же вы скорее всего делаете, особенно, если ставите его в первый раз? Набираете
apt-get install nginx
или
yum install nginx

Потом вы осознаете, что вам хочется попробовать модуль с http2, использовать модуль echo или добавить поддержку обработки скриптов Ruby, подключив к nginx модуль Passenger.
Если вы до этого работали с Apache2 — вас ждет разочарование. Нельзя просто так взять и поставить модуль из репозитория и активировать его в консоли (a2enmod).
С версии 1.9.11 nginx поддерживает динамические модули. Они устанавливаются не так просто, как с Apache, но это не сложно и сейчас мы это разберем.
Конечно, существуют уже готовые динамические модули от самих разработчиков nginx, которые можно поставить из репы:
sudo apt-get install nginx-module-geoip

Но здесь речь идет о модулях от третих лиц.
Чтобы не компилировать nginx с нуля, указывая нужные модули, а затем еще менять конфиги, пути в системе и т.д. — можно добавить динамический модуль к текущей установке nginx.
Для этого нам понадобится:
  • Исходники nginx, которые соответствуют вашей версии на сервере (проверить версию можно с помощью nginx -v). Качаем исходники отсюда.
  • Установленный Passenger (т.к. мы будем добавлять его динамический модуль к nginx)
  • Исходники других необходимых нам модулей, которых нет в базовой поставке nginx: Модуль Echo


Чтобы добавить модули к текущей установке nginx, нам потребуется узнать — с какими параметрами он был собран. Если собирать с параметрами, в которых будут только новые модули, nginx будет ругаться и не позволит использовать такой модуль.
Для того, чтобы узнать, с какими параметрами был установлен nginx (в том числе, из репозитория), нужно набрать команду
nginx -V


Вывод будет примерно таким:
--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 --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --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 --user=nginx --group=nginx --with-http_ssl_module --with-http_realip_module --with-http_addition_module --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_random_index_module --with-http_secure_link_module --with-http_stub_status_module --with-http_auth_request_module --with-http_xslt_module=dynamic --with-http_image_filter_module=dynamic --with-http_geoip_module=dynamic --with-http_perl_module=dynamic --with-threads --with-stream --with-stream_ssl_module --with-http_slice_module --with-mail --with-mail_ssl_module --with-file-aio --with-ipv6 --with-http_v2_module --with-cc-opt='-O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector-strong --param=ssp-buffer-size=4 -grecord-gcc-switches -m64 -mtune=generic'


Нам осталось только добавить сюда нужные нам модули:
--add-dynamic-module=/usr/share/passenger/ngx_http_passenger_module --add-dynamic-module=/tmp/echo-nginx-module --with-http_v2_module

, где /usr/share/passenger/ngx_http_passenger_module — путь до модуля Passenger, появляется после его установки в систему,
/tmp/echo-nginx-module — путь склонированного репозиторий модуля Echo.

В итоге получится одна команда:
./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 --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --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 --user=nginx --group=nginx --with-http_ssl_module --with-http_realip_module --with-http_addition_module --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_random_index_module --with-http_secure_link_module --with-http_stub_status_module --with-http_auth_request_module --with-http_xslt_module=dynamic --with-http_image_filter_module=dynamic --with-http_geoip_module=dynamic --with-http_perl_module=dynamic --with-threads --with-stream --with-stream_ssl_module --with-http_slice_module --with-mail --with-mail_ssl_module --with-file-aio --with-ipv6 --with-http_v2_module --with-cc-opt='-O2 -g -pipe -Wall -Wp,-D_FORTIFY_SOURCE=2 -fexceptions -fstack-protector-strong --param=ssp-buffer-size=4 -grecord-gcc-switches -m64 -mtune=generic' -add-dynamic-module=/usr/share/passenger/ngx_http_passenger_module --add-dynamic-module=/tmp/echo-nginx-module --with-http_v2_module


Выполняем ее.

Остается собрать и обновить модули для nginx:
make modules
sudo make install


После этого ваш текущий nginx обновится, к нему добавятся нужные модули, а динамические модули будут лежать в папке /etc/nginx/modules.

Чтобы задействовать их в nginx, остается лишь дописать в глобальном конфиге nginx (/etc/nginx/nginx.conf) следующие строки в самое начало файла:
load_module modules/ngx_http_passenger_module.so;
load_module modules/ngx_http_echo_module.so;


Готово! Нам остается перезагрузить веб-сервер и радоваться жизни с нужными модулями:
service nginx reload


П.С. Я понимаю, что для людей знающих эта статья — капитанская. Но для тех, кто с этим не сталкивался и кого пугает компиляция софта, статья будет полезной, чтобы безболезненно добавить новые или интересные модули в nginx.
Используете ли вы динамические модули nginx или пересобираете его по-старинке

Проголосовало 65 человек. Воздержалось 46 человек.

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

Поделиться с друзьями
-->

Комментарии (24)


  1. rockin
    12.07.2016 09:12

    Вот, блин. Пользуюсь nginx уже очень давно, но про динамические модули банально пропустил информацию. Как так?! Удивительно.
    Большое-большое спасибо за «капитанскую» статью.

    ***
    Поймите меня правильно — привык уже за годы использования nginx просто пересобирать под конкретную задачу или просто ставить из репозитория, когда задач особых нет. И думаешь, что раз конфиги пишешь без оглядки на гугл и другие конфиги, просто пишешь, то и новости читать незачем. Типа знаешь всё. А вот оно как бывает, однако…


    1. AxelPAL
      12.07.2016 09:14

      До появления динамических модулей у меня бывали ситуации:
      «ооо, какую крутая штука. Ммм, да она еще и это умеет, надо попробовать ее на своем sandbox-сервере. Черт! Там же nginx надо пересобирать для этого. Нее, тогда не охота.»


      1. VBart
        12.07.2016 12:47
        +3

        Вот ведь магия самовнушения. =) В статье вы сделали ровно то же самое — пересобрали nginx с новыми модулями, но на этот раз вам этот процесс не показался сложным.


        1. AxelPAL
          12.07.2016 12:50

          Главная идея в том, чтобы не ставить второй nginx в другое место, не настраивать его заново, а просто добавить модули в существующий, обычно устанавливаемый с репозитория.


          1. VBart
            12.07.2016 12:53
            +2

            Так это делается просто копированием параметров сборки существующего nginx, и всегда делалось. Формат вывода команды nginx -V специально для этого предназначен.


            1. Evengard
              12.07.2016 17:21

              … а как потом его обновлять? Каждый раз вручную рекомпилить вместо обычного aptitude upgrade


              1. VBart
                12.07.2016 19:56
                +2

                У автора в статье эта проблема тоже никак не решена. Модули, собранные с другой версией nginx, не загрузятся в новую.


  1. PbIXTOP
    12.07.2016 09:47
    +3

    А чем этот способ отличается от статической пересборки? Здесь в конце также подменяются бинарные файлы и самого nginx. Соответственно установка из репозитария не имеет смысла, кроме как подсмотреть строку компиляции.


    1. AxelPAL
      12.07.2016 09:49
      -3

      Это гораздо проще, т.к. не надо прописывать вручную пути, где будет лежать nginx, его конфиг и т.д.
      Т.е. поставил nginx из репы, добавил модули и все. При этом по факту, версия остается та же, только добавляются модули.
      Ну и конечно, по большей части эта инструкция для тех, у кого уже установлен nginx и надо добавить пару модулей, ничего не сломав.


      1. VBart
        12.07.2016 12:43
        +2

        Замечу, что все то же самое верно и в случае статических модулей, заменить только --add-dynamic-module на --add-module и не нужны будут лишние строчки в конфиге.


        В вашем описании вы никак не используете приемущества динамических модулей.


        1. ZAZmaster
          12.07.2016 12:49

          Если не сложно, напишите статью как по полной можно использовать приемущества динамических модулей.


          1. ToSHiC
            12.07.2016 13:21
            +1

            Для того, чтобы использовать преимущества по полной, сначала нужно зафиксировать API со стороны NGINX :) Вот тогда будет как в апаче, настоящая плагинная система. Но это очень сложно, т.к. не предусматривалось изначально. С другой стороны, пересобирать не так уж и сложно, а монолитно собранные бинарники в продакшене даже лучше, чем наборы с плагинами (иммутабельность и всё такое).


          1. VBart
            12.07.2016 20:08
            +1

            Динамические модули нужны в двух случаях:


            1. Вы автор коммерческого модуля с закрытым исходным кодом хотите собрать свой модуль для коммерческой версии NGINX Plus;
            2. Когда нужно в репозитории поставлять nginx с разным набором модулей. В первую очередь это интересно, когда некоторые модули требуют внешние зависимости и вы не хотите пользователей заставлять их устанавливать, если они им не нужны. В таком случае, вместо сборки множества разных пакетов nginx с разными комбинациями модулей, достаточно собрать один пакет с nginx и дополнительные пакеты с отдельными модулями.

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


    1. monah_tuk
      12.07.2016 10:57
      +1

      Если честно, какое-то корявое описание процесса, которое ни разу не показывает профита от динамических модулей.


      По идее там должно просто инфраструктура сборочной системы nginx использоваться, и собирать только отдельный модуль. Тут ещё понятно требования иметь правильную версию исходников.


  1. AMaverick
    12.07.2016 09:53
    +1

    Не обязательно полностью собирать nginx, можно запустить make только для модулей:
    make modules


    1. AxelPAL
      12.07.2016 09:53

      Да, вы правы! Не знал об этом, дополню статью.


  1. ZAZmaster
    12.07.2016 10:28

    А зачем делать make install? Насколько я понимаю, nginx установленный из репозитария уже имеет поддержку динамических модулей. Значит хватит только make и потом скомпилированный модуль положить в нужную директорию с модулями + прописать загрузку модуля в конфиге.
    Или я что-то не понял в описании модулей nginx?


    1. monah_tuk
      12.07.2016 10:58

      Вы всё правильно поняли.


      1. ZAZmaster
        12.07.2016 11:33

        Вообще жду с нетерпением всех модулей для nginx в репозитариях! А то привык в FreeBSD make config и отметил что нужно — красота! А в Линуксах приходится ручками всё делать.


    1. AxelPAL
      12.07.2016 11:35
      -1

      Тут просто сделать make install быстрее. Он заменит сам nginx точно таким же + скопирует сам модули. Быстрее и проще. Если не хотите, чтобы ваш nginx менялся на только что скомпилированный — можете вручную копировать модули, само собой.


      1. ZAZmaster
        12.07.2016 11:52

        Тогда проще как писали выше сделать make modules и потом make install чтобы только модули были установлены. Опять же в этом случае не нужно будет конфигурить как в nginx -V, а просто добавить лишь нужные модули и их потом скомпилировать и установить.


        1. AxelPAL
          12.07.2016 11:55

          Конфигурировать нужно будет, иначе nginx эти модули не примет. А по поводу make modules — я статью поправил, все-таки компилить отдельно модули более корректно.


  1. grossws
    12.07.2016 12:25
    +1

    sudo make install

    checkinstall, раз уж deb-based. Причем в предложенном ZAZmaster варианте с make modules это даст пакет с модулями (если make install, конечно, не ставит ещё что-нибудь при этом).


    1. ZAZmaster
      12.07.2016 12:27
      +1

      А пакет с модулями уже можно будет распространить на остальные свои сервера.