JuiceFS 镜像文档

镜像概述与主要用途

JuiceFS 镜像是基于 JuiceFS 文件系统的容器化部署方案。JuiceFS 是一款为云原生环境设计的高性能共享文件系统，采用 Apache License 2.0 开源协议。其核心用途是将各类对象存储服务转化为具有 POSIX 兼容性的本地文件系统，支持跨平台、跨区域主机同时挂载和访问，满足大规模数据存储与共享需求。

• 维护者：JuiceFS 社区
• 镜像仓库：
  • 社区版 Dockerfile：GitHub
  • 企业版 Dockerfile：GitHub

核心功能与特性

• 高性能：针对云原生场景优化，提供高效数据读写能力
• POSIX 兼容：完全支持 POSIX 文件系统接口，兼容现有应用
• 云原生设计：适配容器化与 Kubernetes 环境，简化部署与管理
• 多对象存储支持：兼容 S3、GCS、OSS 等主流对象存储服务
• 跨平台跨区域共享：支持不同操作系统和地域的主机同时挂载访问
• 弹性扩展：依托对象存储的无限容量，实现存储资源弹性扩展

使用场景与适用范围

• 云原生应用存储：为 Kubernetes 集群中的微服务提供共享存储
• 大规模数据处理：适用于大数据分析、AI 训练等需高性能存储的场景
• 跨团队协作：支持多区域团队共享访问同一数据集
• 对象存储本地化：将对象存储以本地文件系统形式挂载，降低应用改造难度
• 开发测试环境：快速搭建与销毁共享存储环境，提升开发效率

版本标签说明

镜像通过标签区分版本类型，具体说明如下：

• 企业版（ee）：又称"云服务版"

  • 特定版本：如 ee-4.9.23（指定企业版 4.9.23 版本）
  • 开发版：ee-nightly（最新开发版本）

• 社区版（ce）

  • 特定版本：如 ce-v1.1.0（指定社区版 v1.1.0 版本）
  • 开发版：ce-nightly（最新开发版本）

注意：latest 标签已弃用，建议使用具体版本标签以确保环境稳定性。

使用方法与配置说明

社区版（ce）

创建文件系统（format）

使用 juicefs format 命令初始化文件系统，需指定元数据存储和对象存储参数：

shell
docker run --rm \
  juicedata/mount:ce-v1.1.0 juicefs format \
  --storage s3 \          # 对象存储类型（如 s3、gcs、oss 等）
  --bucket [***] \  # 对象存储桶地址
  --access-key=ACCESSKEY \  # 对象存储访问密钥
  --secret-key=SECRETKEY \  # 对象存储密钥
  [--region 区域] [--block-size 块大小] \  # 其他可选参数
  redis://127.0.0.1/1 myjfs  # 元数据存储地址（如 Redis）和文件系统名称

挂载文件系统（mount）

使用 juicefs mount 命令将文件系统挂载到容器内目录：

shell
docker run --name myjfs -d \
  juicedata/mount:ce-v1.1.0 juicefs mount \
  [--read-only] [--cache-size 1024] \  # 可选挂载参数（如只读模式、缓存大小）
  redis://127.0.0.1/1 myjfs /mnt  # 元数据存储地址、文件系统名称和挂载点

企业版（云服务版）

企业版通过令牌认证，直接挂载文件系统：

shell
docker run --name myjfs -d \
  juicedata/mount:ee-4.9.23 juicefs mount \
  --token xxxx \          # 企业版服务令牌
  --access-key=ACCESSKEY \  # 对象存储访问密钥
  --secret-key=SECRETKEY \  # 对象存储密钥
  [--cache-dir /var/jfsCache] [--attr-cache 3600] \  # 其他可选参数
  myjfs /mnt  # 文件系统名称和挂载点

Docker Compose 集成

如需将容器内挂载点映射到主机，实现主机与容器共享 JuiceFS 存储，参考 容器内挂载点映射到主机 文档配置。

JuiceFS CSI Driver 集成

在 Kubernetes 环境中，可通过 CSI Driver 使用自定义镜像，配置方法参考 自定义 Mount Pod 容器镜像。

维护与支持

• ***文档：JuiceFS 文档
• 社区支持：JuiceFS 社区 Slack
• 技术论坛：Server Fault、Unix & Linux、Stack Overflow（相关技术问题平台）