debridmediamanager/debrid-media-manager

媒体库共享与镜像Docker镜像

镜像概述

本Docker镜像专注于媒体资源的共享与同步，提供轻量级解决方案，帮助用户便捷地共享个人媒体库（如视频、音频、图片等）或镜像他人的媒体内容。通过简单配置即可实现媒体文件的跨设备访问，支持内容实时同步，适用于个人、家庭及小型团队的媒体资源管理场景。

核心功能与特性

主要功能

• 媒体库共享：将本地媒体文件通过网络共享，支持多设备访问
• 镜像同步：可指定远程媒体源URL，自动同步（镜像）他人媒体内容至本地
• 跨平台访问：兼容主流设备（PC、移动端、智能电视等）的网络访问
• 轻量化设计：镜像体积小，资源占用低，运行高效

关键特性

• 无需复杂配置，支持通过环境变量快速初始化
• 支持媒体文件自动索引与分类（按类型、日期等）
• 可选访问认证机制，保护媒体资源安全
• 支持断点续传与增量同步，减少带宽占用
• 兼容常见媒体格式（MP4、MP3、JPG等）

使用场景与适用范围

典型场景

• 个人媒体中心：搭建个人媒体库，实现手机、电脑、电视等多设备访问
• 家庭媒体共享：家庭内部共享电影、音乐等资源，无需重复存储
• 内容镜像备份：将重要媒体资源从远程源镜像至本地，防止内容丢失
• 团队资源协作：小型团队共享工作相关媒体素材（如设计稿、演示视频等）

适用人群

• 个人媒体爱好者（电影、音乐收藏者）
• 需要家庭媒体共享的用户
• 需备份或镜像网络媒体内容的创作者
• 小型团队的媒体资源管理者

使用方法与配置说明

基本使用（Docker Run）

通过以下命令快速启动容器，共享本地媒体库：

bash
docker run -d \
  --name media-share \
  -p 8080:8080 \
  -v /path/to/your/media:/media \
  -e MEDIA_PATH=/media \
  -e PORT=8080 \
  docker.xuanyuan.run/media-share-image:latest

参数说明：

• -p 8080:8080：端口映射，将容器内8080端口映射至主机8080端口（可根据需要修改）
• -v /path/to/your/media:/media：挂载本地媒体目录至容器内/media路径（需替换为实际本地路径）
• -e MEDIA_PATH=/media：指定容器内媒体库根路径（需与挂载路径一致）
• -e PORT=8080：设置服务监听端口

镜像同步模式配置

如需镜像远程媒体源，可添加MIRROR_SOURCE环境变量：

bash
docker run -d \
  --name media-mirror \
  -p 8080:8080 \
  -v /local/mirror/path:/mirror \
  -e MEDIA_PATH=/mirror \
  -e MIRROR_SOURCE=https://example.com/media/ \
  -e SYNC_INTERVAL=24h \  # 同步间隔（支持h/m/s，如1h=1小时，30m=30分钟）
  media-share-image:latest

环境变量说明

Docker Compose 配置示例

创建docker-compose.yml文件，简化部署与管理：

yaml
version: '3'
services:
  media-service:
    image: docker.xuanyuan.run/media-share-image:latest
    container_name: media-service
    restart: always
    ports:
      - "8080:8080"
    volumes:
      - /home/user/media:/media  # 本地媒体库路径
    environment:
      - MEDIA_PATH=/media
      - PORT=8080
      - AUTH_USER=admin         # 启用认证
      - AUTH_PASS=secure123     # 认证密码
      # 如需镜像模式，取消以下注释并配置
      # - MIRROR_SOURCE=https://remote-media.example.com/
      # - SYNC_INTERVAL=12h

启动服务：

bash
docker-compose up -d

访问与使用

服务启动后，通过 http://<主机IP>:8080 访问媒体库界面：

• 未启用认证时，直接访问即可浏览媒体文件
• 启用认证时，需输入配置的AUTH_USER和AUTH_PASS登录
• 镜像模式下，首次启动会自动同步源内容，后续按SYNC_INTERVAL定时同步

注意事项

• 确保挂载的本地媒体目录有读写权限（容器内用户需有权限访问）
• 镜像同步模式下，需确保网络通畅且MIRROR_SOURCE可访问
• 大型媒体库建议配置较大存储空间，并考虑使用SSD提升访问速度
• 生产环境建议启用认证功能（AUTH_USER和AUTH_PASS），防止未授权访问