*** 镜像文档

镜像概述和主要用途

Radarr 是 Sonarr 的一个分支，专门用于电影管理，功能类似 Couchpotato。本镜像由 LinuxServer.io 团队维护，提供了稳定、易用的 Radarr 容器化部署方案，适用于个人电影库的自动化管理，包括电影搜索、下载、整理和元数据管理等。

核心功能和特性

Radarr 应用功能

电影库自动化管理，支持搜索、下载、分类和元数据获取
与主流下载客户端（如 qBittorrent、Deluge 等）集成
支持自定义质量配置、文件重命名和目录结构整理
自动监控和更新电影元数据（海报、简介、评分等）

LinuxServer.io 镜像特性

定期、及时的应用更新
简单的用户权限映射（通过 PUID、PGID）
基于 s6 overlay 的自定义基础镜像
每周基础 OS 更新，跨生态系统共享通用层以减少空间占用、 downtime 和带宽消耗
定期安全更新

支持的架构

该镜像通过 Docker manifest 实现多平台支持，拉取 lscr.io/***:latest 即可自动匹配对应架构。也可通过标签指定特定架构：

架构	支持状态	标签格式
x86-64	✅	amd64-<version tag>
arm64	✅	arm64v8-<version tag>
armhf	✅	arm32v7-<version tag>

版本标签

标签	支持状态	描述
latest	✅	Radarr 稳定版发布
develop	✅	Radarr develop 分支版本
nightly	✅	Radarr nightly 分支版本

应用设置

启动容器后，通过 <你的IP>:7878 访问 Web 界面
首次使用需完成初始配置向导，包括设置下载客户端、电影库路径等
媒体文件夹注意事项：
- 镜像默认提供 /movies 和 /downloads 作为可选路径，便于快速上手
- 若需支持硬链接（同一文件在多位置引用但仅占用一份空间）或原子移动（即时文件移动而非复制+删除），建议参考 Servarr 文档规划路径结构

使用方法和配置说明

Docker Compose（推荐）

yaml
---
version: "2.1"
services:
  radarr:
    image: lscr.io/***:latest
    container_name: radarr
    environment:
      - PUID=1000        # 用户ID，详见下方说明
      - PGID=1000        # 组ID，详见下方说明
      - TZ=Etc/UTC       # 时区，如 Asia/Shanghai
    volumes:
      - /path/to/data:/config                     # 配置文件存储路径
      - /path/to/movies:/movies                   # 电影库路径（可选）
      - /path/to/downloads:/downloads             # 下载客户端输出路径（可选）
    ports:
      - 7878:7878        # Web界面端口
    restart: unless-stopped

Docker CLI

bash
docker run -d \
  --name=radarr \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 7878:7878 \
  -v /path/to/data:/config \
  -v /path/to/movies:/movies `# 可选` \
  -v /path/to/downloads:/downloads `# 可选` \
  --restart unless-stopped \
  lscr.io/***:latest

参数说明

参数	功能描述
`-p 7878`	Radarr Web 界面访问端口
`-e PUID=1000`	容器内运行用户的 ID，用于解决权限问题（详见下方用户/组 ID 说明）
`-e PGID=1000`	容器内运行用户组的 ID，用于解决权限问题（详见下方用户/组 ID 说明）
`-e TZ=Etc/UTC`	时区设置，格式参考时区数据库列表
`-v /config`	存储 Radarr 配置文件和数据库的路径
`-v /movies`	电影库路径（可选，建议映射以实现文件管理）
`-v /downloads`	下载客户端输出目录（可选，用于 Radarr 识别和整理下载的电影文件）

环境变量与配置

从文件加载环境变量（Docker Secrets）

可通过 FILE__ 前缀从文件加载环境变量，例如：

bash
-e FILE__PASSWORD=/run/secrets/mysecretpassword

上述命令会将 /run/secrets/mysecretpassword 文件内容作为 PASSWORD 环境变量的值。

Umask 设置

可通过 -e UMASK=022 覆盖容器内应用的默认 umask 设置。注意 umask 是权限掩码（减法操作），而非直接设置权限，详情参考 umask 说明。

用户/组 ID 说明

使用卷挂载（-v 参数）时，主机与容器可能出现权限冲突。通过指定 PUID（用户 ID）和 PGID（组 ID），可确保容器内用户与主机用户权限一致，避免权限问题。

获取当前用户的 UID 和 GID：

bash
id username
# 输出示例：uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

将输出的 uid 和 gid 分别作为 PUID 和 PGID 的值。

Docker Mods

可通过 Docker Mods 扩展容器功能，相关 mods 可增强 Radarr 的功能或集成其他工具。

查看 Radarr 专用 mods：[***]
查看通用 mods（适用于所有 LinuxServer.io 镜像）：[***]

支持信息

容器管理命令

访问容器 Shell：docker exec -it radarr /bin/bash
实时查看日志：docker logs -f radarr
查看容器版本：docker inspect -f '{{ index .Config.Labels "build_version" }}' radarr
查看镜像版本：docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/***:latest

更新说明

LinuxServer.io 镜像为静态版本，需通过更新镜像并重建容器来升级应用（部分例外如 nextcloud、plex 除外）。

通过 Docker Compose 更新

bash
# 更新所有镜像（或指定镜像）
docker-compose pull radarr
# 重建并启动容器
docker-compose up -d radarr
# 清理旧镜像
docker image prune

通过 Docker Run 更新

bash
# 拉取最新镜像
docker pull lscr.io/***:latest
# 停止并删除旧容器
docker stop radarr && docker rm radarr
# 用相同参数重建容器（/config 卷会保留配置）
docker run -d [原参数] lscr.io/***:latest
# 清理旧镜像
docker image prune

通过 Watchtower 自动更新（仅推荐临时使用）

bash
docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once radarr

注意：不建议长期使用 Watchtower 自动更新，推荐使用 Docker Compose 进行版本管理。

本地构建

如需自定义镜像，可通过以下步骤本地构建：

bash
# 克隆仓库
git clone [***]
cd docker-radarr
# 构建镜像
docker build \
  --no-cache \
  --pull \
  -t lscr.io/***:latest .

构建 ARM 架构镜像（需在 x86_64 主机上）

bash
# 注册 qemu-user-static
docker run --rm --privileged multiarch/qemu-user-static:register --reset
# 构建特定架构（如 arm64v8）
docker build -f Dockerfile.aarch64 -t lscr.io/***:arm64v8-latest .