项目介绍
mediaGet 把媒体链接解析集中到网页入口,适合保存自己发布的视频、图集及获得授权的素材。解析结果取决于上游平台,网站运行正常并不代表每个平台都能下载。
它把分享链接中的媒体信息与文件入口放在同一页面,减少在不同解析网站之间切换。除单条视频外,原资料还介绍了图文内容解析和音乐页面,因此使用时应先区分视频、图集与音频三种任务。
适合在家庭局域网维护一个临时素材处理入口。项目采用网页界面,手机和电脑可以访问同一服务;下载结果仍需自己整理到媒体目录,不能把解析成功等同于已完成长期归档。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 分享链接识别 | 从复制的分享文案中识别媒体网址,再交给相应平台解析。 |
| 视频预览与信息 | 在获取结果后查看视频及标题等信息,先确认内容是否对应原链接。 |
| 图集处理 | 处理支持平台的图文或图片内容,适合保存获得授权的素材。 |
| 音乐页面 | 原资料介绍了检索、试听、封面和歌词入口,实际渠道可用性取决于所用版本与上游。 |
| 浏览器访问 | 部署后通过网页操作,不要求每个终端单独安装客户端。 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | Docker |
| 分类 | 影音与下载 |
| 项目仓库 | hotier/mediaGet |
| 整理日期 | 2026-11-14 |
安装或使用条件
准备支持 Docker Compose 的主机、空闲端口与持久化目录。群晖可使用 Container Manager 的项目功能;示例目录以 /volume1/docker 为基准,其他存储卷需要自行替换。
安装与使用步骤
- 在
/volume1/docker/mediaget克隆官方仓库;该项目当前 README 提供源码构建方式,不把来源文章中的第三方镜像当作官方发行。 - 在仓库根目录准备
.env,按 README 的可选配置填写自己需要的项;无需的配置不编造。把下面 Compose 也放在仓库根目录,构建上下文必须能找到项目 Dockerfile。 - 记录并导出
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。只回退镜像不一定能回退已经迁移过的数据库。