Home

Avdb 全部设置与功能特点

适用于当前 Avdb 设置页。配置会保存到服务端数据库；保存后对所有登录设备生效。

页面索引

所有主导航页与设置子页均有独立说明，可按实际页面直接阅读：

区域	独立页面
资源中心	资源总览 · 资源库 · 演员管理 · 任务计划 · 任务记录 · 下载记录
控制中心	访问令牌 · 关于程序
设置中心	下载工具 · Emby · 通知 · 个人 · 规则 · 网络 · 图片缓存 · 数据库

导航树	设置指南与功能介绍
开始前 ├─ 推荐顺序 └─ 配置依赖 资源库 ├─ 筛选与浏览 └─ 下载与播放 演员 ├─ 演员列表与详情 └─ 演员工具 任务 ├─ 任务计划 └─ 任务记录 令牌 └─ 外部 API 授权 工具 ├─ 下载器 └─ 支持的平台 Emby ├─ 连接与媒体库 ├─ 自动刷新与 Webhook └─ 演员资料补全 通知 ├─ Telegram └─ 企业微信 个人 └─ 账户安全 规则 └─ 自动下载 网络 ├─ 基础网络 ├─ MDC-NG └─ libtorrent 缓存 └─ 图片缓存 数据库 ├─ 导入与导出 └─ 清理数据 功能地图	Avdb 将采集、规则筛选、下载、媒体库联动与通知串成一条自动化链路。 通常只需先完成 下载器 → 规则 → Emby（可选）→ 通知（可选），再按实际网络与维护需求调整其余项目。 下面各节可按左侧导航直接跳转阅读。

---

开始前

推荐顺序

1. 在「工具」添加并测试至少一个下载器及保存目录。
2. 在「规则」创建筛选条件，指定下载器与目标路径。
3. 需要媒体库联动时，再配置「Emby」地址、API Key 和媒体库。
4. 最后按需开启 Telegram 或企业微信通知。

配置依赖

功能	前置条件	结果
规则自动下载	已保存的下载器与有效路径	资源命中规则后提交到指定下载器
Emby 匹配 / 演员管理	Emby 地址、API Key、媒体库 ID	可匹配入库影片、刷新媒体库、维护演员资料
演员资料补全	已启用 Emby；按需配置 TMDB	补齐头像、简介及相关资料
Webhook 通知	Emby 可访问 Avdb 的回调地址	媒体新增、删除时触发同步或通知
网络代理	可用的 HTTP / SOCKS5 代理	访问 GitHub、TMDB、Telegram 等外部服务时走指定链路

资源库

路径：资源中心 → 资源中心。资源库集中展示采集到的影片资源，并承接搜索、筛选、下载、入库状态和播放入口，是日常使用的主要页面。

筛选与浏览

可按关键字、站点、版块、分类、发布日期及库存状态过滤资源；已入 Emby、已从 Emby 删除等状态也可单独筛选。支持卡片和列表视图，常用过滤条件与视图偏好会保存，方便下次继续浏览。

资源卡片支持查看封面、简介、番号、分类与关联资源；同番号资源可合并查看，减少在不同来源间重复检索。

下载与播放

• 下载：选择已配置的下载器与保存目录后提交；开启快捷下载模式时，可复用最近一次选择并直接提交。
• 入库状态：启用 Emby 匹配后，资源会展示是否已入库及是否已从媒体库删除。
• 播放入口：已匹配到 Emby 的资源可直接打开对应播放页面。

资源库中的“已删除”描述的是 Emby 中的关联媒体状态，不等同于删除下载文件或删除资源库原始记录。

演员

路径：资源中心 → 演员管理。使用前需要在「Emby」中完成地址、API Key 和媒体库 ID 配置。演员页支持关键字搜索、分页浏览，以及随机 / 按序排序。

演员列表与详情

进入演员详情后，可查看头像、简介、别名、TMDB ID 和关联影片，并可执行头像更换 / 上传、名称和简介修改、单人重新匹配等操作。TMDB 资料保存前会校验名称或别名的精确匹配，避免错误覆盖。

删除演员会同步清理关联影片中的同名演员信息，属于不可恢复操作；修改前请先核对演员和影片的关联范围。

演员工具

演员工具面向批量维护，提供：

• 重名检测与合并：根据演员映射表检查重名，确认保留名称后合并；会修改 Emby 相关演员和影片信息。
• 幽灵演员管理：扫描没有关联影片的演员；确认删除时一并清理影片中的对应演员、同名标签和类型。
• 无头像演员管理：扫描、查看和批量处理无头像演员。
• 显示语言批量更新：按照演员映射表更新显示名称，并写入 Emby。
• 删除导演标签：可通过 Emby API 清理，或递归修改指定目录中的 NFO；NFO 模式完成后会请求媒体库刷新。

任务

路径：资源中心 → 任务计划。任务页用于创建、编辑、启用 / 停用和立即执行定时任务，执行周期使用 Cron 表达式，并提供预设周期和高级自定义模式。

任务计划

创建任务时选择任务规则、站点与执行范围，再设定运行周期。常见工作流包括：按增量游标采集、按页范围全量回填、按最近天数筛选候选资源后套用下载规则，以及对失败任务重试。

建议先使用「立即执行」验证站点访问、任务参数和规则命中结果；确认无误后再启用定时运行。避免给同一站点配置过于密集或重叠的全量任务，以免产生重复工作和无效压力。

任务记录

路径：资源中心 → 任务记录。这里记录任务运行状态、执行时间、成功与失败情况，并支持按任务过滤和导出记录。失败重试任务仅接受由任务记录导出的 JSON 格式，以确保站点和资源分组信息完整。

排查异常时，先查看任务记录确定失败阶段，再检查网络、站点配置、下载器和规则；不要直接反复新建相同任务。

令牌

路径：控制中心 → 访问令牌。令牌用于授权外部程序调用 Avdb 已开放的 API，而不是用于登录 Avdb 页面或替代第三方服务的 API Key。

外部 API 授权

1. 创建一个易识别的令牌标识，例如 db-online 或 home-automation。
2. 创建后立即复制令牌，在外部程序的请求 Header 中添加 X-API-Key: YOUR_API_TOKEN。
3. 在令牌页面查看当前开放接口及其参数；例如资源检索接口可由外部服务按番号查询。
4. 不再使用的令牌应立即删除；怀疑泄露时删除旧令牌并新建，勿仅修改标识。

令牌相当于访问凭证。不要放入截图、公开仓库、前端代码或不可信的第三方服务；每个外部用途使用独立令牌，以便单独撤销。

工具

下载器

路径：设置 → 工具。在这里为每个下载器填写连接信息、认证信息和可选保存目录。保存后，资源库手动下载和下载规则都可以复用该配置。

一个下载器可以配置多个目录；规则或手动提交时选择目标目录即可。修改下载器信息会即时生效，不需要重启整套服务。

支持的平台

平台	适合场景
qBittorrent	常规 BT 下载和长期做种
Transmission	轻量化或 NAS 环境
迅雷	已部署迅雷下载服务的场景
CloudNAS / CloudDrive	网盘或挂载盘工作流
115	115 相关下载、转存工作流

建议先用单条资源验证下载器连通性、目录权限和容器挂载路径，再开启批量规则。

Emby

连接与媒体库

路径：设置 → Emby。至少填写一个 Emby 公网地址或内网地址，以及 API Key；随后读取并多选需要由 Avdb 管理的媒体库 ID。

• 公网地址：供外部访问者打开 Emby 链接使用。
• 内网地址：供局域网 / 反向代理内的请求使用。
• 媒体库 ID：限定影片匹配、刷新和演员工具的操作范围，建议只选择目标影视库。
• 登录页背景：可用选中的 Emby 媒体库生成动态海报墙。

Avdb 会根据访问请求选择合适的内外网 Emby 地址；两者都填写时，局域网访问优先使用内网地址。

自动刷新与 Webhook

• 自动刷新：按设置的间隔刷新已选 Emby 媒体库，也可手动立即刷新。
• Webhook：让 Emby 在媒体新增或删除时回调 Avdb；建议配置签名或密钥校验，避免公开回调地址被滥用。
• Emby 匹配：将资源番号与媒体库项目关联，资源卡片可显示入库状态和播放入口。

演员资料补全

可按需开启演员头像、简介、性别、TMDB ID 等资料补齐，并将资料写入 Emby。支持手动启动、取消任务、完成通知，以及收到 Webhook 后自动触发。

演员管理页还提供头像更换 / 上传、重命名、删除、重名检测、无头像演员扫描和显示语言批量更新等工具。会直接影响 Emby 数据的操作应先确认媒体库范围，并做好配置导出。

通知

路径：设置 → 通知。通知模板支持变量，可分别控制新增媒体、删除媒体和下载任务等事件。

Telegram

填写 Bot Token、接收目标和通知模式后可发送测试通知。Telegram 同时支持轮询与 Webhook 工作方式，也能承接下载完成和 Emby 事件提醒。

企业微信

填写企业微信所需凭证并启用通知后，可使用独立模板推送 Emby 新增、删除和下载任务信息。配置完成后务必先发送测试通知，确认机器人权限与接收范围正确。

个人

账户安全

路径：设置 → 个人。用于维护账号凭证和个人资料。生产环境应使用独立的强密码，避免将 API Key、Bot Token 或代理认证信息截图、分享或提交到公开仓库。

规则

自动下载

路径：设置 → 规则。一条规则将「筛选条件」与「下载器、保存目录」组合起来，匹配的资源会被提交到指定目标。

常见条件包括站点版块、分类、关键字与时间窗口。建议从条件较严格的小范围规则开始，确认命中结果和落盘目录正确后再扩大范围；同一资源命中多条规则时，应避免配置互相冲突的目标路径。

网络

基础网络

路径：设置 → 网络 → 基础网络。

• 代理地址：支持 HTTP 代理，也支持 socks5:// 与 socks5h://；后者会通过 SOCKS5 解析 DNS，适合访问 GitHub、TMDB 等服务。
• 代理例外：填写不应走代理的地址或域名，避免本地 / 内网服务绕路。
• GitHub API Token：提高 GitHub API 请求限额，供资源库与版本相关请求使用。
• CF 过盾模式：按部署情况选择 TRAWL 或 FlareSolverr，并填写相应服务地址。

未填写代理时，Avdb 会显式直连，不继承容器环境中的通用代理变量。代理修改后，相关外部服务会按新配置工作，无需重启。

MDC-NG

用于对接 MDC-NG 容器和映射表。需要填写 容器名、映射表文件路径 与 Docker Socket。只有 Avdb 容器可访问 Docker Socket 且映射路径正确时，相关联动才可正常执行。

Docker Socket 权限很高。仅在确有 MDC-NG 联动需求时挂载，并限制其访问范围。

libtorrent

用于 libtorrent 相关的网络与解析行为调优，可设置：

• DHT 开关；
• 解析超时、轮询间隔、清理等待时间；
• Tracker 列表；
• 可选的自定义 DHT 引导节点。

普通使用保持默认即可。仅当磁力解析、Tracker 连通或下载器链路出现明确问题时，再逐项调整并记录原值，避免同时改动多个变量而难以排查。

缓存

图片缓存

路径：设置 → 缓存。用于设置图片缓存过期时间和自动清理间隔，减少重复拉取头像、封面等图片，同时避免缓存长期占用磁盘。

• 磁盘空间充足、网络较慢：可适当延长过期时间。
• 图片更新频繁或磁盘受限：缩短过期时间和清理间隔。
• 清理缓存只影响本地缓存文件；下次访问时会重新获取图片。

数据库

导入与导出

路径：设置 → 数据库。支持导出全部设置、导入已有设置和恢复初始设置。迁移机器、升级前或批量调整前，优先导出一份设置作为回滚点。

导出的设置含运行环境相关信息；导入到另一台机器后，请检查下载目录、服务地址、API Key、代理和 Docker 挂载是否仍然有效。

清理数据

数据库页可清理任务记录、下载记录、站点资源、演员映射表或资源库数据。此类操作可能不可逆，并会影响页面展示、历史追踪和自动匹配结果。

执行前请确认清理范围；涉及资源库、演员映射表或全部设置时，建议先完成导出。清理数据库记录不会自动删除下载器中的文件或 Emby 中的媒体。

功能地图

站点采集 ──> 资源库 ──> 下载规则 ──> 下载器 / 保存目录
    │                           │
    │                           ├──> 下载完成通知
    │                           │
    └──> Emby 匹配 ──> 媒体库刷新 ──> 演员资料补全 / 管理
                                    │
                                    └──> Emby 事件通知

Avdb 的核心特点是将采集、筛选、下载、入库与通知保持在一个可配置的工作流中。设置页中的每一项都服务于这条链路：下载器决定资源去向，规则决定自动化条件，Emby 承接媒体库体验，网络保证外部服务可达，缓存与数据库则负责运行维护。