## 1. Project Overview & Quickstart (EstrellaXD/Auto_Bangumi) ## File: README.md # 项目说明 本项目是基于 RSS 的全自动追番整理下载工具。只需要在 [Mikan Project][mikan] 等网站上订阅番剧，就可以全自动追番。 并且整理完成的名称和目录可以直接被 [Plex][plex]、[Jellyfin][plex] 等媒体库软件识别，无需二次刮削。 ## AutoBangumi 功能说明 ### 核心功能 - 简易单次配置就能持续使用 - 无需介入的 `RSS` 解析器，解析番组信息并且自动生成下载规则 - 首次运行设置向导，7 步引导完成配置 - 番剧文件整理: ``` 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% 以上的番剧可以直接被媒体库软件直接刮削 ``` [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 [](https://star-history.com/#EstrellaXD/Auto_Bangumi) ## 贡献 欢迎提供 ISSUE 或者 PR, 贡献代码前建议阅读 [CONTRIBUTING.md](CONTRIBUTING.md)。 贡献者名单请见： [](https://github.com/EstrellaXD/Auto_Bangumi/graphs/contributors) ## Licence [MIT licence](https://github.com/EstrellaXD/Auto_Bangumi/blob/main/LICENSE) [mikan]: https://mikanani.me [plex]: https://plex.tv [jellyfin]: https://jellyfin.org --- ## File: docs/home/index.md --- title: 关于 --- ## 关于 AutoBangumi **`AutoBangumi`** 是一款基于 RSS 订阅的全自动番剧下载和整理工具。只需在 [Mikan Project][mikan] 或类似网站订阅番剧，即可自动追踪和下载最新剧集。 整理后的文件名和目录结构可直接兼容 [Plex][plex]、[Jellyfin][jellyfin] 等媒体库软件，无需额外的元数据刮削。 ## 功能特性 - 简单的一次性配置，持续使用 - 无需操心的 RSS 解析器，可提取番剧信息并自动生成下载规则 - 番剧文件整理： ``` 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% 的番剧文件在重命名后可被媒体库软件直接刮削 ``` [Lilith-Raws] Kakkou no Iinazuke - 07 [Baha][WEB-DL][1080p][AVC AAC][CHT][MP4].mp4 >> Kakkou no Iinazuke S01E07.mp4 ``` - 基于父文件夹名称自定义重命名所有子文件 - 季中追番补全当季所有缺失剧集 - 高度自定义选项，可针对不同媒体库软件进行微调 - 零维护，完全透明运行 - 内置 TMDB 解析器，可生成完整的 TMDB 格式文件和番剧元数据 - 支持 Mikan RSS 订阅的反向代理 ## 社区 - 更新通知：[Telegram 频道](https://t.me/autobangumi_update) - Bug 反馈：[Telegram](https://t.me/+yNisOnDGaX5jMTM9) ## 致谢 感谢 [Sean](https://github.com/findix) 对项目的大力帮助。 ## 参与贡献 欢迎提交 Issues 和 Pull Requests！ ## 免责声明 由于 AutoBangumi 通过非官方版权渠道获取番剧： - **请勿**将 AutoBangumi 用于商业用途。 - **请勿**制作包含 AutoBangumi 的视频内容并在国内视频平台（版权相关方）上发布。 - **请勿**将 AutoBangumi 用于任何违反法律法规的活动。 AutoBangumi 仅供学习和个人使用。 ## 许可证 [MIT License](https://github.com/EstrellaXD/Auto_Bangumi/blob/main/LICENSE) [mikan]: https://mikanani.me [plex]: https://plex.tv [jellyfin]: https://jellyfin.org --- ## 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` 的缩写。此方法使用种子下载名称进行重命名。 示例： ``` [Lilith-Raws] 86 - Eighty Six - 01 [Baha][WEB-DL][1080p][AVC AAC][CHT][MKV].mkv >> 86 - Eighty Six S01E01.mkv ``` ### advance 高级重命名。此方法使用父文件夹名称进行重命名。 ``` /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 会在重命名时自动应用： ``` 原始：S02E01.mkv 应用偏移（季度：-1，剧集：+28）：S01E29.mkv ``` 配置偏移： 1. 点击番剧海报 2. 打开高级设置 3. 设置季度偏移和/或剧集偏移值 4. 或使用"自动检测"让 AB 建议正确的偏移 有关自动检测的更多详情，请参阅[番剧管理](./bangumi.md#episode-offset-auto-detection)。 --- ## 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` 作为搜索关键词的占位符。 示例： ``` 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][ISSUE] 报告。 ### 如何编写过滤关键词 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](https://containrrr.dev/watchtower) 官方文档 ### 使用 Docker Compose 更新 如果您的 AB 是使用 Docker Compose 部署的，请使用 `docker compose pull` 来更新。 拉取新镜像后，使用 `docker compose up -d` 来重启。 您也可以在 `docker-compose.yml` 中添加 `pull_policy: always` 来在每次启动时拉取最新镜像。 ### 升级导致问题怎么办 由于配置可能各不相同，升级可能会导致程序失败。在这种情况下，删除所有之前的数据和生成的配置文件，然后重启容器。 然后在 WebUI 中重新配置。 如果从旧版本升级，请先参阅[升级指南](/changelog/2.6)。 如果您遇到上述未涵盖的问题，请使用 bug 模板在 [Issues][ISSUE] 报告。 [ISSUE]: https://github.com/EstrellaXD/Auto_Bangumi/issues --- ## File: docs/faq/network.md # 网络问题 ## 无法连接到 Mikan Project 由于 Mikan Project 主站（`https://mikanani.me`）在某些地区可能被屏蔽，AB 可能无法连接。请使用以下解决方案： - [使用 Mikan Project 备用域名](#mikan-project-备用域名) - [使用代理](#配置代理) - [使用 Cloudflare Worker 反向代理](#cloudflare-workers-反向代理) ### Mikan Project 备用域名 Mikan Project 有一个新域名 `https://mikanime.tv`。使用此域名配合 AB，无需启用代理。 如果您看到： ``` DNS/Connect ERROR ``` - 请检查您的网络连接。如果网络正常，请检查 DNS 解析。 - 在 AB 中添加 `dns=8.8.8.8`。如果使用 Host 网络模式，可以忽略此项。 如果您使用代理，正确配置后通常不会出现此错误。 ### 配置代理 ::: tip 在 AB 3.1+ 中，AB 自己处理 RSS 更新和通知，因此您只需要在 AB 中配置代理。 ::: AB 有内置的代理配置。要配置代理，请按照[代理设置](../config/proxy)中的说明正确设置 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](/ChinaREADME.md) ## `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 #### I don't want any copyright also don't need you to donate, I only need you with a star 🌟 Thx 😄 - [x] Automatic generation tag - [x] Automatic generation of JSON search - [x] Adaptive template - [x] Automatic generation of feed.xml - [x] Automatic paging generation - [x] Modify _config.yml's links for your menu - [x] 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 * [Issues](https://github.com/Liberxue/liberxue.github.io/issues) * [Email](mailto:liberxue@gmail.com) * [Twitter](https://twitter.com/liberxue).