安吉软件包安装#

要使用您发行版的包管理器安装和更新安吉，请添加并配置适当的存储库。

小技巧

我们每天都会测试并构建来自仓库的代码，这些每夜构建版本适合在正式发布前尝试新功能。

每夜构建的版本始终对应即将发布的版本。命名和安装方式通常与下文所示相同，但请将路径前缀 https://download.angie.software/angie/* 替换为 https://download.angie.software/angie-nightly/*。

发行版#

名称	版本	架构
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

阿尔玛、CentOS、MSVSphere、Oracle、RED OS、Rocky、ROSA、SberLinux#

要添加存储库，请创建一个名为 /etc/yum.repos.d/angie.repo 的文件，内容如下：

[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

[angie]
name=Angie repo
baseurl=https://download.angie.software/angie/centos/$releasever/
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc

[angie]
name=Angie repo
baseurl=https://download.angie.software/angie/msvsphere/$releasever/
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc

[angie]
name=Angie repo
baseurl=https://download.angie.software/angie/oracle/$releasever/
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc

[angie]
name=Angie repo
baseurl=https://download.angie.software/angie/redos/$releasever/
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc

[angie]
name=Angie repo
baseurl=https://download.angie.software/angie/rocky/$releasever/
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc

[angie]
name=Angie repo
baseurl=https://download.angie.software/angie/rosa-chrome/$releasever/
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
priority=9

[angie]
name=Angie repo
baseurl=https://download.angie.software/angie/rosa/$releasever/
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
priority=9

[angie]
name=Angie repo
baseurl=https://download.angie.software/angie/sberlinux/$releasever/
gpgcheck=1
enabled=1
gpgkey=https://angie.software/keys/angie-signing.gpg.asc
priority=9

安装 Angie 软件包：
```
$ sudo yum install -y angie
```
(可选) 安装您需要的任何额外软件包：
```
$ sudo yum install -y <PACKAGE NAME>
```
启动服务：
```
$ sudo systemctl start angie
```
使 Angie 在服务器重启后自动启动：
```
$ sudo systemctl enable angie
```

Alpine#

安装添加 Angie 存储库所需的先决条件：

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

下载 Angie 存储库的公钥以进行软件包验证：

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

添加 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

更新存储库索引：
```
$ sudo apk update
```
安装 Angie 软件包：
```
$ sudo apk add angie
```
(可选) 安装您需要的任何额外软件包：
```
$ sudo apk add <PACKAGE NAME>
```
启动服务：
```
$ sudo service angie start
```
使 Angie 在服务器重启时自动启动：
```
$ sudo rc-update add angie
```

ALT Linux#

创建 /etc/ssl/angie 目录：
```
$ sudo mkdir -p /etc/ssl/angie/
```

安装添加 Angie 存储库所需的先决条件：

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

下载 Angie 存储库的公钥以进行软件包验证：

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

将下载的密钥导入受信任的密钥环：

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

保存密钥的签名：

$ 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

添加 Angie 存储库：

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

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

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

更新存储库索引：
```
$ sudo apt-get update
```
安装 Angie 软件包：
```
$ sudo apt-get install -y angie
```
(可选) 安装您需要的任何额外软件包：
```
$ sudo apt-get install -y <PACKAGE NAME>
```
启动服务：
```
$ sudo systemctl start angie
```
使 Angie 在服务器重启后自动启动：
```
$ sudo systemctl enable angie
```

Astra SE#

安装添加 Angie 存储库所需的先决条件：

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

下载 Angie 存储库的公钥以进行软件包验证：

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

添加 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

更新存储库索引：
```
$ sudo apt-get update
```
(可选) 在运行封闭软件环境 (CSE) 时，安装 Angie 二进制验证所需的密钥包：
```
$ sudo apt-get install -y angie-digsig-key
```
更新 CSE：
```
$ sudo update-initramfs -uk all
```
然后 重启服务器：
```
$ sudo shutdown -r now
```
安装 Angie 软件包：
```
$ sudo apt-get install -y angie
```
(可选) 安装您需要的任何额外软件包：
```
$ sudo apt-get install -y <PACKAGE NAME>
```

Debian、Ubuntu#

安装添加 Angie 存储库所需的先决条件：

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

下载 Angie 存储库的公钥以进行软件包验证：

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

添加 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

更新存储库索引：
```
$ sudo apt-get update
```
安装 Angie 软件包：
```
$ sudo apt-get install -y angie
```
(可选) 安装您需要的任何额外软件包：
```
$ sudo apt-get install -y <PACKAGE NAME>
```

FreeBSD#

要添加 Angie 存储库，请创建这些目录：

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

要配置存储库，请创建一个名为 /usr/local/etc/pkg/repos/angie.conf 的文件，内容如下：

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
}

下载 Angie 存储库的公钥以进行软件包验证：

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

更新存储库索引：
```
$ sudo pkg update
```
安装 Angie 软件包：
```
$ sudo pkg install -y angie
```
(可选) 安装您需要的任何额外软件包：
```
$ sudo pkg install -y <PACKAGE NAME>
```
启动服务：
```
$ sudo service angie start
```
要在服务器重启时自动启动 Angie：
```
$ sudo sysrc angie_enable=YES
```

openSUSE#

要添加存储库，请创建一个名为 /etc/zypp/repos.d/angie.repo 的文件，内容如下：

[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

更新存储库索引：
```
$ sudo zypper refresh
```
安装 Angie 软件包：
```
$ sudo zypper install -y angie
```
(可选) 安装您需要的任何额外软件包：
```
$ sudo zypper install -y <PACKAGE NAME>
```
启动服务：
```
$ sudo systemctl start angie
```
要在服务器重启后自动启动 Angie：
```
$ sudo systemctl enable angie
```

额外#

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

控制台轻量版#

控制台轻量版是一个轻量级的监控接口，发布在我们的存储库中，名为 angie-console-light。它的安装方式与上面所述的 angie 软件包相同；请参见 Console Light 网络监控面板中的配置步骤。

动态模块#

为了扩展 Angie 的基本功能，您可以添加各种动态模块。模块可以根据相应版本的 Angie 从 source 构建，但从我们的存储库获取现成的软件包更为简单：

angie-module-image-filter	添加一个过滤器以转换 JPEG、GIF、PNG 和 WebP 图像。
angie-module-njs: HTTP JS 模块，流式 JS 模块	允许在 Angie 配置中分别在 `http` 和 `stream` 上下文中使用 njs（JavaScript 子集）。
angie-module-perl	允许使用 Perl 编写 `location` 和变量处理程序，还可以从 SSI 调用 Perl。
angie-module-wamr	允许与 WebAssembly Micro Runtime 集成以执行 WASM 代码。
angie-module-wasm	添加核心 WASM 支持。
angie-module-wasmtime	允许与 Wasmtime 运行时集成以执行 WASM 代码。
angie-module-xslt	添加一个过滤器以使用 XSLT 样式表转换 XML 响应。

我们还在我们的存储库中构建并发布以下第三方模块软件包：

angie-module-auth-jwt	添加客户端 JWT 认证。
angie-module-auth-ldap	添加对多个 LDAP 服务器的认证支持。
angie-module-auth-pam	添加 PAM 认证支持。
angie-module-auth-spnego	添加 SPNEGO、GSSAPI 支持。
angie-module-brotli	启用 Brotli 进行动态和静态响应压缩。
angie-module-cache-purge	启用清除 FastCGI、代理、SCGI 和 uWSGI 缓存内容。
angie-module-cgi	启用 CGI。
angie-module-dav-ext	扩展 WebDAV 方法支持，添加 PROPFIND 和 OPTIONS。
angie-module-dynamic-limit-req	启用动态锁定 IP 并定期释放它们。
angie-module-echo	启用 `echo`、`sleep`、`time`、`exec`，和其他 shell 风格的命令在配置文件中。
angie-module-enhanced-memcached	增强内置 Memcached 模块的功能。
angie-module-eval	允许在变量中捕获子请求响应体。
angie-module-geoip2: http_geoip2, stream_geoip2	允许在 MaxMind GeoIP2 数据库中查找地理数据。
angie-module-headers-more	允许设置和清除输入和输出头。
angie-module-http-auth-radius	启用 Radius 支持。
angie-module-keyval	允许从键值对创建变量。
angie-module-lua: http_lua_module, stream_lua_module	允许在 Angie 配置中使用 Lua 在 `http` 和 `stream` 上下文中。
angie-module-modsecurity	添加一个连接器，允许 ModSecurity 规则。备注该软件包需要额外设置。
angie-module-ndk	添加 Nginx 开发工具包 (NDK) 用于模块开发。
angie-module-otel	启用将遥测数据发送到 OpenTelemetry 收集器。
angie-module-opentracing	通过 OpenTracing 添加对 Angie 请求的分布式跟踪；包括 Zipkin 和 DataDog 的数据导出插件。
angie-module-postgres	启用与 PostgreSQL 数据库的直接通信。
angie-module-redis2	启用 Redis 2.0 用于 HTTP 上游。
angie-module-rtmp	启用 RTMP 进行实时流播放和视频点播。
angie-module-set-misc	向 Rewrite 模块添加各种 `set_xxx` 指令。
angie-module-subs	启用在 HTTP 响应体中进行正则表达式字符串替换。
angie-module-testcookie	通过基于 cookie 的挑战-响应机制启用机器人缓解。
angie-module-upload	为文件上传添加 `multipart/form-data` 编码（RFC 1867），启用可恢复上传。
angie-module-vod	启用对 HLS、HDS、MSS 和 DASH 流媒体的 MP4 文件重新打包。
angie-module-vts: module-vts, module-sts, module-stream-sts	打包三个列出的模块以进行流量监控。备注各自的模板文件如下安装： /usr/share/angie-module-vts/status.compress.html /usr/share/angie-module-vts/status.template.html /usr/share/angie-module-vts/stream/status.compress.html /usr/share/angie-module-vts/stream/status.template.html
angie-module-zip	启用动态打包 ZIP 压缩档案。
angie-module-zstd	启用 Zstandard 压缩。

要在 configuration 中使用已安装的模块，请使用 load_module 指令加载它。