clash github坑一:把两个不同的东西当成同一个
最常见的误解,是把「客户端程序」和「配置文件」混为一谈。前者是装在设备上的那个应用, 后者是一份纯文本规则。你换客户端,配置文件可以照用;你换配置文件,客户端不用重装。 分不清这两者,就会在「明明换了版本怎么还是不行」里反复打转。
判断方法:如果问题出在界面选项上,那是客户端的事;如果出在流量走向上,那是配置的事。我们是一支不大的编辑团队,做的是同一件事:把散落在公开页面里的 clash github 相关信息, 一条一条核对、重写、归档,让第一次接触的人不用在几十个标签页之间反复横跳。
自 2021 年起持续整理 · 最近核对 2026-09-12
品牌名 clash-gh,域名 clash-gh.cn,做的是信息导航与内容解析,不是下载站,也不是服务商。
很多人第一次听到 clash github 这个词,是在某个群聊里。有人丢过来一句「你去 GitHub 上搜一下就有了」, 然后你就打开了一个全英文的仓库页面:README 很长,release 列表一排版本号,issue 区几百条未读, 侧边栏还有七八个分支。你能看懂每个单词,但拼不起来「我到底该点哪一个」。
clash-gh 就是为这个瞬间存在的。我们把公开页面上那些零散的说明——项目在做什么、不同分支侧重什么、 配置文件里的字段分别管什么、常见报错通常指向哪里——重新组织成中文条目,按「先懂概念、再看版本、最后动手」的顺序排好。 你不需要先成为开发者,也能读出个大概。
我们不提供安装包托管,不做镜像加速,不代理任何流量。所有条目都指向公开来源, 具体下载与使用请回到项目原页面自行判断。这个边界我们守得很死,因为一旦越过去, 站点就从「帮你省时间」变成了「替你承担风险」,那对我们和对你都不划算。
团队规模不大,编辑、校对、技术核对加起来不到十个人。有人负责盯上游提交,有人负责把技术语言翻译成人话, 有人专门挑刺——把已经写好的段落再读一遍,问一句「这句是不是在替读者下结论」。慢,但错得少。
一个编辑上的取舍:凡是无法核实的版本号、发布时间、维护者名单,我们宁可留空,也不猜一个数字填上去。 你在这里看到的每一条时间信息,都对应着一次真实的核对动作。
后台留言里出现频率最高的问题,翻来覆去其实是同一类:「这两个东西是不是一回事?」 有人把客户端和订阅配置当成一个东西,有人以为换个分支就等于换了服务。 概念没理清之前,装十遍也还是懵。所以我们后来把「概念背景」放到了整站最前面。
一篇教程如果只讲正确路径,读者走岔了还是得自己摸索。我们现在更愿意花篇幅写「如果你看到这个界面, 说明你打开的是另一个东西」。把错误路径标出来,比把正确路径写漂亮更有用。
上游几个月没动静,我们也不会为了显得勤快去改几个字凑数。页面上标的更新日期, 是最后一次实际核对的时间,不是自动生成的时间戳。这一点我们不想含糊。
这是我们编辑日常做内容核对时顺手记录的公开网络访问延迟区间,用来判断「某个来源页面最近是不是不好打开」。 数值是区间估算,不是实时测速结果,仅供参考。
说明:以上为编辑人工抽样记录的延迟区间,随网络环境波动,不代表任何服务承诺,也不构成对第三方线路的评价。
不用跳级。每一级都建立在前一级的认知上,跳过去大概率要回头补。
这是最容易混淆的一步。客户端是那个装在设备上的程序,配置文件是喂给它的规则文本。两者分开理解,后面所有问题都会变简单。
打开配置文件,先别急着改。认出几个主要段落,明白它们各自管什么,能读懂缩进层级,这一级就算过了。
规则列表不是并列关系,是从上往下逐条比对、命中即停。想通这一点,你就能解释「为什么我加的规则没生效」这类问题。
出问题时不要反复重启,先看日志里最后几条记录。它通常直接告诉你哪一行配置有问题,或者哪一步连接没走通。
到了这一级,你不再照抄别人的配置,而是知道哪些流量该走哪条路、为什么这么分。这是从「会用」到「用得顺」的分界线。
点开任意一条展开查看。答案里如果提到别的章节,可以直接跳过去接着读。
clash github 指的是托管在 GitHub 上、由开源社区维护的那一类代理客户端项目及其说明文档。 我们做的事情是把这些公开页面的信息整理成中文条目——项目叫什么、谁在维护、最近一次提交大概是什么时候、 不同分支的侧重点在哪。
我们不提供安装包托管,也不做镜像加速,你在这里看到的每一条都指向公开来源, 具体下载与使用请回到项目原页面自行判断。
不需要。全站免费浏览,不设账号体系,不弹登录框,也不收集手机号。我们靠页面上的展示位维持基本的服务器开销, 所以你打开任何一篇文章都是直接读,没有试用期、没有积分墙。
如果你在别处遇到打着本站名义要求付费或索要账号密码的页面,那和我们没有关系,可以直接忽略。
我们的原则是只搬运公开可查的内容,并且尽量标明出处。凡是无法核实的版本号、发布时间、维护者名单, 我们宁可空着也不猜一个填上去。
你在阅读时如果发现某条信息和项目原页面已经对不上,那大概率是上游更新了我们还没跟上,欢迎通过页脚邮箱告诉我们。 关于信息边界和处理方式,可以再看一眼 内容说明 那一节。
建议先读 深度解读 里的上手部分,那里把最容易踩的几个坑按顺序列了出来: 先分清「客户端」和「订阅配置」是两回事,再理解配置文件里的规则是自上而下匹配的, 最后才是去折腾分流规则。按这个顺序走,能省掉很多来回试错的时间。
看完之后如果还有具体疑问,直接翻上面的折叠项,大部分常见问题都覆盖到了。
没有固定周期,跟着上游动。项目有重要提交、分支有合并、说明文档有改动,我们就会去核对一遍相关条目; 如果上游几个月没动静,我们也不会为了显得勤快去改几个字凑数。
页面上标注的更新日期就是最后一次实际核对的时间,不是自动生成的时间戳。
发邮件到页脚标注的纠错邮箱就行,附上页面地址和具体哪一句有问题,最好再带上你的依据来源。 我们会在 48 小时内回信确认,核实之后尽快改。
如果是版权方面的诉求,请走同一个邮箱并在标题里注明「版权」,处理优先级会更高。
下面这些不是理论,是我们自己踩过、也在留言里反复看到别人踩的。
最常见的误解,是把「客户端程序」和「配置文件」混为一谈。前者是装在设备上的那个应用, 后者是一份纯文本规则。你换客户端,配置文件可以照用;你换配置文件,客户端不用重装。 分不清这两者,就会在「明明换了版本怎么还是不行」里反复打转。
判断方法:如果问题出在界面选项上,那是客户端的事;如果出在流量走向上,那是配置的事。配置里的规则列表是自上而下逐条匹配、命中即停,不是全部过一遍再取交集。 所以把一条宽泛的规则放在前面,后面那些更精确的规则就永远轮不到。 很多人写的新规则「不生效」,其实是被上面某条兜底规则提前截走了。
排查顺序:从规则列表顶部往下看,找到第一条能匹配上的,问题通常就在那里。重启能解决一部分问题,但也会把现场清掉。日志里通常有更直接的线索——哪一行解析失败、 哪一步连接超时,写得清清楚楚。养成先看日志再动手的习惯,能省下大量瞎试的时间。
日志里如果出现「解析失败」字样,先检查缩进和标点,多半是格式问题而不是功能问题。别人的配置是针对他自己的使用习惯写的,直接拿来用,短期能用,长期一定别扭。 更好的做法是先读懂每一段在干什么,然后只搬你需要的那部分。 这也是我们在站内把配置拆成小节讲、而不是整份贴出来的原因。
从最小可用配置起步,每加一条规则都知道它为什么在那儿,比一次抄全更省事。上游文档是跟着最新版本走的。如果你手上是较早的版本,却照着最新文档改配置, 很可能遇到「文档里有的字段我这里没有」的情况。遇到这种不一致,先确认版本,再找对应时期的说明。
核对版本时,以项目原页面标注的信息为准,不要依赖第三方转载的截图。配置文件对缩进敏感,混用空格和制表符、少缩进一级、多缩进一级,都可能让整段配置失效。 这类问题不会报「语法错误」,只会表现为「某条规则没生效」,特别容易误判成功能问题。
用纯文本编辑器打开,开启显示空白字符,一眼就能看出缩进是否对齐。这部分写得比较直白,希望你花两分钟看完,能省掉后面很多误会。