Auto_Bangumi Documentation

Python anime & auto-downloader repository by @EstrellaXD. AI agent rules & system prompts with 8.1k stars.

8,139 stars Python Python 1 file · ~3,989 tokens #anime#auto-downloader#docker#python#qbittorrent#rss-parser
RAW Doc

Docker & Self-Hosted Deployment Verified OCI

Deploy Auto_Bangumi on any server, homelab, or cloud container platform.

1-Click Terminal Command
bash (docker run)
docker run -d --name auto_bangumi --restart always ghcr.io/estrellaxd/auto_bangumi:latest
Configured Services & Ports
⚙️ qbittorrent
image: linuxserver/qbittorrent
⚙️ AutoBangumi
image: ghcr.io/estrellaxd/auto_bangumi:latest
docker-compose.yml
yaml (docker-compose.yml)
version: "3.4"
services:
  qbittorrent:
    container_name: qbittorrent
    image: linuxserver/qbittorrent
    hostname: qbittorrent
    environment:
      - PGID=$(id -g)
      - PUID=$(id -u)
      - TZ=Asia/Shanghai
    volumes:
      - ./qb_config:/config
      - :/downloads # 注意 修改此处为自己存放动漫的目录,ab 内下载路径填写downloads
    network_mode: bridge
    restart: unless-stopped

  AutoBangumi:
    image: "ghcr.io/estrellaxd/auto_bangumi:latest"
    container_name: AutoBangumi
    depends_on:
      - qbittorrent
    volumes:
      - ./config:/app/config
      - ./data:/app/data
    network_mode: bridge
    dns:
      - 223.5.5.5
    # 应用内“一键更新”依赖此重启策略:更新后容器会自行退出,由 Docker 重启
    # 以应用更新,因此必须保留 restart: unless-stopped。
    restart: unless-stopped
    logging:
      driver: json-file
      options:
        max-size: "10m"
        max-file: "3"
    environment:
      - TZ=Asia/Shanghai
      - PGID=$(id -g)
      - PUID=$(id -u)
      - UMASK=022

1. Project Overview & Quickstart (EstrellaXD/Auto_Bangumi)

File: README.md

项目说明

本项目是基于 RSS 的全自动追番整理下载工具。只需要在 Mikan Project 等网站上订阅番剧,就可以全自动追番。
并且整理完成的名称和目录可以直接被 Plex、Jellyfin 等媒体库软件识别,无需二次刮削。

AutoBangumi 功能说明

核心功能

  • 简易单次配置就能持续使用

  • 无需介入的 RSS 解析器,解析番组信息并且自动生成下载规则

  • 首次运行设置向导,7 步引导完成配置

  • 番剧文件整理:

    text
    Bangumi
    ├── bangumi_A_title
    │   ├── Season 1
    │   │   ├── A S01E01.mp4
    │   │   ├── A S01E02.mp4
    │   │   ├── A S01E03.mp4
    │   │   └── A S01E04.mp4
    │   └── Season 2
    │       ├── A S02E01.mp4
    │       ├── A S02E02.mp4
    │       ├── A S02E03.mp4
    │       └── A S02E04.mp4
    ├── bangumi_B_title
    │   └─── Season 1
  • 全自动重命名,重命名后 99% 以上的番剧可以直接被媒体库软件直接刮削

    text
    [Lilith-Raws] Kakkou no Iinazuke - 07 [Baha][WEB-DL][1080p][AVC AAC][CHT][MP4].mp4 
    >>
     Kakkou no Iinazuke S01E07.mp4
  • 自定义重命名,可以根据上级文件夹对所有子文件重命名。

  • 季中追番可以补全当季遗漏的所有剧集

  • 高度可自定义的功能选项,可以针对不同媒体库软件微调

  • 支持多种 RSS 站点,支持聚合 RSS 的解析

  • 无需维护完全无感使用

  • 内置 TMDB 解析器,可以直接生成完整的 TMDB 格式的文件以及番剧信息

3.3 新功能

  • 程序内更新:在日志页面检查、应用和回滚更新,并进行 sha256 与 ed25519 签名校验
  • 多供应商 LLM 解析器:支持 OpenAI 兼容接口、Anthropic Claude、Google Gemini,并提供 fallback / primary 模式
  • aria2 一等下载器支持:支持添加、查询、重命名、管理与重复检测,不再只是简单添加任务
  • 剧场版 / OVA / Special 支持:自动识别电影、OVA、OAD、SP 等类型并按媒体库友好的结构整理
  • 单番发布偏好:可为单个番剧设置字幕组与分辨率偏好,避免同集多字幕组重复下载
  • SSE 驱动的 WebUI:状态、下载器与日志页面改用事件流更新,减少轮询并提升稳定性
  • 安全与架构升级:全异步后端、加固的认证栈、健康检查和更可靠的数据库迁移

[Roadmap](https://github.com/users/EstrellaXD/projects/2)

已支持的下载器:

  • qBittorrent
  • aria2

Star History

贡献

欢迎提供 ISSUE 或者 PR, 贡献代码前建议阅读 CONTRIBUTING.md。

贡献者名单请见:

Licence

MIT licence


File: docs/home/index.md


title: 关于

关于 AutoBangumi

AutoBangumi 是一款基于 RSS 订阅的全自动番剧下载和整理工具。只需在 Mikan Project 或类似网站订阅番剧,即可自动追踪和下载最新剧集。

整理后的文件名和目录结构可直接兼容 Plex、Jellyfin 等媒体库软件,无需额外的元数据刮削。

功能特性

  • 简单的一次性配置,持续使用

  • 无需操心的 RSS 解析器,可提取番剧信息并自动生成下载规则

  • 番剧文件整理:

    text
    Bangumi
    ├── bangumi_A_title
    │   ├── Season 1
    │   │   ├── A S01E01.mp4
    │   │   ├── A S01E02.mp4
    │   │   ├── A S01E03.mp4
    │   │   └── A S01E04.mp4
    │   └── Season 2
    │       ├── A S02E01.mp4
    │       ├── A S02E02.mp4
    │       ├── A S02E03.mp4
    │       └── A S02E04.mp4
    ├── bangumi_B_title
    │   └─── Season 1
  • 全自动重命名——超过 99% 的番剧文件在重命名后可被媒体库软件直接刮削

    text
    [Lilith-Raws] Kakkou no Iinazuke - 07 [Baha][WEB-DL][1080p][AVC AAC][CHT][MP4].mp4
    >>
    Kakkou no Iinazuke S01E07.mp4
  • 基于父文件夹名称自定义重命名所有子文件

  • 季中追番补全当季所有缺失剧集

  • 高度自定义选项,可针对不同媒体库软件进行微调

  • 零维护,完全透明运行

  • 内置 TMDB 解析器,可生成完整的 TMDB 格式文件和番剧元数据

  • 支持 Mikan RSS 订阅的反向代理

社区

致谢

感谢 Sean 对项目的大力帮助。

参与贡献

欢迎提交 Issues 和 Pull Requests!

免责声明

由于 AutoBangumi 通过非官方版权渠道获取番剧:

  • 请勿将 AutoBangumi 用于商业用途。
  • 请勿制作包含 AutoBangumi 的视频内容并在国内视频平台(版权相关方)上发布。
  • 请勿将 AutoBangumi 用于任何违反法律法规的活动。

AutoBangumi 仅供学习和个人使用。

许可证

MIT License


File: docs/home/pipline.md

AutoBangumi 工作原理

AutoBangumi(简称 AB)本质上是一个 RSS 解析器。它从番剧种子站点解析 RSS 订阅源,从种子标题中提取元数据,生成下载规则并发送给 qBittorrent 进行下载。下载完成后,将文件整理成标准的媒体库目录结构。

流程概览

  1. RSS 解析 — AB 定期获取并解析您订阅的 RSS 源
  2. 标题分析 — 解析种子标题以提取番剧名称、集数、季度、字幕组和分辨率
  3. 规则生成 — 根据解析的信息在 qBittorrent 中创建下载规则
  4. 下载管理 — qBittorrent 负责实际的种子下载
  5. 文件整理 — 下载的文件被重命名并移动到标准化的目录结构中
  6. 媒体库就绪 — 整理后的文件可直接被 Plex、Jellyfin 等媒体服务器识别

File: docs/feature/bangumi.md

番剧管理

点击首页的番剧海报可管理单个番剧条目。

如果一部番剧有多个下载规则(例如不同字幕组),将出现规则选择弹窗:

选择规则后,编辑弹窗打开:

通知徽章

从 v3.2 开始,番剧卡片显示 iOS 风格的通知徽章来指示状态:

  • 黄色徽章带 !:订阅需要审核(例如检测到偏移问题)
  • 数字徽章:该番剧存在多个规则
  • 组合徽章(例如 ! | 2):有警告且有多个规则

带有警告的卡片还会显示黄色发光动画以引起注意。

剧集偏移自动检测

某些番剧具有复杂的季度结构,导致 RSS 剧集编号与 TMDB 数据不匹配。例如:

  • "葬送的芙莉莲" 第一季分两部分播出,中间隔了 6 个月
  • RSS 可能显示 "S2E01",而 TMDB 认为是 "S1E29"

AB v3.2 可以自动检测这些问题:

  1. 点击编辑弹窗中的 自动检测 按钮
  2. AB 分析 TMDB 剧集播出日期以识别"虚拟季度"
  3. 如果发现不匹配,AB 会建议正确的偏移值
  4. 点击 应用 保存偏移

后台扫描线程还会定期检查现有订阅的偏移问题,并标记需要审核的项目。

归档 / 取消归档番剧

从 v3.2 开始,您可以归档已完结或不活跃的番剧,以保持列表整洁。

手动归档

  1. 点击番剧海报
  2. 在编辑弹窗中,点击 归档 按钮
  3. 番剧移至列表底部的"已归档"区域

自动归档

AB 可以在以下情况自动归档番剧:

  • TMDB 上的系列状态显示为"已完结"或"已取消"
  • 使用 配置 → 刷新元数据触发自动归档

查看已归档番剧

已归档番剧出现在番剧列表底部的可折叠"已归档"区域。点击展开查看已归档项目。

取消归档

要恢复已归档番剧:

  1. 展开"已归档"区域
  2. 点击番剧海报
  3. 点击 取消归档 按钮

禁用 / 删除番剧

由于 AB 会持续解析聚合 RSS 订阅,对于来自聚合 RSS 中不再需要的下载规则:

  • 禁用番剧:番剧不会被下载或重新解析
  • 从聚合 RSS 中移除订阅

如果您删除番剧条目,它将在下次解析周期被重新创建。

高级设置

点击编辑弹窗中的 高级设置 访问更多选项:

  • 季度偏移:调整季度编号偏移
  • 剧集偏移:调整剧集编号偏移
  • 过滤:用于种子匹配的自定义正则表达式过滤器

File: docs/feature/calendar.md

日历视图

从 v3.2 开始,AB 包含日历视图,按播出日期显示您订阅的番剧。

功能

每周时间表

日历按播出日期(周一至周日)组织显示番剧,另有"未知"列显示没有播出时间数据的番剧。

Bangumi.tv 集成

AB 从 Bangumi.tv 获取播出时间数据,以准确显示每部番剧的播出时间。

点击 刷新时间表 按钮更新播出数据。

分组显示

从 v3.2 开始,具有多个下载规则的番剧会被分组显示:

  • 同一番剧只显示一次,即使有多个字幕组规则
  • 点击分组番剧可查看所有可用规则
  • 选择特定规则进行编辑

这样可以保持日历整洁,同时仍能访问所有规则。

导航

点击日历中的任意番剧海报可:

  • 查看番剧详情
  • 编辑下载规则
  • 访问归档/禁用选项

提示

::: tip
如果番剧出现在"未知"列,可能是 Bangumi.tv 上没有播出数据,或番剧标题无法匹配。
:::


File: docs/feature/rename.md

文件重命名

AB 目前提供三种重命名方式:pn、advance 和 none。

pn

pure name 的缩写。此方法使用种子下载名称进行重命名。

示例:

text
[Lilith-Raws] 86 - Eighty Six - 01 [Baha][WEB-DL][1080p][AVC AAC][CHT][MKV].mkv
>>
86 - Eighty Six S01E01.mkv

advance

高级重命名。此方法使用父文件夹名称进行重命名。

text
/downloads/Bangumi/86 - Eighty Six(2023)/Season 1/[Lilith-Raws] 86 - Eighty Six - 01 [Baha][WEB-DL][1080p][AVC AAC][CHT][MKV].mkv
>>
86 - Eighty Six(2023) S01E01.mkv

none

不重命名。文件保持原样。

收藏重命名

AB 支持收藏重命名。收藏重命名需要:

  • 剧集位于收藏的一级目录中
  • 可以从文件名解析出剧集编号

AB 还可以重命名一级目录中的字幕文件。

重命名后,剧集和目录将放置在 Season 文件夹中。

重命名后的收藏将被移动并归类到 BangumiCollection 下。

剧集偏移

从 v3.2 开始,AB 支持重命名时的剧集偏移。在以下情况下很有用:

  • RSS 显示的剧集编号与预期不同(例如 S2E01 应该是 S1E29)
  • 番剧因播出间隔而产生"虚拟季度"

当为番剧配置偏移后,AB 会在重命名时自动应用:

text
原始:S02E01.mkv
应用偏移(季度:-1,剧集:+28):S01E29.mkv

配置偏移:

  1. 点击番剧海报
  2. 打开高级设置
  3. 设置季度偏移和/或剧集偏移值
  4. 或使用"自动检测"让 AB 建议正确的偏移

有关自动检测的更多详情,请参阅番剧管理。


File: docs/feature/rss.md


title: RSS 管理

RSS 管理

RSS 管理页面

RSS 管理页面显示您所有的 RSS 订阅及其连接状态。

连接状态

从 v3.2 开始,AB 会跟踪每个 RSS 源的连接状态:

状态 说明
已连接(绿色) RSS 源可访问且返回有效数据
错误(红色) RSS 源无法响应或返回无效数据

当源显示错误时,将鼠标悬停在状态标签上可在提示框中查看错误详情。

AB 会在每次 RSS 刷新周期自动更新连接状态。

添加收藏

AB 提供两种手动下载方式:
收藏 和 订阅。

  • 收藏 一次性下载所有剧集,适用于已完结番剧。
  • 订阅 添加带有对应 RSS 链接的自动下载规则,适用于连载番剧。

解析 RSS 链接

AB 支持解析所有资源站的收藏 RSS 链接。在对应网站找到您想要的番剧收藏 RSS,点击 AB 右上角的 + 按钮,在弹出窗口中粘贴 RSS 链接。

添加下载

如果解析成功,将出现一个窗口显示解析后的番剧信息。点击 收藏 或 订阅 将其添加到下载队列。

常见问题

如果出现解析错误,可能是由于 RSS 链接不正确或字幕组命名格式不支持。

管理番剧

从 v3.0 开始,AB 在 WebUI 中提供手动番剧管理功能,允许您手动调整解析错误的番剧信息。

编辑番剧信息

在番剧列表中,点击番剧海报进入番剧信息页面。
修改信息后,点击 应用。
AB 将根据您的更改重新调整目录并自动重命名文件。

删除番剧

从 v3.0 开始,您可以手动删除番剧。点击番剧海报,进入信息页面,点击 删除。

::: warning
删除番剧后,如果 RSS 订阅未取消,AB 仍会重新解析。要禁用下载规则,请使用禁用番剧。
:::

禁用番剧

从 v3.0 开始,您可以手动禁用番剧。点击番剧海报,进入信息页面,点击 禁用。

禁用后,番剧海报将变灰并排序到末尾。要重新启用下载规则,点击 启用。


File: docs/feature/search.md

种子搜索

从 v3.1 开始,AB 包含搜索功能,可快速查找番剧。

使用搜索功能

::: warning
搜索功能依赖主程序的解析器。当前版本不支持解析收藏。解析收藏时出现 warning 是正常现象。
:::

搜索栏位于 AB 顶栏。点击打开搜索面板。

选择资源站,输入关键词,AB 将自动解析并显示搜索结果。要添加番剧,点击卡片右侧的添加按钮。

::: tip
当资源站为 Mikan 时,AB 默认使用 mikan 解析器。其他资源站使用 TMDB 解析器。
:::

管理搜索源

从 v3.2 开始,您可以直接在设置页面管理搜索源,无需编辑 JSON 文件。

搜索源设置面板

导航至 配置 → 搜索源 访问设置面板。

在这里您可以:

  • 查看 所有已配置的搜索源
  • 添加 新搜索源,使用"添加源"按钮
  • 编辑 现有源的 URL
  • 删除 自定义源(默认源 mikan、nyaa、dmhy 不能删除)

URL 模板格式

添加自定义源时,URL 必须包含 %s 作为搜索关键词的占位符。

示例:

text
https://example.com/rss/search?q=%s

%s 将被替换为用户的搜索查询。

默认源

以下源为内置源,不能删除:

源 URL 模板
mikan https://mikanani.me/RSS/Search?searchstr=%s
nyaa https://nyaa.si/?page=rss&q=%s&c=0_0&f=0
dmhy http://dmhy.org/topics/rss/rss.xml?keyword=%s

通过配置文件添加源

您也可以通过编辑 config/search_provider.json 手动添加源:

json
{
  "mikan": "https://mikanani.me/RSS/Search?searchstr=%s",
  "nyaa": "https://nyaa.si/?page=rss&q=%s&c=0_0&f=0",
  "dmhy": "http://dmhy.org/topics/rss/rss.xml?keyword=%s",
  "bangumi.moe": "https://bangumi.moe/rss/search/%s"
}

File: docs/faq/index.md

常见问题

WebUI

WebUI 地址

默认端口为 7892。服务器部署时访问 http://serverhost:7892,本地部署时访问 http://localhost:7892。如果修改了端口,请记得同时修改 Docker 端口映射。

默认用户名和密码

  • 默认用户名:admin,默认密码:adminadmin。
  • 请在首次登录后修改密码。

修改或重置密码

  • 修改密码:登录后,点击右上角的 ···,点击 个人资料,即可修改用户名和密码。
  • 目前没有简便的密码重置方法。如果忘记密码,请删除 data/data.db 文件后重启。

为什么配置修改不生效?

  • 修改配置后,点击 应用 按钮,然后在 ··· 菜单中点击 重启 来重启主程序。
  • 如果启用了调试模式,请在 ··· 菜单中点击 关闭 来重启容器。

如何检查程序是否正常运行

新版 WebUI 右上角有一个小圆点。绿色表示程序正常运行,红色表示发生错误且程序已暂停。

海报墙不显示图片

  • 如果您的版本是 3.0:
    AB 默认使用 mikanani.me 地址作为海报图片来源。如果图片不显示,说明您的网络无法访问这些图片。
  • 如果您的版本是 3.1 或更高版本:
    • 如果海报显示错误图标,说明图片缺失。请点击右上角菜单中的刷新海报按钮来获取 TMDB 海报。
    • 如果海报加载失败,请清除浏览器缓存。
    • 使用 mikanime.tv 作为 RSS 地址时,客户端代理可能会阻止海报加载。请为其添加 direct 规则。

v3.0 如何管理番剧

升级到 v3.0 后,AB 可以在 WebUI 中管理番剧种子和下载规则。这依赖于种子下载路径和规则名称。
如果您在 QB 中手动修改了种子下载路径,可能会遇到通知缺少海报或种子删除失败等问题。
请尽量在 AB 内管理番剧和种子。

下载与关键词过滤

下载路径

下载路径应该填什么?

  • 这个参数只需要与您的 qBittorrent 配置匹配即可:
    • Docker:如果 qB 使用 /downloads,则设置为 /downloads/Bangumi。您可以将 Bangumi 改为任何名称。
    • Linux/macOS:如果是 /home/usr/downloads 或 /User/UserName/Downloads,只需在末尾添加 /Bangumi。
    • Windows:将 D:\Media\ 改为 D:\Media\Bangumi

下载没有自动开始

检查 AutoBangumi 的日志中是否有种子相关的条目。

  • 如果没有,请检查您的订阅是否正确。

下载没有保存到正确的目录

  • 检查下载路径是否正确。
  • 检查 qBittorrent 的 PGID 和 PUID 配置是否有创建文件夹的权限。尝试手动下载任意种子到指定目录——如果出错或目录未创建,则是权限问题。
  • 检查 qBittorrent 的默认设置:保存管理应设置为手动(保存管理 >> 默认 Torrent 管理模式 >> 手动)。

下载了很多未订阅的番剧

  • 检查您的 Mikan 订阅是否包含了同一番剧的所有字幕组。每个番剧只订阅一个字幕组,并启用高级订阅。
    • 高级订阅可以在 Mikan Project 的用户设置中启用。
  • 正则表达式过滤可能不够——请参阅下一节来扩展正则表达式。
  • 如果以上都不适用,请携带日志在 Issues 报告。

如何编写过滤关键词

AB 中的过滤关键词是正则表达式,仅在创建规则时添加。要在创建后扩展规则,请使用 WebUI(v3.0+)单独配置每个番剧。

  • 过滤关键词是正则表达式——用 | 分隔不需要的关键词。
  • 默认的 720|\d+-\d+ 规则会过滤掉所有合集和 720P 番剧。在部署 AB 前添加过滤器;之后的环境变量修改只影响新规则。
  • 常用正则表达式关键词(用 | 分隔):
    • 720 — 过滤 720、720P、720p 等。
    • \d+-\d+ — 过滤 [1-12] 等合集
    • [Bb]aha — 过滤 Baha 发布
    • [Bb]ilibili、[Bb]-Global — 过滤 Bilibili 发布
    • 繁、CHT — 过滤繁体中文字幕
  • 要匹配特定关键词,请在 QB 的包含字段中添加:XXXXX+1080P\+,其中 1080P\+ 匹配 1080P+ 发布。

首次部署时下载了不想要的番剧

  1. 删除 QB 中多余的自动下载规则和文件。
  2. 检查订阅和过滤规则。
  3. 在浏览器中访问 resetRule API:http://localhost:7892/api/v1/resetRule 来重置规则。
  4. 重启 AB。

AB 识别的 RSS 条目比订阅的少

在较新版本中,AB 的过滤器默认也会过滤所有 RSS 条目。不要一次添加所有过滤器。要进行细粒度控制,请在 WebUI 中单独配置每个番剧。

过滤关键词不生效

  • 检查 全局过滤器 参数是否设置正确。
  • 检查 QB 的 RSS 自动下载规则——您可以在右侧看到匹配的 RSS,调整下载规则并点击保存来确定是哪个关键词导致问题。

剧集补全

剧集补全不生效

检查 剧集补全 参数是否配置正确。

文件重命名

解析错误 `Cannot parse XXX`

  • AB 目前不支持解析合集。
  • 如果不是合集,请在 GitHub Issues 上报告问题。

`Rename failed` 或重命名错误

  • 检查文件路径。标准存储路径应为 /title/Season/Episode.mp4。非标准路径会导致命名错误——请检查您的 qBittorrent 配置。
  • 检查 下载路径 是否填写正确。路径不正确会导致无法正确重命名。
  • 其他问题请在 GitHub Issues 上报告。

没有自动重命名

  • 检查 QB 中的种子分类是否为 Bangumi。
  • AB 只会重命名已下载的文件。

如何使用 AB 重命名非 AB 下载的番剧

  • 只需将种子的分类改为 Bangumi。
  • 注意:种子必须存储在 Title/Season X/ 文件夹中才能触发重命名。

如何重命名合集

  1. 将合集的分类改为 Bangumi。
  2. 将合集的存储路径改为 Title/Season X/。
  3. 等待合集下载完成,重命名将自动完成。

Docker

如何自动更新

在 Docker 中运行 watchtower 守护进程来自动更新您的容器。

watchtower 官方文档

使用 Docker Compose 更新

如果您的 AB 是使用 Docker Compose 部署的,请使用 docker compose pull 来更新。
拉取新镜像后,使用 docker compose up -d 来重启。

您也可以在 docker-compose.yml 中添加 pull_policy: always 来在每次启动时拉取最新镜像。

升级导致问题怎么办

由于配置可能各不相同,升级可能会导致程序失败。在这种情况下,删除所有之前的数据和生成的配置文件,然后重启容器。
然后在 WebUI 中重新配置。
如果从旧版本升级,请先参阅升级指南。

如果您遇到上述未涵盖的问题,请使用 bug 模板在 Issues 报告。


File: docs/faq/network.md

网络问题

无法连接到 Mikan Project

由于 Mikan Project 主站(https://mikanani.me)在某些地区可能被屏蔽,AB 可能无法连接。请使用以下解决方案:

Mikan Project 备用域名

Mikan Project 有一个新域名 https://mikanime.tv。使用此域名配合 AB,无需启用代理。

如果您看到:

text
DNS/Connect ERROR
  • 请检查您的网络连接。如果网络正常,请检查 DNS 解析。
  • 在 AB 中添加 dns=8.8.8.8。如果使用 Host 网络模式,可以忽略此项。

如果您使用代理,正确配置后通常不会出现此错误。

配置代理

::: tip
在 AB 3.1+ 中,AB 自己处理 RSS 更新和通知,因此您只需要在 AB 中配置代理。
:::

AB 有内置的代理配置。要配置代理,请按照代理设置中的说明正确设置 HTTP 或 SOCKS 代理。这可以解决访问问题。

对于 3.1 之前的版本,还需要配置 qBittorrent 代理

如下图所示在 QB 中配置代理(SOCKS 方法相同):

Cloudflare Workers 反向代理

您也可以通过 Cloudflare Workers 使用反向代理方式。设置域名并绑定到 Cloudflare 超出了本指南的范围。
在 Workers 中添加以下代码,即可使用您自己的域名访问 Mikan Project 并从 RSS 链接下载种子:

javascript
const TELEGRAPH_URL = 'https://mikanani.me';
const MY_DOMAIN = 'https://yourdomain.com'

addEventListener('fetch', event => {
  event.respondWith(handleRequest(event.request))
})

async function handleRequest(request) {
  const url = new URL(request.url);
  url.host = TELEGRAPH_URL.replace(/^https?:\/\//, '');

  const modifiedRequest = new Request(url.toString(), {
    headers: request.headers,
    method: request.method,
    body: request.body,
    redirect: 'manual'
  });

  const response = await fetch(modifiedRequest);
  const contentType = response.headers.get('Content-Type') || '';

  // Only perform replacement if content type is RSS
  if (contentType.includes('application/xml')) {
    const text = await response.text();
    const replacedText = text.replace(/https?:\/\/mikanani\.me/g, MY_DOMAIN);
    const modifiedResponse = new Response(replacedText, response);

    // Add CORS headers
    modifiedResponse.headers.set('Access-Control-Allow-Origin', '*');

    return modifiedResponse;
  } else {
    const modifiedResponse = new Response(response.body, response);

    // Add CORS headers
    modifiedResponse.headers.set('Access-Control-Allow-Origin', '*');

    return modifiedResponse;
  }
}

完成配置后,添加 RSS 时将 https://mikanani.me 替换为您的域名。

无法连接到 qBittorrent

首先,检查 AB 中的 下载器地址 参数是否正确。

  • 如果 AB 和 QB 在同一个 Docker 网络中,请尝试使用容器名称进行寻址,例如 http://qbittorrent:8080。
  • 如果 AB 和 QB 在同一台 Docker 服务器上,请尝试使用 Docker 网关地址,例如 http://172.17.0.1:8080。
  • 如果 AB 的网络模式不是 host,请不要使用 127.0.0.1 访问 QB。

如果 Docker 中的容器无法相互访问,请在 QB 的网络连接设置中设置 QB 和 AB 之间的网络链接。如果 qBittorrent 使用 HTTPS,请在 下载器地址 前添加 https:// 前缀。

2. Official Technical Reference & Guides (EstrellaXD/EstrellaXD.github.io)

liberxue.github.io preview (demo) (https://liberxue.github.io/)

`Jekyll Themes`

中文版帮助文档README

`Lightweight` `Minimalist` `Jekyll blog`

The first step is to click [fork][https://github.com/liberxue/liberxue.github.io/fork]

The second step is to modify the _config.yml in URL for your domain name

OK all right, it's that simple

  • Automatic generation tag
  • Automatic generation of JSON search
  • Adaptive template
  • Automatic generation of feed.xml
  • Automatic paging generation
  • Modify _config.yml's links for your menu
  • Modify the _config.yml of paginate for how many pages you want to page

1.First step Click[fork](https://github.com/Liberxue/liberxue.github.io#fork-destination-box)


2. modify _config.yml url URL for your domain