<!-- review: finished -->

<a id="pro-packages"></a>

# Instalação por Pacotes do Angie PRO

Para acessar o repositório de pacotes,
você precisa assinar um contrato e adquirir uma licença.
Para questões sobre licenças, contratos e builds personalizados, entre em contato:

- [info@wbsrv.ru](mailto:info@wbsrv.ru)
- [https://angie.software/](https://angie.software/)
- +7 (495) 120 50 33

Em seguida, configure o repositório para o gerenciador de pacotes da sua distribuição
para instalar e atualizar o Angie PRO
e os [módulos dinâmicos](#install-dynamicmodules-pro) que você precisa.
Por fim, instale o [arquivo de licença](#install-license)
e remova as restrições.

<a id="distributions-1"></a>

## Distribuições

| Nome                              | Versões                        | Arquiteturas                  |
|-----------------------------------|--------------------------------|-------------------------------|
| [AlmaLinux](#install-yum-pro)     | 10,  9,  8                     | x86-64, arm64                 |
| [Alpine](#install-alpine-pro)     | 3.23,  3.22,  3.21,  3.20      | x86-64, arm64                 |
| [Alt](#install-alt-pro)           | 11,  10  8                     | x86-64, arm64  x86-64         |
| [Astra SE](#install-astrase-pro)  | 4.7  1.8, 1.7                  | arm64  x86-64                 |
| [CentOS](#install-yum-pro)        | 10,  9                         | x86-64, arm64                 |
| [Debian](#install-deb-pro)        | 13,  12,  11                   | x86-64, arm64                 |
| [Fedora](#install-yum-pro)        | 44,  43                        | x86-64, arm64                 |
| [FreeBSD](#install-freebsd-pro)   | 15,  14,  13                   | x86-64, arm64                 |
| [MSVSphere](#install-yum-pro)     | 10,  9  8                      | x86-64, arm64  x86-64         |
| [openSUSE](#install-opensuse-pro) | 16,  15                        | x86-64, arm64                 |
| [Oracle Linux](#install-yum-pro)  | 10,  9,  8                     | x86-64, arm64                 |
| [OSNova](#install-osnova-pro)     | 3.3.0,  2.13                   | x86-64                        |
| [RED OS](#install-yum-pro)        | 8,  7                          | x86-64, arm64                 |
| [Rocky Linux](#install-yum-pro)   | 10,  9,  8                     | x86-64, arm64                 |
| [ROSA](#install-yum-pro)          | Chrome 13  Chrome 12  Fresh 12 | x86-64  x86-64, arm64  x86-64 |
| [SberLinux](#install-yum-pro)     | 9                              | x86-64                        |
| [Ubuntu](#install-deb-pro)        | 26.04,  24.04,  22.04          | x86-64, arm64                 |

<a id="install-yum-pro"></a>

### Alma, CentOS, Fedora, MSVSphere, Oracle, RED OS, Rocky, ROSA, SberLinux

1. Crie o diretório `/etc/ssl/angie/`:
   ```console
   $ sudo mkdir -p /etc/ssl/angie/
   ```
2. Transfira os arquivos que você recebeu com sua licença:

   | Tipo de Arquivo   | Nome Original    | Onde Colocar                    |
   |-------------------|------------------|---------------------------------|
   | Certificado       | `angie-repo.crt` | `/etc/ssl/angie/angie-repo.crt` |
   | Chave Privada     | `angie-repo.key` | `/etc/ssl/angie/angie-repo.key` |
3. Para adicionar o repositório,
   crie o arquivo
   `/etc/yum.repos.d/angie.repo`
   com o seguinte conteúdo:

   Alma
   ```ini
   [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
   ```

   CentOS
   ```ini
   [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
   ```

   Fedora
   ```ini
   [angie-pro]
   name=Angie PRO repo
   baseurl=https://download.angie.software/angie-pro/fedora/$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
   ```

   MSVSphere
   ```ini
   [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
   ```

   Oracle
   ```ini
   [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
   ```

   RED OS
   ```ini
   [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
   ```

   Rocky
   ```ini
   [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
   ```

   ROSA Chrome
   ```ini
   [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
   ```

   ROSA Fresh
   ```ini
   [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
   ```

   SberLinux
   ```ini
   [angie-pro]
   name=Angie PRO repo
   baseurl=https://download.angie.software/angie-pro/sberlinux/$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. Instale o pacote Angie PRO:
   ```console
   $ sudo yum install -y angie-pro
   $ # -- OU --
   $ sudo dnf install -y angie-pro
   ```
5. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-pro)
   que você precisar:
   ```console
   $ sudo yum install -y <NOME DO PACOTE>
   $ # -- OU --
   $ sudo dnf install -y <NOME DO PACOTE>
   ```
6. Inicie o serviço:
   ```console
   $ sudo systemctl start angie
   ```
7. Para iniciar automaticamente o Angie PRO após a reinicialização do servidor:
   ```console
   $ sudo systemctl enable angie
   ```

<a id="install-alpine-pro"></a>

### Alpine

1. Transfira os arquivos que você recebeu com sua licença:

   | Tipo de Arquivo   | Nome Original    | Onde Colocar        |
   |-------------------|------------------|---------------------|
   | Certificado       | `angie-repo.crt` | `/etc/apk/cert.pem` |
   | Chave Privada     | `angie-repo.key` | `/etc/apk/cert.key` |
2. Instale os pacotes auxiliares
   para adicionar o repositório Angie PRO:
   ```console
   $ sudo apk update
   $ sudo apk add curl ca-certificates
   ```
3. Baixe a chave pública do repositório Angie PRO
   para verificação de pacotes:
   ```console
   $ sudo curl -o /etc/apk/keys/angie-signing.rsa \
               https://angie.software/keys/angie-signing.rsa
   ```
4. Adicione o repositório Angie PRO:
   ```console
   $ 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. Atualize os índices do repositório:
   ```console
   $ sudo apk update
   ```
6. Instale o pacote Angie PRO:
   ```console
   $ sudo apk add angie-pro
   ```
7. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-pro)
   que você precisar:
   ```console
   $ sudo apk add <NOME DO PACOTE>
   ```
8. Inicie o serviço:
   ```console
   $ sudo service angie start
   ```
9. Para iniciar automaticamente o Angie PRO após a reinicialização do servidor:
   ```console
   $ sudo rc-update add angie
   ```

<a id="install-alt-pro"></a>

### Alt

1. Crie o diretório `/etc/ssl/angie/`:
   ```console
   $ sudo mkdir -p /etc/ssl/angie/
   ```
2. Transfira os arquivos que você recebeu com sua licença:

   | Tipo de Arquivo   | Nome Original    | Onde Colocar                    |
   |-------------------|------------------|---------------------------------|
   | Certificado       | `angie-repo.crt` | `/etc/ssl/angie/angie-repo.crt` |
   | Chave Privada     | `angie-repo.key` | `/etc/ssl/angie/angie-repo.key` |
3. Baixe a chave pública do repositório Angie PRO
   para verificação de pacotes:
   ```console
   $ 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. Salve a assinatura da chave:
   ```sh
   $ 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. Adicione o repositório Angie PRO:

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

   Alt 10
   ```console
   $ 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
   ```

   Alt SP 10
   ```console
   $ 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
   ```

   Alt SP 8
   ```console
   $ 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
   ```
6. Crie o arquivo de configuração `apt` do repositório Angie PRO
   em `/etc/apt/apt.conf.d`:
   ```console
   $ ( 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. Atualize os índices do repositório:
   ```console
   $ sudo apt-get update
   ```
8. Instale o pacote Angie PRO:
   ```console
   $ sudo apt-get install -y angie-pro
   ```
9. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-pro)
   que você precisar:
   ```console
   $ sudo apt-get install -y <NOME DO PACOTE>
   ```
10. Inicie o serviço:
    ```console
    $ sudo systemctl start angie
    ```
11. Para iniciar automaticamente o Angie PRO após a reinicialização do servidor:
    ```console
    $ sudo systemctl enable angie
    ```

<a id="install-astrase-pro"></a>

### Astra SE

1. Crie o diretório `/etc/ssl/angie/`:
   ```console
   $ sudo mkdir -p /etc/ssl/angie/
   ```
2. Transfira os arquivos que você recebeu com sua licença:

   | Tipo de Arquivo   | Nome Original    | Onde Colocar                    |
   |-------------------|------------------|---------------------------------|
   | Certificado       | `angie-repo.crt` | `/etc/ssl/angie/angie-repo.crt` |
   | Chave Privada     | `angie-repo.key` | `/etc/ssl/angie/angie-repo.key` |

   Restrinja o acesso ao diretório e arquivos:
   ```console
   $ sudo chown -R _apt:nogroup /etc/ssl/angie/
   ```
3. Instale os pacotes auxiliares
   para adicionar o repositório Angie PRO:
   ```console
   $ sudo apt-get update
   $ sudo apt-get install -y apt-transport-https lsb-release \
                  ca-certificates curl gnupg2
   ```
4. Baixe a chave pública do repositório Angie PRO
   para verificação de pacotes:
   ```console
   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   ```
5. Adicione o repositório Angie PRO:
   ```console
   $ 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. Para configurar o repositório, crie um arquivo
   `/etc/apt/apt.conf.d/90download-angie`
   com o seguinte conteúdo:
   ```console
   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. Atualize os índices do repositório:
   ```console
   $ sudo apt-get update
   ```
8. (*Opcional*) Ao executar no modo Ambiente de Software Fechado
   ([CSE](https://wiki.astralinux.ru/pages/viewpage.action?pageId=41190634)),
   instale o pacote de chave para verificar a autenticidade dos
   arquivos executáveis do Angie PRO:
   ```console
   $ sudo apt-get install -y angie-digsig-key
   ```

   Atualize o CSE:
   ```console
   $ sudo update-initramfs -uk all
   ```

   Em seguida **reinicie o servidor**:
   ```console
   $ sudo shutdown -r now
   ```
9. Instale o pacote Angie PRO:
   ```console
   $ sudo apt-get install -y angie-pro
   ```
10. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-pro)
    que você precisar:
    ```console
    $ sudo apt-get install -y <NOME DO PACOTE>
    ```

<a id="install-deb-pro"></a>

### Debian, Ubuntu

1. Crie o diretório `/etc/ssl/angie/`:
   ```console
   $ sudo mkdir -p /etc/ssl/angie/
   ```
2. Transfira os arquivos que você recebeu com sua licença:

   | Tipo de Arquivo   | Nome Original    | Onde                            |
   |-------------------|------------------|---------------------------------|
   | Certificado       | `angie-repo.crt` | `/etc/ssl/angie/angie-repo.crt` |
   | Chave Privada     | `angie-repo.key` | `/etc/ssl/angie/angie-repo.key` |

   Restrinja o acesso ao diretório e arquivos:
   ```console
   $ sudo chown -R _apt:nogroup /etc/ssl/angie/
   ```
3. Instale os pré-requisitos
   para adicionar o repositório Angie PRO:
   ```console
   $ sudo apt-get update
   $ sudo apt-get install -y apt-transport-https lsb-release \
                  ca-certificates curl gnupg2
   ```
4. Baixe a chave pública do repositório Angie PRO
   para verificação de pacotes:
   ```console
   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   ```
5. Adicione o repositório Angie PRO:
   ```console
   $ 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. Para configurar o repositório, crie um arquivo chamado
   `/etc/apt/apt.conf.d/90download-angie`
   com o seguinte conteúdo:
   ```console
   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. Atualize os índices do repositório:
   ```console
   $ sudo apt-get update
   ```
8. Instale o pacote Angie PRO:
   ```console
   $ sudo apt-get install -y angie-pro
   ```
9. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-pro)
   que você precisar:
   ```console
   $ sudo apt-get install -y <NOME DO PACOTE>
   ```

<a id="install-osnova-pro"></a>

### OSNova

1. Instale os pré-requisitos
   para adicionar o repositório Angie PRO:
   ```console
   $ sudo apt-get update
   $ sudo apt-get install -y ca-certificates curl
   ```
2. Baixe a chave pública do repositório Angie PRO
   para verificação de pacotes:
   ```console
   $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
               https://angie.software/keys/angie-signing.gpg
   ```
3. Adicione o repositório Angie PRO:
   ```console
   $ echo "deb https://download.angie.software/angie-pro/osnova/$(egrep -o \
          '[0-9]*' /etc/osnova_version | head -1) \
          $(. /etc/os-release && echo "$VERSION_CODENAME") main" \
          | sudo tee /etc/apt/sources.list.d/angie.list > /dev/null
   ```
4. Atualize os índices do repositório:
   ```console
   $ sudo apt-get update
   ```
5. Instale o pacote Angie PRO:
   ```console
   $ sudo apt-get install -y angie
   ```
6. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-pro)
   que você precisar:
   ```console
   $ sudo apt-get install -y <NOME DO PACOTE>
   ```

<a id="install-freebsd-pro"></a>

### FreeBSD

1. Para adicionar o repositório Angie PRO, crie estes diretórios:
   ```console
   $ sudo mkdir -p /usr/local/etc/pkg/angie/ /usr/local/etc/pkg/repos/
   ```
2. Para configurar o repositório, crie um arquivo chamado
   `/usr/local/etc/pkg/repos/angie.conf`
   com o seguinte conteúdo:
   ```pkgconfig
   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. Baixe a chave pública do repositório Angie PRO
   para verificação de pacotes:
   ```console
   $ sudo curl -o /usr/local/etc/pkg/angie/angie-signing.rsa \
               https://angie.software/keys/angie-signing.rsa
   ```
4. Transfira os arquivos que você recebeu com sua licença:

   | Tipo de Arquivo   | Nome Original    | Onde                                      |
   |-------------------|------------------|-------------------------------------------|
   | Certificado       | `angie-repo.crt` | `/usr/local/etc/pkg/angie/angie-repo.crt` |
   | Chave Privada     | `angie-repo.key` | `/usr/local/etc/pkg/angie/angie-repo.key` |
5. Adicione o certificado e a chave à configuração do gerenciador de pacotes:
   ```sh
   $ 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. Atualize os índices do repositório:
   ```console
   $ sudo pkg update
   ```
7. Instale o pacote Angie PRO:
   ```console
   $ sudo pkg install -r angie -y angie-pro
   ```
8. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-pro)
   que você precisar:
   ```console
   $ sudo pkg install -r angie -y <NOME DO PACOTE>
   ```
9. Inicie o serviço:
   ```console
   $ sudo service angie start
   ```
10. Para iniciar automaticamente o Angie PRO após a reinicialização do servidor:
    ```console
    $ sudo sysrc angie_enable=YES
    ```

#### NOTE
Como o gerenciador de pacotes do FreeBSD pode determinar incorretamente a versão mais recente,
use a seguinte abordagem para atualizar pacotes já instalados:

```console
$ sudo pkg upgrade `pkg search -r angie angie-pro-[0-9] | sort -Vr | head -1 | awk {'print $1'}`
```

<a id="install-opensuse-pro"></a>

### openSUSE

1. Crie o diretório `/etc/ssl/angie/`:
   ```console
   $ sudo mkdir -p /etc/ssl/angie/
   ```
2. Transfira os arquivos que você recebeu com sua licença:

   | Tipo de Arquivo   | Nome Original    | Onde                            |
   |-------------------|------------------|---------------------------------|
   | Certificado       | `angie-repo.crt` | `/etc/ssl/angie/angie-repo.crt` |
   | Chave Privada     | `angie-repo.key` | `/etc/ssl/angie/angie-repo.key` |

   Em seguida, combine-os em um pacote `/etc/ssl/angie/angie-repo-bundle.crt`:
   ```console
   $ 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. Para adicionar o repositório, crie um arquivo chamado
   `/etc/zypp/repos.d/angie.repo`
   com o seguinte conteúdo:
   ```ini
   [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. Atualize os índices do repositório:
   ```console
   $ sudo zypper refresh
   ```
5. Instale o pacote Angie PRO:
   ```console
   $ sudo zypper install -y angie-pro
   ```
6. (*Opcional*) Instale quaisquer pacotes [extras](#install-extras-pro)
   que você precisar:
   ```console
   $ sudo zypper install -y <NOME DO PACOTE>
   ```
7. Inicie o serviço:
   ```console
   $ sudo systemctl start angie
   ```
8. Para iniciar automaticamente o Angie PRO após a reinicialização do servidor:
   ```console
   $ sudo systemctl enable angie
   ```

<a id="install-extras-pro"></a>

## Extras

Além dos pacotes que fornecem funcionalidade principal,
também publicamos vários pacotes adicionais,
tanto nossos próprios quanto de fontes terceirizadas selecionadas.

<a id="install-console-light-pro"></a>

### Painel Web Console Light

O Console Light é um
[painel web de monitoramento](https://pt.angie.software//angie/docs/configuration/monitoring.md#monitoring) leve para o Angie PRO,
publicado em nossos repositórios como o pacote `angie-pro-console-light`.
Ele é instalado da mesma forma que o pacote `angie` nas instruções acima;
para instruções de configuração, consulte a seção [Painel Web de Monitoramento Console Light](https://pt.angie.software//angie/docs/configuration/monitoring.md#monitoring).

<a id="install-dynamicmodules-pro"></a>

### Módulos Dinâmicos

Para estender a funcionalidade básica do Angie PRO,
você pode adicionar vários módulos dinâmicos.
Você pode obtê-los como pacotes prontos do nosso repositório:

| [angie-pro-module-image-filter](https://pt.angie.software//angie/docs/configuration/modules/http/http_image_filter.md#http-image-filter)                                                                                                     | Adiciona transformações de imagem para formatos JPEG, GIF, PNG e WebP.                                                                        |
|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|
| angie-pro-module-njs:<br/>[JS](https://pt.angie.software//angie/docs/installation/external-modules/http_js.md#http-js) (HTTP),<br/>[JS](https://pt.angie.software//angie/docs/installation/external-modules/stream_js.md#stream-js) (stream) | Permite usar a linguagem njs (um subconjunto de JavaScript)<br/>na configuração do Angie PRO nos contextos `http` e `stream` respectivamente. |
| [angie-pro-module-perl](https://pt.angie.software//angie/docs/configuration/modules/http/http_perl.md#http-perl)                                                                                                                             | Permite escrever manipuladores de `location` e variáveis em Perl,<br/>bem como chamar Perl a partir de SSI.                                   |
| [angie-pro-module-xslt](https://pt.angie.software//angie/docs/configuration/modules/http/http_xslt.md#http-xslt)                                                                                                                             | Adiciona um filtro que transforma respostas XML usando templates XSLT.                                                                        |

Para aplicar um módulo instalado em sua [configuração](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile),
carregue-o usando a diretiva [load_module](https://pt.angie.software//angie/docs/configuration/modules/core.md#load-module) no contexto `main`:

```nginx
load_module modules/<module name>.so;
```

Uma ampla gama de [módulos de terceiros](https://pt.angie.software//angie/docs/installation/external-modules/index.md#install-thirdpartymodules) também está disponível.

<a id="install-license"></a>

## Arquivo de Licença

Para configurar a licença para o Angie PRO:

1. Salve o arquivo de licença como `/etc/angie/license.pem`,
   definindo as mesmas permissões que você usa para seus
   [certificados de cliente](https://pt.angie.software//angie/docs/configuration/ssl.md#ssl-config).
2. Verifique se a licença é válida;
   caso contrário, verifique os detalhes:
   ```console
   $ 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. Monitore o console e os logs para quaisquer problemas de licenciamento.
   Se a licença expirar durante a operação,
   o Angie PRO emite periodicamente avisos correspondentes.
   Além disso, ao recarregar, mensagens de erro de configuração aparecerão
   se, por exemplo, o número de processos de trabalho
   especificado nos termos da licença for excedido.
4. Modifique o arquivo `/etc/angie/angie.conf`;
   após a instalação, dois parâmetros nele limitam a operação:
   ```nginx
   worker_processes 1;
   worker_connections 256;
   ```

   Após salvar o arquivo de licença,
   altere-os de acordo com os termos da sua licença, por exemplo:
   ```nginx
   worker_processes 8;
   worker_connections 65535;
   ```