Network

镜像只解决一件事:把规则文件拿回来

规则仓库托管在 GitHub 的 raw 通道上,这条通道在国内网络里时通时不通。四个「加速」选项做的就是换一段前缀。它不改文件内容,也不加速视频——搞清这条界线,能省掉很多无效折腾。

四个加速选项 含自测命令 适合:装规则总失败的人

先分清是哪一种「卡」

「卡」有四种完全不同的原因,只有前两种跟镜像有关。先对号入座,别一上来就翻设置:

四种症状与真正的原因
症状实际发生了什么镜像能救吗
打开「规则仓库」一直转圈,最后报无法访问取不到 index.json 清单能
列表刷出来了,点某一条的「安装」失败清单拿到了,取 {name}.json 时又断了多半能
规则装好了,但搜不到番跟网络无关,是规则或站点的问题不能
能搜到也能选集,就是播放卡、缓冲慢走的是规则指向的那个视频站,与 GitHub 无关不能
最常见的一处误解播放卡的时候去换镜像,是这件事上最白费的动作。镜像只影响「规则文件能不能下载下来」,规则下好之后它就存在本地了,播放全程不经过 GitHub。播放慢只能换源、换线路,或者降低超分档位。

镜像做的事:换前缀,不换内容

软件对仓库只有两次 GET,都是从同一个固定地址出发的:

客户端里写死的原始地址
https://raw.githubusercontent.com/Predidit/KazumiRules/main/

选镜像之后,请求前会把这段前缀换掉,后面的 index.json 或 {name}.json 不动。所以拿到手的仍然是仓库里那份文件,一个字都不会变——换镜像不会让规则变得更好用,只会让列表刷得出来。

四个选项,差别只在改写方式

入口是规则仓库页右上角的「切换加速」,加载失败页上也有同名按钮。四个选项分成两类:

四个加速选项的地址改写方式
选项改写方式什么情况下用
gh-proxy(默认) 前缀加完整原始地址 默认值,多数地区开箱可用
ghfast 同上,只换了个前缀域名 默认那个超时或报错时换它
GitCode 换成 GitCode 的镜像路径,把原地址里域名之后的部分接在末尾 国内镜像,前两个都不通时试
直连 不加前缀,用原始地址 能正常访问 GitHub 的网络,通常最快

前三个都是别人维护的中转,域名和可用性会变,具体以软件里显示的为准。这也解释了为什么「某个镜像昨天好用今天不行」——不是软件坏了,是中转站挂了。

建议的尝试顺序能访问 GitHub 就选直连,它没有任何中间环节,最不容易出问题。不行再回到 gh-proxy → ghfast → GitCode。四个轮流试一遍花不了一分钟,通常总有一个能通。

用一条命令确认某个镜像通不通

与其在软件里反复试点,不如在终端里直接问一句。下面三条分别测直连、前缀型镜像和 GitCode,返回 200 就说明这条路是通的:

在终端里自测(macOS / Linux / Windows PowerShell)
# 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 是中转站自己出问题,换一个。

别把第三方镜像当成「可信下载源」这些中转站只转发 GitHub 上的文件,理论上不该改内容,但你没法自己验证。这也是为什么装完规则最好看一眼它的 baseURL 指向哪个站——规则决定你的请求发去哪里,值得花十秒确认。

实在连不上:绕开网络这一步

仓库不是唯一的入口。如果你能通过别的途径拿到一个 JSON 规则文件,直接导入就行,全程不需要访问 GitHub:

  1. 拿到规则的 JSON 文件(作者分享的、从别处下载的、自己写的都可以)。
  2. 「我的 → 规则管理 → 添加规则 → 从文件导入」,选那个文件。
  3. 装完确认它在列表里是启用状态。

导入和点「安装」落的是同一个地方,唯一差别是少了「名字必须与清单一致」和「禁止降级」两道护栏——细节在规则仓库怎么运作里有一张对照表。要注意的是,导入的规则以后仍然能收到更新提示,只要名字和仓库里的对得上。

网络通了但番还是看不了

那就跟镜像彻底无关了,按这个顺序往下查:

规则装好了,搜索还是没有结果

规则本身的问题,或者规则指向的站点已经改版。转到规则失效排查,那里按四道门逐层定位。

能搜到,但选某条线路之后播不动

那条线路的源站慢或者挂了。换线路是最快的解法——详情页下拉就能换,客户端在当前线路失败后也会自己试下一条。

不开超分很流畅,开了就卡

超分是逐帧计算,吃 GPU。播放设置里有档位可选,降一档通常就顺了;老设备直接关掉更省电。原理在功能详解里写过。

所有源都慢,是不是这个软件本身不行

Kazumi 只是把请求转给你选的源,视频流是直接从那个站点来的。所有源都慢,说明你选的这批源质量不行,或者你的网络到这些站点的链路差。换一批源,或者换个网络环境再判断。

Next

规则装上了,
但你不确定包本身是干净的吗。

从非官方渠道拿到安装包时,三步就能确认它和官方原包是同一个文件——不用信任任何网站,只信哈希。