Instalação do Angie via Pacotes

Para instalar e atualizar o Angie usando o gerenciador de pacotes da sua distribuição, adicione e configure o repositório apropriado.

Distribuições

Nome	Versões	Arquiteturas
AlmaLinux	10,   9,   8	x86-64, arm64
Alpine	3.22,   3.21,   3.20,   3.19	x86-64, arm64
Alt	11,   10 8	x86-64, arm64 x86-64
Astra SE	4.7 1.8, 1.7	arm64 x86-64
CentOS	10,   9	x86-64, arm64
Debian	13,   12,   11	x86-64, arm64
FreeBSD	14,   13	x86-64, arm64
MSVSphere	9	x86-64
openSUSE	15	x86-64, arm64
Oracle Linux	10,   9,   8	x86-64, arm64
OSNova	3.3.0,   2.13	x86-64
RED OS	8,   7	x86-64, arm64
Rocky Linux	10,   9,   8	x86-64, arm64
ROSA	Chrome 13 Chrome 12 Fresh 12	x86-64 x86-64, arm64 x86-64
SberLinux	9	x86-64
Ubuntu	24.04,   22.04,   20.04	x86-64, arm64

Builds de Teste

Testamos e compilamos código do nosso repositório diariamente, e estes builds noturnos são adequados para explorar novos recursos antes dos lançamentos oficiais.

A versão dos builds noturnos sempre corresponde ao próximo lançamento. O processo de nomenclatura e instalação é geralmente similar ao mostrado abaixo, mas ao invés do prefixo de caminho https://download.angie.software/angie/* use https://download.angie.software/angie-nightly/*.

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

1. Para adicionar o repositório, crie um arquivo chamado /etc/yum.repos.d/angie.repo com o seguinte conteúdo:

   AlmaCentOSMSVSphereOracleRED OSRockyROSA ChromeROSA FreshSberLinux

   [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. Instale o pacote Angie:

   $ sudo yum install -y angie
   $ # -- OU --
   $ sudo dnf install -y angie
   

3. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo yum install -y <NOME DO PACOTE>
   $ # -- OU --
   $ sudo dnf install -y <NOME DO PACOTE>
   

4. Inicie o serviço:

   $ sudo systemctl start angie
   

5. Para iniciar automaticamente o Angie após a reinicialização do servidor:

   $ sudo systemctl enable angie
   

Alpine

1. Instale os pré-requisitos para adicionar o repositório do Angie:

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

2. Baixe a chave pública do repositório do Angie para verificação de pacotes:

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

3. Adicione o repositório do 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. Atualize os índices do repositório:

   $ sudo apk update
   

5. Instale o pacote do Angie:

   $ sudo apk add angie
   

6. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo apk add <NOME DO PACOTE>
   

7. Inicie o serviço:

   $ sudo service angie start
   

8. Para inicializar automaticamente o Angie após a reinicialização do servidor:

   $ sudo rc-update add angie
   

Alt

1. Crie o diretório /etc/ssl/angie/:

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

2. Instale os pré-requisitos para adicionar o repositório do Angie:

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

3. Baixe a chave pública do repositório do Angie para verificação de pacotes:

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

4. Importe a chave baixada para o chaveiro confiável:

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

5. Salve a assinatura da chave:

   $ 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. Adicione o repositório do Angie:

   Alt 11Alt 10Alt SP 10Alt SP 8

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

7. Atualize os índices do repositório:

   $ sudo apt-get update
   

8. Instale o pacote do Angie:

   $ sudo apt-get install -y angie
   

9. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo apt-get install -y <NOME DO PACOTE>
   

10. Inicie o serviço:

    $ sudo systemctl start angie
    

11. Para inicializar automaticamente o Angie após a reinicialização do servidor:

    $ sudo systemctl enable angie
    

Astra SE

1. Instale os pré-requisitos para adicionar o repositório do Angie:

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

2. Baixe a chave pública do repositório do Angie para verificação de pacotes:

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

3. Adicione o repositório do 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. Atualize os índices do repositório:

   $ sudo apt-get update
   

5. (Opcional) Ao executar um Ambiente de Software Fechado (CSE), instale o pacote de chave para verificação de binários do Angie:

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

   Atualize o CSE:

   $ sudo update-initramfs -uk all
   

   Em seguida, reinicie o servidor:

   $ sudo shutdown -r now
   

6. Instale o pacote do Angie:

   $ sudo apt-get install -y angie
   

7. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo apt-get install -y <NOME DO PACOTE>
   

Debian, Ubuntu

1. Instale os pacotes auxiliares para adicionar o repositório do Angie:

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

2. Baixe a chave pública do repositório do Angie para verificação de pacotes:

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

3. Adicione o repositório do 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. Atualize os índices do repositório:

   $ sudo apt-get update
   

5. Instale o pacote do Angie:

   $ sudo apt-get install -y angie
   

6. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo apt-get install -y <NOME DO PACOTE>
   

OSNova

1. Instale os pacotes auxiliares para adicionar o repositório do Angie:

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

2. Baixe a chave pública do repositório do Angie para verificação de pacotes:

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

3. Adicione o repositório do Angie:

   $ echo "deb https://download.angie.software/angie/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:

   $ sudo apt-get update
   

5. Instale o pacote do Angie:

   $ sudo apt-get install -y angie
   

6. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo apt-get install -y <NOME DO PACOTE>
   

FreeBSD

1. Para adicionar o repositório do Angie, crie os diretórios:

   $ 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:

   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. Baixe a chave pública do repositório do Angie para autenticação de pacotes:

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

4. Atualize os índices do repositório:

   $ sudo pkg update
   

5. Instale o pacote do Angie:

   $ sudo pkg install -y angie
   

6. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo pkg install -y <NOME DO PACOTE>
   

7. Inicie o serviço:

   $ sudo service angie start
   

8. Para inicializar automaticamente o Angie após a reinicialização do servidor:

   $ sudo sysrc angie_enable=YES
   

openSUSE

1. Para adicionar o repositório, crie um arquivo chamado /etc/zypp/repos.d/angie.repo com o seguinte conteúdo:

   [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. Atualize os índices do repositório:

   $ sudo zypper refresh
   

3. Instale o pacote do Angie:

   $ sudo zypper install -y angie
   

4. (Opcional) Instale quaisquer pacotes extras que você precisar:

   $ sudo zypper install -y <NOME DO PACOTE>
   

5. Inicie o serviço:

   $ sudo systemctl start angie
   

6. Para inicializar automaticamente o Angie após a reinicialização do servidor:

   $ sudo systemctl enable angie
   

Extras

Além dos pacotes que fornecem a funcionalidade básica, também publicamos alguns pacotes extras, tanto nossos próprios quanto construídos a partir de fontes de terceiros selecionadas.

Painel Web Console Light

Console Light é um painel web leve de monitoramento para o Angie, publicado como angie-console-light em nossos repositórios. É instalado da mesma forma que o pacote angie nos passos acima; veja os passos de configuração em Painel Web de Monitoramento Console Light.

Módulos Dinâmicos

Para estender a funcionalidade básica do Angie, você pode adicionar vários módulos dinâmicos. Os módulos podem ser construídos a partir do código-fonte contra uma versão correspondente do Angie, mas é mais fácil obtê-los como pacotes prontos do nosso repositório:

angie-module-image-filter	Adiciona um filtro para transformar imagens JPEG, GIF, PNG e WebP.
angie-module-njs: JS (HTTP), JS (streaming)	Permite usar njs (um subconjunto de JavaScript) na configuração do Angie nos contextos http e stream, respectivamente.
angie-module-perl	Permite escrever manipuladores de location e variáveis em Perl, e também invocar Perl a partir de SSI.
angie-module-wamr	Permite integração com WebAssembly Micro Runtime para executar código WASM.
angie-module-wasm	Adiciona suporte básico para WASM.
angie-module-wasmtime	Permite integração com o runtime Wasmtime para executar código WASM.
angie-module-xslt	Adiciona um filtro para transformar respostas XML com folhas de estilo XSLT.

Para usar um módulo instalado em uma configuração, carregue-o usando a diretiva load_module no contexto main:

load_module modules/<nome do módulo>.so;

Uma ampla gama de módulos de terceiros também está disponível.