核心用法
mediaproc 是一个通过 SSH 通道调用媒体处理工具的 skill,部署在基于 lockbox 的锁定容器中。用户通过 scripts/mediaproc.sh 包装脚本与远程服务交互,支持视频转码(ffmpeg/ffprobe)、音频处理(sox/soxi)和图像操作(ImageMagick 套件)。工作流程遵循上传→处理→下载的模式:先用 put 将文件注入工作目录,执行处理命令后,用 get 取回结果。
显著优点
- 安全隔离:底层基于 lockbox 容器,无 shell 访问、无命令注入路径,所有操作被严格限制在工作目录内
- 工具链完整:集成 ffmpeg、sox、ImageMagick 三大主流工具,覆盖 99% 的常见媒体处理需求
- 插件生态:内置 frei0r 视频特效、LADSPA/LV2 音频插件,支持专业级效果处理
- 字体覆盖广:2200+ 内置字体,涵盖多语言场景
- 路径安全:文件操作命令显式限制目录遍历,降低路径注入风险
潜在缺点与局限性
- 部署门槛高:需要自行部署 Docker 容器并配置 SSH 密钥、环境变量(MEDIAPROC_HOST/PORT),非开箱即用
- 无状态设计:每次会话需重复上传/下载大文件,网络开销显著
- 交互限制:纯命令行交互,无进度反馈、无批量任务队列管理
- 依赖外部维护:作者个人项目(psyb0t),长期维护承诺不明确
- 插件调用复杂:frei0r/LADSPA 语法需用户自行掌握 ffmpeg/sox 的插件调用约定
适合人群
- 需要在隔离环境中处理不可信媒体文件的安全敏感用户
- 已具备 Docker/SSH 运维能力的技术团队
- 熟悉 ffmpeg/sox/ImageMagick 命令行的高级用户
- 批量转码、格式统一化、视频缩略图生成等自动化场景
常规风险
- SSH 密钥泄露:若
MEDIAPROC_HOST指向公网实例且密钥管理不当,存在未授权访问风险 - DoS 资源耗尽:大文件处理或复杂滤镜可能占满容器 CPU/内存,影响同宿主机服务
- 输出文件污染:虽然输入路径受限,但处理后的输出文件仍需用户自行校验安全性
- 版本锁定:容器内工具版本固定,可能滞后于上游安全更新