Spritsail/Sonarr Docker镜像文档

镜像概述和主要用途

Spritsail/Sonarr是基于Alpine Linux构建的Docker镜像，用于运行电视节目管理软件Sonarr。Sonarr是一款开源电视节目管理工具，支持自动搜索、下载、组织和更新电视节目集。该镜像提供了简单的初始配置脚本，可通过环境变量设置运行时参数，简化部署流程。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 运行时配置：支持通过环境变量设置config.xml中的关键参数（如日志级别、URL基础路径等）
• 灵活存储：配置文件和数据库通过卷挂载持久化，支持自定义存储路径
• 权限管理：默认使用用户ID（$SUID=906）运行，确保对挂载卷的读写权限可控
• 版本跟踪：支持指定Sonarr的更新分支（如master、develop），灵活控制软件版本

使用场景和适用范围

适用于需要在Docker环境中部署电视节目管理系统的用户，包括：

• 个人媒体服务器管理员，需自动化管理电视节目下载、分类和更新
• 家庭影院系统（HTPC）用户，希望通过Web界面便捷管理电视内容
• 对容器化部署有需求，追求轻量级、可配置性的技术用户
• 需要持久化配置和媒体文件存储，且注重权限隔离的场景

详细使用方法和配置说明

基础用法

默认配置下的基本部署命令：

docker run -dt \
    --name=sonarr \
    --restart=always \
    -v $PWD/config:/config \
    -p 8989:8989 \
    spritsail/sonarr

注意：必须使用-t（伪终端）参数，否则不会生成日志。

高级用法（自定义配置）

通过环境变量自定义配置的部署命令：

docker run -dt \
    --name=sonarr \
    --restart=always \
    -v $PWD/config:/config \
    -p 8989:8989 \
    -e URL_BASE=/sonarr \
    -e ANALYTICS=false \
    -e LOG_LEVEL=Debug \
    -e BRANCH=master \
    spritsail/sonarr

卷（Volumes）

Sonarr访问的其他文件（如电视节目目录）也需确保$SUID或$SGID（组ID）具有足够的读写权限。

配置参数（环境变量）

以下环境变量用于设置config.xml中的对应选项，提供Docker部署便捷性：