Пакетная установка Angie PRO#

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

  • https://angie.software/

  • +7 (495) 120 50 33

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

Дистрибутивы#

Название

Версии

Архитектуры

AlmaLinux

9,   8

x86-64, arm64

Alpine

3.20,   3.19,   3.18,   3.17

x86-64, arm64

Альт

10
8

x86-64, arm64
x86-64

Astra SE

4.7
1.8, 1.7

arm64
x86-64

CentOS

9

x86-64, arm64

Debian

12,   11

x86-64, arm64

FreeBSD

14,   13

x86-64, arm64

МСВСфера

9

x86-64

openSUSE

15

x86-64, arm64

Oracle Linux

9,   8

x86-64, arm64

РЕД ОС

8
7

x86-64
x86-64, arm64

Rocky Linux

9,   8

x86-64, arm64

РОСА

Хром 12
Фреш 12

x86-64, arm64
x86-64

SberLinux

9

x86-64

Ubuntu

24.04,   22.04,   20.04

x86-64, arm64

Alma, CentOS, МСВСфера, Oracle, РЕД ОС, Rocky, РОСА, SberLinux#

  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

    Подсказка

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

  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

    Подсказка

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

  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

Альт#

  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

    Подсказка

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

  3. Скачайте открытый ключ репозитория Angie PRO для проверки подлинности пакетов:

    $ curl -o ~/angie-signing.gpg https://angie.software/keys/angie-signing.gpg && \
       sudo gpg --no-default-keyring --keyring /usr/lib/alt-gpgkeys/pubring.gpg --import ~/angie-signing.gpg

  4. Сохраните сигнатуру ключа:

    $ echo 'simple-key "angie-pro" {
          Fingerprint "EB8EAF3D4EF1B1ECF34865A2617AB978CB849A76";
          Name "Angie PRO (Signing Key) <devops@tech.wbsrv.ru>";
  }' | sudo tee /etc/apt/vendors.list.d/angie.list > /dev/null

  5. Подключите репозиторий Angie PRO:

    $ echo "rpm [angie-pro] https://download.angie.software/angie-pro/altlinux/10/ $(uname -m) main" \
    | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null

  6. Создайте файл конфигурации apt репозитория Angie PRO в /etc/apt/apt.conf.d:

    $ ( echo 'Acquire::https::Verify-Peer "true";';
    echo 'Acquire::https::Verify-Host "true";';
    echo 'Acquire::https::SslCert     "/etc/ssl/angie/angie-repo.crt";';
    echo 'Acquire::https::SslKey      "/etc/ssl/angie/angie-repo.key";';
  )  | sudo tee -a /etc/apt/apt.conf >/dev/null

  7. Обновите индексы репозиториев:

    $ sudo apt-get update

  8. Установите пакет Angie PRO:

    $ sudo apt-get install -y angie-pro

  9. (Необязательно) Установите пакеты необходимых вам дополнений:

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

  10. Запустите сервис:

    $ sudo systemctl start angie

  11. Чтобы автоматически запускать 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

    Подсказка

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

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

    $ 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

    Подсказка

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

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

    $ 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/$(. /etc/os-release && echo "$ID/$VERSION_ID $VERSION_CODENAME") 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

    Подсказка

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

  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

openSUSE#

  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

    И соберите из них связку /etc/ssl/angie/angie-repo-bundle.crt:

    $ cat /etc/ssl/angie/angie-repo.crt /etc/ssl/angie/angie-repo.key | \
      sudo tee -a /etc/ssl/angie/angie-repo-bundle.crt > /dev/null

    Подсказка

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

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

    [angie-pro]
enabled=1
autorefresh=1
baseurl=https://download.angie.software/angie-pro/opensuse/$releasever_major?ssl_clientcert=/etc/ssl/angie/angie-repo-bundle.crt&ssl_verify=peer
gpgcheck=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc

  4. Обновите индексы репозиториев:

    $ sudo zypper refresh

  5. Установите пакет Angie PRO:

    $ sudo zypper install -y angie-pro

  6. (Необязательно) Установите пакеты необходимых вам дополнений:

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

  7. Запустите сервис:

    $ sudo systemctl start angie

  8. Чтобы автоматически запускать Angie PRO после перезагрузки сервера:

    $ sudo systemctl enable angie

Дополнения#

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

Веб-панель Console Light#

Console Light — это облегченная веб-панель мониторинга Angie PRO, публикуемая в наших репозиториях в виде пакета angie-pro-console-light. Устанавливается он так же, как и пакет angie в инструкциях выше; инструкции по настройке см. в разделе Веб-панель мониторинга Console Light.

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

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

angie-pro-module-image-filter

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

angie-pro-module-njs: JS (HTTP), JS (потоковый)

Позволяют использовать язык 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-ldap

Добавляет поддержку LDAP-аутентификации с несколькими серверами.

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-dynamic-limit-req

Служит для динамической блокировки IP-адресов и ее периодического снятия.

angie-pro-module-echo

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

angie-pro-module-enhanced-memcached

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

angie-pro-module-eval

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

angie-pro-module-geoip2: http_geoip2, stream_geoip2

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

angie-pro-module-headers-more

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

angie-pro-module-keyval

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

angie-pro-module-lua: http_lua_module, stream_lua_module

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

angie-pro-module-modsecurity

Добавляет коннектор для использования правил ModSecurity.

Примечание

Пакет нуждается в дополнительной настройке.

angie-pro-module-ndk

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

angie-pro-module-otel

Позволяет отправлять данные телеметрии сборщику OpenTelemetry.

angie-pro-module-opentracing

Добавляет распределенную OpenTracing-трассировку запросов в Angie PRO; содержит плагины для экспорта данных в Zipkin и DataDog.

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-testcookie

Помогает бороться с ботами при помощи механизма "вызов-ответ" на основе cookie.

angie-pro-module-upload

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

angie-pro-module-vod

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

angie-pro-module-vts: module-vts, module-sts, module-stream-sts

Включает три перечисленных модуля для отслеживания трафика.

Примечание

Соответствующие им файлы шаблонов устанавливаются сюда:

/usr/share/angie-pro-module-vts/status.compress.html
/usr/share/angie-pro-module-vts/status.template.html
/usr/share/angie-pro-module-vts/stream/status.compress.html
/usr/share/angie-pro-module-vts/stream/status.template.html

angie-pro-module-zip

Включает динамическую упаковку ZIP-архивов.

angie-pro-module-zstd

Включает сжатие Zstandard.

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

Файл лицензии#

Чтобы настроить лицензию для Angie PRO:

  1. Сохраните файл лицензии как /etc/angie/license.pem, присвоив ему те же права, что и для клиентских сертификатов.

  2. Убедитесь, что лицензия действительна; в противном случае уточните подробности:

    $ sudo angie -t

  angie: Valid license found:
  angie:   - owner: CN=Angie Client License
  angie:   - period: Jul  8 21:00:00 2024 GMT .. Jul 17 20:59:59 2024 GMT
  angie:
  angie: Limitations:
  angie:   - worker_processes_limit: 8
  angie:   - worker_connections_limit: 0

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

  4. Измените файл /etc/angie/angie.conf; после установки два параметра в нем ограничивают работу:

    worker_processes 1;
worker_connections 256;

    Сохранив файл лицензии, измените их согласно условиям вашей лицензии, например:

    worker_processes 8;
worker_connections 65535;