nomuas/cloud-media-scripts

镜像概述

本Docker镜像整合plexdrive、rclone和UnionFS工具，旨在帮助用户管理云存储（如Google Drive）中的媒体文件。通过配置可实现云存储挂载、文件加密/解密、本地与云文件合并、自动上传本地文件至云端及按策略清理本地文件等功能，适用于个人媒体库的高效管理。

核心功能

1. 云存储挂载：使用plexdrive将Google Drive挂载到本地目录，支持缓存策略配置；
2. 加密/解密：通过rclone实现云存储和本地文件的加密与解密；
3. 文件合并：利用UnionFS将本地解密文件与云解密文件合并为统一目录，方便访问；
4. 自动管理：支持按空间或时间策略自动上传本地文件至云端，并清理本地文件；
5. Plex集成：可配置Plex Media Server地址和令牌，实现垃圾清理功能。

使用场景

• 个人媒体库管理：将本地媒体同步至云存储，节省本地空间；
• Plex媒体服务器：通过挂载云存储，实现Plex对云端媒体的访问；
• 多设备同步：利用云存储实现不同设备间的媒体文件同步。

配置说明

部署示例

Docker Create命令

默认配置（本地媒体空间100GB，24小时清理缓存）：

bash
docker create \
    --name cloud-media-scripts \
    -v /media:/local-media:shared \
    -v /mnt/external/media:/local-decrypt:shared \
    -v /configurations:/config \
    -v /mnt/external/plexdrive:/chunks \
    -v /logs:/log \
    --privileged --cap-add=MKNOD --cap-add=SYS_ADMIN --device=/dev/fuse \
    madslundt/cloud-media-scripts

自定义空间配置（2TB本地空间，1TB清理阈值）：

bash
docker create \
    --name cloud-media-scripts \
    -v /media:/local-media:shared \
    -v /mnt/external/media:/local-decrypt:shared \
    -v /configurations:/config \
    -v /mnt/external/plexdrive:/chunks \
    -v /logs:/log \
    -e CLEAR_CHUNK_MAX_SIZE="1000G" \
    -e REMOVE_LOCAL_FILES_WHEN_SPACE_EXCEEDS_GB="2000" \
    -e FREEUP_ATLEAST_GB="1000" \
    --privileged --cap-add=MKNOD --cap-add=SYS_ADMIN --device=/dev/fuse \
    madslundt/cloud-media-scripts

Docker Compose配置

yaml
services:
  cloud-media-scripts:
    image: docker.xuanyuan.run/madslundt/cloud-media-scripts
    container_name: cloud-media-scripts
    volumes:
      - /media:/local-media:shared
      - /mnt/external/media:/local-decrypt:shared
      - /configurations:/config
      - /mnt/external/plexdrive:/chunks
      - /logs:/log
    environment:
      - CLEAR_CHUNK_MAX_SIZE=1000G
      - REMOVE_LOCAL_FILES_WHEN_SPACE_EXCEEDS_GB=2000
      - FREEUP_ATLEAST_GB=1000
    privileged: true
    devices:
      - /dev/fuse
    cap_add:
      - MKNOD
      - SYS_ADMIN

卷挂载说明

环境变量说明

部分关键环境变量：

• ENCRYPT_MEDIA：是否加密媒体文件（0=否，1=是，默认1）；
• REMOVE_LOCAL_FILES_BASED_ON：本地文件清理策略（space/time/instant，默认space）；
• REMOVE_LOCAL_FILES_WHEN_SPACE_EXCEEDS_GB：本地空间阈值（默认100GB）；
• PLEX_URL：Plex Media Server地址（用于垃圾清理）；
• PUID/PGID：用户/组ID。

设置步骤

1. Rclone配置：执行docker exec -ti <容器名> rclone_setup，根据提示创建云存储和加密远程；
2. Plexdrive配置：执行docker exec -ti <容器名> plexdrive_setup，连接Google Drive；
3. Cron任务：设置定时上传和清理，如@daily docker exec <容器名> cloudupload、@weekly docker exec <容器名> rmlocal。

常用命令

• 上传本地文件至云端：docker exec <容器名> cloudupload；
• 清理本地文件：docker exec <容器名> rmlocal；
• 检查服务状态：docker exec <容器名> check；
• 清理Plex垃圾：docker exec <容器名> emptytrash（需配置PLEX_URL和PLEX_TOKEN）。