一、先搞清楚:这东西到底是什么

入门

很多人第一次打开 Quantumult X(一款运行在 iPhone 上的网络工具类 App,下面简称 QX)会被它的界面劝退:一堆策略组,每个后面跟着一串英文名字,看起来像乱码。

Qure 做的事情很简单:它是一套现成的图标,把这些冷冰冰的文字换成一眼能认出来的小图片。比如「Apple 服务走哪条线路」后面放一个苹果标志,「流媒体解锁」后面放一个 Netflix 的 Logo,扫一眼就知道每个策略组管的是什么。

这个项目本身不包含任何可执行程序,只有图片和两个 JSON 清单文件(JSON 是一种「给程序看的列表格式」,你可以先把它理解成一份带编号的目录)。所以它的「安装」其实就是在配置文件里填两个网址。

Qure 不是一个 App,也不需要装在手机上。它只是托管在 GitHub 上的一堆图片,你的 QX 客户端通过网络地址去取用。

Qure 图标集整体效果图

上图是 Qure 全部图标的预览。所有图标的名字都能在效果图里对应查到,配置时直接照着写就行。

二、前置条件:你手上得先有 QX

入门

在动手之前,确认下面几件事:

  • 你已经在 iPhone 上装好了 Quantumult X,并且能正常打开它的「配置」编辑界面。
  • 你愿意手动改一点文本配置。QX 没有图形化的图标选择器,一切靠在配置文件里写网址完成。
  • 手机能正常联网。因为图标是从 GitHub 上实时下载的,网络不通就只会显示空白。

如果你连 QX 都还没装,或者还在用 Shadowrocket、Loon 之类的同类工具,那么这篇教程对你暂时用不上——Qure 是 QX 专用的,其他工具需要用别的方式引图(本文末尾会简单提到)。

三、核心用法:两份订阅地址分别填到哪

入门

Qure 官方给了两个订阅地址,分别对应两种使用场景。这是整个项目最需要记住的信息:

「PROXY」这类代理策略组,推荐用 Qure mini(纯白小图标);「自定义策略」这类按服务分组的,推荐用 Qure Color(彩色图标)。

两份地址原文如下:

纯白版(Qure mini):
https://raw.githubusercontent.com/Koolson/Qure/master/Other/Quremini.json

彩色版(Qure Color):
https://raw.githubusercontent.com/Koolson/Qure/master/Other/QureColor.json

为什么这么分?道理和家里的门牌一样:走廊上的一排房间用统一的白色门牌就够整齐,而每个房间内部的东西各不相同,才需要用不同颜色区分。策略组数量少、都是「主用/备用/直连」这种同级的,用纯白版更清爽;策略组是按 Netflix、YouTube、Apple 分服务的,用彩色版辨识度才高。

具体操作步骤

打开 QX 主界面,点右下角风车图标进入「风车(设置)」,找到「策略组」或直接编辑配置文件,你会看到类似下面的结构:

policy_path = https://example.com/my_config.conf

在配置文件的 [policy] 段落里,每个策略组都可以加一行 icon-url 参数,指向某个图标图片的网址。写法如下:

[policy]
static = 🇨🇳 中国, server-policy, url="https://raw.githubusercontent.com/Koolson/Qure/master/Other/QureColor.json", interval=3600, icon-url="https://raw.githubusercontent.com/Koolson/Qure/master/Color/China_Map.png"

看到 icon-url= 后面那一长串了吗?那就是某个具体图标的下载地址。它的规律很固定:

https://raw.githubusercontent.com/Koolson/Qure/master/Color/图标名.png

彩色图标放在 Color 目录下,纯白图标放在 BlackAndWhite 目录下,把中间的「图标名」替换成效果图里看到的名字即可。

更省事的方式:直接整份订阅

一个个手写 icon-url 很累,这也是 Qure 提供 JSON 清单的用意。在 QX 的「风车 → 策略组 → 订阅」里,把前面那两个 JSON 地址粘进去,QX 会自动把清单里的图标名称和图片对应起来——你只要保证策略组的命名和图标名对得上,图标就会自动出现。

四、命名对应:让图标自己「认领」策略组

进阶 · 推荐细读

订阅清单之所以能自动匹配,靠的是「名字对得上」。就像快递驿站按收件人名字取件,你的策略组叫什么名字,直接决定了能不能对上图标。

举几个实际例子,注意策略组名里的英文关键词:

Netflix, server-policy, img-url=Netflix.png
Apple, server-policy, img-url=Apple.png
China, server-policy, img-url=China_Map.png
Direct, server-policy, img-url=direct.png
Reject, server-policy, img-url=reject.png

这里有个容易忽略的细节:v2.7 版本里作者把 Direct.png、Proxy.png、Reject.png 这三个首字母大写的老名字归档了,改成了小写的 direct.png、proxy.png、reject.png。同时 x0.png、x1.png 等倍速图标也被改名归档。

如果你以前照着老教程配置,突然发现某些图标不显示了,多半是撞上了这次改名。解决办法是去效果图里查一下现在的正确名字,把配置里的文件名改过来。

另外 SS_Letter.png、VMess_Letter.png 这类带 _Letter 后缀的,是「只放协议字母」的简洁版图标,适合策略组名字已经写清楚协议、只想加个小角标的情况。

五、踩坑合集:图标不显示时按这个顺序排查

进阶 · 推荐细读

配置完发现图标一片空白?按下面顺序查,基本能覆盖九成情况:

第一,拼写。 图标文件名是区分大小写的,China_Map.png 和 china_map.png 是两个不同的文件,后者取不到。建议直接从效果图里复制名字,不要手打。

第二,网络。 图标托管在 GitHub 上,国内网络环境访问 raw.githubusercontent.com 经常不稳定。如果图片加载不出来,先在手机浏览器里打开那个图标地址试试——浏览器能显示,QX 才有希望取到。

第三,缓存。 改完配置后 QX 不一定立刻刷新,需要下拉刷新策略组列表,或者切换一次网络再切回来,让它重新请求。

第四,格式。 icon-url 后面的网址必须用英文双引号包起来,中间不能有空格和换行。中文输入法打出来的引号也会导致失效。

第五,位置。 icon-url 参数必须写在策略组那一行里,写错段落 QX 会直接忽略它,且不会报任何错误提示——这是新手最容易卡住的地方。

六、定制:找不到想要的图标怎么办

深入 · 老手可选

Qure 从 2019 年一路更新到 v2.7,新增了大量图标:从协议类的 SS.png、Trojan.png、VMess.png,到平台类的 App_Store.png、iCloud.png、TestFlight.png,再到地区类的 Malaysia.png、China_Map.png,覆盖面已经相当广。

但如果你想要的图标确实没有,有两条路:

一是自己画一张同尺寸的 PNG,传到自己的 GitHub 仓库或图床,然后在 icon-url 里填自己的地址。QX 对图标尺寸没有硬性要求,但保持和 Qure 现有图标接近的大小,视觉上才不会突兀。

二是去项目 Issues 提需求。作者对图标优化和更名一直比较活跃(v2.7 一次就更新了 30 多个图标),合理的请求是有可能被采纳的。

Qure 项目 Logo

需要提醒的是,作者在 README 里明确写了:图标仅用于资源共享和学习参考,不要用于商业用途或牟利;如果发现侵权内容可以在 Issues 反馈,核实后会删除。转载教程时也请注明出处。

七、判断建议:你到底需不需要用它

入门

如果你符合下面任意一条,Qure 值得用:

  • 策略组数量超过 5 个,已经开始记不住哪个是哪个;
  • 常需要在手机上快速切换线路,想靠视觉而不是靠文字定位;
  • 觉得纯文字界面太枯燥,想让它看起来像回事。

如果你只有一两个策略组,或者主要在 Mac/电脑上用 QX,图标的意义不大,不必折腾。

还有一点要分清:图标好看不代表网络更快。它纯粹是界面层面的美化,对速度、稳定性没有任何影响。别为了配图标花太多时间,配好了记得回归正事。

对使用其他同类工具(如 Loon、Shadowrocket、Surge)的朋友,思路是一样的——都是在策略配置里填 icon-url 指向图片地址,只是参数名和语法略有差异,Qure 的图片本身是可以跨工具复用的。

八、写在最后

Qure 这个项目的价值,用一句话概括就是:它把「配置文件」变成了一眼能懂的界面。不需要写代码,不需要编译,只要在配置里粘对一个网址,你的 QX 就能从满屏英文变成图文并茂的样子。

建议先从纯白版 Qure mini 起步,把基础策略组(direct / proxy / reject)配上,熟悉了命名规律之后再换彩色版,一次一个策略组地加。遇到图标不显示,回头对照第五节的顺序排查,绝大多数问题十分钟内能解决。

配置改动前建议先备份现有配置文件。改错内容导致连不上网络时,有备份就能立刻还原,不至于手足无措。

项目信息

项目 值
仓库 Koolson/Qure
语言 None
Star 3,511
Fork 701
主页 无

参考链接

延伸阅读

想继续探索?这些同领域的教程可能也适合你: