mephistoxol/s3fs

!https://raw.githubusercontent.com/MephistoXoL/Docker-S3/master/Docker-s3fs.png

Docker-S3FS

支持多架构的Docker镜像，用于将Amazon S3及兼容存储桶挂载为文件系统。

![]([]

该Docker镜像基于s3fs-fuse构建，可将您的S3存储桶挂载为文件系统。更多选项和文档请参考https://github.com/s3fs-fuse/s3fs-fuse%E3%80%82

镜像概述

本镜像支持多架构，兼容Amazon S3及Minio等S3协议兼容的存储服务，通过文件系统接口简化云存储访问，适用于需要以文件方式操作云存储资源的场景。

核心功能

1. 多架构支持：适配多种硬件架构，满足不同环境需求。
2. S3兼容：支持Amazon S3及Minio等主流S3协议存储服务。
3. 灵活配置：通过环境变量自定义存储桶、端点及额外挂载选项。
4. 文件系统访问：将云存储桶映射为本地文件系统，方便应用程序直接读写。

使用场景

• 云存储资源的文件化访问与管理。
• 数据备份与同步：将本地目录与S3存储桶同步。
• 应用程序集成：让不支持S3 API的应用通过文件系统访问云存储。

配置说明

环境变量

安装要求

1. S3凭证文件：需将凭证文件挂载到容器内/root/passwd-s3fs路径，权限设置为600。凭证格式示例：minio:minio123。
2. 挂载路径：存储桶在容器内挂载到/data目录，需将本地目录与该路径映射。
3. 容器权限：容器需添加--privileged标志及ALL权限。

部署示例

Docker命令行

bash
docker run --name=S3FS --privileged --cap-add=ALL \
-v /path/to/your/passwd-s3fs:/root/passwd-s3fs \
-v /your/local/mountpoint:/data \
-e S3_BUCKET="您的存储桶名称" \
-e S3_URL="http://您的S3服务端点" \
-e OPTION="额外挂载选项" \
mephistoxol/s3fs:latest

Docker Compose

yaml
version: '3.2'
services:
  s3fs:
    container_name: S3FS
    image: mephistoxol/s3fs:latest
    cap_add:
      - ALL
    privileged: true
    restart: unless-stopped
    environment:
      - S3_BUCKET="您的存储桶名称"
      - S3_URL="http://您的S3服务端点"
      - OPTION="额外挂载选项"
    volumes:
      - /path/to/your/passwd-s3fs:/root/passwd-s3fs
      - /your/local/mountpoint:/data
    labels:
      - traefik.enable=false
    networks:
      - internal-network

networks:
  internal-network:
    driver: bridge

Ansible配置

yaml
- name: 部署S3FS容器
  docker_container:
    name: S3FS
    image: mephistoxol/s3fs:latest
    capabilities: ALL
    privileged: yes
    env:
      S3_BUCKET: "您的存储桶名称"
      S3_URL: "http://您的S3服务端点"
      OPTION: "额外挂载选项"
    volumes:
      - /path/to/your/passwd-s3fs:/root/passwd-s3fs
      - /your/local/mountpoint:/data
    restart_policy: unless-stopped
    labels:
      traefik.enable: "false"
    networks:
      - name: internal-network
  register: result

更新日志

31-05-2020
- 从Dockerfile中移除uid和gid配置
  · 可通过环境变量$OPTION添加相关参数

21-05-2020
- 初始发布
  · 基于最新Alpine镜像
  · 使用s3fs-fuse v1.86版本

***

如果该镜像对您有帮助，欢迎通过开发：
https://raw.githubusercontent.com/MephistoXoL/Things/master/***.png]([]