Overseerr Docker镜像

镜像概述

Overseerr是一款与现有Plex生态系统配合使用的请求管理和媒体发现工具。本Docker镜像基于Arch Linux构建，集成了Overseerr的最新开发版本（来自Arch Linux AUR），旨在帮助用户轻松管理媒体请求、发现新内容，并通过内联推荐功能探索更多感兴趣的媒体。

核心功能与特性

• 媒体请求管理：支持用户提交媒体观看请求，无缝整合至Plex生态系统
• 媒体发现：提供高效的媒体搜索功能，帮助用户查找电影、电视剧等内容
• 智能推荐：基于用户兴趣提供内联内容建议，拓展媒体探索范围
• Plex生态集成：与Plex媒体服务器深度协作，优化媒体库管理流程
• Arch Linux基础：基于Arch Linux构建，包含最新开发版本的Overseerr组件

使用场景

适用于已部署Plex媒体服务器的个人或家庭用户，尤其适合需要集中管理媒体请求、发现新内容，或希望通过智能推荐丰富媒体库的场景。可作为家庭媒体中心、小型媒体服务平台的辅助管理工具。

使用方法与配置说明

基本运行命令

docker run -d \
    -p 5055:5055 \
    --name=<容器名称> \
    -v <配置文件路径>:/config \
    -v /etc/localtime:/etc/localtime:ro \
    -e HEALTHCHECK_COMMAND=<命令> \
    -e HEALTHCHECK_ACTION=<操作> \
    -e HEALTHCHECK_HOSTNAME=<主机名> \
    -e UMASK=<文件创建权限掩码> \
    -e PUID=<用户UID> \
    -e PGID=<用户GID> \
    binhex/arch-overseerr

请将上述命令中所有<>包含的用户变量替换为实际值。

参数说明

端口映射

• -p 5055:5055：将容器内Overseerr服务的5055端口映射到主机，用于Web界面访问

卷挂载

• -v <配置文件路径>:/config：挂载配置文件目录，持久化Overseerr的配置数据
• -v /etc/localtime:/etc/localtime:ro：挂载本地时间文件（只读），确保容器时间与主机同步

环境变量

• HEALTHCHECK_COMMAND：健康检查执行命令
• HEALTHCHECK_ACTION：健康检查失败时的操作
• HEALTHCHECK_HOSTNAME：健康检查目标主机名
• UMASK：文件创建权限掩码（默认建议000）
• PUID：运行容器的用户UID（用户ID）
• PGID：运行容器的用户GID（组ID）

应用访问

容器启动后，通过以下地址访问Overseerr Web界面：
http://<主机IP>:5055

使用示例

docker run -d \
    -p 5055:5055 \
    --name=overseerr \
    -v /apps/docker/overseerr:/config \
    -v /etc/localtime:/etc/localtime:ro \
    -e UMASK=000 \
    -e PUID=0 \
    -e PGID=0 \
    binhex/arch-overseerr

注意事项

获取PUID和PGID

若需以特定用户身份运行容器，可通过以下命令获取目标用户的UID（PUID）和GID（PGID）：

id <用户名>

示例（获取用户media的ID）：

id media

输出结果格式：uid=1000(media) gid=1000(media)，其中1000即PUID和PGID值。