denbeke/staticsloth

StaticSloth 静态文件服务器

镜像概述

StaticSloth 是一个用Go编写的轻量级静态文件服务器，所有配置通过环境变量完成，无需复杂的配置文件。它支持多种实用功能，适合快速部署静态网站或提供静态资源服务。

核心功能与特性

• 环境变量配置：所有功能通过环境变量灵活配置，无需配置文件
• 访问日志：可启用访问日志记录
• Gzip压缩：默认启用gzip压缩以优化传输性能
• 缓存控制：可对指定路径设置Cache-Control头，控制资源缓存策略
• 路径阻塞：可阻止访问指定路径，增强安全性

使用场景

• 本地开发环境中快速预览静态网站
• 小型静态网站或应用的生产环境部署
• 作为前端应用的静态资源服务器
• 需要简单配置和轻量级部署的静态内容服务

使用方法

Docker Run 示例

基本用法（使用默认配置）：

bash
docker run -d -p 1234:1234 -v $(pwd)/html:/var/www/html denbeke/staticsloth

自定义配置示例（修改端口、启用访问日志、设置缓存控制）：

bash
docker run -d \
  -p 8080:8080 \
  -v $(pwd)/static:/var/www/html \
  -e HTTP_ADDRESS=":8080" \
  -e ACCESS_LOG="1" \
  -e CACHE_CONTROL_PATHS="/assets,/images" \
  -e CACHE_CONTROL_DURATION="3600" \
  denbeke/staticsloth

Docker Compose 示例

yaml
version: '3'
services:
  staticsloth:
    image: denbeke/staticsloth
    ports:
      - "80:1234"
    volumes:
      - ./html:/var/www/html
    environment:
      - HTTP_ADDRESS=:1234
      - PATH_PREFIX=/
      - DIRECTORY=/var/www/html
      - ACCESS_LOG=1
      - GZIP=1
      - CACHE_CONTROL_PATHS="/assets,/css,/js"
      - CACHE_CONTROL_DURATION=86400
      - BLOCK_PATHS="/.git,/tmp"

配置参数

以下环境变量可用于配置StaticSloth服务器：

注意事项

• 该项目目前处于开发中（WIP），可能存在未完善的功能或潜在问题
• 挂载本地目录时，确保目录权限正确，容器内用户需要有读取权限
• 当启用CACHE_CONTROL_PATHS时，必须同时设置CACHE_CONTROL_DURATION才会生效