mdhiggins/radarr-sma 镜像文档

镜像概述和主要用途

基于 *** 的官方 SMA 容器，集成了运行 SickBeard MP4 Automator (SMA) 所需的 FFMPEG 和 Python 环境。该镜像将 Radarr（电影管理工具）与 SMA（媒体文件自动转码工具）结合，实现下载完成后自动转码媒体文件的功能。

核心功能和特性

• 集成 Radarr 的稳定版/nightly 版，提供电影下载、管理和组织能力
• 内置 FFMPEG 和 ffprobe 工具，支持媒体文件转码
• 预装 SMA 及其依赖，实现下载完成后自动触发转码流程
• 支持自定义 FFMPEG 编译（通过 build 标签），可集成 VAAPI、NVENC 等硬件加速
• 配置文件自动注入，简化 Radarr 与 SMA 的联动设置

使用场景和适用范围

适用于需要自动化管理电影媒体库的用户，特别是：

• 使用 Radarr 进行电影下载、整理和元数据管理的场景
• 需要将下载的媒体文件统一转码为 MP4 格式的需求
• 希望通过硬件加速（如 VAAPI、NVENC）提升转码效率的用户

版本标签

使用方法和配置说明

最近更新（重要）

2020年3月9日起，容器结构已调整：

• 脚本路径从 /usr/local/bin/sma/sickbeard_mp4_automator 变更为 /usr/local/sma
• 自动处理配置的挂载点调整为 /usr/local/sma/config（更符合 Docker 最佳实践）
  请根据以下说明更新挂载配置。

Docker Compose 部署示例

services:
  radarr:
    image: mdhiggins/radarr-sma
    container_name: radarr
    volumes:
      - /opt/appdata/radarr:/config  # Radarr 配置目录（本地路径需替换）
      - /opt/appdata/sma:/usr/local/sma/config  # SMA 配置目录（本地路径需替换）
      - /mnt/storage/movies:/movies  # 电影存储目录（本地路径需替换）
      - /mnt/storage/downloads:/downloads  # 下载目录（本地路径需替换）
    ports:
      - 7878:7878  # Radarr Web 界面端口
    restart: always
    environment:
      - PUID=${PUID}  # 用户 ID（需替换为实际值，如 1000）
      - PGID=${PGID}  # 组 ID（需替换为实际值，如 1000）

autoProcess.ini 配置

• 挂载要求：将包含 autoProcess.ini 的目录通过 volumes 挂载到 /usr/local/sma/config。建议设置为可写，以便 SMA 自动添加新配置项。
• 配置注入：容器运行时会从 Radarr 的 config.xml 中读取以下参数，并自动注入到 autoProcess.ini：
  • ffmpeg、ffprobe 路径
  • host（从环境变量获取或默认 127.0.0.1）
  • webroot、port、ssl

FFMPEG 二进制文件路径

容器内置 FFMPEG 工具，路径如下：

• /usr/local/bin/ffmpeg
• /usr/local/bin/ffprobe

Radarr 配置步骤

1. 启用完成下载处理

• 进入 Radarr Web 界面 → 设置 → 下载客户端 → 完成下载处理
• 勾选 启用 → 保存设置

2. 添加自定义脚本

• 进入 Radarr Web 界面 → 设置 → 连接 → + 添加 → 自定义脚本

日志位置

SMA 日志文件位于容器内的 /usr/local/sma/config/sma.log，同时会映射到本地挂载的 SMA 配置目录（如 /opt/appdata/sma/sma.log）。

环境变量

特殊考虑

build 标签的自定义构建

build 标签使用多阶段构建，基于 jrottenberg/ffmpeg 容器编译 FFMPEG，支持 VAAPI、NVENC 等硬件加速选项。本地构建时可通过 ARG 参数修改基础镜像标签：

VAAPI 硬件加速示例（docker-compose）

services:
  radarr:
    container_name: radarr
    build:
      context: [***]
      args:
        - ffmpeg_tag=4.2-vaapi  # 使用支持 VAAPI 的 FFMPEG 标签