linuxserver/flexget

LinuxServer.io FlexGet 容器介绍

LinuxServer.io 团队特点

LinuxServer.io 团队提供的容器具有以下特性：

• 定期且及时的应用更新
• 便捷的用户权限映射（PGID、PUID）
• 基于 s6 overlay 的自定义基础镜像
• 每周基础系统更新，通过共享通用层减少存储空间占用、 downtime 和带宽消耗
• 常规安全更新

社区支持与资源

• 博客：<[***]>（包含容器使用指南、教程及技术观点）
• ****：<
• 论坛：<[***]>（社区讨论与问题反馈）
• GitHub：<[***]>（所有代码仓库源码）
• 赞助支持：<[]>（欢迎通过或贡献支持我们）

linuxserver/flexget 容器

FlexGet 是一款媒体自动化管理工具，可用于处理下载任务、内容筛选等媒体相关自动化流程。

支持的架构

该镜像通过 Docker manifest 实现多平台支持，直接拉取 lscr.io/linuxserver/flexget:latest 即可自动匹配对应架构。也可通过标签指定具体架构：

应用设置

• 默认配置文件路径：/config/.flexget
• 更多使用细节可参考 FlexGet 官方文档

下载文件夹说明

容器中 /data 路径为可选挂载路径，适用于快速上手场景。若无需硬链接或原子移动功能，可直接使用该路径；若需自定义存储结构，可忽略此路径并自行映射其他目录。

只读模式运行

该镜像支持以只读容器文件系统运行，详情参见 官方文档。

使用方法

可通过 docker-compose（推荐）或 docker cli 启动容器。

[!NOTE]
除标记为“可选”的参数外，其余均为必填项，需提供具体值。

docker-compose 方式

yaml
---
services:
  flexget:
    image: lscr.io/linuxserver/flexget:latest
    container_name: flexget  # 容器名称
    environment:
      - PUID=1000             # 用户ID，详见下方说明
      - PGID=1000             # 组ID，详见下方说明
      - TZ=Etc/UTC            # 时区，如 Asia/Shanghai
      - FG_LOG_LEVEL=info     # 日志级别
      - FG_LOG_FILE=/config/flexget.log  # 日志文件路径
      - FG_CONFIG_FILE=/config/.flexget/config.yml  # 配置文件路径
      - FG_WEBUI_PASSWORD=info # WebUI密码（可选）
    volumes:
      - /path/to/flexget/data:/config  # 本地配置文件路径映射
      - /path/to/downloads:/data       # 下载目录映射（可选）
    ports:
      - 5050:5050             # WebUI端口映射
    restart: unless-stopped   # 重启策略

docker cli 方式

bash
docker run -d \
  --name=flexget \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e FG_LOG_LEVEL=info \
  -e FG_LOG_FILE=/config/flexget.log \
  -e FG_CONFIG_FILE=/config/.flexget/config.yml \
  -e FG_WEBUI_PASSWORD=info `# 可选：WebUI密码` \
  -p 5050:5050 \
  -v /path/to/flexget/data:/config \
  -v /path/to/downloads:/data `# 可选：下载目录映射` \
  --restart unless-stopped \
  lscr.io/linuxserver/flexget:latest

参数说明

环境变量文件（Docker secrets）

可通过 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）可解决此问题，确保主机卷目录所有者与容器内用户一致。

通过以下命令获取当前用户的 UID 和 GID：

bash
id your_user

示例输出：

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

此时 PUID=1000、PGID=1000。

Docker Mods

可通过 Docker Mods 扩展容器功能，支持该镜像的 Mods 列表见 flexget Mods，通用 Mods 见 universal Mods。

支持信息

容器内命令行访问

bash
docker exec -it flexget /bin/bash

实时查看日志

bash
docker logs -f flexget

查看容器版本

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

查看镜像版本

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

更新方法

容器需通过更新镜像并重建来升级应用（除非特定镜像说明支持内部更新）。

通过 docker-compose 更新

1. 更新镜像：

   • 所有镜像：docker-compose pull
   • 单个镜像：docker-compose pull flexget

2. 更新容器：

   • 所有容器：docker-compose up -d
   • 单个容器：docker-compose up -d flexget

3. 清理旧镜像：docker image prune

通过 docker run 更新

1. 拉取新镜像：docker pull lscr.io/linuxserver/flexget:latest

2. 停止并删除旧容器：

   bash
   docker stop flexget
   docker rm flexget
   

3. 使用原参数重建容器（配置文件通过卷映射保留）

4. 清理旧镜像：docker image prune

[!TIP]
推荐使用 Diun 接收镜像更新通知，不建议使用自动更新工具。

本地构建

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

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

跨架构构建（如 x86_64 构建 ARM 镜像）需先注册 qemu-static：

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

然后使用对应架构的 Dockerfile（如 -f Dockerfile.aarch64）。

版本历史

• 18.09.24：设置 WebUI 密码时不再创建空日志文件
• 17.08.24：因部分插件与 Python 3.12 不兼容，回退至 Alpine 3.20
• 19.06.24：基于 Alpine 3.20 重构
• 20.03.24：基于 Alpine 3.19 重构
• 07.10.23：从 linuxserver 仓库 安装 unrar
• 10.08.23：升级 unrar 至 6.2.10
• 03.07.23：初始发布