Requestrr Docker镜像文档

镜像概述与主要用途

Requestrr 是一款聊天机器人，旨在通过聊天简化 Sonarr/Radarr/Lidarr/Overseerr/Ombi 等服务的使用。它允许用户通过聊天界面（主要是 ***）轻松请求媒体内容，无需直接操作这些服务的管理界面。

!logo

核心功能与特性

• ***** 集成**：支持通过斜杠命令、按钮等方式请求内容
• 请求通知：用户可在请求完成时收到通知
• 媒体服务集成：
  • Sonarr (V2-V4) 和 Radarr (V2-V5) 集成，支持通过 Overseerr 管理多实例（仅 4k/1080p）
  • Lidarr (V1-V2) 集成
  • Overseerr 集成，支持用户权限/配额管理和问题提交
  • Ombi (V3/V4) 集成，支持用户角色/配额管理和问题提交
• Web 门户配置：所有功能均可通过 Web 界面完全配置

使用场景与适用范围

适用于需要通过聊天界面简化媒体内容请求流程的用户群体，特别是：

• 媒体服务器管理员（使用 Sonarr/Radarr/Lidarr 等工具）
• *** 社区管理员，希望为成员提供便捷的内容请求渠道
• 需要集中管理用户内容请求、权限和配额的组织

Docker部署与启动

基本部署命令

打开命令行终端，使用以下命令创建并启动容器：

docker run -d \
  --name requestrr \
  -p 4545:4545 \
  -v /path/to/config:/root/config \
  --restart=unless-stopped \
  thomst08/requestrr

注意：将 /path/to/config 替换为宿主机上的实际配置目录路径。

以非root用户运行

可通过 --user 参数指定容器运行用户，具体配置方法参考 Docker run 用户设置文档。

访问与初始化

1. 容器启动后，通过 http://<服务器地址>:4545 访问 Web 管理界面
2. 创建管理员账户并完成初始配置
3. 将机器人邀请至 *** 服务器后，输入 /help 查看所有可用命令

环境变量

Requestrr 支持以下环境变量自定义部署配置：

REQUESTRR_PORT

• 描述：设置应用在容器内监听的端口
• 默认值：4545
• 示例：-e REQUESTRR_PORT=5000

REQUESTRR_BASEURL

• 描述：定义 Requestrr 的基础 URL 路径，适用于在反向代理子路径下部署（如 /requestrr）
• 默认值：/
• 示例：-e REQUESTRR_BASEURL=/requestrr

带环境变量的部署示例

docker run -d \
  --name requestrr \
  -p 5000:5000 \
  -v /opt/Requestrr/config:/root/config \
  -e REQUESTRR_PORT=5000 \
  -e REQUESTRR_BASEURL=/requestrr \
  --restart=unless-stopped \
  thomst08/requestrr

注意：设置 REQUESTRR_BASEURL 时，需确保与反向代理配置中的子路径一致。

配置说明

配置方式

所有配置均通过 Web 门户完成，无需手动编辑配置文件。

集成配置

Web 界面支持配置以下服务的集成参数：

• Sonarr (V2-V4)、Radarr (V2-V5)
• Lidarr (V1-V2)
• Overseerr（含用户权限/配额管理）
• Ombi (V3/V4)（含用户角色/配额管理）

详细配置文档

完整配置指南请参考官方 Wiki：[***]

非Docker部署

Requestrr 也支持非容器部署，详情参见 GitHub 仓库：[***]