Clash Verge for iOS（Clash Verge 苹果版）是一个专注于 Apple 全平台的网络代理客户端项目。 它的诞生源于一个简单但强烈的信念：Apple 用户值得拥有真正原生的代理体验。 市面上现有的 iOS 代理工具大多功能陈旧、界面过时、对 iPad 和 Mac 的适配敷衍了事， 更遑论 iCloud 同步、快捷指令集成或 Watch 伴侣应用等 Apple 独有能力。 我们决定从头开始——用Swift 和 SwiftUI编写真正的原生代码， 遵循 Apple Human Interface Guidelines 设计规范， 充分利用 iCloud Drive / Shortcuts / WidgetKit / WatchKit 等 Apple 框架能力。 基于 mihomo (Clash.Meta) 内核驱动全部协议支持， 目标是打造 Apple 平台上最优雅、最强大、最「苹果味」的代理客户端。
核心特性
Apple 全平台原生覆盖
一套代码库同时服务 iPhone / iPad / Mac / Apple Watch 四端设备。SwiftUI 跨平台声明式 UI + Platform-specific 适配层确保每端体验都原生流畅。
iCloud 无缝同步生态
利用 CloudKit 和 iCloud Drive 实现配置实时双向同步。在 iPhone 上添加的订阅自动出现在 Mac 上，切换的节点状态全平台一致。
Swift & SwiftUI 纯原生技术栈
不使用任何跨平台框架（如 Flutter 或 React Native）。100% Swift/SwiftUI 编写，完全遵循 Apple HIG 人机交互设计指南，性能和体验均达到系统级水准。
Apple Silicon 极致性能优化
mihomo 内核 ARM64 原生编译，针对 M 系列芯片统一内存架构专项优化。实测吞吐量提升 40%+，功耗降低 60%，MacBook 续航几乎不受影响。
Shortcuts & WidgetKit 深度整合
提供 20+ 个 Shortcuts Action 支持自动化场景，三种尺寸桌面 Widget 实时显示连接状态和速度数据。与 Apple 自动化生态无缝衔接。
完全免费且开源
遵循 GPL-3.0 协议开源发布。无广告、无内购、无追踪、无付费墙。源代码公开在 GitHub，接受社区贡献和代码审查。
技术架构
| 层级 | iOS / iPadOS | macOS | 说明 |
|---|---|---|---|
| UI 层 | SwiftUI + UIKit | SwiftUI + AppKit | 声明式 UI 框架 + 平台适配 |
| 引擎层 | mihomo (Clash.Meta) | C/Go 语言多协议代理内核 | |
| 网络层 | Network Extension (NE) | Apple 系统 TUN/VPN API | |
| 同步层 | CloudKit + iCloud Drive | 配置跨设备双向同步 | |
| 数据层 | Core Data / UserDefaults | 本地持久化存储 | |
| 自动化 | Intents (Shortcuts) | 20+ 快捷指令 Action | |
| 小组件 | WidgetKit + TimelineProvider | 三尺寸桌面 Widget | |
| 手表 | WatchKit (独立 App) | watchOS 8+ 伴侣应用 | |
| 最低 SDK | iOS 14.0 / iPadOS 14.0 | macOS 11.0 Big Sur | 覆盖绝大多数活跃设备 |
快速上手（3 步）
下载安装到您的 Apple 设备
iPhone/iPad 用户通过 TestFlight 安装（推荐）或 IPA 侧载； macOS 用户下载 DMG 包拖入应用程序文件夹即可。
授权并导入订阅配置
首次打开时授予 VPN 权限和本地网络权限。 进入「配置」页面，通过 URL / 扫码 / 文件导入您的订阅链接。
选择节点，一键连接
从节点列表选择服务器，点击连接按钮。 状态栏出现钥匙图标即表示代理已生效。可通过通知中心、小组件或 Apple Watch 控制状态。
致谢
强大的多协议代理内核引擎，是整个项目的基石。mihomo 的卓越性能和丰富的协议支持让一切成为可能。
开创性的 YAML 规则配置理念和伪代架构，构建了庞大的规则集社区和生态系统。
提供了 SwiftUI、Network Extension、CloudKit、WidgetKit、WatchKit 等优秀的框架，让我们能实现真正的原生体验。
维护了最流行的 Clash 规则集 DIRECT 和 REJECT 规则，国内分流变得简单高效。
本项目遵循 GNU General Public License v3.0 协议发布。
您可以自由使用、修改和分发本软件，但衍生作品需同样以 GPL-3.0 协议开源。
完整许可证文本请参阅 LICENSE 文件。