Angie 软件包安装

要使用您的发行版软件包管理器 安装和更新 Angie, 请添加并配置相应的仓库。

发行版

名称	版本	架构
AlmaLinux	10,   9,   8	x86-64, arm64
Alpine	3.23,   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	15,   14,   13	x86-64, arm64
MSVSphere	9	x86-64
openSUSE	16,   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

测试构建

我们每天测试并构建来自我们仓库的代码, 这些 每日构建 适合在正式发布之前探索新功能。

每日构建的版本始终对应于即将发布的版本。 命名和安装过程通常与下面显示的类似, 但不使用路径前缀 https://download.angie.software/angie/*, 而是使用 https://download.angie.software/angie-nightly/*。

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

1. 要添加仓库,请创建一个名为 /etc/yum.repos.d/angie.repo 的文件,内容如下:

   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. 安装 Angie 软件包:

   $ sudo yum install -y angie
   $ # -- 或者 --
   $ sudo dnf install -y angie
   

3. (可选) 安装您需要的任何 额外 软件包:

   $ sudo yum install -y <PACKAGE NAME>
   $ # -- 或者 --
   $ sudo dnf install -y <PACKAGE NAME>
   

4. 启动服务:

   $ sudo systemctl start angie
   

5. 要在服务器重启后自动启动 Angie:

   $ sudo systemctl enable angie
   

Alpine

1. 安装添加 Angie 仓库的 先决条件:

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

2. 下载 Angie 仓库的公钥 用于软件包验证:

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

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

   $ sudo apk update
   

5. 安装 Angie 软件包:

   $ sudo apk add angie
   

6. (可选) 安装您需要的任何 额外 软件包:

   $ sudo apk add <PACKAGE NAME>
   

7. 启动服务:

   $ sudo service angie start
   

8. 要在服务器重启后自动启动 Angie:

   $ sudo rc-update add angie
   

Alt

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

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

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

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

3. 下载 Angie 仓库的公钥 用于软件包验证:

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

4. 将下载的密钥导入到受信任的密钥环:

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

5. 保存密钥的签名:

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

   $ sudo apt-get update
   

8. 安装 Angie 软件包:

   $ sudo apt-get install -y angie
   

9. (可选) 安装您需要的任何 额外 软件包:

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

10. 启动服务:

    $ sudo systemctl start angie
    

11. 要在服务器重启后自动启动 Angie:

    $ sudo systemctl enable angie
    

Astra SE

1. 安装添加 Angie 仓库所需的前置软件包:

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

2. 下载 Angie 仓库的公钥用于软件包验证:

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

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

   $ sudo apt-get update
   

5. (可选) 当运行封闭软件环境 (CSE) 时, 安装用于 Angie 二进制文件验证的密钥软件包:

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

   更新 CSE:

   $ sudo update-initramfs -uk all
   

   然后 重启服务器:

   $ sudo shutdown -r now
   

6. 安装 Angie 软件包:

   $ sudo apt-get install -y angie
   

7. (可选) 安装您需要的任何 额外 软件包:

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

Debian, Ubuntu

1. 安装添加 Angie 仓库所需的前置软件包:

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

2. 下载 Angie 仓库的公钥用于软件包验证:

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

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

   $ sudo apt-get update
   

5. 安装 Angie 软件包:

   $ sudo apt-get install -y angie
   

6. (可选) 安装您需要的任何 额外 软件包:

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

OSNova

1. 安装添加 Angie 仓库所需的前置软件包:

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

2. 下载 Angie 仓库的公钥用于软件包验证:

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

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

   $ sudo apt-get update
   

5. 安装 Angie 软件包:

   $ sudo apt-get install -y angie
   

6. (可选) 安装您需要的任何 额外 软件包:

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

FreeBSD

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

   $ 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/freebsd/${VERSION_MAJOR}/${ARCH}",
      signature_type: "pubkey",
      pubkey: "/usr/local/etc/pkg/angie/angie-signing.rsa",
      enabled: yes
   }
   

3. 下载 Angie 仓库的公钥用于软件包验证:

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

4. 更新仓库索引:

   $ sudo pkg update
   

5. 安装 Angie 软件包:

   $ sudo pkg install -y angie
   

6. (可选) 安装您需要的任何 额外 软件包:

   $ sudo pkg install -y <PACKAGE NAME>
   

7. 启动服务:

   $ sudo service angie start
   

8. 设置服务器重启后自动启动 Angie:

   $ sudo sysrc angie_enable=YES
   

备注

由于 FreeBSD 软件包管理器可能无法正确确定最新版本, 请使用以下方法更新已安装的软件包:

$ sudo pkg upgrade `pkg search -r angie angie-[0-9] | sort -Vr | head -1 | awk {'print $1'}`

openSUSE

1. 要添加仓库,请创建名为 /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
   

2. 更新仓库索引:

   $ sudo zypper refresh
   

3. 安装 Angie 软件包:

   $ sudo zypper install -y angie
   

4. (可选) 安装您需要的任何 额外 软件包:

   $ sudo zypper install -y <PACKAGE NAME>
   

5. 启动服务:

   $ sudo systemctl start angie
   

6. 设置服务器重启后自动启动 Angie:

   $ sudo systemctl enable angie
   

额外软件包

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

Console Light 网页面板

Console Light 是一个用于 Angie 的轻量级网页监控面板, 在我们的仓库中以 angie-console-light 发布。 它的安装方式与上述步骤中的 angie 软件包相同; 配置步骤请参见 Console Light Web 监控面板。

动态模块

为了扩展 Angie 的基本功能, 您可以添加各种动态模块。 模块可以针对相应版本的 Angie 从源代码构建, 但从我们的仓库获取现成的软件包会更容易:

angie-module-image-filter	为 JPEG、GIF、PNG 和 WebP 图像添加转换功能。
angie-module-njs: JS (HTTP), JS (stream)	允许在 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 响应。

要在 配置 中使用已安装的模块, 请在 main 上下文中使用 load_module 指令加载它:

load_module modules/<module name>.so;

还有大量的 第三方模块 可用。