Docker-Radarr 镜像文档

镜像概述和主要用途

Docker-Radarr 是基于 *** 的扩展镜像，在基础镜像之上集成了 PHP 7.0、PHP-Curl 扩展（用于 Pushover 通知集成）以及 FFmpeg 3.4.2 静态二进制文件。该镜像旨在为 Radarr 用户提供开箱即用的自定义后处理能力，无需额外配置依赖环境。

核心功能和特性

• 基础镜像支持：基于 *** 构建，继承其所有核心功能（如电影管理、自动下载等）
• PHP 环境集成：内置 PHP 7.0 运行环境，支持 PHP 编写的自定义脚本
• Pushover 支持：包含 PHP-Curl 扩展，可直接对接 Pushover 服务发送通知
• FFmpeg 工具链：集成 FFmpeg 3.4.2 静态二进制文件，支持视频转码、格式处理等媒体操作，无需单独安装
• 静态二进制优势：FFmpeg 采用静态编译，避免系统依赖冲突，确保跨环境一致性

使用场景和适用范围

• 需要通过 PHP 脚本实现自定义后处理逻辑（如文件重命名、元数据修改）的 Radarr 部署
• 需集成 Pushover 接收任务状态通知的场景
• 需要对下载的电影文件进行格式转换、编码调整等 FFmpeg 操作的用户
• 希望简化依赖配置，追求"一键部署"体验的 Docker 环境

使用方法和配置说明

基本部署命令

使用 docker run 快速启动容器：

docker run -d \
  --name=radarr \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -p 7878:7878 \
  -v /path/to/radarr/config:/config \
  -v /path/to/movies:/movies \
  -v /path/to/downloads:/downloads \
  --restart unless-stopped \
  docker-radarr

核心配置说明

环境变量（继承自 ***）

• PUID：运行 Radarr 的用户 ID（默认 1000）
• PGID：运行 Radarr 的用户组 ID（默认 1000）
• TZ：时区设置（如 Asia/Shanghai）
• UMASK_SET：文件权限掩码（默认 022）

卷挂载

• /config：Radarr 配置文件存储目录
• /movies：电影文件存储目录
• /downloads：下载文件存放目录（与下载器对接）

自定义后处理示例

使用 FFmpeg 进行视频转码

在 Radarr 中配置后处理脚本（Settings > Connect > Custom Script），示例 PHP 脚本（保存至 /config/scripts/transcode.php）：

<?php
// 使用 FFmpeg 将视频转码为 MP4 格式
$inputFile = $argv[1]; // 输入文件路径
$outputFile = str_replace('.mkv', '.mp4', $inputFile); // 输出文件路径

// 执行 FFmpeg 转码命令
exec("/usr/local/bin/ffmpeg -i {$inputFile} -c:v libx264 -c:a aac {$outputFile}");

// 通过 Pushover 发送完成通知（需替换为实际的 Pushover API 信息）
$pushoverToken = 'your_pushover_token';
$pushoverUser = 'your_pushover_user';
$message = "电影转码完成：{$outputFile}";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "[***]");
curl_setopt($ch, CURLOPT_POSTFIELDS, [
  'token' => $pushoverToken,
  'user' => $pushoverUser,
  'message' => $message
]);
curl_exec($ch);
curl_close($ch);
?>

注意事项

• FFmpeg 二进制文件路径为 /usr/local/bin/ffmpeg，自定义脚本中需使用绝对路径调用
• PHP 脚本需放置在 Radarr 可访问的目录（如 /config/scripts/）并设置执行权限
• Pushover 通知需提前获取 API Token 和 User Key，并在脚本中正确配置
• 镜像版本与基础镜像 *** 保持同步，可通过 Docker 标签指定具体版本