wiserain/plexdrive

docker-plexdrive

用于https://github.com/plexdrive/plexdrive%E6%8C%82%E8%BD%BD%E7%9A%84Docker%E9%95%9C%E5%83%8F

• 基于Ubuntu 20.04
• 支持文件系统合并（可选择mergerfs或unionfs）

镜像概述和主要用途

该镜像提供了一种便捷方式将Google Drive内容通过plexdrive挂载到本地文件系统，并支持与本地目录通过mergerfs或unionfs进行合并，适用于需要访问云端媒体文件的场景（如Plex媒体服务器）。

核心功能和特性

• 基于Ubuntu 20.04系统，稳定可靠
• 支持plexdrive挂载Google Drive内容
• 可选mergerfs或unionfs文件系统合并本地目录与云端目录
• 可配置用户ID（PUID）和组ID（PGID），确保权限正确
• 支持自定义时区设置，保证日志时间戳准确

使用场景和适用范围

• Plex媒体服务器需要访问Google Drive中的媒体文件
• 需要将本地存储与云端存储合并为单一访问点
• 希望通过Docker容器化方式管理plexdrive挂载，简化部署和维护

使用方法和配置说明

Docker Compose配置

yaml
version: '3'

services:
  plexdrive:
    container_name: plexdrive
    image: wiserain/plexdrive:latest
    restart: always
    network_mode: "bridge"
    volumes:
      - ${DOCKER_ROOT}/plexdrive/config:/config  # 配置文件目录
      - ${DOCKER_ROOT}/plexdrive/cache:/cache   # 可选：用于--chunk-file
      - /your/mounting/point:/data:shared       # 挂载点
      - /local/dir/to/be/merged/with:/local     # 可选：需合并的本地目录
    devices:
      - /dev/fuse
    cap_add:
      - SYS_ADMIN
    security_opt:
      - apparmor:unconfined
    environment:
      - PUID=${PUID}    # 用户ID
      - PGID=${PGID}    # 组ID
      - TZ=${TZ}        # 时区

Docker Run命令

bash
docker run -d \
    --name=plexdrive \
    --cap-add SYS_ADMIN \
    --device /dev/fuse \
    --security-opt apparmor=unconfined \
    -v ${DOCKER_ROOT}/plexdrive/config:/config \
    -v ${DOCKER_ROOT}/plexdrive/cache:/cache \
    -v /your/mounting/point:/data:shared \
    -v /local/dir/to/be/merged/with:/local \
    -e PUID=${PUID} \
    -e PGID=${PGID} \
    -e TZ=${TZ} \
    wiserain/plexdrive:latest

配置文件生成

首次运行容器后，需要生成plexdrive配置文件：

1. 执行内置脚本：

   bash
   docker-compose exec <service_name> plexdrive_setup
   

2. 按照提示输入API令牌
3. 完成后按Ctrl+C退出
4. 在/config目录下会生成两个JSON配置文件，容器将自动继续执行挂载命令

此时可通过/your/mounting/point访问Google Drive内容。

plexdrive挂载命令

容器内部执行的plexdrive挂载命令如下：

bash
plexdrive mount ${plexdrive_mountpoint:-/data} \
    --config /config/ \
    --uid=${PUID:-911} \
    --gid=${PGID:-911} \
    --umask=0100775 \
    -o allow_other \
    ${PLEXDRIVE_OPTS}

环境变量说明

默认情况下，plexdrive_mountpoint为/data；若容器绑定挂载了/local目录，则会回退到/cloud，以便后续进行文件系统合并。

mergerfs或unionfs配置（可选）

通过设置POOLING_FS=mergerfs，可将本地目录与plexdrive目录合并：

mergerfs配置

内部执行命令：

bash
mergerfs \
    -o uid=${PUID:-911},gid=${PGID:-911},umask=022,allow_other \
    -o ${MFS_USER_OPTS} \
    /local=RW:/cloud${PLEXDRIVE_PATH}=NC /data

默认MFS_USER_OPTS值：

bash
MFS_USER_OPTS="rw,use_ino,func.getattr=newest,category.action=all,category.create=ff,cache.files=auto-full,dropcacheonclose=true"

unionfs配置

设置POOLING_FS=unionfs使用unionfs合并：

内部执行命令：

bash
unionfs \
    -o uid=${PUID:-911},gid=${PGID:-911},umask=022,allow_other \
    -o ${UFS_USER_OPTS} \
    /local=RW:/cloud${PLEXDRIVE_PATH}=RO /data

默认UFS_USER_OPTS值：

bash
UFS_USER_OPTS="cow,direct_io,nonempty,auto_cache,sync_read"

可通过PLEXDRIVE_PATH指定plexdrive的子目录进行合并（路径需以/开头）。