Bitnami NGINX Open Source 镜像文档

镜像概述和主要用途

NGINX Open Source 是一款高性能的 Web 服务器，同时也可用作反向代理、负载均衡器和 HTTP 缓存。因其能够提供更快的内容交付能力，特别适用于高负载网站。Bitnami 提供的 NGINX Open Source 镜像经过精心打包，包含 Helm Chart 支持，可快速部署到 Kubernetes 集群，满足生产级工作负载需求。

NGINX Open Source ***概述

商标说明：本软件列表由 Bitnami 打包。所提及的相关商标归各自公司所有，使用这些商标并不意味着任何关联或背书。

核心功能和特性

• 多角色支持：同时作为 Web 服务器、反向代理、负载均衡器和 HTTP 缓存运行
• 高性能架构：针对高并发场景优化，资源占用低，响应速度快
• 生产级 Helm Chart：提供经过工程化、持续维护的 Helm Chart，支持 Kubernetes 快速部署
• 安全强化：遵循 Bitnami Secure Images 计划，提供硬化容器、减小***面、CVE 透明度（通过 VEX/KEV）和 SBOM 支持
• 灵活配置：支持自定义服务器块、上下文配置（Main/Events/HTTP）、环境变量注入
• 监控集成：可与 Prometheus 集成，通过 nginx-prometheus-exporter 暴露指标
• TLS 加密：支持自定义证书或自动生成证书，保障传输安全
• 多源部署：支持从 Git 仓库、ConfigMap 或现有 PVC 部署自定义 Web 应用

使用场景和适用范围

• 高流量网站：为静态或动态内容提供高效服务，支持数万并发连接
• 反向代理：作为后端服务的入口，隐藏内部架构并提供统一访问点
• 负载均衡：在多个后端实例间分发流量，提高系统可用性和扩展性
• HTTP 缓存：缓存静态资源，减少后端服务器负载并提升用户访问速度
• Kubernetes 环境：通过 Helm Chart 实现 NGINX 在 Kubernetes 集群中的标准化部署
• 开发与生产环境：支持从开发测试到生产部署的全生命周期使用，提供一致的运行环境

详细使用方法和配置说明

前置要求

• Kubernetes 部署：Kubernetes 1.23+、Helm 3.8.0+
• Docker 部署：Docker Engine 19.03+

Docker 快速启动

console
docker run --name nginx -p 80:8080 docker.io/bitnami/nginx:latest

注意：Bitnami 镜像默认使用非 root 用户运行，HTTP 服务默认监听 8080 端口（而非 80）。生产环境建议使用不可变标签（如具体版本号）而非 latest。

Helm Chart 部署

TL;DR

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/nginx

安装步骤

1. 添加 Bitnami Helm 仓库（如需）：

   console
   helm repo add bitnami [***]
   helm repo update
   

2. 安装 Chart：

   console
   helm install my-release oci://registry-1.docker.io/bitnamicharts/nginx
   

3. 验证部署：

   console
   helm list  # 列出所有发布
   kubectl get pods  # 检查 Pod 状态
   kubectl port-forward svc/my-release-nginx 8080:8080  # 端口转发测试
   

高级配置

资源请求与限制

为生产环境配置资源请求和限制，避免资源竞争：

yaml
# values.yaml
resources:
  requests:
    cpu: 100m
    memory: 128Mi
  limits:
    cpu: 500m
    memory: 256Mi

通过 resourcesPreset 使用预设配置（开发环境适用）：

yaml
# values.yaml
resourcesPreset: small  # 自动应用预定义的小型资源配置

Prometheus 监控集成

启用 Prometheus 指标采集：

yaml
# values.yaml
metrics:
  enabled: true  # 部署 nginx-prometheus-exporter 边车容器
  serviceMonitor:
    enabled: true  # 创建 ServiceMonitor 对象（需 Prometheus Operator）

TLS 加密配置

使用自定义证书：

yaml
# values.yaml
tls:
  enabled: true
  certificatesSecret: my-tls-secret  # 包含证书的 Secret 名称
  certFilename: tls.crt  # 证书文件名
  certKeyFilename: tls.key  # 密钥文件名
  certCAFilename: ca.crt  # CA 证书文件名（可选）

自动生成证书：

yaml
# values.yaml
tls:
  enabled: true
  autoGenerated: true  # 自动生成自签名证书

部署自定义 Web 应用

从 Git 仓库拉取：

yaml
# values.yaml
cloneStaticSiteFromGit:
  enabled: true
  repository: [***]  # 应用仓库
  branch: master  # 分支名
  interval: 3600  # 拉取间隔（秒）

使用 ConfigMap：

yaml
# values.yaml
staticSiteConfigmap: my-app-configmap  # 包含静态文件的 ConfigMap 名称

使用现有 PVC：

yaml
# values.yaml
staticSitePVC: my-app-pvc  # 包含应用内容的 PVC 名称

自定义服务器块

yaml
# values.yaml
serverBlock: |-
  server {
    listen 0.0.0.0:8080;
    server_name example.com;
    
    location / {
      root /app;
      index index.html;
    }
    
    location /api/ {
      proxy_pass [***]
      proxy_set_header Host $host;
    }
  }

上下文配置（Context Includes）

内联配置：

yaml
# values.yaml
contextIncludes:
  main: |
    load_module /opt/bitnami/nginx/modules/ngx_http_dav_module.so;
    worker_processes auto;
  
  events: |
    worker_connections 2048;
    use epoll;
  
  http: |
    gzip on;
    gzip_types text/plain application/json text/css;
    add_header X-Frame-Options DENY;

外部 ConfigMap 引用：

yaml
# values.yaml
existingContextMainConfigmaps:
  - nginx-main-config
existingContextHttpConfigmaps:
  - nginx-http-security

镜像标签策略

生产环境强烈建议使用不可变标签（如 1.25.3-debian-11-r10），避免因镜像更新导致部署意外变更。Bitnami 会通过更新 Chart 版本来引入主容器新版本、重大变更或修复关键漏洞。

自 2025 年 8 月 28 日起，非硬化的 Debian 基础镜像将逐步从公共目录（docker.io/bitnami）迁移至 "Bitnami Legacy" 仓库（docker.io/bitnamilegacy），且不再接收更新。

配置参数说明

全局参数

通用参数

NGINX 核心参数

部署参数

⚠️ 重要通知：Bitnami 镜像目录即将变更

自 2025 年 8 月 28 日起，Bitnami 将升级其公共目录，通过新的 Bitnami Secure Images 计划 提供精选的硬化、安全聚焦镜像。此过渡包含以下变更：

• 首次向社区用户开放流行容器镜像的安全优化版本访问权限
• Bitnami 将开始在免费层中弃用非硬化的 Debian 基础软件镜像，并逐步从公共目录中移除非最新标签。社区用户将只能访问数量减少的硬化镜像，这些镜像仅以 "latest" 标签发布，适用于开发目的
• 自 8 月 28 日起，两周内所有现有容器镜像（包括旧版本或特定版本标签，如 2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移至 "Bitnami Legacy" 仓库（docker.io/bitnamilegacy），且不再接收更新
• 对于生产工作负载和长期支持，建议用户采用 Bitnami Secure Images，包括硬化容器、更小的***面、CVE 透明度（通过 VEX/KEV）、SBOM 和企业支持

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，提升所有 Bitnami 用户的安全态势。更多详情请访问 Bitnami Secure Images 公告。