Static Web Server 项目中的 Docker Compose 配置指南

Static Web Server 是一个轻量级的高性能静态文件服务器，支持多种平台和架构。该项目提供了 Docker 镜像来简化部署流程，但在官方文档中，关于 Docker Compose 的配置示例主要针对 Traefik 环境，对于其他场景的用户可能不够友好。

在实际使用中，用户 hanscees 分享了一个更通用的 Docker Compose 配置方案，这个方案不依赖 Traefik，更适合简单的静态网站部署场景。以下是技术专家对该配置的详细解析和优化建议：

基础配置解析

version: "3.3"

services:
  web:
    image: joseluisq/static-web-server:2-alpine
    ports:
      - 80:80
    restart: always
    environment:
      - SERVER_CONFIG_FILE=/etc/config.toml
    volumes:
      - ./public:/public
      - ./hanscees_com:/var/hanscees
      - ./etc:/etc

这个配置的核心要素包括：

1. 镜像选择：使用了基于 Alpine Linux 的 2.x 版本镜像，体积小且安全
2. 端口映射：将容器内的 80 端口映射到主机的 80 端口
3. 自动重启：配置了 always 策略确保服务异常退出后自动恢复
4. 环境变量：指定了服务器配置文件路径
5. 卷挂载：挂载了多个目录用于存放静态文件和配置

配置优化建议

对于生产环境，可以考虑以下优化点：

1. 使用特定版本标签：避免使用 latest 或主版本号，推荐使用完整版本号如 2.16.0-alpine
2. 资源限制：添加 CPU 和内存限制防止单个容器占用过多资源
3. 健康检查：配置健康检查端点确保服务可用性
4. 日志配置：配置日志驱动和轮转策略
5. 网络隔离：使用自定义网络而非默认的 bridge 网络

进阶配置示例

version: "3.8"

services:
  web:
    image: joseluisq/static-web-server:2.16.0-alpine
    ports:
      - "8080:80"
    restart: unless-stopped
    deploy:
      resources:
        limits:
          cpus: '0.5'
          memory: 256M
    healthcheck:
      test: ["CMD", "wget", "-q", "--spider", "http://localhost"]
      interval: 30s
      timeout: 10s
      retries: 3
    environment:
      - SERVER_CONFIG_FILE=/etc/config.toml
      - SERVER_PORT=80
      - SERVER_ROOT=/public
    volumes:
      - ./public:/public
      - ./config:/etc
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"

配置说明

1. 版本控制：使用了更具体的镜像版本号，提高部署的确定性
2. 端口安全：将容器端口映射到主机的 8080 而非 80，避免权限问题
3. 资源限制：设置了 CPU 和内存使用上限
4. 健康检查：通过 HTTP 请求验证服务状态
5. 日志管理：配置了日志轮转防止磁盘空间耗尽
6. 环境变量：添加了常用的服务器配置参数

最佳实践

1. 配置文件管理：将配置文件通过卷挂载而非直接写入镜像，便于修改
2. 静态文件分离：保持静态文件目录与配置目录分离，便于维护
3. 最小权限原则：考虑使用非 root 用户运行容器
4. 监控集成：可以添加 Prometheus 监控端点
5. TLS 支持：对于生产环境，建议配置 HTTPS 支持

通过以上配置和优化建议，用户可以更安全、高效地部署 Static Web Server 服务，满足不同场景下的静态文件服务需求。