核心用法
mediaproc 是一个基于 Docker 容器的服务端媒体处理工具，通过 SSH 协议对外暴露 ffmpeg、sox、ImageMagick 等主流多媒体处理能力。用户通过配置 MEDIAPROC_HOST 和 MEDIAPROC_PORT 环境变量连接远程实例，所有操作均通过 SSH 命令行完成。
典型工作流：上传文件（put）→ 执行处理（ffmpeg/sox/convert）→ 下载结果（get）→ 清理文件（rm）。文件系统被限制在 /work 目录，支持基本的目录管理（mkdir/rmdir/rrmdir）。
显著优点
1. 工具链完整：集成 ffmpeg（视频/音频）、sox（音频）、ImageMagick（图像）三大生态，覆盖 99% 的日常媒体处理场景
2. 插件丰富：内置 frei0r 视频特效、LADSPA/TAP/CMT/SWH 音频插件、LV2 标准，支持专业级特效处理
3. 字体支持：预装 2200+ 字体，涵盖 emoji、CJK、阿拉伯语、泰语等，字幕与图文处理无虞
4. 隔离性强：Docker 容器化部署，命令白名单机制，无 shell 访问权限
潜在缺点与局限性
1. 无交互界面：纯命令行操作，学习曲线陡峭，不适合非技术用户
2. 文件传输繁琐：需通过 stdin/stdout 流式传输，大文件处理效率受限
3. 无持久化存储：容器内 /work 为临时工作区，服务重启数据丢失
4. 单实例瓶颈：无内置负载均衡，高并发场景需自行扩展
5. 网络依赖：所有操作依赖稳定 SSH 连接，弱网环境体验差
适合人群
- 开发者与 DevOps 工程师（CI/CD 流水线集成媒体处理）
- 内容创作者的技术团队（批量转码、自动化后期）
- 需要安全隔离媒体处理的企业（避免本地安装 ffmpeg 的安全风险）
常规风险
1. SSH 密钥泄露：若私钥管理不当，攻击者可获得容器内完整媒体处理能力
2. 资源耗尽攻击：恶意用户可通过复杂滤镜任务（如高分辨率 frei0r 特效）耗尽 CPU/内存
3. 路径逃逸隐患：虽声明阻止 ../ 遍历，但白名单实现的健壮性依赖代码审计
4. 依赖维护：ffmpeg 等工具版本更新滞后时可能存在已知 CVE 漏洞
安全架构评估
该 skill 采用"零 shell"设计哲学：Python wrapper 拦截所有 SSH 会话，仅放行白名单命令，元字符（&|;$()）被当作字面量处理而非操作符。这种"无 shell 介入"模式从根本上杜绝了命令注入攻击面，是容器化媒体服务的安全最佳实践。