# 常见问题

遇到任何问题, 请先在系统日志页查看日志, 信息或错误都要看!!!!用 Ctrl + F 在本页面快速搜索问题

## 全局

### 如何获取 Cookie

建议使用 Chrome 开启无痕模式抓取, 多次出现使用 EDGE 抓取到的 Cookie 无法使用的问题 以 Chrome 举例, 打开希望获取 Cookie 的网站, 按 F12 之后弹出开发者工具窗口, 选择 Network / 网络 标签页 (1), 之后刷新一次页面, 然后左侧点击第一个 (2), 然后在右方弹出的小窗口种寻找 Request Header 下的 Cookie (3), 复制内容即可 

<figure><img src="https://1236336705-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe867Ol3sPaghugvFZy1U%2Fuploads%2FwV5AGjtsU98EoVC7ijCU%2Fcookie.jpeg?alt=media&#x26;token=899569df-62b7-4e78-9703-a0c5ab996ddd" alt=""><figcaption></figcaption></figure>

### 如何查看日志

进入 Vertex, 侧边栏选择 `系统日志`&#x20;

### **登陆后一直提示** 鉴权失效，需要刷新页面

1. 异常运行导致的容器重启，可以检查 docker 日志排查问题。
2. 导入他人备份造成异常重启，有能力排查具体原因的自己排查，没能力的别导入。
3. 导入他人备份造成异常重启，着重检查 RSS 规则及删种规则内的 JavaScript 类型规则，实在不行全删了。
4. 和其它容器共用同个 IP，因 cookie 不区分端口，可能导致 cookie 被其它应用刷新，使用无痕模式打开 vertex 登录后检查是否能正常使用。解决办法是使用不同 IP，或单独绑定域名使用

### Unexpected end of JSON input

VT 所在硬盘被占满过，并且占满时进行了配置文件变更导致写出文件为空内容，具体配置文件夹可以在日志里找到线索，找到对应空文件后删了就行，若为其它组件依赖的组件，需要同步修改。

### **密码忘记了怎么办? 如何重置密码?**

1. 删除位于 `vertex/data/setting.json` 文件内的 `password` 一行
2. 若 `password` 一行位于最后一行, 需要删除上一行最后的 , 符号
3. 然后重启容器, 重新生成的密码保存在 `vertex/data/password` 文件内

### **ETIMEDOUT / ENETUNREACH / ESOCKETTIMEOUT / ECONNREFUSED / socket hang up ...**

如果 Vertex 和下载器在同一个机器上，且下载器也是 Docker 安装，百度 docker 间网络不通

网络问题, 检查 Vertex 与 下载器 / 站点 间网络是否通畅

如果是站点无法访问, 可以尝试

* 进入 常用工具 - 修改 hosts 来指定站点 ip, 优化 Cloudflare 的访问, 获取 Cloudflare 对应的 IP 可以参照这个教程: [CloudflareST](https://zhuanlan.zhihu.com/p/207315892)
* 进入 常用工具 - http 代理, 添加 http 代理的方式通过代理访问网站, http 代理服务端的搭建方式请自行研究

### getaddrinfo EAI\_AGAIN

DNS 解析发生错误, 检查要访问的地址是否正常解析, 特殊情况下也可能是网络拥堵引起的解析失败, 可以刷新或稍后重试

### unraid br0 模式下 docker 间网络不通

进入 设置 - docker

### Cookie 失效

* 字面意思, Cookie 失效或者获取 Cookie 的方式不对, 可以尝试重新获取 Cookie
* 网络原因, 某些情况下可能会导致访问 PT 站点时遇到 Cloudflare 5s 盾, 这种情况大多是 Vertex 所在的网络环境被 Cloudflare 认为是有安全威胁, 可以尝试更换 IP 甚至网络环境

### openapi 回调地址不通过

* Token 和 AesKey 需要先在 Vertex 里 保存 一遍
* openapi 调用需要公网 v4 环境能够访问自己的 vertex 页面, 可以是 FRP, NPS 等内网穿透工具, 但是前提是没有其它跳转, 或者验证环节 (比如扫码)
* 检查 AesKey 与 Token 是否填写正确，注意前后是否有多余空格
* openapi 用于追剧部分的微信交互功能，属于不是必须通过的内容，可以不配置

### error not a number : buffer\[0]=xx

出现这个错误的原因是下载到的文件不是标准的种子文件, 可以考虑以下问题

* Rss 链接用错, 需要用支持 BT 客户端的 Rss 链接
* NexusPHP 站点在第一次下载的时候需要确认, 请确认自己已经确认过
* 站内种子页面点击 下载种子, 尝试能否正常下载, 不要使用复制链接的方式下载种子
* Cookie 失效，可以试试 Cookie 是否还有效
* 可能是网络问题, 可以尝试重试下载种子

### Invalid data: Missing delemiter ":" \[0xxx]

同上

### TypeError: Cannot read property 'alias' of undefined

有 RSS 规则内选择了下载器，但是这个被选择的下载器已经被删了，取消指定下载器就行。

### 无效的 PANEL KEY

在 Vertex 系统设置 - 安全设置中填写 Panel Key。Panel Key 需在 [Vertex Panel](https://dash.vertex-app.top) 注册获得

### Too Many Requests

下载器配置的通知频道和监控频道分开，每一个下载器单独一个监控频道。

### &#x20;Telegram 推送提示 description: 'Bad Request: chat not found'

1. 频道 ID 不对
2. 机器人未拉进频道
3. 个别用户反馈需要将频道设置为公开

## 下载器

### 显示连接失败

查看错误日志, 排查问题

### **statusCode is 404**

下载器设置 WebUrl 最后的 / 去掉

### **statusCode is 403**

下载器内设置的账号密码输入错误, 也或者是曾经输入错误导致登录失败次数过多, 此时需要修改下载器账号密码配置甚至重新启动 qBittorrent

### 种子添加上了却没速度?

* 检查下载器是否能够正常连接 tracker
* 检查是否有做种者, 并且已经连接上
* 检查种子是否有限速
* 检查种子文件的下载目录是否有写入权限

### 种子添加上了提示错误?

* 检查种子文件的下载目录是否有写入权限

### 如何查看 qBittorrent 的日志

qBittorrent 登录之后网址后面添加 /api/v2/log/main

### Unauthorized

从 Vertex 内打开 qBittorrent 显示 `Unauthorized`, 需要通过原地址登录 qBittorrent 修改 设置 - WebUI - 启用跨站请求伪造 (CSRF) 保护, 取消勾选该项目保存即可

### 种子 Tracker 列表显示 Skipping tracker announce

可以尝试以下操作

* 关闭设置内的验证 HTTPS tracker 证书
* qBittorrent 43x 版本的问题， 可以尝试在 qBittorrent 内修改 BitTorrent 端口，或者直接将 qBittorrent 降级至 42x 版本

### 推送报错: Bad Request message to edit not found

下载器推送监控所用的通知工具, 必须勾选 下载器已连接 的通知类型

## Rss

### 添加了 Rss 任务之后一直不见有种子添加? 任务历史也显示空白?

* 检查 rss 链接是否正确, 一般的我们认为 Rss 链接是在 PT 站右上角生成的 Rss 链接, 而不是收藏夹
* 检查日志, 排除网络等问题

### 添加了 Rss 任务之后一直不见有种子添加? 任务历史只显示拒绝最长休眠时间?

* 检查 rss 内容是否有新种子添加, 也就是站点内是否有新种子发布

### **Vertex 显示添加成功, 但是客户端看不到种子?**

* Rss 链接用错, 需要用支持 BT 客户端的 Rss 链接
* 下载器网络问题, 自行检查
* 检查完以上内容后, 手动添加种子测试看看, 如果手动添加也不行, 重启下载器
* 除了上面提到的情况, 目前有些站添加了流控, 也就是短时间内不能下载超过一定数量的种子, 可以后续重试看看

### **Vertex 显示添加成功, 客户端也显示有种子, 但是一直处于等待状态或速度很慢?**

* 检查是否连接上 tracker, 如果连接不上, 考虑网络原因
* 检查是否做种者是否已经开始上传
* 检查已经连接上的其他用户与自己的进度差距, 即有东西可以下载
* 检查种子是否被限速
* 检查种子保存路径是否有读写权限

### **如何理解最长休眠时间?**

最长休眠时间, 若上次成功 RSS 在 N 秒以前, 则本次 RSS 拒绝所有种子, 建议为 3-5 倍于 Rss 周期, 单位为秒 设置最长休眠时间的目的是避免 Rss 任务 **第一次添加任务或长时间因网络或站点问题失败之后突然加入大量种子** 的情况 **你这个时候要做的, 就是等新种子** **如果不想启用本功能, 应当在最长休眠时间处填写 10 个 9**

**举例讲, Rss 周期为五分钟, 设置最长休眠时间 1100s**

* 14: 00, 本次 Rss 成功获取种子列表
* 14: 05, 本次 Rss 获取种子失败
* 14: 10, 本次 Rss 获取种子失败
* 14: 15, 本次 Rss 获取种子失败
* 14: 20, 本次 Rss 获取种子成功, 但是距离上次成功 Rss 过去了 20 \* 60 = 1200s > 1100s, 拒绝本次 Rss 获取到的所有种子, 同时记录下本次 Rss 成功的时间为 14: 20
* 14: 25, 本次 Rss 获取种子成功, 因此距离上次 Rss 成功时间为 5 \* 60 = 300s < 1100s, 正常进入判断流程添加种子
* 14: 30, 本次 Rss 获取种子失败
* 14: 35, 本次 Rss 获取种子成功, 同时上次 Rss 任务成功时间为 14: 25, 因此距离上次 Rss 成功时间为 10 \* 60 = 600s < 1100s, 正常进入判断流程添加种子
* **修改 Rss 任务会重新计时**

### **站点里显示免费, 但是 Vertex 提示非免费种**

两种情况

* 目前 CHD 与 U2 需要在 控制面版 - 网站设置 - 种子页面 将促销种子设置为 添加标记 选项
* 另外还有一种情况是个别站点种子的发布与优惠状态的更新不是一起执行的, 存在先发布, 后加优惠的情况, 因此需要在 Rss 任务内设置等待时间

### Cannot read property '0' of undefined

站点在生成 RSS 链接时有两个, 用了错误的一个, 尝试换用另一个 RSS 链接

### Cannot read property 'length' of undefined

创建的 Rss 链接返回的种子列表为空, 简单讲, 没有种子符合自己所选择的情况 另: MTeam 存在流控, 把 Rss 周期修改为 `*/6 * * * *`

### ERR\_INVALID\_URL

Rss 任务设置内, Rss 链接的格式不正确或存在空行

### Error: Unexpected close tag

报错原因为解析 rss 链接返回的 xml 失败, 可能以下几个原因

* 站点暂时无法访问
* rss 链接填写错误, 检查链接是否正确
* 遇到 Cloudflare 的 5s 盾, 可以考虑在全局设置内修改 UserAgent, 若修改了依然有此问题, 考虑更换 Vertex 所在的网络 IP 或者网络环境

> 可以在`常用工具 - 网络测试` 里测试看看返回的什么内容。 {.is-info}

> User Agent 可以在这里获取 => [User Agent](https://ua.lswl.workers.dev/) {.is-info}

### Non-whitespace before first tag

同上

### Cannot read property 'rss' of null

同上

### 无可用下载器

* 检查下载器状态是否正常
* 检查下载器状态是否符合下载器设置的 上限上传速度 / 上限下载速度 / 最小剩余空间 / 最大下载数量 三个限制
* 检查下载器状态是否符合 RSS 任务内设置的 下载器最高上传速度 / 下载器最高下载速度 / 下载器下载任务上限 三个限制

### M-Team 抓取免费提示 Cookie 失效

M-Team 的 Cookie 与 IP 以及 User-Agent 绑定, Vertex 页进入 常用工具 - MT 登录 手动操作一次即可 使用无痕模式抓取 Cookie, Cookie 输入框内仅保留 tp=xxxx; 一段即可, 登录之后将 tp=xxxx 填入站点列表及 Rss 任务内的 Cookie

### CHDBits 经常提示 RSS 遇到错误

CHDBits 有 RSS 流控，注意不要同时运行多个 RSS 任务。 可以通过设定不同的 RSS 规则达到分流的效果。

### 添加种子失败

* 检查 RSS 链接，需要用支持 BT 客户端的 Rss 链接
* 检查是否被站点流控限制，可以自行在站内下载一次种子试试

## 追剧

### 添加豆瓣账号并刷新后, 想看列表无内容

* 检查豆瓣 Cookie 是否正确
* 检查豆瓣网站上是否添加想看
* 查看日志

### 添加豆瓣账号并刷新后, 提示 Cookie 过期

* 注意填写 Cookie 之后尽量不要在其它地方登录，目前作者感受到的情况是，如果你填写 cookie 之后，在某地用网页登录了豆瓣，cookie 就会失效。
* 检查主账号以及附加账号的想看列表是否均有想看项目, 不能为空
* 使用常用工具 - 网络测试, 网址填入 `https://www.douban.com`, 并填入 cookie, 执行返回结果后, Ctrl + F 搜索自己的用户名, 如果搜索不到, 证明 Cookie 失效, 重新抓取

### 添加豆瓣账号并刷新后, 想看列表有内容但没有自动下载种子

首次添加豆瓣账号时会将豆瓣账号内现有的想看条目设置为已下载, 如果有希望下载的东西需要在 想看列表页 删除条目, 在豆瓣重新添加想看后刷新豆瓣账号即可

### 订阅列表里面有重复项

检查是否订阅任务之间有关键词是相同或包含问题 比如自己在豆瓣加了一个想看，填写标签为`国产剧集`，这个标签可能会同时匹配上 `剧集` 和 `国产剧集`

### 订阅列表删除之后, 刷新豆瓣又添加了回来

**默认情况下**, 删除操作时会自动删除豆瓣网站上的记录，但是某些时候遇到报错，可能需要手动在豆瓣网站上删除项目

### 查找到 0 个种子

检查所选择的站内是否有对应种子, 比如 `向往的生活 第六季` 就应该在 `追光迷影 - 聚合搜索` 内搜索 `向往的生活 第六季` 看看是否有正常返回

## 附: 提问的艺术