安全媒体处理

技能简介

mediaproc 通过锁定的 SSH 容器执行媒体文件处理，集成 ffmpeg、sox 和 ImageMagick 工具链，支持视频转码、音频处理、图像操作等功能。基于 lockbox 构建，无 shell 访问权限，防止命令注入。

业务背景

企业需在隔离环境中处理音视频及图像文件，传统方案存在命令注入风险。本服务通过锁定式SSH容器运行ffmpeg等工具链，阻断shell访问通道，在保障转码、特效处理、元信息提取等核心能力的同时，杜绝恶意代码执行路径，满足安全合规要求。

落地案例：市场部需将4K宣传片批量转为多规格版本适配各渠道。运营人员配置环境变量后，调用包装脚本上传源文件，执行H.264编码与frei0r水印叠加指令，完成后下载成品并清理临时文件。全程无需登录容器，路径被限制在工作目录内，防止越权操作。

能做什么

• 视频格式转换、编码、滤镜处理（含 frei0r 特效）
• 音频格式转换、归一化处理（支持 LADSPA/LV2 插件）
• 图像缩放、缩略图生成、格式转换
• 媒体文件元信息提取（ffprobe/soxi/identify）
• 安全的文件上传、下载、目录管理

使用说明

1. 环境准备：部署 mediaproc 容器实例，配置 MEDIAPROC_HOST 和 MEDIAPROC_PORT 环境变量
2. 安装脚本：获取 scripts/mediaproc.sh 包装脚本，该脚本自动处理主机密钥接受
3. 基本调用：

   scripts/mediaproc.sh <command> [args]

4. 文件上传处理流程：

   # 上传文件
   scripts/mediaproc.sh "put input.mp4" < input.mp4
   # 执行处理
   scripts/mediaproc.sh "ffmpeg -i /work/input.mp4 -c:v libx264 /work/output.mp4"
   # 下载结果
   scripts/mediaproc.sh "get output.mp4" > output.mp4
   # 清理文件
   scripts/mediaproc.sh "remove-file input.mp4"

输入与输出

见下方输入与输出表格。

风险提示

• 所有文件路径限制在工作目录内，目录遍历被阻止
• 需预先配置 SSH 主机密钥信任关系
• 大文件传输受网络带宽和容器存储限制
• 部分音视频滤镜可能消耗大量计算资源

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/psyb0t/mediaproc/SKILL.md
来源类型：GitHub 开源项目