peterbuga/rclone-mount

rclone-mount 轻量版 Docker 镜像

镜像概述

本镜像是基于 rclone 的轻量级云存储挂载解决方案，功能上与 mumiehub/rclone-mount 兼容，核心差异在于通过精简基础镜像（如采用 Alpine Linux）和优化依赖，实现了更小的镜像体积，降低资源占用。主要用途是将各类云存储服务（如 Google Drive、AWS S3、Dropbox 等）通过 rclone 工具挂载为本地文件系统，提供便捷的云存储访问能力。

核心功能与特性

功能兼容性

• 完整支持 rclone 原生挂载能力，包括文件系统映射、缓存策略、权限控制等核心功能。
• 兼容 mumiehub/rclone-mount 的配置方式与使用流程，迁移成本低。

轻量级设计

• 基于 Alpine Linux 构建，镜像体积较 mumiehub/rclone-mount 减少 50% 以上（典型镜像大小 < 50MB）。
• 精简非必要依赖，降低内存占用与启动时间，适合资源受限环境。

灵活配置

• 支持通过环境变量或挂载配置文件两种方式定义 rclone 参数。
• 兼容 rclone 全量挂载选项（如 --allow-other、--read-only 等）。

多后端支持

• 适配 rclone 支持的所有云存储后端（S3、Google Drive、OneDrive、FTP 等）。

使用场景和适用范围

个人/家庭场景

• 个人云盘（如 Google Drive、OneDrive）本地挂载，通过文件管理器直接操作云端文件。
• 家庭 NAS 设备中集成云存储，扩展本地存储容量。

服务器/企业场景

• 服务器端云存储访问，用于日志归档、静态资源托管、备份数据存储。
• 容器化环境中为应用提供云存储持久化卷（需配合 --volumes-from 或外部挂载）。

资源受限环境

• 低配置服务器、树莓派等边缘设备，减少存储/内存占用。
• 网络带宽有限场景，通过 rclone 缓存策略降低重复下载流量。

使用方法和配置说明

前提条件

1. 已准备 rclone 配置文件（通常位于 ~/.config/rclone/rclone.conf），包含目标云存储的认证信息（可通过 rclone config 命令生成）。

基础使用（docker run）

方式 1：挂载本地配置文件

bash
docker run -d \
  --name rclone-mount \
  --cap-add SYS_ADMIN \
  --device /dev/fuse \
  -v /path/to/local/rclone.conf:/config/rclone/rclone.conf:ro \  # 挂载配置文件
  -v /host/mount/point:/mnt/rclone:shared \  # 宿主机挂载点（共享容器内挂载内容）
  -e RCLONE_MOUNT_REMOTE="myremote" \  # 远程存储名称（配置文件中定义）
  -e RCLONE_MOUNT_PATH="/docs" \  # 远程存储内的子路径（如 "/" 表示根目录）
  -e MOUNT_OPTIONS="--allow-other --dir-cache-time 30s" \  # 挂载选项
  your-image-name:latest

方式 2：通过环境变量传入配置

若不便挂载文件，可直接传入配置文件内容（需正确转义换行符）：

bash
docker run -d \
  --name rclone-mount \
  --cap-add SYS_ADMIN \
  --device /dev/fuse \
  -v /host/mount/point:/mnt/rclone:shared \
  -e RCLONE_MOUNT_REMOTE="mygdrive" \
  -e RCLONE_MOUNT_PATH="/" \
  -e MOUNT_OPTIONS="--read-only --vfs-cache-mode minimal" \
  -e RCLONE_CONFIG="mygdrive:\n  type = drive\n  scope = drive\n  token = {\"access_token\":\"xxx\",\"token_type\":\"Bearer\",...}" \  # 配置文件内容
  your-image-name:latest

docker-compose 配置示例

yaml
version: '3'

services:
  rclone-mount:
    image: your-image-name:latest
    container_name: rclone-mount
    restart: unless-stopped
    cap_add:
      - SYS_ADMIN
    devices:
      - /dev/fuse:/dev/fuse
    volumes:
      - /home/user/.config/rclone/rclone.conf:/config/rclone/rclone.conf:ro  # 挂载配置文件（推荐）
      - /data/cloud-mount:/mnt/rclone:shared  # 宿主机挂载点
    environment:
      - RCLONE_MOUNT_REMOTE=myawsS3  # 远程存储名称
      - RCLONE_MOUNT_PATH=backups  # 远程存储子路径
      - MOUNT_OPTIONS=--allow-other --umask 002 --dir-cache-time 5m  # 挂载选项
      - LOG_LEVEL=info  # 日志级别（debug/info/warn/error）

启动命令：docker-compose up -d

环境变量说明

常用 MOUNT_OPTIONS 选项

验证与维护

验证挂载

• 查看容器日志：docker logs rclone-mount，确认无 ERROR 级日志。
• 检查容器内挂载：docker exec -it rclone-mount ls /mnt/rclone，应显示远程存储文件。
• 宿主机访问：ls /host/mount/point（需宿主机挂载点已通过 -v ...:shared 映射）。

注意事项

• 权限要求：容器必须添加 --cap-add SYS_ADMIN 并挂载 /dev/fuse 设备，否则无法使用 fuse 挂载。
• 配置安全：RCLONE_CONFIG 含敏感信息，建议优先通过文件挂载（-v）传入，避免命令行暴露。
• 稳定性：网络波动可能导致挂载中断，建议配置容器重启策略（如 restart: unless-stopped）。