mumiehub/rclone-mount

rclone-mount 容器镜像

概述

轻量级Docker镜像，基于alpine:latest（160MB）构建，集成编译的rclone工具，用于将云存储（如Google Drive）挂载到容器内，并通过共享卷使主机或其他容器可访问。使用S6 Overlay管理容器启停和崩溃恢复（自动执行fusermount -uz卸载挂载点），并负责挂载点准备工作。

核心功能与特性

• 轻量级设计：基于alpine基础镜像，仅160MB大小，资源占用低
• 完整rclone支持：兼容所有rclone远程存储配置，可挂载各类云存储服务
• 自动故障处理：S6 Overlay管理容器生命周期，在应用崩溃或容器停止时自动执行安全卸载（fusermount -uz）
• 灵活共享机制：通过Docker共享卷将挂载的云存储提供给主机或其他容器（如Plex媒体服务器）
• 环境变量配置：支持通过环境变量自定义远程路径、挂载参数等关键配置

使用场景

• 为Plex、Emby等媒体服务器提供云存储中的媒体文件访问
• 在Docker环境中实现多容器共享同一云存储资源
• 无需在主机直接安装rclone，通过容器化方式管理云存储挂载
• 临时挂载云存储进行文件备份或迁移操作

使用方法

基本部署示例

bash
docker run -d --name rclone-mount \
    --restart=unless-stopped \
    --cap-add SYS_ADMIN \
    --device /dev/fuse \
    --security-opt apparmor:unconfined \
    -e RemotePath="mediaefs:" \
    -e MountCommands="--allow-other --allow-non-empty" \
    -v /path/to/config:/config \
    -v /host/mount/point:/mnt/mediaefs:shared \
    mumiehub/rclone-mount

必要参数说明

强制Docker参数

• --cap-add SYS_ADMIN：添加系统管理权限，用于执行挂载操作
• --device /dev/fuse：挂载fuse设备，rclone需要通过fuse实现文件系统挂载
• --security-opt apparmor:unconfined：禁用apparmor限制，允许fuse相关操作

必要卷映射

• -v /path/to/config:/config：映射主机rclone配置文件目录到容器内，需包含有效的rclone.conf
• -v /host/mount/point:/mnt/mediaefs:shared：将容器内挂载点共享到主机目录，:shared选项允许主机和其他容器访问

环境变量配置

自定义挂载命令示例

如需添加高级rclone挂载参数（如缓存时间、轮询间隔、缓冲区大小），可通过MountCommands环境变量指定：

bash
-e MountCommands="--allow-other --allow-non-empty --dir-cache-time 48h --poll-interval 5m --buffer-size 128M"

上述示例添加了目录缓存时间（48小时）、文件变更轮询间隔（5分钟）和缓冲区大小（128M）参数。所有可用参数可参考rclone mount命令文档。

故障排除

• 挂载点残留：若强制删除容器（未正常停止），需在主机执行sudo fusermount -u -z /host/mount/point手动卸载残留挂载点
• 权限问题：确保MountCommands包含--allow-other参数，否则其他用户或容器可能无法访问挂载内容
• 配置文件错误：检查/path/to/config目录下是否存在有效的.rclone.conf文件，且远程名称与RemotePath匹配

注意事项

• 容器启动前需确保主机已安装fuse模块并加载
• 共享卷的主机路径需提前创建，且具有正确的读写权限
• rclone配置文件（.rclone.conf）需预先创建，可通过其他主机复制或在容器内通过docker exec -it rclone-mount /bin/sh创建
• 部分云存储服务可能需要额外配置（如API密钥、OAuth令牌），需确保rclone.conf中包含完整认证信息