From 8b134aae6a1002206d1b2a8b194a25585e4f0464 Mon Sep 17 00:00:00 2001 From: EstrellaXD Date: Tue, 10 Oct 2023 12:38:42 +0800 Subject: [PATCH] docs: faq. --- docs/.vitepress/config.ts | 2 +- docs/faq/index.md | 52 +++-------------------- docs/faq/{mikan-network.md => network.md} | 51 ++++++++++++++++------ 3 files changed, 44 insertions(+), 61 deletions(-) rename docs/faq/{mikan-network.md => network.md} (53%) diff --git a/docs/.vitepress/config.ts b/docs/.vitepress/config.ts index 01aff34d..be3b5860 100644 --- a/docs/.vitepress/config.ts +++ b/docs/.vitepress/config.ts @@ -158,7 +158,7 @@ export default defineConfig({ }, { text: "网络问题", - link: "/faq/mikan-network", + link: "/faq/network", } ], }, diff --git a/docs/faq/index.md b/docs/faq/index.md index ebcdcb81..1df0823b 100644 --- a/docs/faq/index.md +++ b/docs/faq/index.md @@ -101,20 +101,19 @@ AB 中的过滤关键词是正则表达式，只会在建立规则的时候添 ### 番剧补全不起作用 -- 请检查是否正确设置了 **番剧补全** 参数。 -- 旧版本的 AB 不支持修改参数临时启用补全，请清除数据并重新部署。 -- 2.5.15 版本之后的 AB 支持临时启用。 +请检查是否正确设置了 **番剧补全** 参数。 ## 📁 重命名相关 -### 解析错误 `NOT match with XXXXX` +### 解析错误 `Cannot parse XXX` -- AB 暂时不支持解析合集，合集请通过 API 添加。 +- AB 暂时不支持解析合集。 - 如果非合集，请在 issue 中反馈问题。 ### `Rename failed` 或者重命名失败怎么办？ - 检查文件路径，标准存储路径应为 `/title/Season/Episode.mp4` 如果不为标准格式路径会导致命名错误。发生这类错误请排查 qbittorrent 的配置。 +- 请检查 `下载路径` 是否正确填写，错误填写会导致无法正确重命名。 - 非上述问题，请到 issue 反馈。 ### 没有自动重命名怎么办？ @@ -133,47 +132,6 @@ AB 中的过滤关键词是正则表达式，只会在建立规则的时候添 2. 把合集的存储路径更改为 `Title/Season X/`。 3. 等待合集下载完成，重命名完成。 -## 🌍 网络链接 - -### 无法连接到 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 的网络连接的链接中，设定链接 AB。 -- 如果 qBittorrent 使用 HTTPS 模式，请在 **下载器地址** 参数中添加 `https://` 前缀。 - -### `DNS/Connect ERROR` - -- 请检查网络连接，如果网络连接正常，请检查 DNS 解析。 -- 可以给 AB 添加一个 `dns=8.8.8.8`，如果是 HOST 模式可以忽略。 -- 如果 DNS 解析正常，添加代理。 -- 使用 TMDB 请添加代理。 - -### 如何给 Mikan 添加代理 - -AB 现在提供三种代理模式 -1. HTTP 以及 Socks 代理 - - 老版本的 AB 就有这项功能，升级到 2.6 版本之后只需要在 WebUI 中检查代理配置即可正常访问蜜柑计划。 - - 不过这时候 qBittorrent 无法正常访问蜜柑计划的 RSS 和种子地址，因此需要在 qBittorrent 中添加代理。详情可以查看 #198 - -2. 自定义反向代理 URL - - 2.6 版本的 AB 在配置中增加了 `custom_url` 选项，可以自定义反向代理的 URL。 - 可以在配置中设置为自己正确设置的反代 URL。这样 AB 就会使用自定义的 URL 来访问蜜柑计划。并且 QB 也可以正常下载。 - -3. AB 作为反代中转 - - 在 AB 配置代理之后，AB 自身可以作为本地的反代中转。不过目前仅开放 RSS 相关功能的反代。 - 这时候只需要把 `custom_url` 设置为 `http://abhost:abport` 即可。 `abhost` 为 AB 的 IP 地址，`abport` 为 AB 的端口。 - 此时 AB 会把自身地址推送给 qBittorrent，qBittorrent 会使用 AB 的地址作为反代来访问蜜柑计划。 - - 请注意，此时如果你没有用 NGINX 等工具对 AB 进行反代，请填入 `http://` 来保证程序正常运行。 - 注意点2: 请不要在同时使用代理的情况下在 `custom_url` 中使用容器寻址，或者 Docker 的容器或者网关地址。转跳代理之后可能会无法访问 RSS。 - ## 🐬 Docker 相关 ### 如何自动更新 @@ -187,6 +145,8 @@ AB 现在提供三种代理模式 如果你的 AB 使用 Docker compose 部署，可以使用 `docker-compose pull` 命令更新。 拉取完成容器之后可以使用 `docker-compose up -d` 重启容器。 +也可以在 `docker-compose.yml` 中添加 `pull_policy: always` 参数，这样每次启动容器都会拉取最新的镜像。 + ### 如果升级出现了问题需要怎么做 由于每个人配置可能不尽相同，现在升级可能会出现程序无法运行的问题，此时删除掉所有以前的数据以及生成的配置文件后重启容器。 diff --git a/docs/faq/mikan-network.md b/docs/faq/network.md similarity index 53% rename from docs/faq/mikan-network.md rename to docs/faq/network.md index a77baea8..74be35f7 100644 --- a/docs/faq/mikan-network.md +++ b/docs/faq/network.md @@ -1,4 +1,6 @@ -# Mikan 网络问题的应对方法 +# 网络问题 + +## 无法连接蜜柑计划 由于蜜柑计划本站: `https://mikanani.me` 目前被 GFW 封锁，因此可能会导致 AB 无法正确连接蜜柑计划的情况，建议使用如下方法解决。 @@ -6,25 +8,36 @@ - [使用代理](#代理) - [使用 CloudFlare Worker 进行反代](#cloudflare-workers) -## 蜜柑计划国内域名 +### 蜜柑计划国内域名 -- 蜜柑计划更新了新的域名 `https://mikanime.tv`，请在不打开代理的情况下配合 AB 使用。 +蜜柑计划更新了新的域名 `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 以前版本需要对 QB 进行代理配置** + +请按照如下截图对 QB 中进行代理设置 （Socks 同理） -1. AB 中自带了代理配置，如果要配置代理请按照 [配置代理](../config/proxy) 中的方式正确配置 HTTP 或者 Socks 代理。配置完成可以规避墙的问题。 -2. QB 中也需要配置代理，请按照如下截图对 QB 中进行代理设置 （Socks 同理） image -3. 在 2.6 版本更新中 AB 额外提供了两种解决被墙的方案。 -- 可以在 WebUI 中的 `源站链接` 中修改为自己反代过的 URL -- 使用代理之后可以使用 AB 自身作为反代节点。 - -具体可以看[配置代理](../config/proxy)中的说明。 - -## CloudFlare Workers +### CloudFlare Workers 反代 根据 OpenAI 被墙的经验，我们也可以通过反向代理的方式解决。具体如何申请域名绑定 CloudFlare 在此不再赘述。 在 Workers 中添加如下代码即可以用你自己的域名访问蜜柑计划并且解析下载 RSS 链接中的种子。 @@ -72,4 +85,14 @@ async function handleRequest(request) { } ``` -完成上述配置之后，将你的域名填入 AB 的 **源站链接｜Custom URL** 中即可。 \ No newline at end of file +完成上述配置之后，使用你的域名替换 `https://mikanani.me` **添加 RSS** 即可。 + +## 无法连接到 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 的网络连接的链接中，设定链接 AB， 如果 qBittorrent 使用 HTTPS 模式，请在 **下载器地址** 参数中添加 `https://` 前缀。 +