docker-static-website 镜像文档

镜像概述

docker-static-website 是一个极小的 Docker 镜像，专为托管静态网站设计。该镜像基于 BusyBox 和 thttpd（轻量级 HTTP 服务器）构建，体积仅约 80KB，能够以高效、低资源占用的方式部署静态内容，无需复杂配置即可快速启动。

核心功能和特性

• 超小体积：镜像大小仅约 80KB，显著减少存储空间占用和拉取时间
• 轻量高效：基于 thttpd 服务器，资源消耗低，适合边缘环境和资源受限场景
• 简单易用：零配置启动，通过基础 Docker 命令即可完成部署
• 灵活配置：支持自定义端口和静态文件根目录
• 广泛兼容：可托管各类静态资源（HTML、CSS、JavaScript、图片等）

使用场景和适用范围

• 个人博客或静态网站部署
• 项目文档托管（如 MkDocs、Jekyll 生成的静态文档）
• 静态演示页面或产品原型展示
• 轻量级内部工具的前端资源托管
• CI/CD 流程中的静态内容临时预览服务

使用方法和配置说明

基本使用

将本地静态文件目录挂载到容器中，即可启动服务：

bash
docker run -d -p 8080:80 -v $(pwd)/public:/srv lipanski/docker-static-website

说明：

• -v $(pwd)/public:/srv：将当前目录下的 public 文件夹挂载为容器内的静态文件根目录（默认路径 /srv）
• -p 8080:80：将容器内 80 端口（默认端口）映射到主机的 8080 端口
• 访问 http://localhost:8080 即可查看网站

自定义配置

自定义端口

通过 PORT 环境变量指定容器内服务端口，结合 -p 参数映射到主机端口：

bash
docker run -d -e PORT=8080 -p 3000:8080 -v $(pwd)/public:/srv lipanski/docker-static-website

效果：容器内服务监听 8080 端口，主机通过 3000 端口访问

指定静态文件目录

通过 DIR 环境变量自定义容器内静态文件根目录：

bash
docker run -d -p 8080:80 -e DIR=/www -v $(pwd)/my-site:/www lipanski/docker-static-website

说明：将本地 my-site 文件夹挂载到容器内 /www 目录（通过 DIR 指定为根目录）

Docker Compose 示例

创建 docker-compose.yml 配置文件：

yaml
version: '3'
services:
  static-site:
    image: lipanski/docker-static-website
    ports:
      - "80:80"  # 主机 80 端口映射到容器默认端口
    volumes:
      - ./public:/srv  # 挂载本地静态文件目录
    environment:
      - PORT=80        # 容器内服务端口（默认 80）
      - DIR=/srv       # 静态文件根目录（默认 /srv）

启动服务：

bash
docker-compose up -d

环境变量说明

注意事项

• 确保挂载的静态文件目录包含可访问的入口文件（如 index.html），thttpd 默认以此为首页
• 挂载目录权限需允许容器读取文件（避免因权限问题导致访问失败）
• 如需 HTTPS 支持，可结合反向代理（如 Nginx、Caddy）使用