📌 前言
本教程适合在VPS上使用Docker部署qBittorrent的小白用户，提供3种方法查看下载文件的MediaInfo信息。特别推荐 方法三：publish-helper ，这是专为PT玩家设计的神器！
🎯 什么是MediaInfo？
MediaInfo是媒体文件分析工具，PT站发种必备，可以查看：
视频编码格式（H.264、H.265/HEVC等）
分辨率和帧率（1080p、4K、23.976fps等）
音频编码和声道数（AAC、DTS、5.1环绕声等）
字幕信息（简繁字幕、外挂内嵌等）
比特率、文件大小等详细参数
📋 方法对比
📋 方法一：在VPS系统上直接安装MediaInfo（最简单）
1. 连接到VPS
ssh root@你的VPS_IP
2. 安装MediaInfo
Ubuntu/Debian系统：
apt update
apt install mediainfo -y
CentOS/RHEL系统：
yum install epel-release -y
yum install mediainfo -y
3. 验证安装
mediainfo --version
如果显示版本号（例如：MediaInfo v25.07），说明安装成功！
4. 找到qBittorrent下载目录
查看docker-compose.yml：
# 进入docker-compose.yml所在目录
cd /path/to/docker-compose/
# 查看配置文件
cat docker-compose.yml | grep -A 5 volumes
找到类似配置：
volumes:
- /home/downloads:/downloads # 左边是VPS路径，右边是容器内路径
或使用命令查看容器挂载：
# 查看容器名
docker ps
# 查看挂载信息
docker inspect qbittorrent | grep -A 20 "Mounts"
记住 VPS上的路径 （例如：/home/downloads）
5. 查看MediaInfo
# 进入下载目录
cd /home/downloads
# 查看文件列表
ls -lh
# 查看视频文件的MediaInfo
mediainfo "电影名称/电影文件.mkv"
6. 实用命令
简洁模式（只显示关键信息）：
mediainfo --Inform="General;文件: %FileName%\n大小: %FileSize/String%\n时长: %Duration/String%\n\nVideo;视频: %Format% %Width%x%Height% %FrameRate% fps\n码率: %BitRate/String%\n\nAudio;音频: %Format% %Channel(s)% 声道\n" "文件.mkv"
PT站格式输出（Text模式）：
mediainfo --Output=Text "文件.mkv"
查看目录下所有视频文件：
find . -type f \( -name "*.mkv" -o -name "*.mp4" -o -name "*.avi" \) -exec echo "=== {} ===" \; -exec mediainfo {} \;
输出为HTML格式：
mediainfo --Output=HTML "文件.mkv" > mediainfo.html
📋 方法二：使用MediaInfo的Docker容器（带GUI界面）
1. 创建docker-compose.yml
version: '3'
services:
mediainfo:
image: jlesage/mediainfo
container_name: mediainfo
ports:
- "5800:5800" # Web界面端口
volumes:
- /docker/appdata/mediainfo:/config
- /home/downloads:/storage:ro # 映射qB下载目录（只读）
environment:
- USER_ID=1000
- GROUP_ID=1000
- TZ=Asia/Shanghai
restart: unless-stopped
2. 启动容器
docker-compose up -d
3. 访问Web界面
在浏览器打开：http://你的VPS_IP:5800
就可以通过图形界面浏览和查看文件的MediaInfo了！
优点：
✅ 图形界面，操作直观
✅ 支持多种显示模式（文本、树状、HTML等）
✅ 可以直接浏览文件目录
4. 管理容器
# 停止容器
docker-compose down
# 查看日志
docker logs mediainfo
# 重启容器
docker restart mediainfo
📋 方法三：使用publish-helper（强烈推荐给PT玩家）⭐⭐⭐⭐⭐
🎯 什么是publish-helper？
publish-helper是专为PT站设计的发布辅助工具，集成了完整的种子制作流程。
核心优势：
✅ 一键获取格式化的MediaInfo
✅ 自动截图和生成缩略图
✅ 自动上传图片到图床
✅ 自动生成标题和副标题
✅ 批量重命名剧集文件
✅ 制作硬链接（节省空间）
✅ 直接制作种子文件
✅ 支持API调用和自动化
1. Docker安装publish-helper（推荐）
创建docker-compose.yml：
version: '3'
services:
publish-helper:
image: sertion1126/publish-helper:latest
container_name: publish-helper
ports:
- "18080:18080" # Web界面端口
volumes:
- /home/downloads:/downloads # 映射qB下载目录
- ./publish-helper/static:/app/static # 配置持久化
environment:
- TZ=Asia/Shanghai
restart: unless-stopped
启动容器：
docker-compose up -d
查看日志：
docker logs -f publish-helper
2. 访问Web界面
浏览器打开：http://你的VPS_IP:18080
3. 基础设置
首次使用需要配置：
1. 设置文件路径
点击界面右上角"设置"按钮
配置下载目录路径：
/downloads（容器内路径）配置输出目录（可选）
2. 配置图床（可选但推荐）
支持的免费图床：
支持的商业图床：
支持的自建图床：
在设置中填入图床API地址和Token。
3. 配置PT-Gen（可选）
PT-Gen可以自动获取豆瓣简介
填入PT-Gen API地址
4. 使用publish-helper查看MediaInfo
方式A：Web界面操作
打开publish-helper界面
点击"浏览文件"或直接输入文件路径
选择视频文件
点击"获取MediaInfo"按钮
自动显示格式化的MediaInfo信息
可一键复制到剪贴板，直接粘贴到PT站
方式B：使用API
# 获取MediaInfo
curl "http://localhost:18080/api/getMediaInfo?filePath=/downloads/电影.mkv"
# 返回格式化的MediaInfo文本，可直接发布到PT站
5. 高级功能
一键生成完整发布内容：
选择文件
点击"一键生成"
自动获取：
MediaInfo（格式化）
多张截图（可自定义数量）
缩略图
PT-Gen豆瓣简介
海报图片
自动生成标题和副标题
自动上传图片到图床
生成完整发布BBCode代码
批量处理剧集：
适合处理电视剧、动漫等多集文件。
通过Web界面：
选择剧集文件夹
设置命名规则（如：S01E{ep}.mkv）
批量重命名
通过API：
curl -X POST "http://localhost:18080/api/batchRenameEpisodes" \
-H "Content-Type: application/json" \
-d '{
"path": "/downloads/剧集名称",
"template": "S01E{ep}.mkv"
}'
制作硬链接（节省空间）：
PT玩家必备技巧，可以在不占用额外空间的情况下做种。
curl -X POST "http://localhost:18080/api/makeHardlink" \
-H "Content-Type: application/json" \
-d '{
"source": "/downloads/原文件",
"target": "/downloads/整理后的位置"
}'
直接制作种子：
curl -X POST "http://localhost:18080/api/makeTorrent" \
-H "Content-Type: application/json" \
-d '{
"path": "/downloads/文件或文件夹",
"tracker": "https://tracker.example.com/announce",
"private": true
}'
6. 结合qBittorrent自动化工作流
完整的PT发种流程：
qBittorrent下载完成
自动触发publish-helper
获取MediaInfo和截图
上传图床
生成发布内容
制作种子
发布到PT站
设置qBittorrent下载完成脚本：
创建脚本 /usr/local/bin/qb_complete.sh：
#!/bin/bash
FILE_PATH="$1"
FILE_NAME="$2"
# 调用publish-helper API
curl -X POST "http://localhost:18080/api/processFile" \
-H "Content-Type: application/json" \
-d "{
\"filePath\": \"$FILE_PATH\",
\"fileName\": \"$FILE_NAME\",
\"autoScreenshot\": true,
\"autoUpload\": true
}"
给脚本添加执行权限：
chmod +x /usr/local/bin/qb_complete.sh
在qBittorrent中设置：
工具 → 选项 → 下载
勾选"下载完成时运行外部程序"
填入：
/usr/local/bin/qb_complete.sh "%F" "%N"
7. publish-helper常用快捷操作
快速获取单个文件信息：
# 只获取MediaInfo
curl "http://localhost:18080/api/getMediaInfo?filePath=/downloads/movie.mkv"
# 获取MediaInfo和截图
curl "http://localhost:18080/api/getInfo?filePath=/downloads/movie.mkv&screenshots=6"
批量处理目录：
# 获取目录下所有视频的MediaInfo
curl "http://localhost:18080/api/scanDirectory?path=/downloads/Movies"
📊 MediaInfo输出示例解读
General
Complete name : Movie.2024.1080p.BluRay.x264.mkv
Format : Matroska
File size : 8.5 GiB
Duration : 2h 15min
Video
Format : AVC (H.264) ← 视频编码
Format profile : High@L4.1 ← 编码配置
Width : 1920 pixels ← 宽度
Height : 1080 pixels ← 高度（1080p）
Display aspect : 16:9 ← 画面比例
Frame rate : 23.976 fps ← 帧率
Bit rate : 8 000 kb/s ← 视频比特率
Bit depth : 8 bits ← 色深
Audio #1
Format : DTS ← 音频编码
Channels : 6 channels ← 声道数（5.1环绕声）
Channel layout : C L R Ls Rs LFE ← 声道布局
Bit rate : 1 510 kb/s ← 音频比特率
Sampling rate : 48.0 kHz ← 采样率
Language : English ← 语言
Audio #2
Format : AAC LC ← 音频编码
Channels : 2 channels ← 立体声
Bit rate : 128 kb/s
Language : Chinese (Mandarin) ← 国语音轨
Text #1
Format : UTF-8 ← 字幕格式
Codec ID : S_TEXT/UTF8 ← 字幕编码
Language : Chinese (Simplified) ← 简体中文字幕
Title : 简体中文
Text #2
Format : UTF-8
Language : Chinese (Traditional)
Title : 繁體中文 ← 繁体中文字幕
关键参数说明：
Video Format : 视频编码（H.264/AVC、H.265/HEVC、AV1等）
分辨率 : 1920x1080 = 1080p，3840x2160 = 4K
帧率 : 23.976/24fps（电影）、25fps（PAL）、29.97/30fps（NTSC）、60fps（高帧率）
比特率 : 越高画质越好，一般1080p在5-15Mbps
音频编码 : AAC（通用）、DTS/DTS-HD（高质量）、Dolby Digital/TrueHD（杜比）
声道 : 2.0（立体声）、5.1（环绕声）、7.1（更多环绕）
🔧 常见问题
Q1: 提示"command not found"？
A: MediaInfo未安装成功，重新执行安装命令：
# Ubuntu/Debian
apt install mediainfo -y
# CentOS
yum install mediainfo -y
Q2: 提示"Permission denied"？
A: 权限不足，尝试：
# 使用sudo
sudo mediainfo "文件.mkv"
# 或修改文件权限
chmod +r "文件.mkv"
# 或修改目录权限
chmod -R 755 /home/downloads
Q3: publish-helper无法访问文件？
A: 检查Docker目录映射：
# 查看容器内的路径
docker exec publish-helper ls -la /downloads
# 检查挂载点
docker inspect publish-helper | grep -A 10 "Mounts"
Q4: publish-helper端口被占用？
A: 修改docker-compose.yml中的端口映射：
ports:
- "8888:18080" # 改为8888端口，然后访问 VPS_IP:8888
Q5: 中文文件名乱码？
A: 设置系统编码：
# 设置环境变量
export LANG=zh_CN.UTF-8
export LC_ALL=zh_CN.UTF-8
# 或安装中文语言包
apt install language-pack-zh-hans -y
Q6: MediaInfo显示信息不完整？
A: 可能是文件损坏或格式特殊，尝试：
# 使用完整模式
mediainfo --Full "文件.mkv"
# 或使用ffprobe
ffprobe -v quiet -print_format json -show_format -show_streams "文件.mkv"
Q7: publish-helper图床上传失败？
A:
检查图床API配置是否正确
检查图床Token是否有效
检查图片大小是否超过限制
查看publish-helper日志：
docker logs publish-helper
💡 进阶技巧
1. 创建MediaInfo快捷命令
编辑配置文件：
nano ~/.bashrc
# 添加以下别名
alias mi='mediainfo'
alias mic='mediainfo --Inform="Video;%Format% %Width%x%Height% %FrameRate%fps\nAudio;%Format% %Channel(s)%ch"'
alias mipt='mediainfo --Output=Text' # PT站格式
alias qbcd='cd /home/downloads'
# 保存后生效
source ~/.bashrc
使用示例：
qbcd # 快速进入下载目录
mi "movie.mkv" # 查看完整信息
mic "movie.mkv" # 查看简洁信息
mipt "movie.mkv" # PT站文本格式
2. 批量导出MediaInfo
导出目录下所有视频信息到文本文件：
find /home/downloads -name "*.mkv" | while read file; do
echo "========================================" >> mediainfo_all.txt
echo "文件: $file" >> mediainfo_all.txt
echo "========================================" >> mediainfo_all.txt
mediainfo "$file" >> mediainfo_all.txt
echo "" >> mediainfo_all.txt
done
导出为CSV格式（适合Excel分析）：
echo "文件名,格式,分辨率,帧率,视频编码,音频编码,文件大小,时长" > mediainfo.csv
find /home/downloads -name "*.mkv" | while read file; do
name=$(basename "$file")
format=$(mediainfo --Inform="General;%Format%" "$file")
resolution=$(mediainfo --Inform="Video;%Width%x%Height%" "$file")
fps=$(mediainfo --Inform="Video;%FrameRate%" "$file")
vcodec=$(mediainfo --Inform="Video;%Format%" "$file")
acodec=$(mediainfo --Inform="Audio;%Format%" "$file")
size=$(mediainfo --Inform="General;%FileSize/String%" "$file")
duration=$(mediainfo --Inform="General;%Duration/String%" "$file")
echo "\"$name\",\"$format\",\"$resolution\",\"$fps\",\"$vcodec\",\"$acodec\",\"$size\",\"$duration\"" >> mediainfo.csv
done
3. 使用tmux后台运行
如果需要长时间处理，建议使用tmux：
# 安装tmux
apt install tmux -y
# 创建会话
tmux new -s mediainfo
# 运行你的命令
mediainfo "large_file.mkv"
# 断开会话（按键）：Ctrl+B 然后按 D
# 重新连接
tmux attach -t mediainfo
4. 结合rsync同步文件后自动获取信息
#!/bin/bash
# auto_mediainfo.sh
WATCH_DIR="/home/downloads"
OUTPUT_DIR="/home/mediainfo_reports"
mkdir -p "$OUTPUT_DIR"
inotifywait -m -r -e close_write --format '%w%f' "$WATCH_DIR" | while read file; do
if [[ "$file" =~ \.(mkv|mp4|avi)$ ]]; then
echo "检测到新文件: $file"
filename=$(basename "$file")
mediainfo "$file" > "$OUTPUT_DIR/${filename}.txt"
echo "MediaInfo已保存到: $OUTPUT_DIR/${filename}.txt"
fi
done
📝 方法选择建议
新手推荐：方法一（VPS直接安装）
✅ 最简单，5分钟搞定
✅ 命令行操作，效率高
✅ 适合快速查看
✅ 永久可用，不依赖容器
喜欢GUI：方法二（MediaInfo容器）
✅ 图形界面，更直观
✅ 适合不熟悉命令行的用户
✅ 支持远程访问
PT玩家推荐：方法三（publish-helper）
✅ 功能最全面
✅ 自动化程度最高
✅ 专为PT制作种子设计
✅ 集成截图、图床、种子制作
✅ 大幅提高发种效率
🎓 实战案例
案例1：新手快速查看单个文件
# 1. SSH连接VPS
ssh root@vps.example.com
# 2. 进入下载目录
cd /home/downloads
# 3. 查看文件
mediainfo "Movie.2024.1080p.mkv"
案例2：PT玩家完整发布流程
使用publish-helper：
下载完成后打开
http://vps_ip:18080选择文件
点击"一键生成"
自动获取：
MediaInfo（格式化）
6张截图
豆瓣简介
海报
上传到图床
复制生成的BBCode
粘贴到PT站发布页面
制作种子上传
全程5分钟完成！
案例3：批量处理剧集
# 场景：下载了一部24集的剧集，需要规范命名
# 方法1：使用命令行
cd /home/downloads/剧集名称
rename 's/E(\d+)/E$1/' *.mkv # 统一命名格式
# 方法2：使用publish-helper API
curl -X POST "http://localhost:18080/api/batchRenameEpisodes" \
-H "Content-Type: application/json" \
-d '{
"path": "/downloads/剧集名称",
"template": "SeriesName.S01E{ep}.1080p.WEB-DL.mkv",
"start": 1,
"end": 24
}'
# 查看每集的MediaInfo
for i in {1..24}; do
echo "=== 第${i}集 ==="
mediainfo "SeriesName.S01E$(printf %02d $i).mkv" | grep -E "Format|Duration|Width|Height"
done
🔗 参考资源
MediaInfo官网 : https://mediaarea.net/
MediaInfo下载 : https://mediaarea.net/en/MediaInfo/Download
publish-helper GitHub : https://github.com/bjdbjd/publish-helper
publish-helper Wiki : https://github.com/bjdbjd/publish-helper/wiki
publish-helper API文档 : https://apifox.com/apidoc/shared-6d670fb1-eb1f-4431-afdb-29b19fe1ffe1
Docker Hub - jlesage/mediainfo : https://hub.docker.com/r/jlesage/mediainfo
PT站发布教程 : 各PT站通常有详细的发布规则和教程
🎁 总结
本教程介绍了3种在VPS Docker环境下查看MediaInfo的方法：
如果你是PT玩家 ，强烈推荐使用 publish-helper ，它能：
节省90%的种子制作时间
自动化完成截图、图床、MediaInfo等繁琐步骤
支持批量处理和自动化脚本
提供API接口方便集成到其他工具
现在开始动手实践吧！有任何问题欢迎在评论区交流讨论。
作者 : Jensfrank
更新日期 : 2025年10月16日
关键词 : VPS, Docker, qBittorrent, MediaInfo, PT站, 种子制作, publish-helper
💡 小提示 : 收藏本文章，随时查阅命令！如果觉得有帮助，欢迎分享给其他PT玩家！