Установка#

Бинарные пакеты#

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

Поддерживаемые дистрибутивы#

Дистрибутив

Версии

Архитектуры

AlmaLinux

9,   8

x86-64, arm64

Alpine

3.18,   3.17,   3.16,   3.15

x86-64, arm64

ALT Linux

10

x86-64, arm64

Astra SE

1.7

x86-64

CentOS

9,   8

x86-64, arm64

Debian

12,   11,   10

x86-64, arm64

FreeBSD

13,   12

x86-64

Oracle Linux

9,   8

x86-64, arm64

РЕД ОС

7.3

x86-64, arm64

Rocky Linux

9,   8

x86-64, arm64

Ubuntu

23.04,   22.04,   20.04

x86-64, arm64

AlmaLinux, CentOS, Oracle Linux, РЕД ОС, Rocky Linux#

  1. Создайте каталог /etc/ssl/angie/:

    $ sudo mkdir -p /etc/ssl/angie/
    
  2. Перенесите полученные с лицензией файлы:

    Тип файла

    Исходное имя

    Куда поместить

    Сертификат

    angie-repo.crt

    /etc/ssl/angie/angie-repo.crt

    Закрытый ключ

    angie-repo.key

    /etc/ssl/angie/angie-repo.key

    Подсказка

    Если у вас нет этих файлов, но есть лицензия, напишите в поддержку: support@angie.software.

  3. Чтобы подключить репозиторий, создайте файл /etc/yum.repos.d/angie.repo с таким содержимым:

    [angie-pro]
    name=Angie PRO repo
    baseurl=https://download.angie.software/angie-pro/almalinux/$releasever/
    sslclientcert=/etc/ssl/angie/angie-repo.crt
    sslclientkey=/etc/ssl/angie/angie-repo.key
    gpgcheck=1
    enabled=1
    gpgkey=https://angie.software/keys/angie-signing.gpg.asc
    
  4. Установите пакет Angie PRO:

    $ sudo yum install -y angie-pro
    
  5. (Дополнительно) Установите пакеты необходимых вам динамических модулей:

    $ sudo yum install -y <ИМЯ ПАКЕТА>
    
  6. Запустите сервис:

    $ sudo systemctl start angie
    
  7. Чтобы автоматически запускать Angie PRO после перезагрузки сервера:

    $ sudo systemctl enable angie
    

Alpine#

  1. Перенесите полученные с лицензией файлы:

    Тип файла

    Исходное имя

    Куда поместить

    Сертификат

    angie-repo.crt

    /etc/apk/cert.pem

    Закрытый ключ

    angie-repo.key

    /etc/apk/cert.key

    Подсказка

    Если у вас нет этих файлов, но есть лицензия, напишите в поддержку: support@angie.software.

  2. Установите вспомогательные пакеты для подключения репозитория Angie PRO:

    $ sudo apk update
    $ sudo apk add curl ca-certificates
    
  3. Скачайте открытый ключ репозитория Angie PRO для проверки подлинности пакетов:

    $ sudo curl -o /etc/apk/keys/angie-signing.rsa \
                https://angie.software/keys/angie-signing.rsa
    
  4. Подключите репозиторий Angie PRO:

    $ echo "https://download.angie.software/angie-pro/alpine/v$(egrep -o \
           '[0-9]+\.[0-9]+' /etc/alpine-release)/main" \
           | sudo tee -a /etc/apk/repositories > /dev/null
    
  5. Обновите индексы пакетов:

    $ sudo apk update
    
  6. Установите пакет Angie PRO:

    $ sudo apk add angie-pro
    
  7. (Дополнительно) Установите пакеты необходимых вам динамических модулей:

    $ sudo apk add <ИМЯ ПАКЕТА>
    
  8. Запустите сервис:

    $ sudo service angie start
    
  9. Чтобы автоматически запускать Angie PRO после перезагрузки сервера:

    $ sudo rc-update add angie
    

ALT Linux#

  1. Установите вспомогательные пакеты для подключения репозитория Angie PRO:

    $ sudo apt-get update
    $ sudo apt-get install -y angie-pro-repo
    
  2. Перенесите полученные с лицензией файлы:

    Тип файла

    Исходное имя

    Куда поместить

    Сертификат

    angie-repo.crt

    /etc/ssl/angie/angie-repo.crt

    Закрытый ключ

    angie-repo.key

    /etc/ssl/angie/angie-repo.key

    Подсказка

    Если у вас нет этих файлов, но есть лицензия, напишите в поддержку: support@angie.software.

  3. Обновите индексы пакетов:

    $ sudo apt-get update
    
  4. Установите пакет Angie PRO:

    $ sudo apt-get install -y angie-pro
    
  5. (Дополнительно) Установите пакеты необходимых вам динамических модулей:

    $ sudo apt-get install -y <ИМЯ ПАКЕТА>
    
  6. Запустите сервис:

    $ sudo systemctl start angie
    
  7. Чтобы автоматически запускать Angie PRO после перезагрузки сервера:

    $ sudo systemctl enable angie
    

Astra SE#

  1. Создайте каталог /etc/ssl/angie/:

    $ sudo mkdir -p /etc/ssl/angie/
    
  2. Перенесите полученные с лицензией файлы:

    Тип файла

    Исходное имя

    Куда поместить

    Сертификат

    angie-repo.crt

    /etc/ssl/angie/angie-repo.crt

    Закрытый ключ

    angie-repo.key

    /etc/ssl/angie/angie-repo.key

    Подсказка

    Если у вас нет этих файлов, но есть лицензия, напишите в поддержку: support@angie.software.

    Ограничьте доступ к каталогу и файлам:

    $ sudo chown -R _apt:nogroup /etc/ssl/angie/
    
  3. Установите вспомогательные пакеты для подключения репозитория Angie PRO:

    $ sudo apt-get update
    $ sudo apt-get install -y apt-transport-https lsb-release \
                   ca-certificates curl gnupg2
    
  4. Скачайте открытый ключ репозитория Angie PRO для проверки подлинности пакетов:

    $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
                https://angie.software/keys/angie-signing.gpg
    
  5. Подключите репозиторий Angie PRO:

    $ echo "deb https://download.angie.software/angie-pro/astra-se/$(egrep -o \
           '[0-9]+\.[0-9]+' /etc/astra_version) unstable main" \
           | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
    
  6. Чтобы настроить репозиторий, создайте файл /etc/apt/apt.conf.d/90download-angie c таким содержимым:

    Acquire::https::download.angie.software::Verify-Peer "true";
    Acquire::https::download.angie.software::Verify-Host "true";
    Acquire::https::download.angie.software::SslCert     "/etc/ssl/angie/angie-repo.crt";
    Acquire::https::download.angie.software::SslKey      "/etc/ssl/angie/angie-repo.key";
    
  7. Обновите индексы пакетов:

    $ sudo apt-get update
    
  8. (Дополнительно) При работе в режиме замкнутой программной среды (ЗПС) установите пакет с ключом для проверки подлинности исполняемых файлов Angie PRO:

    $ sudo apt-get install -y angie-digsig-key
    

    Обновите ЗПС:

    $ sudo update-initramfs -uk all
    

    Затем перезагрузите сервер:

    $ sudo shutdown -r now
    
  9. Установите пакет Angie PRO:

    $ sudo apt-get install -y angie-pro
    
  10. (Дополнительно) Установите пакеты необходимых вам динамических модулей:

    $ sudo apt-get install -y <ИМЯ ПАКЕТА>
    

Debian, Ubuntu#

  1. Создайте каталог /etc/ssl/angie/:

    $ sudo mkdir -p /etc/ssl/angie/
    
  2. Перенесите полученные с лицензией файлы:

    Тип файла

    Исходное имя

    Куда поместить

    Сертификат

    angie-repo.crt

    /etc/ssl/angie/angie-repo.crt

    Закрытый ключ

    angie-repo.key

    /etc/ssl/angie/angie-repo.key

    Подсказка

    Если у вас нет этих файлов, но есть лицензия, напишите в поддержку: support@angie.software.

    Ограничьте доступ к каталогу и файлам:

    $ sudo chown -R _apt:nogroup /etc/ssl/angie/
    
  3. Установите вспомогательные пакеты для подключения репозитория Angie PRO:

    $ sudo apt-get update
    $ sudo apt-get install -y apt-transport-https lsb-release \
                   ca-certificates curl gnupg2
    
  4. Скачайте открытый ключ репозитория Angie PRO для проверки подлинности пакетов:

    $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
                https://angie.software/keys/angie-signing.gpg
    
  5. Подключите репозиторий Angie PRO:

    $ echo "deb https://download.angie.software/angie-pro/debian/ `lsb_release -cs` main" \
           | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
    
  6. Чтобы настроить репозиторий, создайте файл /etc/apt/apt.conf.d/90download-angie c таким содержимым:

    Acquire::https::download.angie.software::Verify-Peer "true";
    Acquire::https::download.angie.software::Verify-Host "true";
    Acquire::https::download.angie.software::SslCert     "/etc/ssl/angie/angie-repo.crt";
    Acquire::https::download.angie.software::SslKey      "/etc/ssl/angie/angie-repo.key";
    
  7. Обновите индексы пакетов:

    $ sudo apt-get update
    
  8. Установите пакет Angie PRO:

    $ sudo apt-get install -y angie-pro
    
  9. (Дополнительно) Установите пакеты необходимых вам динамических модулей:

    $ sudo apt-get install -y <ИМЯ ПАКЕТА>
    

FreeBSD#

  1. Чтобы подключить репозиторий Angie PRO, создайте каталоги:

    $ sudo mkdir -p /usr/local/etc/pkg/angie/ /usr/local/etc/pkg/repos/
    
  2. Чтобы настроить репозиторий, создайте файл /usr/local/etc/pkg/repos/angie.conf с таким содержимым:

    angie: {
       url: "https://download.angie.software/angie-pro/freebsd/${VERSION_MAJOR}/${ARCH}",
       signature_type: "pubkey",
       pubkey: "/usr/local/etc/pkg/angie/angie-signing.rsa",
       enabled: yes
    }
    
  3. Скачайте открытый ключ репозитория Angie PRO для проверки подлинности пакетов:

    $ sudo curl -o /usr/local/etc/pkg/angie/angie-signing.rsa \
                https://angie.software/keys/angie-signing.rsa
    
  4. Перенесите полученные с лицензией файлы:

    Тип файла

    Исходное имя

    Куда поместить

    Сертификат

    angie-repo.crt

    /usr/local/etc/pkg/angie/angie-repo.crt

    Закрытый ключ

    angie-repo.key

    /usr/local/etc/pkg/angie/angie-repo.key

    Подсказка

    Если у вас нет этих файлов, но есть лицензия, напишите в поддержку: support@angie.software.

  5. Добавьте сертификат и ключ в конфигурацию пакетного менеджера:

    $ echo '
      PKG_ENV: {
        SSL_CLIENT_CERT_FILE: "/usr/local/etc/pkg/angie/angie-repo.crt",
        SSL_CLIENT_KEY_FILE:  "/usr/local/etc/pkg/angie/angie-repo.key"
      }' | sudo tee -a /usr/local/etc/pkg.conf > /dev/null
    
  6. Обновите индексы пакетов:

    $ sudo pkg update
    
  7. Установите пакет Angie PRO:

    $ sudo pkg install -y angie-pro
    
  8. (Дополнительно) Установите пакеты необходимых вам динамических модулей:

    $ sudo pkg install -y <ИМЯ ПАКЕТА>
    
  9. Запустите сервис:

    $ sudo service angie start
    
  10. Чтобы автоматически запускать Angie PRO после перезагрузки сервера:

    $ sudo sysrc angie_enable=YES
    

Динамические модули#

Чтобы расширить базовую функциональность Angie PRO, можно добавлять разнообразные динамические модули. Получить их можно в виде готовых пакетов из нашего репозитория.

Пакеты динамических модулей из дистрибутива Angie PRO:

angie-pro-module-image-filter

Добавляет преобразования изображений в форматах JPEG, GIF, PNG и WebP.

angie-pro-module-njs: http_js_module, stream_js_module

Позволяют использовать язык njs (подмножество JavaScript) в конфигурации Angie PRO соответственно в контекстах http и stream.

angie-pro-module-perl

Позволяет писать обработчики location и переменных на Perl, а также вызывать Perl из SSI.

angie-pro-module-xslt

Добавляет фильтр, преобразующий XML-ответ с помощью XSLT-шаблонов.

Мы также собираем и публикуем в нашем репозитории пакеты следующих сторонних модулей:

angie-pro-module-auth-jwt

Добавляет JWT-аутентификацию клиентов.

angie-pro-module-auth-spnego

Добавляет поддержку SPNEGO и GSSAPI.

angie-pro-module-brotli

Добавляет статическое и динамическое Brotli-сжатие ответов.

angie-pro-module-cache_purge

Позволяет очищать содержимое кэшей FastCGI, прокси, SCGI и uWSGI.

angie-pro-module-dav-ext

Расширяет поддержку WebDAV методами PROPFIND и OPTIONS.

angie-pro-module-echo

Позволяет использовать echo, sleep, time, exec и другие шелл-команды в файле конфигурации.

angie-pro-module-enhanced-memcached

Расширяет возможности встроенного модуля Модуль http_memcached.

angie-pro-module-eval

Позволяет сохранять в переменных тела ответов на подзапросы.

angie-pro-module-geoip2: http_geoip2, stream_geoip2

Добавляет поиск по геоданным в базах GeoIP2 MaxMind 2.

angie-pro-module-headers-more

Позволяет устанавливать и очищать заголовки запросов и ответов.

angie-pro-module-jwt

Добавляет проверку валидности JWT.

angie-pro-module-keyval

Позволяет использовать переменные со значениями из пар key-value.

angie-pro-module-lua: http_lua_module, stream_lua_module

Позволяют использовать язык Lua в конфигурации Angie PRO соответственно в контекстах http и stream.

angie-pro-module-ndk

Добавляет Nginx Development Kit (NDK) для разработки новых модулей.

angie-pro-module-postgres

Включает непосредственную поддержку баз данных PostgreSQL.

angie-pro-module-redis2

Добавляет протокол Redis 2.0 в HTTP-апстримы.

angie-pro-module-rtmp

Добавляет протокол RTMP для стриминга и трансляции видео по запросу.

angie-pro-module-set-misc

Добавляет различные директивы set_xxx в модуль rewrite.

angie-pro-module-subs

Позволяет заменять строки в теле HTTP-ответа по регулярным выражениям.

angie-pro-module-upload

Добавляет кодировку multipart/form-data (RFC 1868) для отправки файлов со стороны клиента, включая возможность возобновления.

angie-pro-module-vod

Позволяет перепаковывать MP4-файлы для стриминга по HLS, HDS, MSS и DASH.

Чтобы применить установленный модуль в конфигурации, загрузите его с помощью директивы load_module.