funkygibbon/nginx

Nginx + OpenSSL

!https://img.shields.io/badge/nginx-1.17.4-brightgreen.svg !https://img.shields.io/badge/OpenSSL-1.1.1d-brightgreen.svg

镜像概述和主要用途

该镜像基于https://registry.hub.docker.com/u/funkygibbon/ubuntu/%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%90%8E%E8%80%85%E6%98%AF%E8%BD%BB%E9%87%8F%E4%BF%AE%E6%94%B9%E7%9A%84Ubuntu Xenial https://phusion.github.io/baseimage-docker/%E3%80%82%E9%9B%86%E6%88%90%E4%BA%86Nginx 1.17.4和OpenSSL 1.1.1d，提供开箱即用的Web服务能力，支持通过环境变量灵活配置，适用于快速部署需要HTTPS支持的Web应用。

核心功能和特性

• 灵活配置：通过环境变量自定义Nginx参数，服务启动时自动应用配置
• 安全默认设置：采用现代HTTPS配置标准，禁用不安全协议，默认生成自签名SSL证书
• 源码编译：基于Nginx主线源代码编译，包含headers-more模块，禁用不必要模块
• 自动适配：根据可用CPU核心数自动调整worker_processes，最多不超过配置上限

使用场景和适用范围

• 需要快速部署HTTPS Web服务的场景
• 开发/测试环境中需要临时SSL证书的Web应用
• 需要自定义Nginx配置参数的Web服务部署
• 对安全有基本要求的中小型Web应用

使用方法和配置说明

快速启动

使用以下命令启动容器，映射Web目录和端口：

bash
docker run -v "/path/to/www:/app/www" -p "80:80" -p "443:443" docker.xuanyuan.run/funkygibbon/nginx-pagespeed

• 文件服务路径：/app/www/（需通过-v挂载本地目录）
• SSL证书位置：/etc/nginx/ssl（自动生成自签名证书）
• 虚拟主机配置：/etc/nginx/sites-enabled/*（搜索该目录下的配置文件）

通过Docker Compose部署

创建docker-compose.yml文件：

yml
version: '2'
services:
  app:
    image: docker.xuanyuan.run/funkygibbon/nginx
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /path/to/www:/app/www

启动服务：docker-compose up -d

环境变量配置

可通过环境变量自定义Nginx配置，示例：

bash
docker run -e "UPLOAD_MAX_SIZE=50M" docker.xuanyuan.run/funkygibbon/nginx-pagespeed

可用环境变量

安全特性

• 编译配置：基于Nginx主线源代码，使用Ubuntu编译标志，包含：

  • OpenSSL 1.1.1d 源代码（https://www.openssl.org/source/%EF%BC%89
  • headers-more nginx模块（https://github.com/openresty/headers-more-nginx-module/tags%EF%BC%89
  • 禁用http_ssi_module和http_autoindex_module模块

• HTTPS配置：

  • 采用Mozilla中级安全配置文件（参考：https://wiki.mozilla.org/Security/Server_Side_TLS%EF%BC%89
  • 禁用SSLv2和SSLv3，启用TLSv1、TLSv2和TLSv3
  • 自动生成2048位DH参数文件（若未提供）
  • 首次启动生成自签名SSL证书，存储于/etc/nginx/ssl/default.key和/etc/nginx/ssl/default.crt
  • 建议通过挂载ssl和sites-enabled文件夹来使用自定义证书

服务启动流程

1. 设置Nginx用户为${APP_USER:-$DEFAULT_APP_USER}（默认：nginx）
2. 根据{APP_USER:-$DEFAULT_APP_USER}:${APP_GROUP:-$DEFAULT_APP_GROUP}创建用户和组，包含UID/GID匹配检查
3. 调整worker_processes为可用CPU核心数，最大不超过${NGINX_MAX_WORKER_PROCESSES:-$DEFAULT_MAX_WORKER_PROCESSES}
4. 设置client_max_body_size为${UPLOAD_MAX_SIZE:-$DEFAULT_UPLOAD_MAX_SIZE}