theorangeone/static-server

Docker 静态服务器

!https://github.com/RealOrangeOne/docker-static-server/workflows/CI/badge.svg

可定制且高性能的静态文件服务器 - 基于Nginx。

注意：此容器设计用于托管静态文件，而非提供静态网站。

"为什么不直接使用 nginx:alpine？"

如果您不介意，默认的 nginx 容器完全可以满足需求，但此容器有一些修改，使其更适合提供静态文件：

• 使用环境变量进行定制化配置
• 健康检查端点
• GZIP压缩所有文件
• 获取客户端IP时使用 X-Forwarded-For 头

无论如何使用，Nginx都是出色的文件服务器。

使用场景

适用于需要高效托管静态文件的场景，如文件共享服务、静态资源存储、日志文件访问等场景。

使用方法

Docker Compose 配置示例

yml
version: "2.3"

services:
  static:
    image: theorangeone/static-server:latest
    volumes:
      - ".:/srv:ro"  # 挂载本地目录到容器内/srv，只读模式
    ports:
      - "80:80"  # 映射容器80端口到主机80端口

服务器将提供 /srv 目录下的文件。建议将该目录挂载为只读模式以增强安全性。

定制化配置

此镜像支持通过环境变量进行以下定制化：

配置示例

启用增强型文件列表并修改运行用户ID：

yml
version: "2.3"

services:
  static:
    image: theorangeone/static-server:latest
    volumes:
      - ".:/srv:ro"
    ports:
      - "8080:80"
    environment:
      - FANCY_INDEX=on
      - PUID=1001