Instalación de Angie PRO mediante paquetes

Para acceder al repositorio de paquetes, debe firmar un contrato y adquirir una licencia. Para preguntas sobre licencias, contratos y compilaciones personalizadas, póngase en contacto con:

• https://angie.software/

• +7 (495) 120 50 33

Luego, configure el repositorio para el gestor de paquetes de su distribución para instalar y actualizar Angie PRO y los módulos dinámicos que necesite. Finalmente, instale el archivo de licencia y elimine las restricciones.

Distribuciones

Nombre	Versiones	Arquitecturas
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

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

1. Cree el directorio /etc/ssl/angie/:

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

2. Transfiera los archivos que recibió con su licencia:

   Tipo de archivo	Nombre original	Dónde
   Certificado	angie-repo.crt	/etc/ssl/angie/angie-repo.crt
   Clave privada	angie-repo.key	/etc/ssl/angie/angie-repo.key

   Truco

   Si tiene la licencia pero no estos archivos, envíenos un correo electrónico a .

3. Para añadir el repositorio, cree el archivo /etc/yum.repos.d/angie.repo con el siguiente contenido:

   AlmaCentOSMSVSphereOracleRED OSRockyROSA ChromeROSA FreshROSA FreshSberLinux

   [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. Instale el paquete Angie PRO:

   $ sudo yum install -y angie-pro
   $ # -- OR --
   $ sudo dnf install -y angie-pro
   

5. (Opcional) Instale cualquier paquete adicional que necesite:

   $ sudo yum install -y <NOMBRE DEL PAQUETE>
   $ # -- OR --
   $ sudo dnf install -y <NOMBRE DEL PAQUETE>
   

6. Inicie el servicio:

   $ sudo systemctl start angie
   

7. Para iniciar automáticamente Angie PRO después del reinicio del servidor:

   $ sudo systemctl enable angie
   

Alpine

1. Transfiera los archivos que recibió con su licencia:

   Tipo de archivo	Nombre original	Dónde
   Certificado	angie-repo.crt	/etc/apk/cert.pem
   Clave privada	angie-repo.key	/etc/apk/cert.key

   Truco

   Si tiene la licencia pero no estos archivos, envíenos un correo electrónico a .

2. Instale los paquetes auxiliares para añadir el repositorio de Angie PRO:

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

3. Descargue la clave pública del repositorio de Angie PRO para la verificación de paquetes:

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

4. Añada el repositorio de 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. Actualice los índices del repositorio:

   $ sudo apk update
   

6. Instale el paquete Angie PRO:

   $ sudo apk add angie-pro
   

7. (Opcional) Instale cualquier paquete adicional que necesite:

   $ sudo apk add <NOMBRE DEL PAQUETE>
   

8. Inicie el servicio:

   $ sudo service angie start
   

9. Para iniciar automáticamente Angie PRO después del reinicio del servidor:

   $ sudo rc-update add angie
   

Alt

1. Cree el directorio /etc/ssl/angie/:

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

2. Transfiera los archivos que recibió con su licencia:

   Tipo de Archivo	Nombre Original	Dónde
   Certificado	angie-repo.crt	/etc/ssl/angie/angie-repo.crt
   Clave Privada	angie-repo.key	/etc/ssl/angie/angie-repo.key

   Truco

   Si no tiene estos archivos pero tiene una licencia, contacte con soporte: .

3. Descargue la clave pública del repositorio Angie PRO para la verificación de paquetes:

   $ 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. Guarde la firma de la clave:

   $ 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. Añada el repositorio Angie PRO:

   Alt 11Alt 10Alt SP 10Alt SP 8

   $ 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
   

6. Cree el archivo de configuración apt del repositorio Angie PRO en /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. Actualice los índices del repositorio:

   $ sudo apt-get update
   

8. Instale el paquete Angie PRO:

   $ sudo apt-get install -y angie-pro
   

9. (Opcional) Instale cualquier paquete extra que necesite:

   $ sudo apt-get install -y <NOMBRE DEL PAQUETE>
   

10. Inicie el servicio:

    $ sudo systemctl start angie
    

11. Actualice los índices del repositorio:

    $ sudo apt-get update
    

12. Instale el paquete Angie PRO:

    $ sudo apt-get install -y angie-pro
    

13. (Opcional) Instale cualquier paquete extra que necesite:

    $ sudo apt-get install -y <NOMBRE DEL PAQUETE>
    

14. Inicie el servicio:

    $ sudo systemctl start angie
    

15. Para iniciar Angie PRO automáticamente después del reinicio del servidor:

    $ sudo systemctl enable angie
    

Contenido del segundo archivo:

Astra SE

1. Cree el directorio /etc/ssl/angie/:

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

2. Transfiera los archivos que recibió con su licencia:

   Tipo de Archivo	Nombre Original	Dónde
   Certificado	angie-repo.crt	/etc/ssl/angie/angie-repo.crt
   Clave Privada	angie-repo.key	/etc/ssl/angie/angie-repo.key

   Truco

   Si no tiene estos archivos pero tiene una licencia, contacte con soporte: .

   Restrinja el acceso al directorio y archivos:

   $ sudo chown -R _apt:nogroup /etc/ssl/angie/
   

3. Instale los paquetes auxiliares para añadir el repositorio Angie PRO:

   $ sudo apt-get update
   $ sudo apt-get install -y apt-transport-https lsb-release \
                  ca-certificates curl gnupg2
   

4. Descargue la clave pública del repositorio Angie PRO para la verificación de paquetes:

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

5. Añada el repositorio 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. Para configurar el repositorio, cree un archivo /etc/apt/apt.conf.d/90download-angie con el siguiente contenido:

   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. Actualice los índices del repositorio:

   $ sudo apt-get update
   

8. (Opcional) Cuando se ejecuta en modo Entorno de Software Cerrado (CSE), instale el paquete de clave para verificar la autenticidad de los archivos ejecutables de Angie PRO:

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

   Actualice el CSE:

   $ sudo update-initramfs -uk all
   

   Luego reinicie el servidor:

   $ sudo shutdown -r now
   

9. Instale el paquete Angie PRO:

   $ sudo apt-get install -y angie-pro
   

10. (Opcional) Instale cualquier paquete extra que necesite:

    $ sudo apt-get install -y <NOMBRE DEL PAQUETE>
    

Debian, Ubuntu

1. Cree el directorio /etc/ssl/angie/:

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

2. Transfiera los archivos que recibió con su licencia:

   Tipo de Archivo	Nombre Original	Dónde
   Certificado	angie-repo.crt	/etc/ssl/angie/angie-repo.crt
   Clave Privada	angie-repo.key	/etc/ssl/angie/angie-repo.key

   Truco

   Si no tiene estos archivos pero tiene una licencia, contacte con soporte: .

   Restringa el acceso al directorio y a los archivos:

   $ sudo chown -R _apt:nogroup /etc/ssl/angie/
   

3. Instale los requisitos previos para añadir el repositorio Angie PRO:

   $ sudo apt-get update
   $ sudo apt-get install -y apt-transport-https lsb-release \
                  ca-certificates curl gnupg2
   

4. Descargue la clave pública del repositorio Angie PRO para la verificación de paquetes:

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

5. Añada el repositorio 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. Para configurar el repositorio, cree un archivo llamado /etc/apt/apt.conf.d/90download-angie con el siguiente contenido:

   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. Actualice los índices del repositorio:

   $ sudo apt-get update
   

8. Instale el paquete Angie PRO:

   $ sudo apt-get install -y angie-pro
   

9. (Opcional) Instale cualquier paquete extra que necesite:

   $ sudo apt-get install -y <NOMBRE DEL PAQUETE>
   

OSNova

1. Instale los requisitos previos para añadir el repositorio Angie PRO:

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

2. Descargue la clave pública del repositorio Angie PRO para la verificación de paquetes:

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

3. Añada el repositorio Angie PRO:

   $ 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. Actualice los índices del repositorio:

   $ sudo apt-get update
   

5. Instale el paquete Angie PRO:

   $ sudo apt-get install -y angie
   

6. (Opcional) Instale cualquier paquete extra que necesite:

   $ sudo apt-get install -y <NOMBRE DEL PAQUETE>
   

FreeBSD

1. Para añadir el repositorio de Angie PRO, crea estos directorios:

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

2. Para configurar el repositorio, crea un archivo llamado /usr/local/etc/pkg/repos/angie.conf con el siguiente contenido:

   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. Descarga la clave pública del repositorio de Angie PRO para la verificación de paquetes:

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

4. Transfiere los archivos que recibiste con tu licencia:

   Tipo de Archivo	Nombre Original	Dónde
   Certificado	angie-repo.crt	/usr/local/etc/pkg/angie/angie-repo.crt
   Clave Privada	angie-repo.key	/usr/local/etc/pkg/angie/angie-repo.key

   Truco

   Si no tienes estos archivos pero tienes una licencia, contacta con soporte: .

5. Añade el certificado y la clave a la configuración del gestor de paquetes:

   $ 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. Actualiza los índices del repositorio:

   $ sudo pkg update
   

7. Instala el paquete Angie PRO:

   $ sudo pkg install -y angie-pro
   

8. (Opcional) Instala cualquier paquete extra que necesites:

   $ sudo pkg install -y <NOMBRE DEL PAQUETE>
   

9. Inicia el servicio:

   $ sudo service angie start
   

10. Para iniciar automáticamente Angie PRO después del reinicio del servidor:

    $ sudo sysrc angie_enable=YES
    

openSUSE

1. Crea el directorio /etc/ssl/angie/:

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

2. Transfiere los archivos que recibiste con tu licencia:

   Tipo de Archivo	Nombre Original	Dónde
   Certificado	angie-repo.crt	/etc/ssl/angie/angie-repo.crt
   Clave Privada	angie-repo.key	/etc/ssl/angie/angie-repo.key

   Luego combínalos en un paquete /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
   

   Truco

   Si no tienes estos archivos pero tienes una licencia, contacta con soporte: .

3. Para añadir el repositorio, crea un archivo llamado /etc/zypp/repos.d/angie.repo con el siguiente contenido:

   [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. Actualiza los índices del repositorio:

   $ sudo zypper refresh
   

5. Instala el paquete Angie PRO:

   $ sudo zypper install -y angie-pro
   

6. (Opcional) Instala cualquier paquete extra que necesites:

   $ sudo zypper install -y <NOMBRE DEL PAQUETE>
   

7. Inicia el servicio:

   $ sudo systemctl start angie
   

8. Para iniciar Angie PRO automáticamente después del reinicio del servidor:

   $ sudo systemctl enable angie
   

Extras

Además de los paquetes que proporcionan funcionalidad básica, también publicamos varios paquetes adicionales, tanto propios como de fuentes de terceros seleccionadas.

Console Light Web Panel

Console Light es un panel web ligero de monitorización para Angie PRO, publicado en nuestros repositorios como el paquete angie-pro-console-light. Se instala de la misma manera que el paquete angie en las instrucciones anteriores; para instrucciones de configuración, consulta la sección Panel de monitorización web Console Light.

Módulos Dinámicos

Para ampliar la funcionalidad básica de Angie PRO, puedes añadir varios módulos dinámicos. Puedes obtenerlos como paquetes preparados desde nuestro repositorio:

angie-pro-module-image-filter	Añade transformaciones de imágenes para formatos JPEG, GIF, PNG y WebP.
angie-pro-module-njs: JS (HTTP), JS (stream)	Permite usar el lenguaje njs (un subconjunto de JavaScript) en la configuración de Angie PRO en los contextos http y stream respectivamente.
angie-pro-module-perl	Permite escribir manejadores de location y variables en Perl, así como llamar a Perl desde SSI.
angie-pro-module-xslt	Añade un filtro que transforma respuestas XML usando plantillas XSLT.

Para aplicar un módulo instalado en tu configuración, cárgalo usando la directiva load_module en el contexto main:

load_module modules/<nombre del módulo>.so;

También está disponible una amplia gama de módulos de terceros.

Archivo de Licencia

Para configurar la licencia de Angie PRO:

1. Guarda el archivo de licencia como /etc/angie/license.pem, estableciendo los mismos permisos que usas para tus certificados de cliente.

2. Verifica que la licencia sea válida; de lo contrario, verifica los detalles:

   $ 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. Monitoriza la consola y los registros para detectar cualquier problema de licencia. Si la licencia expira durante la operación, Angie PRO emite periódicamente advertencias correspondientes. Además, al recargar, aparecerán mensajes de error de configuración si, por ejemplo, se excede el número de procesos de trabajo especificado en los términos de la licencia.

4. Modifica el archivo /etc/angie/angie.conf; después de la instalación, dos parámetros en él limitan la operación:

   worker_processes 1;
   worker_connections 256;
   

   Después de guardar el archivo de licencia, cámbialos según los términos de tu licencia, por ejemplo:

   worker_processes 8;
   worker_connections 65535;