linuxserver/flexgetLinuxServer.io 团队提供的容器具有以下特性:
FlexGet 是一款媒体自动化管理工具,可用于处理下载任务、内容筛选等媒体相关自动化流程。
该镜像通过 Docker manifest 实现多平台支持,直接拉取 lscr.io/linuxserver/flexget:latest 即可自动匹配对应架构。也可通过标签指定具体架构:
| 架构 | 支持状态 | 标签格式 |
|---|---|---|
| x86-64 | ✅ 支持 | amd64-<版本标签> |
| arm64 | ✅ 支持 | arm64v8-<版本标签> |
/config/.flexget容器中 /data 路径为可选挂载路径,适用于快速上手场景。若无需硬链接或原子移动功能,可直接使用该路径;若需自定义存储结构,可忽略此路径并自行映射其他目录。
该镜像支持以只读容器文件系统运行,详情参见 官方文档。
可通过 docker-compose(推荐)或 docker cli 启动容器。
[!NOTE]
除标记为“可选”的参数外,其余均为必填项,需提供具体值。
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 # 重启策略
bashdocker 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
| 参数 | 功能描述 |
|---|---|
-p 5050:5050 | WebUI的HTTP端口映射 |
-e PUID=1000 | 用户ID,用于解决权限问题,详见“用户/组ID”部分 |
-e PGID=1000 | 组ID,同上 |
-e TZ=Etc/UTC | 时区设置,可参考 时区列表 |
-e FG_LOG_LEVEL=info | FlexGet日志级别(如 info、debug) |
-e FG_LOG_FILE=/config/flexget.log | 日志文件存储路径 |
-e FG_CONFIG_FILE=/config/.flexget/config.yml | 配置文件路径 |
-e FG_WEBUI_PASSWORD=info | WebUI访问密码,注意避开Bash/YAML保留字符 |
-v /config | 本地配置文件目录映射 |
-v /data | 默认下载目录映射(可选) |
--read-only=true | 以只读文件系统运行容器,需配合 文档 配置 |
可通过 FILE__ 前缀从文件中读取环境变量,例如:
bash-e FILE__MYVAR=/run/secrets/mysecretvariable
上述命令会将 /run/secrets/mysecretvariable 文件内容作为 MYVAR 环境变量的值。
所有镜像支持通过 -e UMASK=022 覆盖默认 umask 设置(用于控制文件权限)。umask 为权限掩码,并非直接设置权限,具体说明参见 umask 文档。
使用 -v 映射卷时,主机与容器可能出现权限冲突。通过指定 PUID(用户ID)和 PGID(组ID)可解决此问题,确保主机卷目录所有者与容器内用户一致。
通过以下命令获取当前用户的 UID 和 GID:
bashid your_user
示例输出:
textuid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
此时 PUID=1000、PGID=1000。
可通过 Docker Mods 扩展容器功能,支持该镜像的 Mods 列表见 flexget Mods,通用 Mods 见 universal Mods。
bashdocker exec -it flexget /bin/bash
bashdocker logs -f flexget
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' flexget
bashdocker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/flexget:latest
容器需通过更新镜像并重建来升级应用(除非特定镜像说明支持内部更新)。
更新镜像:
docker-compose pulldocker-compose pull flexget更新容器:
docker-compose up -ddocker-compose up -d flexget清理旧镜像:docker image prune
拉取新镜像:docker pull lscr.io/linuxserver/flexget:latest
停止并删除旧容器:
bashdocker stop flexget docker rm flexget
使用原参数重建容器(配置文件通过卷映射保留)
清理旧镜像:docker image prune
[!TIP]
推荐使用 Diun 接收镜像更新通知,不建议使用自动更新工具。
如需自定义镜像,可按以下步骤本地构建:
bashgit clone [***] docker-flexget docker build \ --no-cache \ --pull \ -t lscr.io/linuxserver/flexget:latest .
跨架构构建(如 x86_64 构建 ARM 镜像)需先注册 qemu-static:
bashdocker run --rm --privileged lscr.io/linuxserver/qemu-static --reset
然后使用对应架构的 Dockerfile(如 -f Dockerfile.aarch64)。





manifest unknown 错误
TLS 证书验证失败
DNS 解析超时
410 错误:版本过低
402 错误:流量耗尽
身份认证失败错误
429 限流错误
凭证保存错误
来自真实用户的反馈,见证轩辕镜像的优质服务