madslundt/cloud-media-scripts

madslundt/cloud-media-scripts 镜像说明

镜像概述

该Docker镜像整合Rclone、Plexdrive和UnionFS工具，实现云端媒体的加密存储、流式传输及本地缓存管理。支持根据空间阈值或时间周期自动清理本地缓存，确保媒体在上传至云端前不被删除，平衡本地存储占用与访问速度。

核心功能

1. 加密保护：云端媒体加密存储，本地解密访问
2. 本地缓存：自动缓存新内容至本地，提升访问效率
3. 智能清理：基于空间或时间策略自动释放本地存储
4. 云端同步：定时将本地媒体上传至云端（如Google Drive）
5. Plex集成：支持清空Plex媒体服务器回收站（需配置参数）
6. 灵活配置：通过环境变量调整缓存大小、清理规则等参数

使用场景

• 需从云端流式播放媒体（电影、音乐）的用户
• 希望加密保护云端媒体的用户
• 需自动化管理云端与本地媒体同步的媒体爱好者
• 平衡本地存储与访问速度的个人或家庭用户

配置说明

Docker Run 示例

默认配置（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: 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

参数说明

卷（Volumes）

• /local-media: 云端与本地媒体联合目录（需加:shared）
• /local-decrypt: 待上传的本地解密文件目录（需加:shared）
• /config: Rclone/Plexdrive配置文件目录
• /chunks: Plexdrive缓存块目录
• /log: 日志文件目录
• /cloud-encrypt: 加密云端目录（ENCRYPT_MEDIA=1时有效，需加:shared）
• /cloud-decrypt: 解密云端目录（需加:shared）

环境变量（Environment Variables）

• ENCRYPT_MEDIA: 是否加密（0=否，1=是，默认1）
• BUFFER_SIZE: Rclone复制缓冲区大小（默认500M）
• REMOVE_LOCAL_FILES_BASED_ON: 清理策略（space/time/instant，默认space）
• REMOVE_LOCAL_FILES_WHEN_SPACE_EXCEEDS_GB: 空间阈值（默认100GB）
• PLEX_URL: Plex服务器URL（用于清空回收站）
• PLEX_TOKEN: Plex服务器Token（用于清空回收站）

初始化配置

Rclone配置

bash
docker exec -ti <容器ID> rclone_setup

• 带加密: 创建3个远程（云端连接、云端加密、本地加密）
• 无加密: 创建1个远程（云端连接）

Plexdrive配置

bash
docker exec -ti <容器ID> plexdrive_setup

常用命令

• 上传本地文件至云端: docker exec <容器ID> cloudupload
• 清理本地文件: docker exec <容器ID> rmlocal
• 检查服务状态: docker exec <容器ID> check
• 清空Plex回收站: docker exec <容器ID> emptytrash

定时任务

添加Cron任务自动同步与清理：

bash
@daily docker exec <容器ID> cloudupload
@weekly docker exec <容器ID> rmlocal

工作原理

通过UnionFS联合云端解密目录（只读）与本地解密目录（可写），写入/local-media的文件会存储到本地待上传目录。定时任务将本地文件上传至云端，并根据策略清理本地缓存，确保云端文件仍可访问。

镜像构建

bash
# 构建镜像
docker build -t cloud-media-scripts .

# 测试运行
docker run --name cloud-media-scripts -d cloud-media-scripts