Пакетная установка Angie PRO#
Чтобы получить доступ к репозиторию пакетов, следует заключить контракт и приобрести лицензию. По вопросам лицензий, контрактов и кастомных сборок обращайтесь:
+7 495 120 50 33
Затем настройте репозиторий для пакетного менеджера своего дистрибутива, чтобы установить и обновлять Angie PRO и нужные вам динамические модули. Наконец, установите файл лицензии и снимите ограничения.
Дистрибутивы#
Название |
Версии |
Архитектуры |
---|---|---|
9, 8 |
x86-64, arm64 |
|
3.20, 3.19, 3.18, 3.17 |
x86-64, arm64 |
|
10 |
x86-64, arm64 |
|
4.7 |
arm64 |
|
9 |
x86-64, arm64 |
|
12, 11 |
x86-64, arm64 |
|
14, 13 |
x86-64, arm64 |
|
9 |
x86-64 |
|
15 |
x86-64, arm64 |
|
9, 8 |
x86-64, arm64 |
|
8 |
x86-64 |
|
9, 8 |
x86-64, arm64 |
|
Хром 12 |
x86-64, arm64 |
|
24.04, 22.04, 20.04 |
x86-64, arm64 |
Alma, CentOS, МСВСфера, Oracle, РЕД ОС, Rocky, РОСА#
-
Создайте каталог /etc/ssl/angie/:
$ sudo mkdir -p /etc/ssl/angie/
-
Перенесите полученные с лицензией файлы:
Тип файла
Исходное имя
Куда поместить
Сертификат
angie-repo.crt
/etc/ssl/angie/angie-repo.crt
Закрытый ключ
angie-repo.key
/etc/ssl/angie/angie-repo.key
Подсказка
Если у вас нет этих файлов, но есть лицензия, напишите в поддержку: .
-
Чтобы подключить репозиторий, создайте файл /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
[angie-pro] name=Angie PRO repo baseurl=https://download.angie.software/angie-pro/centos/$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
[angie-pro] name=Angie PRO repo baseurl=https://download.angie.software/angie-pro/msvsphere/$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
[angie-pro] name=Angie PRO repo baseurl=https://download.angie.software/angie-pro/oracle/$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
[angie-pro] name=Angie PRO repo baseurl=https://download.angie.software/angie-pro/redos/$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
[angie-pro] name=Angie PRO repo baseurl=https://download.angie.software/angie-pro/rocky/$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
[angie-pro] name=Angie PRO repo baseurl=https://download.angie.software/angie-pro/rosa-chrome/$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
[angie-pro] name=Angie PRO repo baseurl=https://download.angie.software/angie-pro/rosa/$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
-
Установите пакет Angie PRO:
$ sudo yum install -y angie-pro
-
(Необязательно) Установите пакеты необходимых вам дополнений:
$ sudo yum install -y <ИМЯ ПАКЕТА>
-
Запустите сервис:
$ sudo systemctl start angie
-
Чтобы автоматически запускать Angie PRO после перезагрузки сервера:
$ sudo systemctl enable angie
Alpine#
-
Перенесите полученные с лицензией файлы:
Тип файла
Исходное имя
Куда поместить
Сертификат
angie-repo.crt
/etc/apk/cert.pem
Закрытый ключ
angie-repo.key
/etc/apk/cert.key
Подсказка
Если у вас нет этих файлов, но есть лицензия, напишите в поддержку: .
-
Установите вспомогательные пакеты для подключения репозитория Angie PRO:
$ sudo apk update $ sudo apk add curl ca-certificates
-
Скачайте открытый ключ репозитория Angie PRO для проверки подлинности пакетов:
$ sudo curl -o /etc/apk/keys/angie-signing.rsa \ https://angie.software/keys/angie-signing.rsa
-
Подключите репозиторий 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
-
Обновите индексы репозиториев:
$ sudo apk update
-
Установите пакет Angie PRO:
$ sudo apk add angie-pro
-
(Необязательно) Установите пакеты необходимых вам дополнений:
$ sudo apk add <ИМЯ ПАКЕТА>
-
Запустите сервис:
$ sudo service angie start
-
Чтобы автоматически запускать Angie PRO после перезагрузки сервера:
$ sudo rc-update add angie
Альт#
-
Создайте каталог
/etc/ssl/angie/
:$ sudo mkdir -p /etc/ssl/angie/
-
Перенесите полученные с лицензией файлы:
Тип файла
Исходное имя
Куда поместить
Сертификат
angie-repo.crt
/etc/ssl/angie/angie-repo.crt
Закрытый ключ
angie-repo.key
/etc/ssl/angie/angie-repo.key
Подсказка
Если у вас нет этих файлов, но есть лицензия, напишите в поддержку: .
-
Скачайте открытый ключ репозитория 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
-
Сохраните сигнатуру ключа:
$ 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
-
Подключите репозиторий 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
$ echo "rpm [angie-pro] https://download.angie.software/angie-pro/altlinux-sp/10/ $(uname -m) main" \ | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
$ echo "rpm [angie-pro] https://download.angie.software/angie-pro/altlinux-sp/8/ $(uname -m) main" \ | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
-
Создайте файл конфигурации
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
-
Обновите индексы репозиториев:
$ sudo apt-get update
-
Установите пакет Angie PRO:
$ sudo apt-get install -y angie-pro
-
(Необязательно) Установите пакеты необходимых вам дополнений:
$ sudo apt-get install -y <ИМЯ ПАКЕТА>
-
Запустите сервис:
$ sudo systemctl start angie
-
Чтобы автоматически запускать Angie PRO после перезагрузки сервера:
$ sudo systemctl enable angie
Astra SE#
-
Создайте каталог /etc/ssl/angie/:
$ sudo mkdir -p /etc/ssl/angie/
-
Перенесите полученные с лицензией файлы:
Тип файла
Исходное имя
Куда поместить
Сертификат
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/
-
Установите вспомогательные пакеты для подключения репозитория Angie PRO:
$ sudo apt-get update $ sudo apt-get install -y apt-transport-https lsb-release \ ca-certificates curl gnupg2
-
Скачайте открытый ключ репозитория Angie PRO для проверки подлинности пакетов:
$ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \ https://angie.software/keys/angie-signing.gpg
-
Подключите репозиторий 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
-
Чтобы настроить репозиторий, создайте файл /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";
-
Обновите индексы репозиториев:
$ sudo apt-get update
-
(Необязательно) При работе в режиме замкнутой программной среды (ЗПС) установите пакет с ключом для проверки подлинности исполняемых файлов Angie PRO:
$ sudo apt-get install -y angie-digsig-key
Обновите ЗПС:
$ sudo update-initramfs -uk all
Затем перезагрузите сервер:
$ sudo shutdown -r now
-
Установите пакет Angie PRO:
$ sudo apt-get install -y angie-pro
-
(Необязательно) Установите пакеты необходимых вам дополнений:
$ sudo apt-get install -y <ИМЯ ПАКЕТА>
Debian, Ubuntu#
-
Создайте каталог /etc/ssl/angie/:
$ sudo mkdir -p /etc/ssl/angie/
-
Перенесите полученные с лицензией файлы:
Тип файла
Исходное имя
Куда поместить
Сертификат
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/
-
Установите вспомогательные пакеты для подключения репозитория Angie PRO:
$ sudo apt-get update $ sudo apt-get install -y apt-transport-https lsb-release \ ca-certificates curl gnupg2
-
Скачайте открытый ключ репозитория Angie PRO для проверки подлинности пакетов:
$ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \ https://angie.software/keys/angie-signing.gpg
-
Подключите репозиторий 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
-
Чтобы настроить репозиторий, создайте файл /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";
-
Обновите индексы репозиториев:
$ sudo apt-get update
-
Установите пакет Angie PRO:
$ sudo apt-get install -y angie-pro
-
(Необязательно) Установите пакеты необходимых вам дополнений:
$ sudo apt-get install -y <ИМЯ ПАКЕТА>
FreeBSD#
-
Чтобы подключить репозиторий Angie PRO, создайте каталоги:
$ sudo mkdir -p /usr/local/etc/pkg/angie/ /usr/local/etc/pkg/repos/
-
Чтобы настроить репозиторий, создайте файл /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 }
-
Скачайте открытый ключ репозитория Angie PRO для проверки подлинности пакетов:
$ sudo curl -o /usr/local/etc/pkg/angie/angie-signing.rsa \ https://angie.software/keys/angie-signing.rsa
-
Перенесите полученные с лицензией файлы:
Тип файла
Исходное имя
Куда поместить
Сертификат
angie-repo.crt
/usr/local/etc/pkg/angie/angie-repo.crt
Закрытый ключ
angie-repo.key
/usr/local/etc/pkg/angie/angie-repo.key
Подсказка
Если у вас нет этих файлов, но есть лицензия, напишите в поддержку: .
-
Добавьте сертификат и ключ в конфигурацию пакетного менеджера:
$ 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
-
Обновите индексы репозиториев:
$ sudo pkg update
-
Установите пакет Angie PRO:
$ sudo pkg install -y angie-pro
-
(Необязательно) Установите пакеты необходимых вам дополнений:
$ sudo pkg install -y <ИМЯ ПАКЕТА>
-
Запустите сервис:
$ sudo service angie start
-
Чтобы автоматически запускать Angie PRO после перезагрузки сервера:
$ sudo sysrc angie_enable=YES
openSUSE#
-
Создайте каталог
/etc/ssl/angie/
:$ sudo mkdir -p /etc/ssl/angie/
-
Перенесите полученные с лицензией файлы:
Тип файла
Исходное имя
Куда поместить
Сертификат
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
Подсказка
Если у вас нет этих файлов, но есть лицензия, напишите в поддержку: .
-
Чтобы подключить репозиторий, создайте файл /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
-
Обновите индексы репозиториев:
$ sudo zypper refresh
-
Установите пакет Angie PRO:
$ sudo zypper install -y angie-pro
-
(Необязательно) Установите пакеты необходимых вам дополнений:
$ sudo zypper install -y <ИМЯ ПАКЕТА>
-
Запустите сервис:
$ sudo systemctl start angie
-
Чтобы автоматически запускать Angie PRO после перезагрузки сервера:
$ sudo systemctl enable angie
Дополнения#
Помимо пакетов, обеспечивающих основную функциональность, мы также публикуем несколько дополнительных пакетов, как наших собственных, так и из отобранных нами сторонних источников.
Веб-панель Console Light#
Console Light — это облегченная
веб-панель мониторинга Angie PRO,
публикуемая в наших репозиториях в виде пакета angie-pro-console-light
.
Устанавливается он так же, как и пакет angie
в инструкциях выше;
инструкции по настройке см. в разделе Веб-панель мониторинга Console Light.
Динамические модули#
Чтобы расширить базовую функциональность Angie PRO, можно добавлять разнообразные динамические модули. Получить их можно в виде готовых пакетов из нашего репозитория:
Добавляет преобразования изображений в форматах JPEG, GIF, PNG и WebP. |
|
Позволяют использовать язык njs (подмножество JavaScript)
в конфигурации Angie PRO соответственно в контекстах |
|
Позволяет писать обработчики |
|
Добавляет фильтр, преобразующий XML-ответ с помощью XSLT-шаблонов. |
Мы также собираем и публикуем в нашем репозитории пакеты следующих сторонних модулей:
Добавляет JWT-аутентификацию клиентов. |
|
Добавляет поддержку LDAP-аутентификации с несколькими серверами. |
|
Добавляет поддержку SPNEGO и GSSAPI. |
|
Добавляет статическое и динамическое Brotli-сжатие ответов. |
|
Позволяет очищать содержимое кэшей FastCGI, прокси, SCGI и uWSGI. |
|
Расширяет поддержку WebDAV методами PROPFIND и OPTIONS. |
|
Служит для динамической блокировки IP-адресов и ее периодического снятия. |
|
Позволяет вызывать |
|
Расширяет возможности встроенного модуля Memcached. |
|
Позволяет сохранять в переменных тела ответов на подзапросы. |
|
angie-pro-module-geoip2: http_geoip2, stream_geoip2 |
Добавляет поиск по геоданным в базах MaxMind GeoIP2. |
Позволяет устанавливать и очищать заголовки запросов и ответов. |
|
Позволяет использовать переменные со значениями из пар "ключ-значение". |
|
angie-pro-module-lua: http_lua_module, stream_lua_module |
Позволяют использовать язык Lua в конфигурации Angie PRO
соответственно в контекстах |
Добавляет коннектор для использования правил ModSecurity. Примечание Пакет нуждается в дополнительной настройке. |
|
Добавляет Nginx Development Kit (NDK) для разработки новых модулей. |
|
Позволяет отправлять данные телеметрии сборщику OpenTelemetry. |
|
Добавляет распределенную OpenTracing-трассировку запросов в Angie PRO; содержит плагины для экспорта данных в Zipkin и DataDog. |
|
Включает непосредственную поддержку баз данных PostgreSQL. |
|
Включает поддержку Redis 2.0 для HTTP-апстримов. |
|
Включает поддержку RTMP для стриминга и трансляции видео по запросу. |
|
Добавляет различные директивы set_xxx в модуль Rewrite. |
|
Позволяет заменять строки в теле HTTP-ответа по регулярным выражениям. |
|
Помогает бороться с ботами при помощи механизма "вызов-ответ" на основе cookie. |
|
Добавляет кодировку |
|
Позволяет перепаковывать 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
|
Включает динамическую упаковку ZIP-архивов. |
|
Включает сжатие Zstandard. |
Чтобы применить установленный модуль в конфигурации, загрузите его с помощью директивы load_module.
Файл лицензии#
Чтобы настроить лицензию для Angie PRO:
Сохраните файл лицензии как
/etc/angie/license.pem
, присвоив ему те же права, что и для клиентских сертификатов.-
Убедитесь, что лицензия действительна; в противном случае уточните подробности:
$ 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
Следите за консолью и логами для выявления любых проблем с лицензией. Если лицензия истекает в процессе работы, Angie PRO периодически выдает соответствующие предупреждения. Кроме того, при перезагрузке появится сообщение об ошибках конфигурации, если, например, превышено количество рабочих процессов, указанных в условиях лицензии.
-
Измените файл
/etc/angie/angie.conf
; после установки два параметра в нем ограничивают работу:worker_processes 1; worker_connections 256;
Сохранив файл лицензии, измените их согласно условиям вашей лицензии, например:
worker_processes 8; worker_connections 65535;