charlesportwoodii/nginx

Nginx Alpine 镜像文档

镜像概述

本镜像为Alpine Linux系统提供Nginx主线版（Mainline）和稳定版（Stable）构建，镜像来源于专用软件仓库apk.erianna.com，基于GitHub项目https://github.com/charlesportwoodii/nginx-build%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E8%BD%BB%E9%87%8F%E3%80%81%E5%8F%AF%E9%9D%A0%E7%9A%84Nginx%E8%BF%90%E8%A1%8C%E7%8E%AF%E5%A2%83%E3%80%82

核心功能与特性

1. 轻量级基础

基于Alpine Linux构建，具备Alpine系统固有的轻量级特性，镜像体积小，资源占用低，适合高效部署。

2. 多版本支持

同时提供Nginx主线版（Mainline）和稳定版（Stable），满足不同场景下对Nginx版本的需求：

• 主线版：包含最新功能和改进，适合需要新特性的场景
• 稳定版：经过充分测试，稳定性高，适合生产环境

3. 可靠构建来源

镜像构建资源来源于专用APK仓库（apk.erianna.com），确保软件包的完整性和安全性，基于成熟的GitHub项目构建流程，保障构建质量。

使用场景与适用范围

• 开发/测试环境：轻量级特性适合快速搭建测试环境，多版本支持满足不同开发需求
• 生产环境：稳定版构建可用于生产环境的Web服务部署，Alpine基础减少资源占用
• 资源受限环境：轻量级镜像特别适合容器化部署、边缘计算等资源受限场景

使用方法与配置说明

基本运行

使用以下命令拉取并运行镜像（假设镜像标签区分主线版和稳定版，如mainline和stable）：

bash
# 运行主线版
docker run -d --name nginx-mainline -p 80:80 <镜像名称>:mainline

# 运行稳定版
docker run -d --name nginx-stable -p 80:80 <镜像名称>:stable

挂载自定义配置

通过挂载本地配置文件覆盖默认配置：

bash
docker run -d --name nginx-custom \
  -p 80:80 \
  -v /path/to/local/nginx.conf:/etc/nginx/nginx.conf:ro \
  -v /path/to/local/conf.d:/etc/nginx/conf.d:ro \
  <镜像名称>:<版本标签>

持久化数据

挂载本地目录存储日志和网站文件：

bash
docker run -d --name nginx-persistent \
  -p 80:80 \
  -v /path/to/nginx/logs:/var/log/nginx \
  -v /path/to/website:/usr/share/nginx/html \
  <镜像名称>:<版本标签>

版本选择

通过镜像标签指定所需版本：

• mainline：Nginx主线版
• stable：Nginx稳定版

配置说明

镜像默认配置遵循Nginx官方标准，主要配置文件路径：

• 主配置文件：/etc/nginx/nginx.conf
• 站点配置目录：/etc/nginx/conf.d/
• 默认网站根目录：/usr/share/nginx/html
• 日志目录：/var/log/nginx/

如需自定义配置，建议通过挂载本地配置文件实现，避免直接修改容器内文件。

注意事项

• 本镜像基于Alpine Linux，依赖Alpine的APK包管理系统，内部命令与标准Linux可能存在差异
• 镜像来源于第三方仓库（apk.erianna.com），使用前建议验证仓库可靠性
• 具体版本信息和构建细节可参考基础项目https://github.com/charlesportwoodii/nginx-build