binhex-official-qbit-guard

binhex-official-qbit-guard

Docker 应用程序 from Binhex's Repository

概述

A zero-dependency Python guard for qBittorrent that blocks pre-air TV episodes (Sonarr), deletes ISO/BDMV-only torrents, and auto-blocklists bad releases in Sonarr/Radarr (with dedupe + queue failover). Runs on "torrent added", fetches metadata safely, and logs everything to stdout.

运行时参数

网络
bridge
外壳
bash
特权
false

模板配置

Variable: QBIT_HOSTVariable

qBittorrent WebUI URL

目标
QBIT_HOST
默认值
http://127.0.0.1:8080
Variable: QBIT_USERVariable

qBittorrent WebUI username

目标
QBIT_USER
默认值
admin
Variable: QBIT_PASSVariable

qBittorrent WebUI password

目标
QBIT_PASS
默认值
adminadmin
Variable: QBIT_ALLOWED_CATEGORIESVariable

Comma-separated list of categories to process

目标
QBIT_ALLOWED_CATEGORIES
默认值
radarr,tv-sonarr
Variable: QBIT_DELETE_FILESVariable

Delete files when removing torrents

目标
QBIT_DELETE_FILES
默认值
true|false
Variable: QBIT_IGNORE_TLSVariable

Set to 1 to ignore SSL certificate errors

目标
QBIT_IGNORE_TLS
默认值
0|1
Variable: QBIT_DRY_RUNVariable

Set to 1 for testing mode (no actual deletions)

目标
QBIT_DRY_RUN
默认值
0|1
Variable: WATCH_POLL_SECONDSVariable

How often to check qBittorrent for new torrents (seconds)

目标
WATCH_POLL_SECONDS
默认值
3.0
Variable: WATCH_PROCESS_EXISTING_AT_STARTVariable

Process existing torrents when container starts (0 or 1)

目标
WATCH_PROCESS_EXISTING_AT_START
默认值
0|1
Variable: WATCH_RESCAN_KEYWORDVariable

Keyword in category/tags to force reprocessing

目标
WATCH_RESCAN_KEYWORD
默认值
rescan
Variable: ENABLE_PREAIR_CHECKVariable

Enable pre-air checking (0 or 1)

目标
ENABLE_PREAIR_CHECK
默认值
1|0
Variable: SONARR_URLVariable

Sonarr base URL

目标
SONARR_URL
默认值
http://127.0.0.1:8989
Variable: SONARR_APIKEYVariable

Sonarr API key

目标
SONARR_APIKEY
Variable: SONARR_CATEGORIESVariable

Categories to apply pre-air checks to

目标
SONARR_CATEGORIES
默认值
tv-sonarr
Variable: EARLY_GRACE_HOURSVariable

Allow releases this many hours before air date

目标
EARLY_GRACE_HOURS
默认值
6
Variable: EARLY_HARD_LIMIT_HOURSVariable

Block releases more than this many hours early

目标
EARLY_HARD_LIMIT_HOURS
默认值
72
Variable: WHITELIST_OVERRIDES_HARD_LIMITVariable

Let whitelisted releases bypass hard limit (0 or 1)

目标
WHITELIST_OVERRIDES_HARD_LIMIT
默认值
0|1
Variable: EARLY_WHITELIST_GROUPSVariable

Comma-separated list of trusted release groups

目标
EARLY_WHITELIST_GROUPS
Variable: EARLY_WHITELIST_INDEXERSVariable

Comma-separated list of trusted indexers

目标
EARLY_WHITELIST_INDEXERS
Variable: EARLY_WHITELIST_TRACKERSVariable

Comma-separated list of trusted trackers

目标
EARLY_WHITELIST_TRACKERS
Variable: RESUME_IF_NO_HISTORYVariable

Proceed if Sonarr history not found (0 or 1)

目标
RESUME_IF_NO_HISTORY
默认值
1|0
Variable: SONARR_TIMEOUT_SECVariable

HTTP timeout for Sonarr API calls

目标
SONARR_TIMEOUT_SEC
默认值
45
Variable: SONARR_RETRIESVariable

Retry attempts for Sonarr operations

目标
SONARR_RETRIES
默认值
3
Variable: RADARR_URLVariable

Radarr base URL

目标
RADARR_URL
默认值
http://127.0.0.1:7878
Variable: RADARR_APIKEYVariable

Radarr API key

目标
RADARR_APIKEY
Variable: RADARR_CATEGORIESVariable

Categories to apply Radarr blocklisting to

目标
RADARR_CATEGORIES
默认值
radarr
Variable: RADARR_TIMEOUT_SECVariable

HTTP timeout for Radarr API calls

目标
RADARR_TIMEOUT_SEC
默认值
45
Variable: RADARR_RETRIESVariable

Retry attempts for Radarr operations

目标
RADARR_RETRIES
默认值
3
Variable: INTERNET_CHECK_PROVIDERVariable

Provider selection: off, tvmaze, tvdb, or both

目标
INTERNET_CHECK_PROVIDER
默认值
tvmaze|tvdb|both|off
Variable: TVMAZE_BASEVariable

TVmaze API base URL

目标
TVMAZE_BASE
默认值
https://api.tvmaze.com
Variable: TVMAZE_TIMEOUT_SECVariable

HTTP timeout for TVmaze API calls

目标
TVMAZE_TIMEOUT_SEC
默认值
8
Variable: TVDB_BASEVariable

TheTVDB API base URL

目标
TVDB_BASE
默认值
https://api4.thetvdb.com/v4
Variable: TVDB_APIKEYVariable

TheTVDB API key (required for TVDB)

目标
TVDB_APIKEY
Variable: TVDB_PINVariable

TheTVDB PIN (optional)

目标
TVDB_PIN
Variable: TVDB_LANGUAGEVariable

Language code for TheTVDB

目标
TVDB_LANGUAGE
默认值
eng
Variable: TVDB_ORDERVariable

Episode order: default or official

目标
TVDB_ORDER
默认值
default|official
Variable: TVDB_TIMEOUT_SECVariable

HTTP timeout for TheTVDB API calls

目标
TVDB_TIMEOUT_SEC
默认值
8
Variable: TVDB_BEARERVariable

Reuse existing bearer token (optional)

目标
TVDB_BEARER
Variable: ENABLE_ISO_CHECKVariable

Enable ISO/disc image cleanup (0 or 1)

目标
ENABLE_ISO_CHECK
默认值
1|0
Variable: MIN_KEEPABLE_VIDEO_MBVariable

Minimum size for video files to keep (MB)

目标
MIN_KEEPABLE_VIDEO_MB
默认值
50
Variable: METADATA_POLL_INTERVALVariable

Seconds between file list checks during metadata fetching

目标
METADATA_POLL_INTERVAL
默认值
1.5
Variable: METADATA_MAX_WAIT_SECVariable

Max wait for metadata resolution (0 = infinite)

目标
METADATA_MAX_WAIT_SEC
默认值
0
Variable: METADATA_DOWNLOAD_BUDGET_BYTESVariable

Max bytes to download during metadata wait (0 = no limit)

目标
METADATA_DOWNLOAD_BUDGET_BYTES
默认值
0
Variable: GUARD_EXT_STRATEGYVariable

Extension strategy: block or allow

目标
GUARD_EXT_STRATEGY
默认值
block|allow
Variable: GUARD_ALLOWED_EXTSVariable

Comma-separated list of allowed extensions (for allow mode)

目标
GUARD_ALLOWED_EXTS
Variable: GUARD_BLOCKED_EXTSVariable

Comma-separated list of blocked extensions (overrides defaults in block mode)

目标
GUARD_BLOCKED_EXTS
Variable: GUARD_EXT_DELETE_IF_ALL_BLOCKEDVariable

Delete only if all files are disallowed (0 or 1)

目标
GUARD_EXT_DELETE_IF_ALL_BLOCKED
默认值
1|0
Variable: GUARD_EXT_DELETE_IF_ANY_BLOCKEDVariable

Delete if any file is disallowed (0 or 1)

目标
GUARD_EXT_DELETE_IF_ANY_BLOCKED
默认值
0|1
Variable: GUARD_EXT_VIOLATION_TAGVariable

Tag applied to torrents deleted for extension violations

目标
GUARD_EXT_VIOLATION_TAG
默认值
trash:ext
Variable: GUARD_DISC_EXTSVariable

Disc image extensions

目标
GUARD_DISC_EXTS
默认值
iso,img,mdf,nrg,cue,bin
Variable: GUARD_EXTS_FILEVariable

Path to JSON config file (optional)

目标
GUARD_EXTS_FILE
Variable: LOG_LEVELVariable

Logging verbosity: INFO or DEBUG

目标
LOG_LEVEL
默认值
INFO|DEBUG
Variable: USER_AGENTVariable

HTTP User-Agent string for API calls

目标
USER_AGENT
默认值
qbit-guard/2.0

详细信息

存储库
ghcr.io/gengines/qbit-guard
最后更新2026-05-31
初见2025-08-28

在Unraid 上运行 binhex-official-qbit-guard 。

binhex-official-qbit-guard 已被列入Unraid OS 的社区应用程序。探索Unraid ,构建灵活的家庭服务器、NAS 或家庭实验室。