physk/rclone-mergerfs

Rclone挂载与上传器镜像

镜像概述

本镜像整合rclone和mergerfs工具，提供云存储挂载、多存储路径合并管理及自动文件上传能力，同时包含Web跟踪界面用于监控上传状态，支持通过环境变量自定义各项参数，满足多云存储整合与文件同步需求。

核心功能

1. 云存储挂载：支持rclone配置的GD（Google Drive）、PG（Team Drive）等远程存储挂载；
2. 存储路径合并：通过mergerfs将多个存储路径合并为统一访问入口；
3. 自动文件上传：自动识别指定远程存储，将目标路径文件上传至云端；
4. Web跟踪界面：默认提供8080端口的Web UI，可监控上传进度与状态；
5. 灵活配置：通过环境变量自定义挂载参数、忽略规则、权限等。

使用场景

• 个人/团队多云存储资源整合，统一访问与管理；
• 本地文件自动同步至云端存储，实现数据备份；
• 媒体文件库的跨存储统一访问与自动上传。

配置说明

初始设置

1. 创建配置目录：

sh
mkdir -p /opt/appdata/uploader/keys

2. 将rclone配置文件复制到/opt/appdata/uploader目录；
3. 修正配置文件中的路径（若原路径为/opt/appdata/pgblitz/keys/）：

sh
OLDPATH=/opt/appdata/pgblitz/keys/
sed -i "s#${OLDPATH}#/config/keys/#g" /opt/appdata/uploader/rclone.conf

4. 将服务账户密钥复制到/opt/appdata/uploader/keys目录。

环境变量参数

若启用RC_ENABLED，需配置RC_ADDR、RC_USER、RC_PASS参数。

上传忽略规则

默认忽略以下文件/路径：

• *partial~
• *_HIDDEN~
• *.fuse_hidden*
• *.lck
• *.version
• .unionfs-fuse/*
• .unionfs/*
• *.inProgress/*

可通过ADDITIONAL_IGNORES添加额外忽略规则，例如：

sh
-e "ADDITIONAL_IGNORES=! -path '*/SocialMediaDumper/*' ! -path '*/test/*'"

部署示例

Docker Run命令

sh
docker run -d \
--name uploader \
-v /opt/appdata/uploader:/config \
-v /mnt/unionfs:/unionfs:shared \
-v /mnt/move:/move \
--cap-add SYS_ADMIN \
--device /dev/fuse \
--security-opt apparmor:unconfined \
--privileged=true \
-e PUID=1000 \
-e PGID=1000 \
physk/rclone-mergerfs:latest

Docker Compose配置

yaml
version: "3"
services:
  uploader:
    container_name: uploader
    image: physk/rclone-mergerfs:latest
    privileged: true
    cap_add:
      - SYS_ADMIN
    devices:
      - "/dev/fuse"
    security_opt:
      - "apparmor:unconfined"
    volumes:
      - "/opt/appdata/uploader:/config"
      - "/mnt/unionfs:/unionfs:shared"
      - "/mnt/move:/move"
    environment:
      - "PUID=${PUID}"
      - "PGID=${PGID}"
    labels:
      - "traefik.enable=true"
      - "traefik.frontend.redirect.entryPoint=https"
      - "traefik.frontend.rule=Host:tracker.example.com"
      - "traefik.port=8080"
    networks:
      - traefik_proxy
    restart: unless-stopped

若需暴露Web界面，可添加-p 56664:8080端口映射，或通过Traefik绑定域名。