Angie PRO 软件包安装#

要访问软件包仓库,您需要签署合同并购买许可证。有关许可证、合同和定制版本的问题,请联系:

  • https://angie.software/

  • +7 (495) 120 50 33

然后,配置您发行版的软件包管理器的仓库,以安装和更新 Angie PRO 及您需要的 动态模块。最后,安装 许可证文件 并更新限制。

发行版#

名称

版本

架构

AlmaLinux

9,   8

x86-64, arm64

Alpine

3.21,   3.20,   3.19,   3.18

x86-64, arm64

Alt

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

MSVSphere

9

x86-64

openSUSE

15

x86-64, arm64

Oracle Linux

9,   8

x86-64, arm64

RED OS

8
7

x86-64
x86-64, arm64

Rocky Linux

9,   8

x86-64, arm64

ROSA

Chrome 12
Fresh 12

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. 创建 /etc/ssl/angie/ 目录:

    $ sudo mkdir -p /etc/ssl/angie/
    
  2. 传输您与许可证一起收到的文件:

    文件类型

    原始名称

    位置

    证书

    angie-repo.crt

    /etc/ssl/angie/angie-repo.crt

    私钥

    angie-repo.key

    /etc/ssl/angie/angie-repo.key

    提示

    如果您拥有许可证但没有这些文件,请通过 联系我们。

  3. 要添加仓库,创建以下名为 /etc/yum.repos.d/angie.repo 的文件:

    [angie-pro]
    name=Angie PRO 仓库
    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. 安装 Angie PRO 软件包:

    $ sudo yum install -y angie-pro
    
  5. (可选) 安装您需要的任何 额外 软件包:

    $ sudo yum install -y <PACKAGE NAME>
    
  6. 启动服务:

    $ sudo systemctl start angie
    
  7. 使 Angie PRO 在服务器重启后自动启动:

    $ sudo systemctl enable angie
    

Alpine#

  1. 传输您与许可证一起收到的文件:

    文件类型

    原始名称

    位置

    证书

    angie-repo.crt

    /etc/apk/cert.pem

    私钥

    angie-repo.key

    /etc/apk/cert.key

    提示

    如果您拥有许可证但没有这些文件,请通过 联系我们。

  2. 安装添加 Angie PRO 仓库所需的先决条件:

    $ sudo apk update
    $ sudo apk add curl ca-certificates
    
  3. 下载 Angie PRO 仓库的公钥以进行软件包验证:

    $ sudo curl -o /etc/apk/keys/angie-signing.rsa \
                https://angie.software/keys/angie-signing.rsa
    
  4. 添加 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. 更新仓库索引:

    $ sudo apk update
    
  6. 安装 Angie PRO 软件包:

    $ sudo apk add angie-pro
    
  7. (可选) 安装您需要的任何 额外 软件包:

    $ sudo apk add <PACKAGE NAME>
    
  8. 启动服务:

    $ sudo service angie start
    
  9. 使 Angie PRO 在服务器重启时自动启动:

    $ sudo rc-update add angie
    

ALT Linux#

  1. 创建 /etc/ssl/angie 目录:

    $ sudo mkdir -p /etc/ssl/angie/
    
  2. 传输您与许可证一起收到的文件:

    文件类型

    原始名称

    位置

    证书

    angie-repo.crt

    /etc/ssl/angie/angie-repo.crt

    私钥

    angie-repo.key

    /etc/ssl/angie/angie-repo.key

    提示

    如果您拥有许可证但没有这些文件,请通过 联系我们。

  3. 下载 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
    
  4. 保存密钥的签名:

    $ 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. 添加 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
    
  6. 将 Angie PRO 仓库的 apt 配置文件保存为 /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. 更新仓库索引:

    $ sudo apt-get update
    
  8. 安装 Angie PRO 软件包:

    $ sudo apt-get install -y angie-pro
    
  9. (可选) 安装您需要的任何 额外 软件包:

    $ sudo apt-get install -y <PACKAGE NAME>
    
  10. 启动服务:

    $ sudo systemctl start angie
    
  11. 使 Angie PRO 在服务器重启时自动启动:

    $ sudo systemctl enable angie
    

Astra SE#

  1. 创建 /etc/ssl/angie/ 目录:

    $ sudo mkdir -p /etc/ssl/angie/
    
  2. 传输您与许可证一起收到的文件:

    文件类型

    原始名称

    位置

    证书

    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/
    
  3. 安装添加 Angie PRO 仓库的先决条件:

    $ sudo apt-get update
    $ sudo apt-get install -y apt-transport-https lsb-release \
                   ca-certificates curl gnupg2
    
  4. 下载 Angie PRO 仓库的公钥 以进行软件包验证:

    $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
                https://angie.software/keys/angie-signing.gpg
    
  5. 添加 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. 要配置该仓库,请创建名为 /etc/apt/apt.conf.d/90download-angie 的文件,内容如下:

    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. 更新仓库索引:

    $ sudo apt-get update
    
  8. (可选) 在运行封闭软件环境时 (CSE), 安装 Angie PRO 二进制验证的密钥包:

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

    更新 CSE:

    $ sudo update-initramfs -uk all
    

    然后 重启服务器

    $ sudo shutdown -r now
    
  9. 安装 Angie PRO 软件包:

    $ sudo apt-get install -y angie-pro
    
  10. (可选) 安装任何 额外 您需要的软件包:

    $ sudo apt-get install -y <PACKAGE NAME>
    

Debian, Ubuntu#

  1. 创建 /etc/ssl/angie/ 目录:

    $ sudo mkdir -p /etc/ssl/angie/
    
  2. 转移您收到的许可证文件:

    文件类型

    原始名称

    在哪里

    证书

    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/
    
  3. 安装添加 Angie PRO 仓库的先决条件:

    $ sudo apt-get update
    $ sudo apt-get install -y apt-transport-https lsb-release \
                   ca-certificates curl gnupg2
    
  4. 下载 Angie PRO 仓库的公钥 以进行软件包验证:

    $ sudo curl -o /etc/apt/trusted.gpg.d/angie-signing.gpg \
                https://angie.software/keys/angie-signing.gpg
    
  5. 添加 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. 要配置该仓库,请创建名为 /etc/apt/apt.conf.d/90download-angie 的文件,内容如下:

    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. 更新仓库索引:

    $ sudo apt-get update
    
  8. 安装 Angie PRO 软件包:

    $ sudo apt-get install -y angie-pro
    
  9. (可选) 安装任何 额外 您需要的软件包:

    $ sudo apt-get install -y <PACKAGE NAME>
    

FreeBSD#

  1. 要添加 Angie PRO 仓库,请创建这些目录:

    $ sudo mkdir -p /usr/local/etc/pkg/angie/ /usr/local/etc/pkg/repos/
    
  2. 要配置该仓库,请创建名为 /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
    }
    
  3. 下载 Angie PRO 仓库的公钥 以进行软件包验证:

    $ sudo curl -o /usr/local/etc/pkg/angie/angie-signing.rsa \
                https://angie.software/keys/angie-signing.rsa
    
  4. 转移您收到的许可证文件:

    文件类型

    原始名称

    在哪里

    证书

    angie-repo.crt

    /usr/local/etc/pkg/angie/angie-repo.crt

    私钥

    angie-repo.key

    /usr/local/etc/pkg/angie/angie-repo.key

    提示

    如果您有许可证但没有这些文件,请发送电子邮件至

  5. 将证书和密钥添加到包管理器的配置中:

    $ 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. 更新仓库索引:

    $ sudo pkg update
    
  7. 安装 Angie PRO 软件包:

    $ sudo pkg install -y angie-pro
    
  8. (可选) 安装任何 额外 您需要的软件包:

    $ sudo pkg install -y <PACKAGE NAME>
    
  9. 启动服务:

    $ sudo service angie start
    
  10. 要在服务器重启时自动启动 Angie PRO:

    $ sudo sysrc angie_enable=YES
    

openSUSE#

  1. 创建 /etc/ssl/angie 目录:

    $ sudo mkdir -p /etc/ssl/angie/
    
  2. 转移您收到的许可证文件:

    文件类型

    原始名称

    在哪里

    证书

    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
    

    提示

    如果您有许可证但没有这些文件,请发送电子邮件至

  3. 要添加该仓库,请创建名为 /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
    
  4. 更新仓库索引:

    $ sudo zypper refresh
    
  5. 安装 Angie PRO 软件包:

    $ sudo zypper install -y angie-pro
    
  6. (可选) 安装任何 额外 您需要的软件包:

    $ sudo zypper install -y <PACKAGE NAME>
    
  7. 启动服务:

    $ sudo systemctl start angie
    
  8. 要在服务器重启后自动启动 Angie PRO:

    $ sudo systemctl enable angie
    

附加内容#

除了提供基本功能的软件包外, 我们还发布了一些额外的软件包, 包括我们自己的和从精心挑选的第三方来源构建的。

控制台轻量版#

控制台轻量版是一个轻量级的实时监控界面,用于 Angie PRO, 在我们的仓库中发布为 angie-pro-console-light。 它的安装方式与上述 angie 软件包相同; 请参阅 Console Light 网络监控面板 中的配置步骤。

动态模块#

为了扩展 Angie PRO 的基本功能, 您可以添加各种动态模块, 这些模块可以作为现成的软件包从我们的仓库中获取:

angie-pro-module-image-filter

添加一个过滤器来转换 JPEG、GIF、PNG 和 WebP 图像。

angie-pro-module-njs: HTTP JS 模块, 流式 JS 模块

使得在 Angie 配置中分别在 httpstream 上下文中使用 njs(JavaScript 子集)成为可能。

angie-pro-module-perl

允许用 Perl 编写 location 和变量处理程序, 还允许从 SSI 中调用 Perl。

angie-pro-module-xslt

添加一个过滤器来使用 XSLT 样式表转换 XML 响应。

我们还在我们的仓库中构建并发布以下第三方模块包:

angie-pro-module-auth-jwt

添加客户端 JWT 认证。

angie-pro-module-auth-ldap

添加对多个 LDAP 服务器进行身份验证的支持。

angie-pro-module-auth-pam

添加 PAM 认证支持。

angie-pro-module-auth-spnego

添加 SPNEGO、GSSAPI 支持。

angie-pro-module-brotli

启用 Brotli 用于动态和静态响应压缩。

angie-pro-module-cache-purge

启用清除 FastCGI、代理、SCGI 和 uWSGI 缓存内容。

angie-pro-module-cgi

启用 CGI。

angie-pro-module-dav-ext

扩展 WebDAV 方法支持,添加 PROPFIND 和 OPTIONS。

angie-pro-module-dynamic-limit-req

启用动态锁定 IP 并定期释放它们。

angie-pro-module-echo

启用在配置文件中使用 echosleeptimeexec 和其他 shell 风格的命令。

angie-pro-module-enhanced-memcached

增强内置 Memcached 模块的功能。

angie-pro-module-eval

允许在变量中捕获子请求的响应体。

angie-pro-module-geoip2: http_geoip2, stream_geoip2

允许在 MaxMind GeoIP2 数据库中进行地理数据查找。

angie-pro-module-headers-more

允许设置和清除输入和输出头部。

angie-pro-module-http-auth-radius

启用 Radius 支持。

angie-pro-module-keyval

允许从键值对创建变量。

angie-pro-module-lua: http_lua_module, stream_lua_module

允许在 Angie PRO 配置中使用 Lua 在 httpstream 上下文中。

angie-pro-module-modsecurity

添加一个连接器,启用 ModSecurity 规则。

备注

此包需要 额外设置

angie-pro-module-ndk

为模块开发添加 Nginx 开发工具包 (NDK)。

angie-pro-module-otel

允许将遥测数据发送到 OpenTelemetry 收集器。

angie-pro-module-opentracing

通过 OpenTracing 添加 Angie PRO 请求的分布式追踪; 包括 Zipkin 和 DataDog 的数据导出插件。

angie-pro-module-postgres

允许与 PostgreSQL 数据库进行直接通信。

angie-pro-module-redis2

启用 Redis 2.0 作为 HTTP 上游。

angie-pro-module-rtmp

允许用于实时流媒体和视频点播的 RTMP。

angie-pro-module-set-misc

重写 模块添加各种 set_xxx 指令。

angie-pro-module-subs

允许在 HTTP 响应体中进行正则表达式字符串替换。

angie-pro-module-testcookie

通过基于 Cookie 的挑战响应机制启用机器人缓解。

angie-pro-module-upload

添加 multipart/form-data 编码 (RFC 1867) 以支持文件上传, 启用可恢复的上传。

angie-pro-module-vod

允许为 HLS、HDS、MSS 和 DASH 流媒体重新打包 .mp4 文件。

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

angie-pro-module-zip

允许动态打包 ZIP 归档。

angie-pro-module-zstd

启用 Zstandard 压缩。

要在 配置 中使用已安装的模块, 请使用 load_module 指令加载它。

许可证文件#

要配置 Angie PRO 的许可证:

  1. 将许可证文件保存为 /etc/angie/license.pem, 设置您用于 客户端证书 的权限。

  2. 验证许可证是否有效; 否则,请检查详细信息:

    $ sudo angie -t
    
      angie: 找到有效许可证:
      angie:   - 所有者: CN=Angie Client License
      angie:   - 有效期: Jul  8 21:00:00 2024 GMT .. Jul 17 20:59:59 2024 GMT
      angie:
      angie: 限制:
      angie:   - worker_processes_limit: 8
      angie:   - worker_connections_limit: 0
    
  3. 监控控制台和日志以获取任何许可证问题。 如果许可证在操作中期到期, Angie PRO 会定期记录指示此情况的警告。 此外,在重新加载时,如果例如,许可证条款中规定的工作进程数量 被超出,它会报告配置错误。

  4. 更新 /etc/angie/angie.conf; 安装后,它有两个限制操作的设置:

    worker_processes 1;
    worker_connections 256;
    

    保存许可证文件后, 根据您的许可证条款更新设置,例如:

    worker_processes 8;
    worker_connections 65535;