Angie PRO 软件包安装

要访问软件包仓库，您需要签署合同并购买许可证。有关许可证、合同和自定义构建的问题，请联系：

• https://angie.software/

• +7 (495) 120 50 33

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

发行版

名称	版本	架构
AlmaLinux	9,   8	x86-64, arm64
Alpine	3.20,   3.19,   3.18,   3.17	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：

   AlmaCentOSMSVSphereOracleRED OSRockyROSA ChromeROSA 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. 安装 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 仓库：

   ALT 10ALT 10 SPALT 8 SP

   $ 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. 保存一个 apt 配置文件用于 Angie PRO 仓库，路径为 /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
   

附加组件

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

Console Light

Console Light 是一款轻量级的实时监控界面，用于 Angie PRO，作为 angie-pro-console-light 在我们的仓库中发布。它的安装方式与上述步骤中的 angie 包相同；有关配置步骤，请参见 监控。

动态模块

为了扩展 Angie PRO 的基本功能，您可以从我们的仓库添加各种动态模块，这些模块作为现成的软件包提供：

angie-pro-module-image-filter	添加一个过滤器以转换 JPEG、GIF、PNG 和 WebP 图片。
angie-pro-module-njs: HTTP JS 模块， 流式 JS 模块	允许在 Angie 配置中使用 njs（JavaScript 的子集），分别在 http 和 stream 上下文中。
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-spnego	添加 SPNEGO，GSSAPI 支持。
angie-pro-module-brotli	启用 Brotli 用于动态和静态响应压缩。
angie-pro-module-cache-purge	允许清除 FastCGI、代理、SCGI 和 uWSGI 缓存内容。
angie-pro-module-dav-ext	扩展 WebDAV 方法支持，添加 PROPFIND 和 OPTIONS。
angie-pro-module-dynamic-limit-req	启用动态锁定 IP，并定期释放。
angie-pro-module-echo	允许在配置文件中使用 echo、sleep、time、exec 和其他 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-keyval	启用从键值对创建变量。
angie-pro-module-lua: http_lua_module, stream_lua_module	分别在 http 和 stream 上下文中启用在 Angie PRO 配置中使用 Lua。
angie-pro-module-modsecurity	添加一个连接器以启用 ModSecurity 规则。 备注 该软件包需要 额外设置。
angie-pro-module-ndk	添加 Nginx Development Kit (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	向 Rewrite 模块添加各种 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	启用将 .mp4 文件重新打包为 HLS、HDS、MSS 和 DASH 流。
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:   - 期间: 2024年7月8日 21:00:00 GMT .. 2024年7月17日 20:59:59 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;