概要

フル名
docker.io/svenstaro/miniserve
Registry
docker.io
名前空間
svenstaro
リポジトリ
miniserve
キャッシュ Tag 数
84
最終同期
07/06/2026, 12:04 PM

概要

miniserve Rust 轻量静态文件 HTTP 服务器镜像,单二进制零配置分享目录,适合临时文件分发与内网静态站点。

詳細

svenstaro/miniserve 用 Rust 实现的高性能静态文件服务,支持目录列表、上传、Basic Auth 与 TLS。典型用于快速分享构建产物或 homelab 文件目录,与 python -m http.server 相比功能更全且性能更好。生产应固定 tag、只读挂载源目录并启用认证,公网暴露需 HTTPS 与访问控制。

快速启动

docker run -d --name miniserve \
  -p 8080:8080 \
  -v $(pwd)/share:/share:ro \
  docker.io/svenstaro/miniserve:latest \
  /share

推荐实践

docker run -d --name miniserve \
  --restart unless-stopped \
  -p 8080:8080 \
  -v /data/public:/share:ro \
  docker.io/svenstaro/miniserve:0.24.0 \
  --auth admin:strong-pass --enable-tzip /share

核心参数说明

  • -p 8080:8080 — HTTP 文件服务端口
  • -v .../share:... — 静态文件根目录(建议只读)
  • --auth user:pass — Basic Auth 保护
  • --enable-tzip — 目录 tar 打包下载
  • --restart unless-stopped — 文件站持续在线
  • 固定 tag — 二进制版本 pin

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: miniserve
spec:
  replicas: 1
  selector:
    matchLabels:
      app: miniserve
  template:
    metadata:
      labels:
        app: miniserve
    spec:
      containers:
        - name: miniserve
          image: docker.io/svenstaro/miniserve:0.24.0
          args: ["--auth", "$(AUTH)", "/share"]
          ports:
            - containerPort: 8080
          envFrom:
            - secretRef:
                name: miniserve-secrets
          volumeMounts:
            - name: share
              mountPath: /share
              readOnly: true
      volumes:
        - name: share
          persistentVolumeClaim:
            claimName: miniserve-share
---
apiVersion: v1
kind: Service
metadata:
  name: miniserve
spec:
  selector:
    app: miniserve
  ports:
    - port: 8080
      targetPort: 8080

PVC 或 hostPath 挂载静态资源;Ingress Basic Auth 或 OAuth2 代理双层保护。

Tagアーキテクチャプッシュ日時サイズDigest同期期望操作
docker.io/svenstaro/miniserve
:alpine
linux/arm64/v8linux/amd64linux/arm/v7
2026/07/01 19:216.1 MBsha256:1e872cd2d37c
docker.io/svenstaro/miniserve
:latest
linux/arm64/v8linux/amd64linux/arm/v7
2026/07/01 19:2130.2 MBsha256:f0540d4c92e7
docker.io/svenstaro/miniserve
:0.35.0-alpine
linux/arm64/v8linux/amd64linux/arm/v7
2026/04/08 20:186.1 MBsha256:25aeff1f8f23
docker.io/svenstaro/miniserve
:0.35.0
linux/arm64/v8linux/amd64linux/arm/v7
2026/04/08 20:1830.0 MBsha256:300127993c2b
docker.io/svenstaro/miniserve
:0.34.0-alpine
linux/arm64/v8linux/amd64linux/arm/v7
2026/04/08 06:146.1 MBsha256:b32b85ba0539
docker.io/svenstaro/miniserve
:0.34.0
linux/arm64/v8linux/amd64linux/arm/v7
2026/04/08 06:1430.0 MBsha256:728ccd5869ba
docker.io/svenstaro/miniserve
:0.33.0-alpine
linux/arm64/v8linux/amd64linux/arm/v7
2026/02/16 15:456.1 MBsha256:22b169188d3e
docker.io/svenstaro/miniserve
:0.33.0
linux/arm64/v8linux/amd64linux/arm/v7
2026/02/16 15:4529.8 MBsha256:d16319cfb32c
docker.io/svenstaro/miniserve
:0.32.0-alpine
linux/arm64/v8linux/amd64linux/arm/v7
2025/09/17 08:566.1 MBsha256:23e76d6a975d
docker.io/svenstaro/miniserve
:0.32.0
linux/arm64/v8linux/amd64linux/arm/v7
2025/09/17 08:5531.0 MBsha256:a8299613dd3c
docker.io/svenstaro/miniserve
:0.31.0-alpine
linux/arm64/v8linux/amd64linux/arm/v7
2025/06/28 01:206.0 MBsha256:65824b3e5cdc
docker.io/svenstaro/miniserve
:0.31.0
linux/arm64/v8linux/amd64linux/arm/v7
2025/06/28 01:2030.8 MBsha256:18a9fd18f7d8
docker.io/svenstaro/miniserve
:0.30.0-alpine
linux/arm64/v8linux/amd64linux/arm/v7
2025/06/26 17:506.0 MBsha256:46f89154007c
docker.io/svenstaro/miniserve
:0.30.0
linux/arm64/v8linux/amd64linux/arm/v7
2025/06/26 17:5030.8 MBsha256:29a884c107e1
docker.io/svenstaro/miniserve
:0.29.0-alpine
linux/arm64/v8linux/amd64linux/arm/v7
2025/02/06 14:455.8 MBsha256:3b8d2c303401
docker.io/svenstaro/miniserve
:0.29.0
linux/arm64/v8linux/amd64linux/arm/v7
2025/02/06 14:4430.1 MBsha256:10e4e71f2efe
docker.io/svenstaro/miniserve
:0.28.0-alpine
linux/arm64linux/amd64linux/arm
2024/09/12 10:205.7 MBsha256:e0a693ca9800
docker.io/svenstaro/miniserve
:0.28.0
linux/arm64linux/amd64linux/arm
2024/09/12 10:2033.1 MBsha256:6a51143d97e3
docker.io/svenstaro/miniserve
:0.27.0-alpine
linux/arm64linux/amd64linux/arm
2024/03/16 19:355.0 MBsha256:c2189d32f7ec
docker.io/svenstaro/miniserve
:0.27.0
linux/arm64linux/amd64linux/arm
2024/03/16 19:3531.9 MBsha256:520257118bd3