影音与下载

mediaGet:视频与图集解析使用指南

  • 0 次阅读
  • 0 条评论
文章摘要

mediaGet 把媒体链接解析集中到网页入口,适合保存自己发布的视频、图集及获得授权的素材。解析结果取决于上游平台,网站运行正常并不代表每个平台都能下载。 它把分享链接中的媒体信息与文件入口放在同一页面,减少在不同解析网站之间切换。除单条视频外,原资料还介绍了图文内容解析和音乐页面,因此使用时应先区分视频、图集与音频三种任务。 适合在家庭局域网维护一个临时素材处理入口。项目采用网页界面,手机和电脑可以访问同一服务;下载结果仍需自己整理到媒体目录,不能把解析成功等同于已完成长期归档。

项目介绍

mediaGet 把媒体链接解析集中到网页入口,适合保存自己发布的视频、图集及获得授权的素材。解析结果取决于上游平台,网站运行正常并不代表每个平台都能下载。

它把分享链接中的媒体信息与文件入口放在同一页面,减少在不同解析网站之间切换。除单条视频外,原资料还介绍了图文内容解析和音乐页面,因此使用时应先区分视频、图集与音频三种任务。

适合在家庭局域网维护一个临时素材处理入口。项目采用网页界面,手机和电脑可以访问同一服务;下载结果仍需自己整理到媒体目录,不能把解析成功等同于已完成长期归档。

核心功能

功能 作用与使用方式
分享链接识别 从复制的分享文案中识别媒体网址,再交给相应平台解析。
视频预览与信息 在获取结果后查看视频及标题等信息,先确认内容是否对应原链接。
图集处理 处理支持平台的图文或图片内容,适合保存获得授权的素材。
音乐页面 原资料介绍了检索、试听、封面和歌词入口,实际渠道可用性取决于所用版本与上游。
浏览器访问 部署后通过网页操作,不要求每个终端单独安装客户端。

功能示意

mediaGet 功能示意图

图 1:自制功能示意图,概括本文的使用要点。

项目信息

项目 说明
类型 Docker
分类 影音与下载
项目仓库 hotier/mediaGet
整理日期 2026-11-14

安装或使用条件

准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。

安装与使用步骤

  1. 在 /volume1/docker/mediaget 克隆官方仓库;该项目当前 README 提供源码构建方式,不把来源文章中的第三方镜像当作官方发行。
  2. 在仓库根目录准备 .env,按 README 的可选配置填写自己需要的项;无需的配置不编造。把下面 Compose 也放在仓库根目录,构建上下文必须能找到项目 Dockerfile。
  3. 记录并导出 BUILD_ID 后启动,打开 http://NAS_IP:3008。先用自己有权处理的一条测试链接检查解析和结果,批量任务再逐步增加。

操作示例

git clone https://github.com/hotier/mediaGet.git /volume1/docker/mediaget
cd /volume1/docker/mediaget
touch .env
chmod 600 .env
export BUILD_ID="$(git rev-parse HEAD)"

从源码更新

更新前保存当前提交号和 .env。切换到经过检查的新版本后重新构建:

export BUILD_ID="$(git rev-parse HEAD)"
docker compose build
docker compose up -d

本地构建镜像使用 build 更新,单独执行 docker compose pull 不会替你拉取和构建源码。

首次使用与操作检查

先选自己发布的一条短视频链接,把完整分享文案粘贴到输入框。核对识别的平台、标题和预览,再下载一个文件并确认格式与时长。之后换一条图集链接测试图片数量,最后再查看音乐入口是否可用。

只在某个平台失败时,先换一个同平台的公开测试链接,区分链接失效、账号要求和解析接口变化;所有链接都失败时再检查服务日志、容器外网连接及环境配置。

Docker Compose

按官方 README 的本地构建与 docker run 方式转换。此文件依赖完整源码与同目录 .env,不能脱离仓库单独运行;宿主端口改为 3008。

群晖目录准备

在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/mediaget/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。

sudo sh <<'HALO_PREPARE'
set -eu
if [ ! -d /volume1/docker/mediaget/.git ]; then git clone https://github.com/hotier/mediaGet.git /volume1/docker/mediaget; fi
mkdir -p /volume1/docker/mediaget
cd /volume1/docker/mediaget
umask 077
touch .env
chmod 600 .env
HALO_PREPARE
cd /volume1/docker/mediaget

此项目从完整仓库构建,准备命令需要 NAS 已安装 Git;不能把下面的 Compose 单独放进空目录。

services:
  mediaget:
    build:
      context: .
      args:
        BUILD_ID: "${BUILD_ID:-local}"
    image: mediaget:local
    init: true
    restart: unless-stopped
    env_file:
      - .env
    ports:
      - "3008:3000"

在项目目录保存为 compose.yaml 后,先检查配置,再启动:

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100

配置与常见问题

  • 原参考使用 panda-995 构建及镜像代理,它们属于第三方方案,不能标为官方镜像。
  • 任务涉及解析器子进程时应保留项目要求的 init 设置;不要照搬未知镜像的权限。
  • 页面无法打开:先用 docker compose ps 检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。
  • 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。

更新与备份

保留部署配置和下载文件;更新前确认解析器及镜像来源。

更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose build 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。

参考资料