bitnamicharts/nginx

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 https://charts.bitnami.com/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: https://github.com/mdn/beginner-html-site-styled.git  # 应用仓库
  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 http://backend-service:8080/;
      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 用户的安全态势。更多详情请访问 https://github.com/bitnami/containers/issues/83267%E3%80%82