1. 项目缘起从“追番焦虑”到自动化解决方案作为一个老二次元我敢说每个追番人都有过类似的烦恼每周要手动去各个平台、论坛、资源站翻找最新一集生怕错过更新遇到喜欢的冷门作品更是要像侦探一样四处搜寻蛛丝马迹。这种“追番焦虑”不仅耗时耗力还常常因为信息滞后而错过第一时间观看的乐趣。直到我遇到了 QClaw一个开源的、高度可定制的智能追踪与推送工具它彻底改变了我的追番方式。简单来说QClaw 就像一个不知疲倦的、24小时在线的动漫情报员。它的核心能力是根据你设定的规则比如番剧名称、字幕组、分辨率等自动在指定的目标网站如动漫花园、蜜柑计划等 BT 站点或是一些特定的资源库上进行扫描和匹配。一旦发现符合条件的新资源它就会立刻通过你预设的渠道比如 Telegram Bot、邮件、Webhook 等向你发出通知甚至可以直接联动下载工具如 qBittorrent、Transmission进行自动下载。整个过程完全自动化将你从繁琐的重复劳动中解放出来。网络上关于 QClaw 的讨论常常和“mx动漫”、“玖逸动漫库”、“动漫花园(dmhy)”这些资源站的名字联系在一起也侧面说明了它的应用场景。它解决的正是信息获取的“最后一公里”问题——你不用再主动去“找”资源更新会主动来“找你”。无论是追当季热门新番如《租借女友》还是补一些经典老番甚至是寻找特定的字幕组版本QClaw 都能大显身手。接下来我将结合自己数月的部署和使用经验带你从零开始打造一个属于你自己的、高度个性化的动漫智能追踪与推送系统。2. 核心组件解析QClaw 是如何工作的在动手部署之前理解 QClaw 的核心架构和工作流程至关重要。这能帮助你在后续配置时知其然更知其所以然遇到问题也能快速定位。QClaw 本质上是一个基于规则的信息过滤与聚合引擎其核心逻辑可以拆解为四个部分抓取器Crawler、解析器Parser、过滤器Filter和通知器Notifier。2.1 抓取器与解析器信息的“眼睛”与“大脑”抓取器负责从目标数据源获取原始的、结构化的数据通常是 RSS 订阅源或网页。对于动漫资源来说最常用的数据源就是各大 BT 站点的 RSS。例如动漫花园 (dmhy) 就为每个分类、每个关键词提供了 RSS 链接。抓取器会定期可配置如每10分钟去请求这些 RSS 链接获取包含最新种子信息的 XML 数据。然而原始的 RSS 数据只是一段文本。解析器的任务就是将这些文本“翻译”成程序能够理解的、结构化的信息对象。它会从 RSS 的每个item条目中提取出标题、链接、发布时间、文件大小等关键字段。这里的一个核心挑战在于不同站点的 RSS 格式、标题命名规则千差万别。例如一个典型的资源标题可能是“[Lilith-Raws] 租借女友 / Kanojo, Okarishimasu S04 - 01 [Baha][WEB-DL][1080p][AVC AAC][CHT][MP4]”。解析器需要能识别出其中的番剧名“租借女友”、季数“S04”、集数“01”、字幕组“Lilith-Raws”、分辨率“1080p”等信息。QClaw 内置了针对多个主流站点的解析规则也允许用户通过正则表达式进行自定义这是其强大灵活性的基础。2.2 过滤器精准匹配的“守门人”抓取并解析出大量资源信息后过滤器就开始工作了。这是整个系统的“决策中枢”直接决定了哪些资源是你真正需要的。过滤规则是 QClaw 配置的核心通常包括以下几个方面关键词匹配最基本也最常用的规则。你可以设置必须包含must_contain或必须排除must_not_contain某些关键词。例如must_contain: [“租借女友”, “1080p”]must_not_contain: [“先行”, “生肉”]。这里的匹配通常是针对解析后的“标题”字段进行的。字段精确匹配基于解析器提取出的结构化字段进行更精确的过滤。比如你可以指定resolution: “1080p”subgroup: “Lilith-Raws”。这比在标题中模糊匹配“1080p”要准确得多。正则表达式提供最强大的匹配能力。例如如果你想精准匹配《租借女友》第四季的所有集数可以设置正则规则匹配标题中的“租借女友.*S04.*\d{2}”。这对于处理那些标题格式不规则的资源非常有效。其他条件还可以过滤文件大小避免下载体积过大的合集、发布时间只关注最近24小时的新资源等。一个资源条目必须通过你为某个“任务”设置的所有过滤规则才会被视为有效命中进入下一个环节。2.3 通知器与动作执行结果的“信使”与“执行者”当过滤器筛选出目标资源后通知器负责将结果告知你。QClaw 支持多种通知方式Telegram Bot最流行、最即时的方式。配置好 Bot Token 和 Chat ID 后QClaw 会将匹配到的资源信息包括标题、链接等以格式化的消息发送到你的 Telegram。邮件较为传统但可靠的方式。Webhook允许你自定义 HTTP 回调将数据推送到任何兼容的服务器实现更复杂的集成比如自动写入数据库、触发其他自动化流程等。除了通知QClaw 更强大的功能在于可以执行“动作”。最常见的动作就是自动下载。它可以与下载工具如 qBittorrent的 Web API 集成。一旦资源匹配成功QClaw 会直接将种子的下载链接或磁力链接推送给下载工具并开始下载到指定目录。这样从资源发布到存入你的硬盘全程无需人工干预。注意自动下载功能非常便利但请务必谨慎设置过滤规则并确保你的下载工具做好了分类和存储管理否则容易导致大量非预期内容被下载占用磁盘空间。3. 实战部署从零搭建你的 QClaw 系统理解了原理我们开始动手。部署 QClaw 有多种方式这里我推荐使用Docker Compose部署这是最简洁、最易于管理和维护的方式能很好地处理 QClaw 本身及其可能依赖的数据库如 Redis用于去重和缓存之间的关系。3.1 环境准备与文件配置首先确保你的服务器或本地电脑已经安装了 Docker 和 Docker Compose。接下来我们需要创建核心配置文件。创建项目目录在你的工作空间如/opt/qclaw下创建以下目录结构/opt/qclaw/ ├── config/ │ └── config.yml # QClaw 主配置文件 ├── data/ # 用于持久化数据如果需要 └── docker-compose.yml编写docker-compose.yml这个文件定义了服务。version: 3.8 services: qclaw: image: qclaw/qclaw:latest # 使用官方镜像 container_name: qclaw restart: unless-stopped volumes: - ./config:/app/config # 挂载配置文件目录 # - ./data:/app/data # 如果需要持久化数据取消注释 ports: - “8080:8080” # 将容器内Web UI端口映射到主机8080 environment: - TZAsia/Shanghai # 设置容器时区非常重要关系到定时任务 command: [“serve”] # 启动命令运行主服务这里我们将本地的./config目录映射到容器的/app/config这样我们放在./config下的config.yml就能被 QClaw 读取。编写核心config.yml这是 QClaw 的灵魂。一个最基础的、包含一个追踪任务和 Telegram 通知的配置示例如下# config/config.yml log: level: INFO # 通知器配置 notifiers: telegram: token: “YOUR_BOT_TOKEN_HERE” # 从 BotFather 获取 chat_id: “YOUR_CHAT_ID_HERE” # 与你的 Bot 对话后通过特定 API 获取 template: | 发现新资源 标题{{ title }} 大小{{ size }} 链接{{ url }} 发布时间{{ publish_time }} # 任务配置 tasks: - name: “track_rental_girlfriend_s04” # 任务名称 interval: “*/10 * * * *” # 执行间隔Cron 表达式每10分钟一次 source: - type: rss url: “https://share.dmhy.org/topics/rss/rss.xml?keyword租借女友” # 动漫花园的 RSS filters: - must_contain: [“S04”] # 必须包含 S04第四季 - must_not_contain: [“先行”, “生肉”, “AVI”] # 排除先行版、无字幕版和 AVI 格式 - field_match: resolution: “1080p” # 分辨率要求 1080p notifiers: - telegram # 使用上面定义的 telegram 通知器 # actions: # 如果需要自动下载配置 actions # - type: qbittorrent # host: http://your-qbittorrent-host:8080 # username: admin # password: your_password # category: “Anime” # 在 qBittorrent 中分类关键点解析interval使用了 Cron 表达式*/10 * * * *表示每10分钟执行一次抓取和过滤任务。不建议设置得过短以免对目标站点造成压力。source.url这里以动漫花园为例。你需要根据实际想追踪的内容组合关键词。RSS 链接的格式通常是固定的可以通过在网站搜索后观察其 RSS 订阅链接获得。filters过滤规则是层层递进的。上述配置意味着首先标题必须包含“S04”然后不能包含“先行”等词最后解析出的resolution字段必须是“1080p”。只有全部满足才会触发通知。notifiers和actions通知和动作是分开的。你可以只通知也可以通知的同时执行下载动作。自动下载需要额外配置下载工具的连接信息。3.2 获取与配置 Telegram BotTelegram 通知是体验最佳的方式。配置步骤如下在 Telegram 中搜索BotFather发送/newbot指令按照提示创建你的 Bot最终你会获得一个HTTP API Token这就是配置文件中的token。获取chat_id和你刚创建的 Bot 发起对话随便发一条消息如/start。然后在浏览器访问这个 URL将YOUR_BOT_TOKEN替换为你的 Tokenhttps://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates在返回的 JSON 数据中找到message.chat.id字段的值那个数字就是你的chat_id。将token和chat_id填入config.yml的对应位置。3.3 启动与验证服务配置完成后在项目目录 (/opt/qclaw) 下执行命令启动服务docker-compose up -d使用docker-compose logs -f qclaw可以实时查看日志检查是否有配置错误或启动失败。如果一切正常访问http://你的服务器IP:8080应该能看到 QClaw 的 Web UI如果镜像提供。在日志中你应该能看到类似“Task ‘track_rental_girlfriend_s04’ started”和按计划执行的信息。你可以手动修改 RSS 链接中的关键词追踪一个当前正在更新的番剧进行测试。当目标站点有新资源发布时你的 Telegram 就会收到一条格式化的消息了。4. 高级配置与个性化技巧基础系统跑通后我们可以让它变得更强大、更智能更贴合个人需求。这部分是区分“能用”和“好用”的关键。4.1 多源聚合与去重策略你肯定不想只盯着一两个站点。QClaw 支持在一个任务中配置多个数据源。tasks: - name: “track_popular_anime_multi_source” source: - type: rss url: “https://share.dmhy.org/...rss.xml?keyword咒术回战” - type: rss url: “https://mikanime.tv/RSS/Search?searchword咒术回战” # 蜜柑计划 - type: rss url: “https://acg.rip/.xml?term咒术回战” # acg.rip这样QClaw 会并行抓取这三个源极大提高覆盖率和时效性。但随之而来的是去重问题同一个资源可能被多个站点发布标题略有不同。QClaw 通常内置基于资源链接url或信息哈希的去重机制确保同一资源只通知或下载一次。在配置中你可以关注deduplication相关的设置项确保其开启。4.2 复杂过滤正则表达式与逻辑组合面对五花八门的标题基础的关键词匹配有时会力不从心。这时就需要正则表达式出场。场景一精准匹配特定季的特定集数。假设你想精确匹配《咒术回战 第二季》的第5到第10集且是某个特定字幕组。filters: - must_contain: [“咒术回战”, “S02”] - regex: title: “.*(0[5-9]|10).*” # 匹配集数 05,06,07,08,09,10 - field_match: subgroup: “桜都字幕组”这个regex规则确保了集数在5-10之间避免了匹配到总集数回顾或特别篇。场景二排除多种不想要的版本。filters: - must_not_contain: [“先行”, “生肉”, “无修”, “AVI”, “WMV”, “剧场版”, “总集篇”] - regex: title: “^(?!.*(SP|Special|OVA)).*$” # 排除标题中含有SP/Special/OVA的非贪婪匹配这里结合了关键词排除和正则排除能过滤掉大部分非正片内容。4.3 与下载工具深度集成分类与标签自动化仅仅自动下载还不够良好的文件管理同样重要。以 qBittorrent 为例你可以在 QClaw 的 action 配置中实现自动化分类。actions: - type: qbittorrent host: “http://192.168.1.100:8080” username: “admin” password: “your_secure_password” save_path: “/data/Downloads/Anime” # 默认保存路径 category: “{{ series_name }}” # 动态分类使用解析出的番剧名 tags: [“auto-added”, “qclaw”] # 自动添加标签便于在 qBittorrent 内筛选这里的{{ series_name }}是一个模板变量QClaw 在解析资源标题时如果成功提取出了番剧名就会用实际值如“咒术回战”替换它。这样不同番剧的种子会自动被下载到 qBittorrent 中名为“咒术回战”的分类下管理起来一目了然。重要安全提示配置文件中的密码等敏感信息强烈建议不要明文写入。可以通过 Docker Compose 的environment部分设置环境变量在config.yml中使用{{ env(‘QB_PASSWORD’) }}的方式引用。或者使用 Docker Secrets 等更安全的管理方式。4.4 错误处理与监控自动化系统必须考虑稳定性。你需要关注以下几点日志级别在config.yml中将log.level设置为DEBUG可以获取最详细的运行信息便于排错。生产环境可设为INFO或WARN。网络异常处理QClaw 内置重试机制但如果你的服务器网络不稳定可能导致任务持续失败。可以观察日志中是否有连接超时 (TimeoutError) 或拒绝连接 (ConnectionRefusedError) 的错误。资源解析失败如果某个站点的 RSS 结构发生变化或者标题格式无法被内置解析器识别日志中会出现ParserError或匹配失败警告。此时你可能需要等待作者更新或者尝试自己编写自定义解析规则如果 QClaw 支持该功能。监控通知除了资源通知你还可以考虑设置一个“心跳”任务或使用第三方监控工具如 Uptime Kuma来监控 QClaw 服务本身是否在正常运行。5. 常见问题排查与优化心得在实际使用中你肯定会遇到一些“坑”。下面是我总结的一些典型问题及其解决方案。5.1 收不到通知一步步诊断这是最常见的问题。请按以下顺序排查检查容器状态与日志docker-compose ps确认容器是Up状态。docker-compose logs --tail50 qclaw查看最近日志是否有明显的配置错误如 YAML 格式错误、网络连接错误或认证失败。验证任务是否执行在日志中搜索你的任务名如track_rental_girlfriend_s04看是否有“Task started”和“Finished fetching”的记录。如果没有检查interval的 Cron 表达式是否正确以及系统时间/时区。验证过滤条件是否过严在日志中任务执行后通常会显示扫描到了多少条目 (items fetched)以及经过过滤后剩余多少条目 (items after filter)。如果items after filter始终为 0说明你的过滤规则可能太严格把有效资源也排除了。尝试暂时简化或注释掉部分filters看是否能收到通知。检查通知器配置Telegram确认token和chat_id完全正确没有多余空格。确认 Bot 已启动并与它有过对话。可以在服务器上用curl命令模拟 Bot 发送一条消息测试 Token 和 Chat ID 是否有效。网络连通性确保运行 QClaw 的服务器能够正常访问 Telegram 的 API (api.telegram.org)。如果服务器在国内这可能是一个常见障碍需要考虑网络环境配置。检查源 RSS 是否有效直接将config.yml中source.url的地址复制到浏览器中打开看是否能返回有效的、包含近期种子的 RSS XML 内容。如果 RSS 链接本身失效或返回空那自然是无结果的。5.2 误报或漏报优化过滤规则误报抓到不想要的内容通常是must_contain关键词太宽泛或must_not_contain排除不够。例如只包含“女友”可能会抓到《女朋友 and 女朋友》。解决方案是使用更精确的关键词组合或者引入正则表达式进行更严格的匹配。利用field_match比单纯匹配标题更精确。漏报没抓到想要的内容原因可能更复杂。标题解析失败QClaw 的解析器没能从标题中正确提取出series_name、season、episode等字段导致你的field_match规则失效。查看日志中解析后的条目详情确认字段提取是否正确。如果不正确可能需要等待解析器更新或寻找该站点其他格式的 RSS 源。延迟问题RSS 源本身更新有延迟或者你的抓取间隔 (interval) 刚好错过了更新窗口。适当缩短间隔但需保持礼貌如从10分钟调到5分钟或添加多个冗余数据源。站点反爬频繁的请求可能触发目标站点的反爬机制返回错误页面或空数据。确保你的请求频率在合理范围内可以考虑在配置中添加delay请求延迟或使用代理。5.3 性能与维护建议任务数量与间隔不要创建过多任务或设置过短的执行间隔。每个任务都会产生网络请求和解析开销。将同类番剧的追踪尽量合并到同一个任务的多源中而非为每个番剧创建独立任务。使用 Redis 缓存对于生产环境建议启用 Redis 作为缓存和去重后端。这能显著提升性能并在服务重启后保持去重状态。需要在docker-compose.yml中添加 Redis 服务并在 QClaw 配置中连接它。配置版本管理将你的config.yml和docker-compose.yml纳入 Git 等版本控制系统。每次修改前做好备份方便回滚和追踪变更历史。定期更新镜像关注 QClaw 官方镜像的更新定期执行docker-compose pull和docker-compose up -d来获取新功能、修复和安全更新。经过以上步骤你应该已经拥有了一个7x24小时稳定运行的个人动漫智能追踪中心。它就像一位忠诚的管家默默为你关注着所有感兴趣的番剧动态。从此追番不再是需要惦记的“任务”而是一种随时收获惊喜的体验。当 Telegram “叮”的一声响起告诉你期待已久的最新一集已经找到并开始下载时那种感觉才是科技服务于爱好的最佳诠释。