imthai/qbittorrent-filebot

docker-qBittorrent-filebot

镜像概述和主要用途

本Docker镜像基于Ubuntu构建，集成了最新稳定版qBittorrent和Filebot工具，提供一站式媒体文件下载与自动化整理解决方案。适用于需要同时进行BT下载和媒体文件（电影、音乐、剧集、动漫等）规范化管理的场景，支持自定义文件命名格式和权限设置。

有关Filebot的更多信息，请访问[***]

核心功能和特性

• 集成qBittorrent与Filebot，实现下载与整理一体化
• 支持多类型媒体文件（电影、音乐、剧集、动漫）的自动分类与命名
• 可自定义文件命名格式、操作行为（复制、移动等）及冲突解决策略
• 支持文件权限管理，通过PUID/PGID配置用户及组权限
• 提供Web UI管理界面，便于远程操作

变量配置

可通过以下环境变量自定义容器行为：

重要注意事项

• PUID与PGID配置：需根据系统设置PUID和PGID，默认值（99/100）适用于unRAID的nobody/users。
• 命名格式说明：{plex}格式会将文件整理至特定文件夹（Movies、TV Shows、Music等）；使用{plex.id}格式会在文件夹名中包含数字ID，更适合机器识别。
• FILEBOT_ACTION注意事项：默认设为"copy"（复制），若改为"MOVE"（移动）或"HARDLINK"（硬链接），需按以下步骤调整配置：
  1. 使用单一通用挂载点，例如（unRAID系统）将/mnt/user（主机）挂载至/onemount（容器）：-v '/mnt/user':'/onemount':'rw'
  2. 在qBittorrent设置中调整下载文件夹为/onemount/downloads（对应主机/mnt/user/downloads）
  3. 修改/data/filebot目录下的fb.sh脚本，将输出路径改为/onemount/media（对应主机/mnt/user/media）
• Filebot许可证：将Filebot许可证文件（.psm文件）放入/data/filebot目录并重启容器。
• qBittorrent登录：默认登录名为"admin"，初始密码每次启动时生成（查看日志），建议设置永久密码。
• 自定义fb.sh脚本：在脚本中设置custom=1可防止重启时被覆盖。
• FILES_CHECK_PERM影响：设为"yes"可能显著增加启动时间。
• 端口修改注意事项：若在qBittorrent配置中修改默认端口，需同步更新Docker端口映射（使用独立IP或host网络模式除外）。

卷说明

端口映射

注意：使用Docker桥接网络模式时需映射上述端口；若使用独立IP或host网络模式，可忽略端口映射。

使用示例

sh
docker run -d --name='qbittorrent-filebot' \
--net='br0' --ip='10.3.12.21' --ip6='2a01:d33b:f44f:985a:10:2:12:21' \
-e TZ="Europe/Paris" \
-e 'FILEBOT_ACTION'='copy' \
-e 'FILEBOT_LANG'='en' \
-e 'MOVIE_FORMAT'='{plex}' \
-e 'SERIE_FORMAT'='{plex}' \
-e 'PUID'='99' \
-e 'PGID'='100' \
-v '/mnt/user/media/':'/media':'rw' \
-v '/mnt/user/downloads':'/downloads':'rw' \
-v '/mnt/user/appdata/qbittorrent-filebot/':'/data':'rw' \
'imthai/qbittorrent-filebot'

说明：示例使用自定义网络配置，实际部署时请根据自身网络环境和需求调整参数。