使用Docker部署Jellyseerr媒体请求系统的完整指南

前言

Jellyseerr是一款为媒体服务器设计的现代化请求管理工具，它能够优雅地处理用户对电影、电视剧等媒体内容的请求。本文将详细介绍如何使用Docker容器技术来部署Jellyseerr系统，这是官方推荐的首选安装方式。

Docker环境准备

在开始部署前，请确保您已正确安装Docker引擎。Docker提供了跨平台支持，可以在Linux、macOS和Windows系统上运行。对于Windows用户，必须启用WSL2功能以避免数据库损坏问题。

基础概念说明

• 容器(Container)：轻量级的虚拟化技术，将应用及其依赖打包在一起
• 镜像(Image)：容器的静态模板，包含运行应用所需的所有内容
• 卷(Volume)：用于持久化存储容器数据的机制
• Docker Compose：通过YAML文件定义和管理多容器应用的工具

Linux/macOS系统部署

使用Docker CLI部署

这是最直接的部署方式，适合熟悉命令行操作的用户：

docker run -d \
  --name jellyseerr \
  -e LOG_LEVEL=debug \
  -e TZ=Asia/Shanghai \  # 设置为您的实际时区
  -p 5055:5055 \
  -v /path/to/appdata/config:/app/config \
  --restart unless-stopped \
  fallenbagel/jellyseerr

关键参数说明：

• -v /path/to/appdata/config:/app/config：将主机目录映射到容器内，确保配置持久化
• --restart unless-stopped：设置容器自动重启策略
• -e TZ：设置容器时区，确保日志时间准确

使用Docker Compose部署

对于更复杂的部署场景或需要管理多个服务的用户，推荐使用Docker Compose：

version: '3'
services:
  jellyseerr:
    image: fallenbagel/jellyseerr:latest
    container_name: jellyseerr
    environment:
      - LOG_LEVEL=debug
      - TZ=Asia/Shanghai
    ports:
      - 5055:5055
    volumes:
      - /path/to/appdata/config:/app/config
    restart: unless-stopped

部署命令：

docker compose up -d

Windows系统部署注意事项

Windows用户需要特别注意以下几点：

1. 必须启用WSL2功能
2. 避免使用SMB共享挂载配置目录
3. 推荐使用Docker命名卷而非直接目录映射

创建命名卷示例：

docker volume create jellyseerr-data

然后在运行容器时使用该卷：

docker run -d ... -v jellyseerr-data:/app/config ...

系统更新维护

手动更新流程

1. 停止并移除旧容器
2. 拉取最新镜像
3. 使用相同参数重新创建容器

自动更新方案

可以考虑以下自动化工具：

• Watchtower：自动监控并更新容器
• Diun：提供新镜像可用通知

最佳实践建议

1. 日志级别：生产环境可考虑将LOG_LEVEL设置为info而非debug
2. 资源限制：为容器设置合理的CPU和内存限制
3. 备份策略：定期备份映射的配置目录或命名卷
4. 网络配置：在反向代理场景中，可考虑使用自定义网络

常见问题排查

1. 容器无法启动：检查端口是否冲突，目录权限是否正确
2. 数据库损坏：Windows用户必须确认使用WSL2和命名卷
3. 时区不正确：确保TZ环境变量设置为正确的时区名称

结语

通过Docker部署Jellyseerr不仅简化了安装过程，还提供了良好的隔离性和可移植性。本文涵盖了从基础部署到高级配置的各个方面，希望能帮助您顺利搭建自己的媒体请求管理系统。