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

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

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

Название	Версии	Архитектуры
AlmaLinux	9,   8	x86-64, arm64
Alpine	3.21,   3.20,   3.19,   3.18	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

Совет

Мы ежедневно тестируем и собираем код из нашего репозитория, и эти ежедневные сборки подходят для знакомства с новыми возможностями до официального релиза.

Версия ежедневных сборок всегда соответствует ближайшему предстоящему релизу. Названия и способ установки здесь в целом аналогичны приведенным ниже, но вместо префикса пути https://download.angie.software/angie/* используйте https://download.angie.software/angie-nightly/*.

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

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

   AlmaCentOSМСВСфераOracleРЕД ОСRockyРОСА ХромРОСА ФрешSberLinux

   [angie]
   name=Angie repo
   baseurl=https://download.angie.software/angie/almalinux/$releasever/
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   

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

   $ sudo yum install -y angie
   

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

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

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

   $ sudo systemctl start angie
   

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

   $ sudo systemctl enable angie
   

Alpine

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

   $ sudo apk update
   $ sudo apk add curl ca-certificates
   

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

   $ sudo curl -o /etc/apk/keys/angie-signing.rsa \
               https://angie.software/keys/angie-signing.rsa
   

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

   $ echo "https://download.angie.software/angie/alpine/v$(egrep -o \
          '[0-9]+\.[0-9]+' /etc/alpine-release)/main" \
          | sudo tee -a /etc/apk/repositories > /dev/null
   

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

   $ sudo apk update
   

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

   $ sudo apk add angie
   

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

   $ sudo apk add <ИМЯ ПАКЕТА>
   

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

   $ sudo service angie start
   

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

   $ sudo rc-update add angie
   

Альт

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

   $ sudo mkdir -p /etc/ssl/angie/
   

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

   $ sudo apt-get update
   $ sudo apt-get install -y curl apt-https
   

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

   $ sudo curl -o /etc/ssl/angie/angie-signing.gpg \
         https://angie.software/keys/angie-signing.gpg
   

4. Импортируйте скачанный ключ репозитория в цепочку доверенных ключей:

   $ sudo gpg --no-default-keyring \
         --keyring /usr/lib/alt-gpgkeys/pubring.gpg --import /etc/ssl/angie/angie-signing.gpg
   

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

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

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

   Альт 10Альт СП 10Альт СП 8

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

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

   $ sudo apt-get update
   

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

   $ sudo apt-get install -y angie
   

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

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

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

    $ sudo systemctl start angie
    

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

    $ sudo systemctl enable angie
    

Astra SE

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

   $ sudo apt-get update
   $ sudo apt-get install -y ca-certificates curl lsb-release
   

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

   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   

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

   $ echo "deb https://download.angie.software/angie/astra-se/$(egrep -o \
          '[0-9]+.[0-9]+' /etc/astra_version) unstable main" \
          | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   

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

   $ sudo apt-get update
   

5. (Необязательно) При работе в режиме замкнутой программной среды (ЗПС) установите пакет с ключом для проверки подлинности бинарных файлов Angie:

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

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

   $ sudo update-initramfs -uk all
   

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

   $ sudo shutdown -r now
   

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

   $ sudo apt-get install -y angie
   

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

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

Debian, Ubuntu

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

   $ sudo apt-get update
   $ sudo apt-get install -y ca-certificates curl
   

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

   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   

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

   $ echo "deb https://download.angie.software/angie/$(. /etc/os-release && echo "$ID/$VERSION_ID $VERSION_CODENAME") main" \
       | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   

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

   $ sudo apt-get update
   

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

   $ sudo apt-get install -y angie
   

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

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

FreeBSD

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

   $ sudo mkdir -p /usr/local/etc/pkg/angie/ /usr/local/etc/pkg/repos/
   

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

   angie: {
      url: "https://download.angie.software/angie/freebsd/${VERSION_MAJOR}/${ARCH}",
      signature_type: "pubkey",
      pubkey: "/usr/local/etc/pkg/angie/angie-signing.rsa",
      enabled: yes
   }
   

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

   $ sudo curl -o /usr/local/etc/pkg/angie/angie-signing.rsa \
               https://angie.software/keys/angie-signing.rsa
   

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

   $ sudo pkg update
   

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

   $ sudo pkg install -y angie
   

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

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

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

   $ sudo service angie start
   

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

   $ sudo sysrc angie_enable=YES
   

openSUSE

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

   [angie]
   name=Angie repo
   baseurl=https://download.angie.software/angie/opensuse/$releasever_major/
   gpgcheck=1
   enabled=1
   gpgkey=https://angie.software/keys/angie-signing.gpg.asc
   

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

   $ sudo zypper refresh
   

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

   $ sudo zypper install -y angie
   

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

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

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

   $ sudo systemctl start angie
   

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

   $ sudo systemctl enable angie
   

Дополнения

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

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

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

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

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

angie-module-image-filter	Добавляет преобразования изображений в форматах JPEG, GIF, PNG и WebP.
angie-module-njs: JS (HTTP), JS (потоковый)	Позволяют использовать язык njs (подмножество JavaScript) в конфигурации Angie соответственно в контекстах http и stream.
angie-module-perl	Позволяет писать обработчики location и переменных на Perl, а также вызывать Perl из SSI.
angie-module-wamr	Обеспечивает интеграцию с WebAssembly Micro Runtime для выполнения WASM-кода.
angie-module-wasm	Добавляет базовую поддержку WASM.
angie-module-wasmtime	Обеспечивает интеграцию со средой выполнения Wasmtime для выполнения WASM-кода.
angie-module-xslt	Добавляет фильтр, преобразующий XML-ответ с помощью XSLT-шаблонов.

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

load_module modules/<имя модуля>.so;

Также доступен целый ряд сторонних модулей.