linuxserver/overseerr 镜像文档

镜像概述和主要用途

Overseerr 是一个请求管理和媒体发现工具，专为与现有 Plex 生态系统配合使用而设计。LinuxServer.io 团队提供的此 Docker 镜像封装了 Overseerr 应用，确保其可在容器环境中便捷部署和运行。

核心功能和特性

• 定期应用更新：及时跟进上游应用版本更新
• 灵活的用户映射：通过 PUID/PGID 实现容器内用户与宿主机用户权限映射
• 自定义基础镜像：集成 s6 进程管理覆盖层
• 高效系统更新：每周基础 OS 更新，通过跨镜像通用层减少存储空间占用、 downtime 和带宽消耗
• 定期安全更新：持续修复安全漏洞，保障运行环境安全

支持的架构

该镜像利用 Docker 清单实现多平台支持。直接拉取 lscr.io/linuxserver/overseerr:latest 即可自动获取对应架构的镜像，也可通过标签指定特定架构。

版本标签

使用场景和适用范围

适用于需要管理 Plex 媒体库请求的个人或家庭用户，尤其适合以下场景：

• 家庭媒体服务器中统一管理影视内容请求
• 与 Plex、Sonarr、Radarr 等媒体工具配合构建完整媒体生态
• 需要简化用户媒体请求流程、自动化内容获取的场景

应用设置

访问 Web 界面：<你的IP>:5055，更多信息请参考 Overseerr ***文档。

高级操作支持

只读文件系统运行

本镜像支持以只读容器文件系统运行，详情请参阅 相关文档。

非 root 用户运行

本镜像支持以非 root 用户运行，详情请参阅 相关文档。

使用方法和配置说明

Docker Compose (推荐)

yaml
---
services:
  overseerr:
    image: lscr.io/linuxserver/overseerr:latest
    container_name: overseerr
    environment:
      - PUID=1000        # 用户ID
      - PGID=1000        # 组ID
      - TZ=Etc/UTC       # 时区
    volumes:
      - /path/to/overseerr/config:/config  # 配置文件持久化路径
    ports:
      - 5055:5055        # Web界面端口映射
    restart: unless-stopped  # 重启策略

Docker CLI

bash
docker run -d \
  --name=overseerr \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -p 5055:5055 \
  -v /path/to/overseerr/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/overseerr:latest

参数说明

容器运行参数采用 <外部>:<内部> 格式定义，除非标记为“可选”，否则均为必填参数。

环境变量配置

从文件读取环境变量

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

bash
-e FILE__MYVAR=/run/secrets/mysecretvariable

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

应用运行 Umask 设置

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

用户/组 ID 说明

使用卷（-v 参数）时，宿主机与容器间可能出现权限问题。通过指定 PUID（用户ID）和 PGID（组ID）可避免此问题。确保宿主机卷目录的所有者与指定的 PUID/PGID 一致。

获取当前用户的 UID/GID：

bash
id your_user

示例输出：

text
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)

Docker Mods

Docker Mods 提供额外功能扩展。上述徽章链接可查看适用于此镜像的专用 Mods 和适用于所有 LinuxServer 镜像的通用 Mods。

支持信息

容器内 Shell 访问

bash
docker exec -it overseerr /bin/bash

实时查看容器日志

bash
docker logs -f overseerr

查看容器版本号

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' overseerr

查看镜像版本号

bash
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/overseerr:latest

更新说明

使用 Docker Compose 更新

更新镜像

• 更新所有镜像：

  bash
  docker-compose pull
  

• 更新单个镜像：

  bash
  docker-compose pull overseerr
  

更新容器

• 更新所有容器：

  bash
  docker-compose up -d
  

• 更新单个容器：

  bash
  docker-compose up -d overseerr
  

清理旧镜像

bash
docker image prune

使用 Docker Run 更新

更新镜像

bash
docker pull lscr.io/linuxserver/overseerr:latest

停止并删除当前容器

bash
docker stop overseerr
docker rm overseerr

重新创建容器

使用上述 Docker CLI 命令重新创建容器（若卷映射正确，/config 目录及配置将被保留）

清理旧镜像

bash
docker image prune

镜像更新通知 - Diun (Docker Image Update Notifier)

[!TIP] 推荐使用 Diun 接收更新通知。不建议使用自动更新容器的工具。

本地构建

如需本地修改或开发，可按以下步骤构建镜像：

bash
git clone [***]
cd docker-overseerr
docker build \
  --no-cache \
  --pull \
  -t lscr.io/linuxserver/overseerr:latest .

在 x86_64 硬件上构建 ARM 变体（反之亦然）需使用 lscr.io/linuxserver/qemu-static：

bash
docker run --rm --privileged lscr.io/linuxserver/qemu-static --reset

注册后可通过 -f Dockerfile.aarch64 指定架构对应的 Dockerfile。

版本历史

• 2025-07-05：基于 Alpine 3.22 重新构建
• 2024-12-24：基于 Alpine 3.21 重新构建
• 2024-05-31：基于 Alpine 3.20 重新构建
• 2023-12-23：基于 Alpine 3.19 重新构建
• 2023-05-25：基于 Alpine 3.18 重新构建，移除 armhf 架构支持
• 2022-12-18：主分支基于 Alpine 3.17 重新构建
• 2022-10-27：主分支基于 Alpine 3.16 重新构建，迁移至 s6v3
• 2022-08-20：不再安装 cypress
• 2022-04-01：主分支基于 Alpine 3.15 重新构建
• 2022-01-27：develop 分支基于 Alpine 3.15 重新构建
• 2022-01-04：移除缓存文件
• 2021-10-10：添加额外的构建后清理步骤
• 2021-09-19：基于 Alpine 3.14 重新构建，更新代码格式，增加 JS 内存限制
• 2021-04-05：初始发布