woahbase/alpine-nginx

alpine-nginx

镜像概述

alpine-nginx是一个多架构Docker镜像，基于Alpine Linux构建，集成S6进程管理工具和NGINX，主要用于提供Web服务器功能或作为反向代理服务。该镜像由WOAHBase维护，适用于需要轻量级Web服务的场景。

核心功能与特性

• 多架构支持：提供对多种硬件架构的支持，包括x86_64、aarch64、armv7l、armhf、i386、ppc64le、riscv64及s390x等
• 轻量级基础：基于Alpine Linux，具备体积小、资源占用低的特点
• 进程管理：集成S6，提供可靠的进程管理和服务控制能力
• 功能完整：包含NGINX服务，支持静态文件托管、HTTP/HTTPS服务及反向代理等功能

使用场景与适用范围

• 静态网站托管：用于部署包含HTML、CSS、JavaScript等静态资源的网站
• 反向代理：作为反向代理服务器，将客户端请求转发至后端应用服务
• 轻量级Web服务：在资源受限环境（如嵌入式设备、边缘计算节点）中提供高效Web服务
• 多架构部署：支持在不同硬件架构的设备上无缝部署和运行

使用方法与配置说明

基本运行方式

通过以下命令可快速启动容器，默认运行NGINX服务：

bash
docker run -d -p 80:80 --name alpine-nginx woahbase/alpine-nginx

自定义配置

挂载配置文件

通过挂载本地NGINX配置文件自定义服务行为：

bash
docker run -d -p 80:80 \
  -v /本地路径/nginx.conf:/etc/nginx/nginx.conf \
  -v /本地路径/conf.d:/etc/nginx/conf.d \
  --name alpine-nginx woahbase/alpine-nginx

挂载网站目录

将本地网站文件目录挂载至容器默认网站根目录：

bash
docker run -d -p 80:80 \
  -v /本地网站路径:/var/www/localhost/htdocs \
  --name alpine-nginx woahbase/alpine-nginx

Docker Compose配置示例

创建docker-compose.yml文件进行服务编排：

yaml
version: '3'
services:
  nginx:
    image: woahbase/alpine-nginx
    ports:
      - "80:80"
      - "443:443"  # 如需HTTPS服务
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
      - ./conf.d:/etc/nginx/conf.d
      - ./website:/var/www/localhost/htdocs
      - ./ssl:/etc/nginx/ssl  # 如需HTTPS，挂载证书目录
    restart: unless-stopped

相关资源

• 官方文档
• https://hub.docker.com/r/woahbase/alpine-nginx
• https://github.com/woahbase/alpine-nginx