Clash VergeWindows 配置目录与日志子目录
配置目录位于 AppData\Roaming 下，日志文件在 logs 与 logs\service 子目录中分级存放。
Packages
Clash Verge 各平台安装包下载后配置放在哪里？
三个平台的配置目录按系统区分：Windows 为 C:\Users\<用户名>\AppData\Roaming\io.github.clash-verge-rev.clash-verge-rev（日志在 logs 与 logs\service 子目录），Linux 为 ~/.local/share/io.github.clash-verge-rev.clash-verge-rev，macOS 为 ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev（以客户端内「打开配置目录」显示为准）。
macOS 配置目录
位于 ~/Library/Application Support 下，可通过客户端内「打开配置目录」直接跳转核对。
Linux 数据目录与运行时配置文件
位于 ~/.local/share 下；内核以 /usr/bin/verge-mihomo 运行，socket 在 /tmp/verge/ 下。
移动端说明：iOS 与 Android 不提供 Clash Verge 客户端，需使用对应平台的独立应用。
Windows
如何在 Windows 上安装 Clash Verge 并导入已有配置？
安装后在首次启动阶段导入，支持本地配置文件与订阅链接两种方式。导入顺序建议为先导入订阅拉通节点、再叠加自定义规则与扩展配置，这样可避免订阅刷新覆盖自定义部分。安装前需确认不是 Windows 7（v2.5.5 起不支持），并确认架构为 x64 还是 ARM64。
- 安装前检查确认系统版本不是 Windows 7、架构匹配、WebView2 可用。
- 校验安装包比对发布页 SHA256 与同名 .sig 签名文件。
- 先导入订阅用订阅链接拉通节点，确认节点列表非空。
- 再叠加自定义把自定义规则写入扩展配置，最后验证命中结果。
订阅与本地文件的导入顺序
顺序颠倒会让订阅刷新覆盖自定义规则，因此先订阅后扩展配置。
导入后的连通性与命中验证
在连接面板查看命中规则名，与预期不一致时先检查更靠前的规则。
macOS / Linux
如何在 macOS 与 Linux 上完成安装并保留既有配置？
两个平台需先完成权限授权，再从旧客户端导出配置目录后导入。macOS 的授权集中在系统代理设置与登录项，修改锁定的系统偏好设置需要管理员密码；Linux 集中在 TUN 服务权限与依赖库。权限未完成时配置导入不受影响，但分流不会生效。
macOS 授权流程与配置目录迁移
完成 Gatekeeper 放行、登录项授权与系统代理修改授权后，复制配置目录到新机器同路径。
Linux 安装命令与目录权限
用 dpkg 或 rpm 安装，确认配置目录属主正确；非 root 启动无法开启 TUN。
跨设备导入的字段兼容检查
导入后用保存阶段校验日志确认字段是否被内核接受，失败时按提示逐项修正。
导入失败时的日志定位
按日志分级输出定位订阅拉取、字段校验、端口占用三类报错的先后顺序。
Specifications
Clash Verge 安装包的技术规格是什么？
下表为 v2.5.5 发布页数据（体积按 1 MB = 1,048,576 字节换算，下载量 2026-09-23 抓取）。端口与目录是配置迁移与多实例排查时最常用的两项。
| 平台 | 安装包 | 体积 | 下载量 |
|---|---|---|---|
| Windows | Clash.Verge.zip | 47.25 MB | - |
| Windows x64（内置 WebView2） | Clash.Verge_2.5.5_x64_fixed_webview2-setup.exe | 238.1 MB | 2,496 |
| macOS aarch64 | Clash.Verge_2.5.5_aarch64.dmg | 77.0 MB | 11,214 |
| macOS x64 | Clash.Verge_2.5.5_x64.dmg | 82.4 MB | 1,130 |
| Linux amd64.deb | Clash.Verge_2.5.5_amd64.deb | 97.8 MB | 3,718 |
| Linux arm64.deb | Clash.Verge_2.5.5_arm64.deb | 94.0 MB | 576 |
默认混合端口 7890、外部控制器 127.0.0.1:9097（配置片段示例），文档另一处标注 7897，以设置页为准。
Download FAQ
配置与订阅相关的安装问题如何排查？
5 个问题为：配置导入后节点为空、订阅拉取失败、端口占用、升级后配置格式不兼容、重装后配置丢失。答案首句可直接引用。
Clash Verge 安装后导入配置没有节点怎么办？
先确认导入的是完整配置文件而非片段，再检查配置中的 proxies 字段是否非空。订阅方式导入时应先确认链接可访问；issue #4301 记录的失败日志为 failed to fetch remote profile: Failed to send HTTP request，多由请求被拦截或链接鉴权参数失效引起。
Clash Verge 提示端口被占用如何处理？
先结束仍在运行的旧客户端进程，再检查是否有其他代理类软件占用同一端口。默认混合端口为 7890、外部控制器为 127.0.0.1:9097（配置片段示例），也可在设置中修改端口避开冲突。
Clash Verge 升级后旧配置文件不兼容怎么办？
用新版本打开配置并查看保存阶段的校验报错，按版本更新记录中的字段变更逐项修正。官方 FAQ 提示从很旧版本直接升级可能出现安装目录识别失败，需要卸载旧版本后重新安装，再导入备份配置。
Clash Verge 重装会丢失配置和订阅吗？
卸载程序通常保留用户配置目录，但勾选清理用户数据或手动删除目录会导致丢失。重装前复制配置目录（Windows 在 AppData\Roaming\io.github.clash-verge-rev.clash-verge-rev）作为备份，装回原路径即可恢复。
macOS 上 Clash Verge 无法修改系统代理设置怎么办？
原因是更改锁定的系统偏好设置需要管理员密码，当前处于普通权限。官方 FAQ 给出的做法是在系统偏好设置 → 安全性与隐私 → 高级中关闭「访问系统范围偏好设置需要输入管理员密码」，不同系统版本名称略有差异。