首页
/ FFmpeg-over-IP 项目使用教程

FFmpeg-over-IP 项目使用教程

2025-04-16 09:04:08作者:裴麒琰

1. 项目目录结构及介绍

FFmpeg-over-IP 是一个允许在拥有 GPU 访问权限的机器上远程转码视频的开源项目。以下是项目的目录结构及其介绍:

ffmpeg-over-ip/
├── bin/             # 存放编译后的客户端和服务器二进制文件
├── cmd/             # 包含 main 函数的包,用于启动客户端和服务器
├── pkg/             # 包含项目的核心逻辑和库
├── .github/         # 存放 GitHub 工作流文件
├── .gitignore       # 定义 Git 忽略的文件和目录
├── LICENSE.md       # 项目许可证文件
├── Makefile         # 项目构建文件,用于构建和安装二进制文件
├── README.md        # 项目说明文件
├── template.ffmpeg-over-ip.client.jsonc  # 客户端配置文件模板
├── template.ffmpeg-over-ip.server.jsonc  # 服务器配置文件模板

2. 项目的启动文件介绍

项目提供了两个主要的启动文件,分别用于启动客户端和服务器:

  • ffmpeg-over-ip-client: 客户端程序,用于发送转码请求到服务器。
  • ffmpeg-over-ip-server: 服务器程序,用于接收客户端的请求并在有 GPU 的机器上执行视频转码。

客户端启动示例:

./bin/ffmpeg-over-ip-client -i input.mp4 -c:v libx264 -preset medium output.mp4

服务器启动示例:

./bin/ffmpeg-over-ip-server

3. 项目的配置文件介绍

FFmpeg-over-IP 使用 JSONC 格式的配置文件,支持在配置文件中添加注释。以下是配置文件的基本结构和介绍:

客户端配置文件 (template.ffmpeg-over-ip.client.jsonc)

{
  // 日志输出位置
  "log": "/tmp/ffmpeg-over-ip-client.log",
  // 服务器地址
  "address": "localhost:5050",
  // 认证密钥(与服务器配置相同)
  "authSecret": "your-secret-here"
}

服务器配置文件 (template.ffmpeg-over-ip.server.jsonc)

{
  // 日志输出位置
  "log": "stdout",
  // 监听地址
  "address": "0.0.0.0:5050",
  // 认证密钥(与客户端配置相同)
  "authSecret": "your-secret-here",
  // 服务器上的 ffmpeg 路径
  "ffmpegPath": "/usr/bin/ffmpeg",
  // 路径重写规则
  "rewrites": [
    // 文件路径重写
    ["/client/path", "/server/path"],
    // 编解码器重写
    ["h264_nvenc", "h264_qsv"]
  ]
}

请根据实际需求修改配置文件中的参数,确保客户端和服务器端的配置文件中的认证密钥一致。

登录后查看全文
热门项目推荐