juneunchul2/simple-web

dangtong76/simple-web 镜像文档

镜像概述

dangtong76/simple-web 是一款轻量级Docker镜像，专为快速部署基础Web服务设计。该镜像集成基础Web服务组件，具有体积小、资源占用低、配置简单等特点，可帮助用户在几分钟内搭建起可用的Web服务环境。

核心功能和特性

• 轻量级架构：镜像体积优化，启动速度快，适合资源受限环境
• 零配置启动：无需复杂前置配置，支持一键启动基础Web服务
• 基础Web能力：包含HTTP服务核心功能，支持静态文件托管
• 端口灵活映射：支持自定义端口映射，适配不同网络环境需求
• 跨平台兼容：兼容Docker支持的所有主流操作系统和架构

使用场景和适用范围

• 开发测试环境：本地快速搭建Web服务进行应用开发和功能测试
• 静态网站部署：托管简单静态网页、文档或演示站点
• 学习实践：作为Docker入门学习中部署Web服务的示例镜像
• 临时Web服务：快速提供临时访问的Web内容服务
• 小型项目：资源有限场景下的基础Web服务需求

使用方法和配置说明

快速启动

通过以下命令可直接启动Web服务，默认映射主机8080端口：

bash
docker run -d -p 8080:80 --name simple-web-instance dangtong76/simple-web

启动后，访问 http://localhost:8080 即可查看默认Web页面。

自定义配置

1. 端口映射配置

可通过 -p 参数自定义主机端口映射：

bash
# 将容器80端口映射到主机8888端口
docker run -d -p 8888:80 --name custom-port-web dangtong76/simple-web

2. 环境变量配置

支持通过环境变量调整基础服务配置：

示例：自定义端口和文档根目录

bash
docker run -d -p 9000:8080 \
  -e PORT=8080 \
  -e DOC_ROOT=/app/webcontent \
  --name custom-config-web dangtong76/simple-web

3. 挂载自定义内容

通过卷挂载方式使用本地静态文件：

bash
# 将本地./my-web-files目录挂载为容器文档根目录
docker run -d -p 8080:80 \
  -v $(pwd)/my-web-files:/var/www/html \
  --name mounted-web dangtong76/simple-web

Docker Compose 部署

创建 docker-compose.yml 文件：

yaml
version: '3.8'
services:
  web:
    image: dangtong76/simple-web
    ports:
      - "80:80"  # 直接映射主机80端口
    volumes:
      - ./web-content:/var/www/html  # 挂载本地静态文件
    environment:
      - PORT=80
      - DOC_ROOT=/var/www/html
    restart: unless-stopped  # 异常退出时自动重启

启动服务：

bash
docker-compose up -d

注意事项

• 该镜像专注于提供基础Web服务能力，不包含高级安全特性，生产环境使用需额外配置安全措施
• 默认文档根目录包含简单示例页面，实际使用建议通过卷挂载替换为自定义内容
• 高并发场景下建议配合反向代理和负载均衡使用
• 如需持久化数据，建议通过卷挂载方式管理Web内容文件