kevinzjyang/cloudmedialink repository overview

⁠CloudMediaLink

本地媒体文件管理工具，支持自动上传到 115 网盘、TMDB 刮削、生成 STRM 文件供 Emby/Jellyfin 播放，内置 Emby 代理将播放请求直连到 115 CDN。

⁠功能

• 文件监控与上传 — 自动检测本地媒体文件夹变化，通过秒传（SHA1 匹配）或分块上传到 115 网盘
• TMDB 刮削 — 解析文件名匹配 TMDB 电影/电视剧元数据，支持自定义正则规则、Emby 媒体库直接刮削
• STRM 生成 — 从 115 网盘目录生成 .strm 文件，保持原目录结构，支持多源目录管理
• Warp 代理 — 内置代理服务，STRM 播放时将请求直连到 115 CDN，无需中转流量
• Web 管理界面 — Vue 3 + Element Plus 前端，支持仪表盘、上传监控、刮削管理、STRM 管理、日志查看
• Web 认证 — 可选的用户名密码登录保护，适合公网部署

⁠首次使用

1. 访问http://ip:3333（Docker）
2. 首页仪表盘会显示「快速开始」清单，或点击「打开向导」逐步配置
3. 配置步骤：
   • 扫码登录 115 网盘
   • 选择上传目标目录（115 网盘中的目录 ID）、媒体库目录
   • 设置 TMDB API Key（用于刮削）
   • 配置 Emby 服务器地址和 API Key（可选）
4. 在「上传管理」页面选择本地媒体目录，启动文件监控
5. 在「刮削管理」页面批量刮削已上传的媒体文件
6. 在「STRM 管理」页面配置源目录并生成 STRM 文件

⁠Docker 部署

⁠docker-compose.yml

services:
  cloudmedialink:
    image: kevinzjyang/cloudmedialink:latest
    container_name: cloudmedialink
    network_mode: host
    volumes:
      - ./data:/app/data         # 数据库、备份、日志、Cookie
      - /path/to/media:/app/media # 本地媒体文件目录
      - /path/to/strm:/app/strm   # STRM 输出目录
    environment:
      - TZ=Asia/Shanghai
      - PUID=1000
      - PGID=1000
      - WEB_ADMIN=admin          # Web 登录用户名
      - WEB_PASSWORD=adminadmin  # Web 登录密码
    restart: unless-stopped

# 启动
docker compose up -d

# 查看日志
docker compose logs -f

# 更新
docker compose pull
docker compose up -d

⁠数据卷说明

⁠端口说明

⁠环境变量

⁠容器基础配置