镜像只解决一件事:把规则文件拿回来
规则仓库托管在 GitHub 的 raw 通道上,这条通道在国内网络里时通时不通。四个「加速」选项做的就是换一段前缀。它不改文件内容,也不加速视频——搞清这条界线,能省掉很多无效折腾。
先分清是哪一种「卡」
「卡」有四种完全不同的原因,只有前两种跟镜像有关。先对号入座,别一上来就翻设置:
| 症状 | 实际发生了什么 | 镜像能救吗 |
|---|---|---|
| 打开「规则仓库」一直转圈,最后报无法访问 | 取不到 index.json 清单 | 能 |
| 列表刷出来了,点某一条的「安装」失败 | 清单拿到了,取 {name}.json 时又断了 | 多半能 |
| 规则装好了,但搜不到番 | 跟网络无关,是规则或站点的问题 | 不能 |
| 能搜到也能选集,就是播放卡、缓冲慢 | 走的是规则指向的那个视频站,与 GitHub 无关 | 不能 |
镜像做的事:换前缀,不换内容
软件对仓库只有两次 GET,都是从同一个固定地址出发的:
https://raw.githubusercontent.com/Predidit/KazumiRules/main/
选镜像之后,请求前会把这段前缀换掉,后面的 index.json 或 {name}.json 不动。所以拿到手的仍然是仓库里那份文件,一个字都不会变——换镜像不会让规则变得更好用,只会让列表刷得出来。
四个选项,差别只在改写方式
入口是规则仓库页右上角的「切换加速」,加载失败页上也有同名按钮。四个选项分成两类:
| 选项 | 改写方式 | 什么情况下用 |
|---|---|---|
| gh-proxy(默认) | 前缀加完整原始地址 | 默认值,多数地区开箱可用 |
| ghfast | 同上,只换了个前缀域名 | 默认那个超时或报错时换它 |
| GitCode | 换成 GitCode 的镜像路径,把原地址里域名之后的部分接在末尾 | 国内镜像,前两个都不通时试 |
| 直连 | 不加前缀,用原始地址 | 能正常访问 GitHub 的网络,通常最快 |
前三个都是别人维护的中转,域名和可用性会变,具体以软件里显示的为准。这也解释了为什么「某个镜像昨天好用今天不行」——不是软件坏了,是中转站挂了。
用一条命令确认某个镜像通不通
与其在软件里反复试点,不如在终端里直接问一句。下面三条分别测直连、前缀型镜像和 GitCode,返回 200 就说明这条路是通的:
# 1. 直连 GitHub raw
curl -sS -o /dev/null -w "%{http_code} %{time_total}s\n" \
https://raw.githubusercontent.com/Predidit/KazumiRules/main/index.json
# 2. 前缀型镜像:前缀 + 完整原始地址
curl -sS -o /dev/null -w "%{http_code} %{time_total}s\n" \
"https://gh-proxy.org/https://raw.githubusercontent.com/Predidit/KazumiRules/main/index.json"
# 3. GitCode 镜像
curl -sS -o /dev/null -w "%{http_code} %{time_total}s\n" \
https://raw.gitcode.com/gh_mirrors/ka/KazumiRules/raw/main/index.json
读结果:200 且时间在一秒内,选它就行;000 是连不上(DNS 或连接被重置),404 说明路径拼错了,502 / 504 是中转站自己出问题,换一个。
实在连不上:绕开网络这一步
仓库不是唯一的入口。如果你能通过别的途径拿到一个 JSON 规则文件,直接导入就行,全程不需要访问 GitHub:
- 拿到规则的 JSON 文件(作者分享的、从别处下载的、自己写的都可以)。
- 「我的 → 规则管理 → 添加规则 → 从文件导入」,选那个文件。
- 装完确认它在列表里是启用状态。
导入和点「安装」落的是同一个地方,唯一差别是少了「名字必须与清单一致」和「禁止降级」两道护栏——细节在规则仓库怎么运作里有一张对照表。要注意的是,导入的规则以后仍然能收到更新提示,只要名字和仓库里的对得上。
网络通了但番还是看不了
那就跟镜像彻底无关了,按这个顺序往下查:
规则装好了,搜索还是没有结果
规则本身的问题,或者规则指向的站点已经改版。转到规则失效排查,那里按四道门逐层定位。
能搜到,但选某条线路之后播不动
那条线路的源站慢或者挂了。换线路是最快的解法——详情页下拉就能换,客户端在当前线路失败后也会自己试下一条。
不开超分很流畅,开了就卡
超分是逐帧计算,吃 GPU。播放设置里有档位可选,降一档通常就顺了;老设备直接关掉更省电。原理在功能详解里写过。
所有源都慢,是不是这个软件本身不行
Kazumi 只是把请求转给你选的源,视频流是直接从那个站点来的。所有源都慢,说明你选的这批源质量不行,或者你的网络到这些站点的链路差。换一批源,或者换个网络环境再判断。