Netflix优惠码论坛
NGINX Plus 安装配置 - 可打印的版本

+- Netflix优惠码论坛 (https://www.sinovoter.com)
+-- 版块： 合租专栏 (https://www.sinovoter.com/forum-18.html)
+--- 版块： Surge与各类代理加速器合租 (https://www.sinovoter.com/forum-57.html)
+--- 主题： NGINX Plus 安装配置 (/thread-7519.html)

NGINX Plus 安装配置 - netflix - 08-04-2023

在所有受支持的 Linux 发行版上安装和升级 NGINX Plus，并使用基本包和动态模块的分步说明。

本文介绍如何在 Amazon Linux、AlmaLinux、CentOS、Debian、FreeBSD、Oracle Linux、Rocky Linux、Red Hat Enterprise Linux (RHEL)、SUSE Linux Enterprise Server (SLES) 和 Ubuntu 上安装 NGINX Plus。


先决条件
  • NGINX Plus 订阅（已购买或试用）
  • 支持的操作系统
  • root特权
  • 您的MyF5 客户门户凭据，由 F5, Inc. 的电子邮件提供。
  • 您的 NGINX Plus 证书和公钥（nginx-repo.crt和nginx-repo.key文件）由 F5, Inc. 的电子邮件提供。

在 Amazon Linux 2023 上安装 NGINX Plus

NGINX Plus 可以安装在 Amazon Linux 2023（x86_64、aarch64）上。

  1. 如果您安装了较旧的 NGINX Plus 软件包，建议备份配置和日志文件。详细信息请参见“升级 NGINX Plus ”。
  2. 创建/etc/ssl/nginx目录：
    代码:
    sudo mkdir -p /etc/ssl/nginx
    [*]cd /etc/ssl/nginx
  3. 登录MyF5 客户门户并下载nginx-repo.crt和nginx-repo.key文件。
  4. 安装所需的ca 证书依赖项：
    代码:
    sudo yum install ca-certificates
  5. 将nginx-repo.crt和nginx-repo.key文件复制到 Amazon Linux 服务器的/etc/ssl/nginx/目录中：
    代码:
    sudo cp nginx-repo.crt /etc/ssl/nginx/
    [*]sudo cp nginx-repo.key /etc/ssl/nginx/
  6. 通过将plus-amazonlinux2023.repo文件下载到/etc/yum.repos.d来添加 NGINX Plus 存储库：
    代码:
    sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/plus-amazonlinux2023.repo
  7. 如果您有 NGINX ModSecurity 订阅，请通过将modsecurity-amazonlinux2023.repo文件下载到/etc/yum.repos.d来添加 ModSecurity 存储库：
    代码:
    sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/modsecurity-amazonlinux2023.repo
  8. 如果您想启用实验性 QUIC 支持，请通过将plus-quic-amazonlinux2023.repo文件下载到/etc/yum.repos.d来添加 NGINX Plus QUIC 存储库：
    代码:
    sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/plus-quic-amazonlinux2023.repo
  9. 安装nginx-plus软件包。任何较旧的 NGINX Plus 软件包都会被自动替换。
    代码:
    sudo yum install nginx-plus
  10. 如果您有 NGINX ModSecurity 订阅，请安装 ModSecurity 包：
    代码:
    sudo yum install nginx-plus nginx-plus-module-modsecurity
  11. 对于实验性 QUIC 支持，请安装 NGINX Plus QUIC 包：
    代码:
    sudo yum install nginx-plus-quic
  12. 检查nginx二进制版本以确保您已正确安装 NGINX Plus：
    代码:
    nginx -v
  13. 如果您的基础架构中使用NGINX Management Suite 实例管理器，请安装并启用 NGINX 代理。有关详细信息，请参阅安装和配置 NGINX 代理。


在 Amazon Linux 2 上安装 NGINX Plus

NGINX Plus 可以安装在 Amazon Linux 2 LTS（x86_64、aarch64）上。

  1. 如果您安装了较旧的 NGINX Plus 软件包，建议备份配置和日志文件。详细信息请参见“升级 NGINX Plus ”。
  2. 创建/etc/ssl/nginx目录：
    代码:
    sudo mkdir -p /etc/ssl/nginx
    [*]cd /etc/ssl/nginx
  3. 登录MyF5 客户门户并下载nginx-repo.crt和nginx-repo.key文件。
  4. 安装所需的ca 证书依赖项：
    代码:
    sudo yum install ca-certificates
  5. 将nginx-repo.crt和nginx-repo.key文件复制到/etc/ssl/nginx/目录：
    代码:
    sudo cp nginx-repo.crt /etc/ssl/nginx/
    [*]sudo cp nginx-repo.key /etc/ssl/nginx/
  6. 通过将nginx-plus-amazon2.repo文件下载到/etc/yum.repos.d来添加 NGINX Plus 存储库：
    代码:
    sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/nginx-plus-amazon2.repo
  7. 如果您想启用实验性 QUIC 支持，请通过将文件plus-quic-amazon2.repo下载到/etc/yum.repos.d来添加 NGINX Plus QUIC 存储库：
    代码:
    sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/plus-quic-amazon2.repo
  8. 安装nginx-plus软件包。任何较旧的 NGINX Plus 软件包都会被自动替换。
    代码:
    sudo yum install nginx-plus
  9. 如果您有 NGINX ModSecurity 订阅，请安装 ModSecurity 包：
    代码:
    sudo yum install nginx-plus nginx-plus-module-modsecurity
  10. 对于实验性 QUIC 支持，请安装 NGINX Plus QUIC 包：
    代码:
    sudo yum install nginx-plus-quic
  11. 检查nginx二进制版本以确保您已正确安装 NGINX Plus：
    代码:
    nginx -v
  12. 如果您的基础架构中使用NGINX Management Suite 实例管理器，请安装并启用 NGINX 代理。有关详细信息，请参阅安装和配置 NGINX 代理。


在 RHEL 7.4+、CentOS RHEL 7.4+ 和 Oracle Linux 7.4+ 上安装 NGINX Plus

NGINX Plus 可以安装在以下版本的 CentOS/Oracle Linux/RHEL 上：
  • CentOS 7.4+（x86_64、aarch64）
  • Oracle Linux 7.4+ (x86_64)
  • 红帽企业 Linux 7.4+（x86_64、aarch64）

  1. 如果您安装了较旧的 NGINX Plus 软件包，建议备份配置和日志文件。详细信息请参见“升级 NGINX Plus ”。
  2. 创建/etc/ssl/nginx目录：
    代码:
    sudo mkdir -p /etc/ssl/nginx
    [*]cd /etc/ssl/nginx
  3. 登录MyF5 客户门户并下载nginx-repo.crt和nginx-repo.key文件。
  4. 将文件复制到/etc/ssl/nginx/目录：
    代码:
    sudo cp nginx-repo.crt /etc/ssl/nginx/
    [*]sudo cp nginx-repo.key /etc/ssl/nginx/
  5. 安装所需的ca 证书依赖项：
    代码:
    sudo yum install ca-certificates
  6. 如果您有 NGINX App Protect 订阅，请安装epel-release依赖项：
    代码:
    sudo yum install epel-release
  7. 通过将nginx-plus-7.4.repo文件下载到/etc/yum.repos.d来添加 NGINX Plus 存储库：
    代码:
    sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/nginx-plus-7.4.repo
  8. 如果您订阅了 NGINX App Protect，请通过将app-protect-7.repo文件下载到/etc/yum.repos.d来添加 NGINX App Protect 存储库：
    代码:
    $ sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/app-protect-7.repo
  9. 如果您订阅了 NGINX ModSecurity，请通过将modsecurity-7.repo文件下载到/etc/yum.repos.d来添加 NGINX ModSecurity 存储库：
    代码:
    sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/modsecurity-7.repo
  10. 安装nginx-plus软件包。任何较旧的 NGINX Plus 软件包都会被自动替换。
    代码:
    sudo yum install nginx-plus
  11. 如果您订阅了 NGINX App Protect，请安装 NGINX App Protect 及其签名：
    代码:
    sudo yum install nginx-plus app-protect app-protect-attack-signatures
  12. 如果您有 NGINX ModSecurity 订阅，请安装 ModSecurity 包：
    代码:
    sudo yum install nginx-plus nginx-plus-module-modsecurity
  13. 要启用 nginx 服务在启动时启动，请运行以下命令：
    代码:
    sudo systemctl enable nginx.service
  14. 检查nginx二进制版本以确保您已正确安装 NGINX Plus：
    代码:
    nginx -v
  15. 如果您的基础架构中使用NGINX Management Suite 实例管理器，请安装并启用 NGINX 代理。有关详细信息，请参阅安装和配置 NGINX 代理。


在 RHEL 8.1+、Oracle Linux 8.1+、AlmaLinux 8、Rocky Linux 8 上安装 NGINX Plus

NGINX Plus 可以安装在以下版本的 CentOS/RHEL 上：
  • 红帽企业 Linux 8.1+（x86_64、aarch64、s390x）
  • Oracle Linux 8.1+（x86_64、aarch64）
  • AlmaLinux 8.6+（x86_64，aarch64）
  • 洛基 Linux 8.6+（x86_64、aarch64）

  1. 如果您安装了较旧的 NGINX Plus 软件包，建议备份配置和日志文件。详细信息请参见“升级 NGINX Plus ”。
  2. 创建/etc/ssl/nginx目录：
    代码:
    sudo mkdir -p /etc/ssl/nginx
    [*]cd /etc/ssl/nginx
  3. 登录MyF5 客户门户并下载nginx-repo.crt和nginx-repo.key文件。
  4. 将文件复制到/etc/ssl/nginx/目录：
    代码:
    sudo cp nginx-repo.crt /etc/ssl/nginx/
    [*]sudo cp nginx-repo.key /etc/ssl/nginx/
  5. 安装所需的ca 证书依赖项：
    代码:
    sudo yum install ca-certificates
  6. 通过将nginx-plus-8.repo文件下载到/etc/yum.repos.d来添加 NGINX Plus 存储库：
    代码:
    sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/nginx-plus-8.repo
  7. 如果您订阅了 NGINX ModSecurity，请通过将modsecurity-8.repo文件下载到/etc/yum.repos.d来添加 NGINX ModSecurity 存储库：
    代码:
    sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/modsecurity-8.repo
  8. 如果您想启用实验性 QUIC 支持，请通过将文件plus-quic-8.repo下载到/etc/yum.repos.d来添加 NGINX Plus QUIC 存储库：
    代码:
    sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/plus-quic-8.repo
  9. 安装nginx-plus软件包。任何较旧的 NGINX Plus 软件包都会被自动替换。
    代码:
    sudo yum install nginx-plus
  10. 如果您有 NGINX ModSecurity 订阅，请安装 ModSecurity 包：
    代码:
    sudo yum install nginx-plus nginx-plus-module-modsecurity
  11. 对于实验性 QUIC 支持，请安装 NGINX Plus QUIC 包：
    代码:
    sudo yum install nginx-plus-quic
  12. 要启用 nginx 服务在启动时启动，请运行以下命令：
    代码:
    sudo systemctl enable nginx.service
  13. 检查nginx二进制版本以确保您已正确安装 NGINX Plus：
    代码:
    nginx -v
  14. 如果您的基础架构中使用NGINX Management Suite 实例管理器，请安装并启用 NGINX 代理。有关详细信息，请参阅安装和配置 NGINX 代理。


在 RHEL 9.0+、Oracle Linux 9、AlmaLinux 9、Rocky Linux 9 上安装 NGINX Plus

NGINX Plus 可以安装在以下版本的 CentOS/RHEL 上：
  • 红帽企业 Linux 9.0+（x86_64、aarch64、s390x）
  • Oracle Linux 9 (x86_64)
  • AlmaLinux 9（x86_64，aarch64）
  • 洛基 Linux 9（x86_64、aarch64）

  1. 如果您安装了较旧的 NGINX Plus 软件包，建议备份配置和日志文件。详细信息请参见“升级 NGINX Plus ”。
  2. 创建/etc/ssl/nginx目录：
    代码:
    sudo mkdir -p /etc/ssl/nginx
    [*]cd /etc/ssl/nginx
  3. 登录MyF5 客户门户并下载nginx-repo.crt和nginx-repo.key文件。
  4. 将文件复制到/etc/ssl/nginx/目录：
    代码:
    sudo cp nginx-repo.crt /etc/ssl/nginx/
    [*]sudo cp nginx-repo.key /etc/ssl/nginx/
  5. 安装所需的ca 证书依赖项：
    代码:
    sudo yum install ca-certificates
  6. 通过将plus-9.repo文件下载到/etc/yum.repos.d来添加 NGINX Plus 存储库：
    代码:
    sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/plus-9.repo
  7. 如果您订阅了 NGINX ModSecurity，请通过将modsecurity-9.repo文件下载到/etc/yum.repos.d来添加 NGINX ModSecurity 存储库：
    代码:
    sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/modsecurity-9.repo
  8. 如果您想启用实验性 QUIC 支持，请通过将文件plus-quic-9.repo下载到/etc/yum.repos.d来添加 NGINX Plus QUIC 存储库：
    代码:
    sudo wget -P /etc/yum.repos.d https://cs.nginx.com/static/files/plus-quic-9.repo
  9. 安装nginx-plus软件包。任何较旧的 NGINX Plus 软件包都会被自动替换。
    代码:
    sudo yum install nginx-plus
  10. 如果您有 NGINX ModSecurity 订阅，请安装 ModSecurity 包：
    代码:
    sudo yum install nginx-plus nginx-plus-module-modsecurity
  11. 对于实验性 QUIC 支持，请安装 NGINX Plus QUIC 包：
    代码:
    sudo yum install nginx-plus-quic
  12. 要启用 nginx 服务在启动时启动，请运行以下命令：
    代码:
    sudo systemctl enable nginx.service
  13. 检查nginx二进制版本以确保您已正确安装 NGINX Plus：
    代码:
    nginx -v
  14. 如果您的基础架构中使用NGINX Management Suite 实例管理器，请安装并启用 NGINX 代理。有关详细信息，请参阅安装和配置 NGINX 代理。


在 Debian 或 Ubuntu 上安装 NGINX Plus

NGINX Plus 可以安装在以下版本的 Debian 或 Ubuntu 上：
  • Debian 11（x86_64、aarch64）
  • Ubuntu 18.04 LTS（“仿生”）（x86_64、aarch64）
  • Ubuntu 20.04 LTS（“Focal”）（x86_64、aarch64、s390x）
  • Ubuntu 22.04 LTS（“Jammy”）（x86_64、aarch64、s390x）

  1. 如果您安装了较旧的 NGINX Plus 软件包，建议备份配置和日志文件。详细信息请参见“升级 NGINX Plus ”。
  2. 创建/etc/ssl/nginx目录：
    代码:
    sudo mkdir /etc/ssl/nginx
    cd /etc/ssl/nginx
  3. 登录MyF5 客户门户并下载nginx-repo.crt和nginx-repo.key文件。
  4. 将文件复制到/etc/ssl/nginx/目录：
    代码:
    sudo cp nginx-repo.crt /etc/ssl/nginx/
    sudo cp nginx-repo.key /etc/ssl/nginx/
  5. 安装必备包。
    对于 Debian：
    代码:
    sudo apt-get install apt-transport-https lsb-release ca-certificates wget gnupg2 debian-archive-keyring
    对于Ubuntu：
    代码:
    sudo apt-get install apt-transport-https lsb-release ca-certificates wget gnupg2 ubuntu-keyring
  6. 下载并添加NGINX 签名密钥和App Protect 安全更新签名密钥：
    代码:
    wget -qO - https://cs.nginx.com/static/keys/nginx_signing.key | gpg --dearmor | sudo tee /usr/share/keyrings/nginx-archive-keyring.gpg >/dev/null
    wget -qO - https://cs.nginx.com/static/keys/app-protect-security-updates.key | gpg --dearmor | sudo tee /usr/share/keyrings/app-protect-security-updates.gpg >/dev/null
  7. 添加 NGINX Plus 存储库。
    对于 Debian：
    代码:
    printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/plus/debian `lsb_release -cs` nginx-plus\n" | sudo tee /etc/apt/sources.list.d/nginx-plus.list
    对于Ubuntu：
    代码:
    printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/plus/ubuntu `lsb_release -cs` nginx-plus\n" | sudo tee /etc/apt/sources.list.d/nginx-plus.list
  8. 如果您有 NGINX App Protect 订阅，请添加其存储库。
    对于 Debian：
    代码:
    printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/app-protect/debian `lsb_release -cs` nginx-plus\n" | sudo tee /etc/apt/sources.list.d/nginx-app-protect.list

    printf "deb [signed-by=/usr/share/keyrings/app-protect-security-updates.gpg] https://pkgs.nginx.com/app-protect-security-updates/debian `lsb_release -cs` nginx-plus\n" | sudo tee -a /etc/apt/sources.list.d/nginx-app-protect.list
    对于Ubuntu：
    代码:
    printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/app-protect/ubuntu `lsb_release -cs` nginx-plus\n" | sudo tee /etc/apt/sources.list.d/nginx-app-protect.list

    printf "deb [signed-by=/usr/share/keyrings/app-protect-security-updates.gpg] https://pkgs.nginx.com/app-protect-security-updates/ubuntu `lsb_release -cs` nginx-plus\n" | sudo tee -a /etc/apt/sources.list.d/nginx-app-protect.list
  9. 如果您有 NGINX ModSecurity 订阅，请添加 NGINX ModSecurity 存储库。
    对于 Debian：
    代码:
    printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/modsecurity/debian `lsb_release -cs` nginx-plus\n" | sudo tee /etc/apt/sources.list.d/nginx-modsecurity.list
    对于Ubuntu：
    代码:
    printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/modsecurity/ubuntu `lsb_release -cs` nginx-plus\n" | sudo tee /etc/apt/sources.list.d/nginx-modsecurity.list
  10. 如果您想启用实验性 QUIC 支持，请添加 NGINX Plus QUIC 存储库：
    对于 Debian：
    代码:
    printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/plus-quic/debian `lsb_release -cs` nginx-plus\n" | sudo tee /etc/apt/sources.list.d/nginx-plus-quic.list
    对于Ubuntu：
    代码:
    printf "deb [signed-by=/usr/share/keyrings/nginx-archive-keyring.gpg] https://pkgs.nginx.com/plus-quic/ubuntu `lsb_release -cs` nginx-plus\n" | sudo tee /etc/apt/sources.list.d/nginx-plus-quic.list
  11. 将nginx-plus apt 配置下载到/etc/apt/apt.conf.d：
    代码:
    sudo wget -P /etc/apt/apt.conf.d https://cs.nginx.com/static/files/90pkgs-nginx
  12. 更新存储库信息：
    代码:
    sudo apt-get update
  13. 安装nginx-plus软件包。任何较旧的 NGINX Plus 软件包都会被自动替换。
    代码:
    sudo apt-get install -y nginx-plus
  14. 如果您订阅了 NGINX App Protect，请安装 NGINX App Protect 及其签名：
    代码:
    sudo apt-get install app-protect app-protect-attack-signatures
  15. 如果您有 NGINX ModSecurity 订阅，请安装 ModSecurity 包：
    代码:
    sudo apt-get install nginx-plus nginx-plus-module-modsecurity
  16. 对于实验性 QUIC 支持，请安装 NGINX Plus QUIC 包：
    代码:
    sudo apt-get install nginx-plus-quic
  17. 检查nginx二进制版本以确保您已正确安装 NGINX Plus：
    代码:
    nginx -v
  18. 如果您的基础架构中使用NGINX Management Suite 实例管理器，请安装并启用 NGINX 代理。有关详细信息，请参阅安装和配置 NGINX 代理。


在 FreeBSD 上安装 NGINX Plus

NGINX Plus 可以安装在以下版本的 FreeBSD 上：
  • FreeBSD 12.1+ (amd64)
  • FreeBSD 13（amd64）

要在 FreeBSD 上安装 NGINX Plus：

  1. 如果您安装了较旧的 NGINX Plus 软件包，建议备份配置和日志文件。详细信息请参见“升级 NGINX Plus ”。
  2. 创建/etc/ssl/nginx目录：
    代码:
    sudo mkdir -p /etc/ssl/nginx
    [*]cd /etc/ssl/nginx
  3. 登录MyF5 客户门户并下载nginx-repo.crt和nginx-repo.key文件。
  4. 将文件复制到/etc/ssl/nginx/目录：
    代码:
    sudo cp nginx-repo.crt /etc/ssl/nginx/
    [*]sudo cp nginx-repo.key /etc/ssl/nginx/
  5. 安装必备的ca_root_nss软件包：
    代码:
    sudo pkg install ca_root_nss
  6. 将nginx-plus.conf文件复制到/etc/pkg/目录：
    代码:
    sudo fetch -o /etc/pkg/nginx-plus.conf http://cs.nginx.com/static/files/nginx-plus.conf
  7. modsecurity.conf如果您有 NGINX ModSecurity 订阅，请通过将文件下载到/etc/pkg/目录来添加存储库：
    代码:
    sudo fetch -o /etc/pkg/modsecurity.conf http://cs.nginx.com/static/files/modsecurity.conf
  8. 如果您想启用实验性 QUIC 支持，请通过将文件下载plus-quic.conf到/etc/pkg/目录来添加 NGINX Plus QUIC 存储库：
    代码:
    sudo fetch -o /etc/pkg/plus-quic.conf http://cs.nginx.com/static/files/plus-quic.conf
  9. 将以下行添加到/usr/local/etc/pkg.conf文件中：
    代码:
    PKG_ENV: { SSL_NO_VERIFY_PEER: "1",
    [*]SSL_CLIENT_CERT_FILE: "/etc/ssl/nginx/nginx-repo.crt",
    [*]SSL_CLIENT_KEY_FILE: "/etc/ssl/nginx/nginx-repo.key" }
  10. 安装nginx-plus软件包。任何较旧的 NGINX Plus 软件包都会被自动替换。如果您安装了较旧的 NGINX Plus 软件包，建议备份配置和日志文件（详细信息请参阅“升级 NGINX Plus ”）。
    代码:
    sudo pkg install nginx-plus
  11. 如果您有 NGINX ModSecurity 订阅，请安装该nginx-plus-module-modsecurity软件包：
    代码:
    sudo pkg install nginx-plus nginx-plus-module-modsecurity
  12. 对于实验性 QUIC 支持，请安装 NGINX Plus QUIC 包：
    代码:
    sudo pkg install nginx-plus-quic
  13. 检查nginx二进制版本以确保您已正确安装 NGINX Plus：
    代码:
    nginx -v
  14. 如果您的基础架构中使用NGINX Management Suite 实例管理器，请安装并启用 NGINX 代理。有关详细信息，请参阅安装和配置 NGINX 代理。


在 SUSE Linux Enterprise Server 上安装 NGINX Plus

NGINX Plus 可以安装在 SUSE Linux Enterprise Server 12 SP5 (x86_64)、15 SP2 (x86_64) 上。

要在 SLES 上安装 NGINX Plus：

  1. 创建/etc/ssl/nginx目录：
    代码:
    sudo mkdir /etc/ssl/nginx
    cd /etc/ssl/nginx
  2. 登录MyF5 客户门户并下载nginx-repo.crt和nginx-repo.key文件。
  3. 将文件复制到/etc/ssl/nginx/目录：
    代码:
    sudo cp nginx-repo.crt /etc/ssl/nginx/
    sudo cp nginx-repo.key /etc/ssl/nginx/
  4. 创建证书和密钥的文件包：
    代码:
    cat /etc/ssl/nginx/nginx-repo.crt /etc/ssl/nginx/nginx-repo.key > /etc/ssl/nginx/nginx-repo-bundle.crt
  5. 安装所需的ca 证书依赖项：
    代码:
    zypper install ca-certificates
  6. 添加nginx-plus存储库。
    对于 SLES 12：
    代码:
    zypper addrepo -G -t yum -c 'https://pkgs.nginx.com/plus/sles/12?ssl_clientcert=/etc/ssl/nginx/nginx-repo-bundle.crt&ssl_verify=peer' nginx-plus
    对于 SLES 15：
    代码:
    zypper addrepo -G -t yum -c 'https://pkgs.nginx.com/plus/sles/15?ssl_clientcert=/etc/ssl/nginx/nginx-repo-bundle.crt&ssl_verify=peer' nginx-plus
  7. 如果您有 NGINX ModSecurity 订阅，请添加 ModSecurity 存储库。
    对于 SLES 12：
    代码:
    zypper addrepo -G -t yum -c 'https://pkgs.nginx.com/modsecurity/sles/12?ssl_clientcert=/etc/ssl/nginx/nginx-repo-bundle.crt&ssl_verify=peer' nginx-modsecurity
    对于 SLES 15：
    代码:
    zypper addrepo -G -t yum -c 'https://pkgs.nginx.com/modsecurity/sles/15?ssl_clientcert=/etc/ssl/nginx/nginx-repo-bundle.crt&ssl_verify=peer' nginx-modsecurity
  8. 如果您想启用实验性 QUIC 支持，请添加 NGINX Plus QUIC 存储库。
    对于 SLES 15：
    代码:
    zypper addrepo -G -t yum -c 'https://pkgs.nginx.com/plus-quic/sles/15?ssl_clientcert=/etc/ssl/nginx/nginx-repo-bundle.crt&ssl_verify=peer' nginx-plus
  9. 安装nginx-plus软件包。任何较旧的 NGINX Plus 软件包都会被自动替换。
    代码:
    zypper install nginx-plus
  10. 如果您有 NGINX ModSecurity 订阅，请安装 ModSecurity 包：
    代码:
    zypper install nginx-plus-module-modsecurity
  11. 对于实验性 QUIC 支持，请安装 NGINX Plus QUIC 包：
    代码:
    zypper install nginx-plus-quic
  12. 如果您的基础架构中使用NGINX Management Suite 实例管理器，请安装并启用 NGINX 代理。有关详细信息，请参阅安装和配置 NGINX 代理。


在 Alpine Linux 上安装 NGINX Plus

NGINX Plus 可以安装在以下版本的 Alpine Linux 上：
  • 3.14（x86_64、aarch64）
  • 3.15（x86_64、aarch64）
  • 3.16（x86_64、aarch64）
  • 3.17（x86_64、aarch64）

要在 Alpine Linux 上安装 NGINX Plus：

  1. 如果您安装了较旧的 NGINX Plus 软件包，建议备份配置和日志文件。详细信息请参见“升级 NGINX Plus ”。
  2. 登录MyF5 客户门户并下载nginx-repo.crt和nginx-repo.key文件。
  3. 将nginx-repo.key上传到/etc/apk/cert.key并将nginx-repo.crt上传到/etc/apk/cert.pem。请确保文件不包含其他证书和密钥：Alpine Linux 不支持混合不同存储库的客户端证书。
  4. 将 NGINX 签名公钥放入目录/etc/apk/keys：
    代码:
    sudo wget -O /etc/apk/keys/nginx_signing.rsa.pub https://cs.nginx.com/static/keys/nginx_signing.rsa.pub
  5. 将 NGINX 存储库添加到/etc/apk/repositories文件中：
    代码:
    printf "https://pkgs.nginx.com/plus/alpine/v`egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release`/main\n" | sudo tee -a /etc/apk/repositories
  6. 如果您有 NGINX App Protect 订阅，请添加 NGINX App Protect 存储库：
    代码:
    printf "https://pkgs.nginx.com/app-protect/alpine/v`egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release`/main\n" | sudo tee -a /etc/apk/repositories
  7. 如果您订阅了 NGINX ModSecurity，请添加 NGINX ModSecurity 存储库：
    代码:
    printf "https://pkgs.nginx.com/modsecurity/alpine/v`egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release`/main\n" | sudo tee -a /etc/apk/repositories
  8. 如果您想启用实验性 QUIC 支持，请将 NGINX Plus QUIC 存储库添加到/etc/apk/repositories文件中：
    代码:
    printf "https://pkgs.nginx.com/plus-quic/alpine/v`egrep -o '^[0-9]+\.[0-9]+' /etc/alpine-release`/main\n" | sudo tee -a /etc/apk/repositories
  9. 建议删除所有社区支持的 NGINX 软件包。请注意，所有 NGINX 模块也将被删除。
    代码:
    sudo apk del -r nginx
  10. 安装 NGINX Plus 软件包：
    代码:
    sudo apk add nginx-plus
  11. 如果您订阅了 NGINX App Protect，请安装 NGINX App Protect 及其签名：
    代码:
    sudo apk add app-protect app-protect-attack-signatures
  12. 如果您有 NGINX ModSecurity 订阅，请安装 ModSecurity 包：
    代码:
    sudo apk add nginx-plus nginx-plus-module-modsecurity
  13. 对于实验性 QUIC 支持，请安装 NGINX Plus QUIC 包：
    代码:
    sudo apk add nginx-plus-quic
  14. 检查nginx二进制版本以确保您已正确安装 NGINX Plus：
    代码:
    nginx -v
  15. 如果您的基础架构中使用NGINX Management Suite 实例管理器，请安装并启用 NGINX 代理。有关详细信息，请参阅安装和配置 NGINX 代理。


安装动态可加载模块

NGINX Plus 功能可以通过预构建包中未包含的动态可加载模块进行扩展：

NGINX 创作的动态模块 – 由 F5, Inc. 编写和维护的模块。直接从官方存储库安装这些模块：
  • GeoIP
  • Image-Filter
  • njs Scripting Language
  • OTel
  • Perl
  • XSLT

NGINX 认证的社区动态模块 – NGINX 测试和分发的流行第三方模块，NGINX 为其提供安装和基本配置支持。直接从官方存储库安装这些模块：
  • Brotli
  • Encrypted-Session
  • FIPS Status Check
  • GeoIP2
  • Headers-More
  • HTTP Substitutions Filter
  • Lua
  • NGINX ModSecurity WAF
  • NGINX Developer Kit
  • OpenTelemetry
  • OpenTracing
  • Phusion Passenger
  • Prometheus-njs
  • RTMP
  • Set-Misc
  • SPNEGO

社区动态模块 – 由 NGINX 社区的第三方成员编写和分发的模块。从作者的存储库下载源代码，并根据与您的 NGINX Plus 版本对应的NGINX 开源版本进行编译。有关列表，请参阅NGINX Wiki。


从官方存储库安装动态模块

NGINX 创作和 NGINX 认证的动态模块可以直接从模块存储库安装。要安装模块：
  • 对于 RHEL、Amazon Linux、CentOS、Oracle Linux、AlmaLinux 和 Rocky Linux：
    代码:
    yum install <MODULE-NAME>
  • 对于 Debian 和 Ubuntu：
    代码:
    apt-get install <MODULE-NAME>
  • 对于 FreeBSD：
    代码:
    pkg install <MODULE-NAME>
  • 对于 SLES：
    代码:
    zypper install <MODULE-NAME>
  • 对于 Alpine Linux：
    代码:
    sudo apk add <MODULE-NAME>

有关每个动态模块的详细安装说明，请参阅NGINX Plus 动态模块。

请注意，由于操作系统限制，某些模块不适用于某些操作系统版本。有关模块的详细信息和说明，请参阅NGINX Plus 技术规范。

安装该模块后，您需要在 NGINX Plus 配置文件中启用它。有关详细信息，请参阅启用动态模块。


安装 NGINX 社区模块

为了使社区动态模块能够与 NGINX Plus 一起使用，它必须与相应的 NGINX 开源版本一起编译。

  1. 准备构建环境。
    我们强烈建议您在单独的系统上编译动态模块，我们将其称为“构建环境”。这样做可以最大限度地降低您计划升级 NGINX Plus 的系统的风险和复杂性（我们将其称为“生产环境”）。构建环境必须满足以下要求：
    • 与生产环境相同的操作系统
    • 与生产环境相同的NGINX版本
    • 编译器和 make 实用程序
    • PCRE库（开发文件）
    • Zlib压缩库（开发文件）
    为了确保您的构建环境安装了这些先决条件，请运行适当的命令。
    • 对于 Debian 和 Ubuntu：
    代码:
    sudo apt-get install gcc make libpcre3-dev zlib1g-dev
    1. 对于 CentOS、Oracle Linux 和 RHEL：
    代码:
    sudo yum install gcc make pcre-devel zlib-devel
  2. 获取 NGINX 开源。
    • 确定与您的 NGINX Plus 版本相对应的 NGINX 开源版本。请参阅NGINX Plus 版本。
    • 下载相应 NGINX 开源主线版本的源代码，在本例中为 1.23.4：
    代码:
    wget -qO - https://nginx.org/download/nginx-1.23.4.tar.gz | tar zxfv -
  3. 获取动态模块的源。
    动态模块的源代码可以放置在构建环境中的任何目录中。作为示例，我们从 GitHub复制NGINX“Hello World”模块：
    代码:
    git clone https://github.com/perusio/nginx-hello-world-module.git
  4. 编译动态模块。
    configure首先通过使用选项运行脚本来建立二进制兼容性‑‑with‑compat。然后使用 编译模块make modules。
    代码:
    cd nginx-1.23.4/
    ./configure --with-compat --add-dynamic-module=../<MODULE-SOURCES>
    make modules
    构建过程生成的.so文件放置在objs子目录中
    代码:
    ls objs/*.so
    objs/ngx_http_hello_world.so
  5. 复制模块文件并在文件名中包含 NGINX 开源版本。这使得在生产环境中管理动态模块的多个版本变得更加简单。
    代码:
    cp objs/ngx_http_hello_world.so ./ngx_http_hello_world_1.23.4.so

启用动态模块

动态模块位于/etc/nginx/modules目录中，该目录是在 NGINX Plus 安装时自动创建的。

要启用动态模块：

  1. 在/etc/nginx/nginx.confmain的（顶级）上下文中，为您安装的每个动态可加载模块添加一个load_module指令。
    代码:
    load_module modules/<MODULE-NAME>.so;
  2. 检查新配置的语法有效性并重新加载 NGINX Plus。
    代码:
    nginx -t && nginx -s reload

NGINX Plus 非特权安装

在某些环境中，出于安全限制，对 root 帐户的访问受到限制。如果您使用的是 Linux 操作系统，如果没有 root 权限，您将无法运行 NGINX Plus 安装的包管理器。

作为解决方法，在此类环境中，可以使用特殊脚本来安装 NGINX Plus，该脚本修改 NGINX Plus 配置文件以从非 root 用户运行。该脚本还：
  • 下载 NGINX Plus 包
  • 将存档的内容提取到用户定义的包文件夹中
  • 将 NGINX 配置文件中用户文件夹的路径更改为用户定义文件夹中的相对路径
  • 制作配置目录的备份副本
  • 可以选择升级 NGINX Plus 的现有非特权安装

与 NGINX Plus 的常规安装相比，非特权安装有一些局限性和限制：
  • 仍然需要 root 权限才能侦听以下端口1024
  • 该脚本无意取代您操作系统的包管理器。它还不允许安装除 NGINX Plus 及其模块之外的任何其他软件。支持计划不涵盖为任何其他安装修改的脚本。
  • NGINX Plus 不会自动启动，因此，您必须为主机上的每个非特权安装添加自定义init脚本/单元文件systemd
  • NGINX Plus 二进制文件及其模块所需的所有依赖项和库不会自动安装，应手动检查和安装

该脚本可以在以下操作系统上运行
  • 红帽/CentOS
  • 亚马逊Linux 2
  • 亚马逊 Linux 2023
  • Debian、Ubuntu
  • 阿尔卑斯Linux
  • AlmaLinux、Rocky Linux

在开始非特权安装之前，请确保您具备先决条件部分中列出的所有先决条件（特权除外root）。对于基于 RPM 的发行版，请确保您已rpm2cpio安装。

要执行 NGINX Plus 的非特权安装：

  1. 获取脚本：
    代码:
    wget https://raw.githubusercontent.com/nginxinc/nginx-plus-install-tools/main/ngxunprivinst.sh
  2. 使脚本可执行：
    代码:
    chmod +x ngxunprivinst.sh
  3. 下载适用于您的操作系统的 NGINX Plus 及其模块包。<cert_file> 和 <key_file> 是您通过电子邮件提供的 NGINX Plus 证书和私钥：
    代码:
    ./ngxunprivinst.sh fetch -c <cert_file> -k <key_file>
    如果您需要安装特定版本的 NGINX Plus：
    • 首先，列出存储库中所有可用的 NGINX Plus 版本：
      代码:
      ./ngxunprivinst.sh list -c <cert_file> -k <key_file>
    • 然后使用以下选项指定特定的 NGINX Plus 版本-v：
      代码:
      ./ngxunprivinst.sh fetch -c <cert_file> -k <key_file> -v <version>
  4. 将下载的包解压到提供的 NGINX Plus 前缀 <path> 可选-y选项将覆盖现有安装（如果有）：
    代码:
    ./ngxunprivinst.sh install [-y] -p <path> <file1.rpm> <file2.rpm>
  5. 安装过程完成后，运行 NGINX Plus。该-p参数设置保存 nginx 文件的目录的路径。该-c参数设置备用 NGINX 配置文件的路径。请注意 NGINX Plus 必须侦听上述端口1024：
    代码:
    <path>/usr/sbin/nginx -p <path>/etc/nginx -c <path>/etc/nginx/conf.d

使用此脚本，您还可以在提供的环境中升级 NGINX Plus 的现有非特权安装。可选-y选项执行强制升级而不进行任何确认：
代码:
./ngxunprivinst.sh upgrade [-y] -p <path> <file1.rpm> <file2.rpm>


升级 NGINX Plus

引用:注意：从版本 24 (R24) 开始，NGINX Plus 存储库已根据操作系统分发和许可证订阅分为单独的存储库。在从以前的 NGINX Plus 版本升级之前，您必须首先重新配置存储库以指向正确的位置。要重新配置存储库，请按照上面适用于您的操作系统的安装说明进行操作。

要将 NGINX Plus 安装升级到最新版本：

  1. 如果您的系统上有以前的 NGINX 或 NGINX Plus 软件包，请备份配置和日志文件。
    • 对于 Linux 发行版：
      代码:
      sudo cp -a /etc/nginx /etc/nginx-plus-backup
      sudo cp -a /var/log/nginx /var/log/nginx-plus-backup
    • 对于 FreeBSD：
      代码:
      sudo cp -a /usr/local/etc/nginx /usr/local/etc/nginx-plus-backup
      sudo cp -a /var/log/nginx /var/log/nginx-plus-backup
  2. 升级到新的 NGINX Plus 软件包。
    • 对于 RHEL、Amazon Linux、CentOS、Oracle Linux、AlmaLinux 和 Rocky Linux：
      代码:
      sudo yum upgrade nginx-plus
    • 对于 Debian 和 Ubuntu：
      代码:
      sudo apt-get update
      sudo apt-get install nginx-plus
    • 对于 FreeBSD：
      代码:
      sudo pkg upgrade nginx-plus

要验证新的 NGINX Plus 版本是否正在运行，请运行：
代码:
nginx -v
nginx version: nginx/1.23.4 (nginx-plus-r29)


升级 NGINX Plus 模块

升级过程取决于模块的提供和安装方式。
  • NGINX 创作和 NGINX 认证的社区动态模块会与 NGINX Plus 一起自动更新。
    引用:注意：对于 FreeBSD，每个 NGINX 创作和 NGINX 认证的模块必须使用 FreeBSD 包管理工具单独更新。
  • 社区动态模块必须针对相应的 NGINX 开源版本重新编译。