概要

フル名
docker.io/dxflrs/garage
Registry
docker.io
名前空間
dxflrs
リポジトリ
garage
キャッシュ Tag 数
44
最終同期
07/06/2026, 03:44 PM

概要

Garage 轻量分布式对象存储镜像,兼容 S3 API,适合边缘与中小规模自建存储集群,需配置节点角色、RPC 密钥与数据目录。

詳細

dxflrs/garage 是用 Rust 编写的 geo-distributed 对象存储,支持多节点 replication 与 S3 兼容 API,资源占用低于 MinIO/Ceph。部署需指定 node id、rpc_secret 与 metadata/data 路径,多节点组成 cluster。与 MinIO 相比更轻、无 Web 控制台内置;生产应固定 tag、规划 replication factor,并通过反向代理或 Ingress 暴露 S3 HTTPS。

快速启动

docker run -d --name garage \
  -p 3900:3900 -p 3901:3901 \
  -v $(pwd)/garage.toml:/etc/garage.toml \
  -v $(pwd)/meta:/var/lib/garage/meta \
  -v $(pwd)/data:/var/lib/garage/data \
  docker.io/dxflrs/garage:latest server

推荐实践

docker run -d --name garage \
  --restart unless-stopped \
  -p 3900:3900 -p 3901:3901 -p 3903:3903 \
  -v /etc/garage/garage.toml:/etc/garage.toml:ro \
  -v /data/garage/meta:/var/lib/garage/meta \
  -v /data/garage/data:/var/lib/garage/data \
  docker.io/dxflrs/garage:v1.0.0 server

核心参数说明

  • server — 启动存储节点进程
  • -p 3900 — S3 API 端口
  • -p 3901 — 管理/admin API
  • -v .../garage.toml — 节点与集群配置
  • -v .../meta / .../data — 元数据与对象块
  • --restart unless-stopped — 存储节点持续在线

Kubernetes

apiVersion: apps/v1
kind: StatefulSet
metadata:
  name: garage
spec:
  serviceName: garage
  replicas: 3
  selector:
    matchLabels:
      app: garage
  template:
    metadata:
      labels:
        app: garage
    spec:
      containers:
        - name: garage
          image: docker.io/dxflrs/garage:v1.0.0
          args: ["server"]
          ports:
            - containerPort: 3900
            - containerPort: 3901
          volumeMounts:
            - name: config
              mountPath: /etc/garage.toml
              subPath: garage.toml
            - name: meta
              mountPath: /var/lib/garage/meta
            - name: data
              mountPath: /var/lib/garage/data
      volumes:
        - name: config
          configMap:
            name: garage-config
  volumeClaimTemplates:
    - metadata:
        name: meta
      spec:
        accessModes: ["ReadWriteOnce"]
        resources:
          requests:
            storage: 10Gi
    - metadata:
        name: data
      spec:
        accessModes: ["ReadWriteOnce"]
        resources:
          requests:
            storage: 100Gi
---
apiVersion: v1
kind: Service
metadata:
  name: garage
spec:
  selector:
    app: garage
  ports:
    - name: s3
      port: 3900

ConfigMap 存放 garage.toml;三节点起步,Ingress 或 LB 暴露 S3 端点。

Tagアーキテクチャプッシュ日時サイズDigest同期期望操作
docker.io/dxflrs/garage
:v2.3.0
linux/arm64linux/amd64linux/386linux/arm
2026/04/17 04:2225.8 MBsha256:2d3f94a89a8a
docker.io/dxflrs/garage
:v1.3.1
linux/arm64linux/amd64linux/386linux/arm
2026/01/24 23:089.5 MBsha256:cb8c94d28a9e
docker.io/dxflrs/garage
:v2.2.0
linux/arm64linux/amd64linux/386linux/arm
2026/01/24 22:2518.0 MBsha256:dae378a974f1
docker.io/dxflrs/garage
:v1.99.3-internal
linux/arm64linux/amd64linux/386linux/arm
2025/11/07 05:349.1 MBsha256:0c0fa1ab66d4
docker.io/dxflrs/garage
:v2.1.0
linux/arm64linux/amd64linux/386linux/arm
2025/09/16 01:2210.7 MBsha256:6d519fe55949
docker.io/dxflrs/garage
:v1.3.0
linux/arm64linux/amd64linux/386linux/arm
2025/09/15 21:469.3 MBsha256:11816cf0a954
docker.io/dxflrs/garage
:v2.0.0
linux/arm64linux/amd64linux/386linux/arm
2025/06/14 23:3110.3 MBsha256:88bf0cdccf02
docker.io/dxflrs/garage
:v1.2.0
linux/arm64linux/amd64linux/386linux/arm
2025/06/14 00:349.0 MBsha256:38326ae1191d
docker.io/dxflrs/garage
:v2.0.0-rc1
linux/arm64linux/amd64linux/386linux/arm
2025/05/24 02:3510.3 MBsha256:62a63c84a4e5
docker.io/dxflrs/garage
:v1.99.2-internal
linux/386linux/armlinux/arm64linux/amd64
2025/05/23 23:139.7 MBsha256:13e6e94e23f7
docker.io/dxflrs/garage
:v2.0.0-beta1
linux/arm64linux/amd64linux/386linux/arm
2025/04/17 19:3910.4 MBsha256:2690c3dbd742
docker.io/dxflrs/garage
:v1.99.1-internal
linux/arm64linux/amd64linux/386linux/arm
2025/03/08 00:179.2 MBsha256:2c35707393bf
docker.io/dxflrs/garage
:v1.1.0
linux/arm64linux/amd64linux/386linux/arm
2025/03/05 18:529.1 MBsha256:0059de6ecb34
docker.io/dxflrs/garage
:v1.1.0-rc1
linux/arm64linux/amd64linux/386linux/arm
2025/02/21 03:209.1 MBsha256:022a577eb44a
docker.io/dxflrs/garage
:v1.99.0-internal
linux/arm64linux/amd64linux/386linux/arm
2025/02/19 03:209.1 MBsha256:3a9daea628f8
docker.io/dxflrs/garage
:v1.0.1
linux/arm64linux/amd64linux/386linux/arm
2024/09/22 21:129.0 MBsha256:795d30f4a37f
docker.io/dxflrs/garage
:v1.0.0
linux/arm64linux/amd64linux/386linux/arm
2024/04/11 00:068.9 MBsha256:dbe7092e2b86
docker.io/dxflrs/garage
:v0.9.4
linux/arm64linux/amd64linux/386linux/arm
2024/04/08 18:229.1 MBsha256:504886b420d4
docker.io/dxflrs/garage
:v1.0.0-rc1
linux/arm64linux/amd64linux/386linux/arm
2024/03/29 01:208.9 MBsha256:e04011d34f29
docker.io/dxflrs/garage
:v0.8.7
linux/arm64linux/amd64linux/386linux/arm
2024/03/04 23:2620.6 MBsha256:f3255d4a678c