Clash Verge 策略组图标:图片链接、SVG 与缓存处理
在代理组配置中添加 icon,检查图标开关、YAML 格式和图片缓存。
本页目录
策略组图标显示在 Clash Verge Rev 的代理页面中,帮助区分节点选择、直连或特定用途的代理组。它由配置中每个代理组的 icon 字段决定,与系统托盘图标、节点国旗名称和订阅卡片图标不是同一项设置。
先确认图标显示开关
v2.5.8 中打开“设置 → Verge 基础设置 → 界面设置”,确认“代理组图标”已经启用。关闭这个开关时,即使配置包含正确的图标,界面也可能不显示。
接下来确认要修改的是当前启用订阅中的代理组。先保存原配置或创建备份,再在配置副本中试验。远程订阅更新可能重新生成原文件;需要长期保存的改动应放进适用的扩展配置或脚本,而不是依赖手动改一次下载文件。
方法一:使用图片 URL
下面是一个完整的最小本地示例。它只包含直连策略,用来验证图标,不包含可用代理节点,也不替代你的日常订阅:
mixed-port: 7897
mode: rule
log-level: info
proxy-groups:
- name: 示例分组
type: select
proxies:
- DIRECT
icon: https://www.clashverge.dev/assets/icons/google.svg
rules:
- MATCH,示例分组
在订阅页新建或导入本地配置副本后,启用该配置,打开“代理”页,检查“示例分组”旁是否出现图标。验证结束后切回原先的订阅,避免一直使用只有直连的测试配置。已有订阅只需给目标组添加 icon 行,不要用这个示例覆盖整份文件。
图片 URL 应直接返回图片,而不是带有登录按钮的网页或网盘分享页。检查图片能否单独打开;如果网址返回 HTML、403 或 404,先解决链接本身的问题。
方法二:使用 SVG 内容
不想依赖远程图片加载时,可以把简单 SVG 直接写进 YAML。以下是可替换目标代理组 icon 字段的示例:
icon: '<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32"><circle cx="16" cy="16" r="12" fill="#6758e8"/></svg>'
外层使用 YAML 单引号,SVG 属性使用双引号,避免大量转义。不要把完整 SVG 直接裸写成多行 YAML,也不要误删 icon: 前面的缩进。这个图形只作为图标,不改变策略组的选择方式和连接路径。
方法三:使用 Base64 数据地址
icon 也支持 data:image/...;base64, 形式。先将图片文件编码,再把完整数据地址作为字符串填入字段。以 SVG 为例:
data:image/svg+xml;base64,这里替换成SVG文件的Base64编码
这一行展示的是结构,不能原样用作有效图标。注意保留逗号后面的全部编码,不要添加换行或省略号。编码较长时,直接 SVG 内容通常更容易维护;照片或大型图片则不适合塞进配置。
图标大小与外观检查
官方文档说明策略组图标按 32 × 32 像素显示,并带圆角。细字、大量留白和极细线条缩小后容易模糊。选择颜色时同时检查浅色、深色模式,避免黑色图标在暗背景中消失。
保存后若整个配置无法加载,应先处理 YAML 错误:同组中的 name、type、proxies 和 icon 对齐;proxies 下的列表再缩进一级;复制 SVG 时检查引号是否成对。不要通过删除整个 proxy-groups 来绕过一个图标格式错误。
缓存、恢复与远程订阅更新
客户端下载的图标会缓存到应用数据目录的 icons/cache 下。远程文件换了内容而 URL 没变时,旧图可能仍被使用。可先用一个新的、实际存在的图片 URL 验证是否是缓存影响;需要清理时先退出客户端,只处理对应图标缓存,不删除配置目录、订阅文件或其他图标设置。
要撤销修改,删除目标组的 icon 字段并重新应用配置;要暂时隐藏所有策略组图标,关闭“界面设置”中的对应开关即可。如果订阅更新后图标消失,检查远程文件是否覆盖了手改内容,再把改动放入自己的持久扩展中。