linuxserver/requestrr Docker镜像文档

弃用通知

该镜像已弃用。我们将不再提供支持，也不会更新此镜像。上游开发者已终止该项目的开发。

镜像概述和主要用途

linuxserver/requestrr 是基于LinuxServer.io团队构建的Docker镜像，用于运行Requestrr应用。Requestrr是一个聊天机器人，旨在通过聊天界面简化Sonarr、Radarr、Ombi等媒体管理服务的使用流程，允许用户通过聊天工具（如***）便捷地请求媒体内容。

核心功能和特性

LinuxServer.io镜像特性

• 定期应用更新：及时同步上游应用版本更新
• 简化用户权限映射：通过PUID（用户ID）和PGID（组ID）实现容器内用户与宿主机用户权限对齐
• 自定义基础镜像：集成s6 overlay进程管理系统
• 高效基础系统更新：每周更新基础操作系统，通过跨镜像通用层减少存储空间占用、 downtime和带宽消耗
• 定期安全更新：持续修复基础系统和依赖组件的安全漏洞

使用场景和适用范围

• 家庭媒体服务器环境：适用于搭建家庭媒体中心的用户，需简化媒体内容请求流程
• 多服务集成场景：已部署Sonarr（剧集管理）、Radarr（电影管理）、Ombi（媒体请求门户）等服务，需通过聊天工具统一入口管理媒体请求
• 聊天工具集成：支持通过***等聊天平台接收用户媒体请求，减少直接操作服务界面的复杂度

支持的架构

该镜像通过Docker manifest支持多架构，拉取lscr.io/linuxserver/requestrr:latest即可自动匹配宿主机架构。也可通过标签指定特定架构：

应用设置

容器启动后，通过 http://<your-ip>:4545 访问Web管理界面。详细配置指南请参考Requestrr官方文档。

使用方法和配置说明

Docker Compose（推荐）

创建docker-compose.yml文件，内容如下：

---
version: "2.1"
services:
  requestrr:
    image: lscr.io/linuxserver/requestrr:latest
    container_name: requestrr
    environment:
      - PUID=1000        # 宿主机用户ID，用于权限映射
      - PGID=1000        # 宿主机组ID，用于权限映射
      - TZ=Europe/London # 时区设置，如Asia/Shanghai
    volumes:
      - /path/to/appdata/config:/config  # 配置文件存储目录（替换为宿主机实际路径）
    ports:
      - 4545:4545        # Web管理界面端口
    restart: unless-stopped

启动容器：

docker-compose up -d

Docker CLI

直接使用docker run命令启动：

docker run -d \
  --name=requestrr \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Europe/London \
  -p 4545:4545 \
  -v /path/to/appdata/config:/config \
  --restart unless-stopped \
  lscr.io/linuxserver/requestrr:latest

参数说明

容器运行参数通过运行时参数（如上述命令中的-e、-p、-v）配置，格式为<外部>:<内部>。

环境变量从文件读取（Docker Secrets）

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

-e FILE__PASSWORD=/run/secrets/mysecretpassword

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

运行应用的Umask

可通过-e UMASK=022参数覆盖容器内应用的默认umask设置。umask用于控制新创建文件的权限（注：umask是权限掩码，通过减去该值计算实际权限，而非直接设置权限）。

用户/组标识符（PUID/PGID）

当使用卷（-v参数）映射宿主机目录时，可能出现权限问题。通过指定PUID和PGID，可确保容器内进程对映射目录的读写权限与宿主机用户一致。

获取宿主机用户的PUID和PGID：

id username  # 替换username为实际用户名

输出示例：

uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)

其中uid=1000即PUID，gid=1000即PGID。

Docker Mods

LinuxServer.io提供Docker Mods扩展容器功能。以下为可用Mods：

• 应用特定Mods：![Docker Mods]([***]
• 通用Mods：![Docker Universal Mods]([***]

支持信息

• 容器内Shell访问：

  docker exec -it requestrr /bin/bash
  

• 实时查看容器日志：

  docker logs -f requestrr
  

• 查询容器版本：

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

• 查询镜像版本：

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

更新信息

通过Docker Compose更新

1. 拉取最新镜像：

   docker-compose pull requestrr  # 更新单个镜像
   # 或更新所有镜像：docker-compose pull
   

2. 重启容器应用更新：

   docker-compose up -d requestrr  # 重启单个容器
   # 或重启所有容器：docker-compose up -d
   

3. 清理旧镜像：

   docker image prune
   

通过Docker Run更新

1. 拉取最新镜像：

   docker pull lscr.io/linuxserver/requestrr:latest
   

2. 停止并删除当前容器：

   docker stop requestrr && docker rm requestrr
   

3. 使用原参数重新创建容器（配置存储在/config卷中，会自动保留）：

   # 执行原docker run命令（需替换为实际参数）
   

4. 清理旧镜像：

   docker image prune
   

通过Watchtower自动更新（不推荐）

仅建议用于忘记原始启动参数的场景：

docker run --rm \
  -v /var/run/docker.sock:/var/run/docker.sock \
  containrrr/watchtower \
  --run-once requestrr

注意：不推荐使用自动更新工具。长期维护建议使用Docker Compose管理容器。

本地构建

如需自定义镜像，可通过以下步骤本地构建：

1. 克隆仓库：

   git clone [***]
   cd docker-requestrr
   

2. 构建镜像：

   docker build \
     --no-cache \
     --pull \
     -t lscr.io/linuxserver/requestrr:latest .
   

3. 构建ARM架构镜像（需先注册qemu）：

   docker run --rm --privileged multiarch/qemu-user-static:register --reset
   # 构建arm64架构：
   docker build -f Dockerfile.aarch64 -t lscr.io/linuxserver/requestrr:arm64v8-latest .
   

版本历史