Clash For You
官方安装与排错指引

Karing 安装与配置教程

涵盖各操作系统平台的安装步骤、系统权限设置、常见安全弹窗排查与版本更新指引。

安全安装前须知

请务必确保您的安装文件来自官方 GitHub Release 或本站提供的官方直链。开源工具常因未向微软或苹果付费购买商业签名证书而被系统报毒或拦截,这属于正常现象。安装前可通过 SHA-256 哈希比对确认文件未被恶意修改。

Windows 系统安装步骤

步骤 1:获取安装包

根据系统选择 64 位(x64)或 ARM64 安装包(通常为 .exe 安装版或 .zip 便携免安装版)。

步骤 2:运行与 Windows SmartScreen 拦截排查

运行安装文件时,Windows Defender 可能弹出“Windows 已保护你的电脑”蓝色提示窗口:

  1. 点击提示框中的 “更多信息” (More info)
  2. 出现按钮后,点击 “仍要运行” (Run anyway) 即可继续安装。
步骤 3:WebView2 运行环境说明(如适用)

部分现代客户端基于 Tauri 或 WebView2 渲染界面。Windows 10/11 系统通常已内置该组件;如遇提示缺少运行环境,可下载官方提供的 fixed_webview2 版本,或前往微软官网安装 Microsoft Edge WebView2 Runtime。

macOS 系统安装步骤

步骤 1:架构区分

Apple Silicon (M1/M2/M3/M4) 设备请下载 aarch64 / arm64.dmg;Intel 处理器设备请下载 x64.dmg

步骤 2:拖拽安装

双击打开下载的 .dmg 镜像文件,将应用图标拖拽至 Applications (应用程序) 文件夹中。

步骤 3:排查“已损坏”或“未受信任开发者”提示

由于开源构建通常不包含苹果开发者付费公证签名,首次启动可能提示“无法打开”或“已损坏”:

方法 A(系统设置):前往 系统设置 → 隐私与安全性 (Privacy & Security),向下滚动至安全性部分,点击刚被拦截软件旁边的 “仍要打开” (Open Anyway)

方法 B(终端命令移除隔离属性):打开终端(Terminal),执行以下命令:

sudo xattr -cr /Applications/Karing.app

Android 系统安装说明

步骤 1:选择 APK 安装包

绝大部分现代 Android 手机均采用 64 位 ARM 架构,请下载标注 arm64-v8a.apk 的安装包;较老设备可选择 armeabi-v7a.apk

步骤 2:允许安装未知应用

从浏览器或文件管理器点击 APK 时,系统会提示“禁止安装未知来源应用”,进入系统权限设置中开启“允许来自此来源的安装”即可完成安装。

iOS 系统安装指南 (iPhone / iPad)

官方首选:Apple App Store 一键下载

Karing 官方正版已正式上架苹果 App Store,支持 iPhone 与 iPad 设备直接安装与自动后台更新。

前往 App Store 安装
账号区域说明:如在国区 App Store 无法检索到,请将 App Store 账号切换为香港区、美区等国际 Apple ID 即可搜索并下载。
备用途径:TestFlight 邀请或 IPA 侧载

如暂无非国区 Apple ID,亦可访问 Karing 官方 GitHub 仓库加入 TestFlight 公测计划,或下载官方 IPA 安装包通过 AltStore 等自签名工具进行侧载安装。

如何升级与更新版本?

开源客户端升级通常有两种方式:

  • 覆盖安装:直接前往 Karing 下载页 获取最新安装包,关闭正在运行的应用后直接运行新安装包覆盖,历史配置与节点信息均会被保留。
  • 应用内检查更新:在软件“设置”或“关于”中检查官方 Release 更新通道。