chen2he/orange-cloud

## 中文 Orange Cloud 是一款面向 iPhone、iPad 与 Apple Watch 的 Cloudflare 第三方管理客户端，完全使用 Swift 与 SwiftUI 构建。与其他客户端不同，它通过 Cloudflare 官方 **OAuth 2.0 + PKCE** 流程登录——无需手动复制粘贴 API Token。以 iOS 17 为基线，并在支持的设备上渐进增强 iOS 18 / 26 的新能力。 ### 功能 - **OAuth 2.0 + PKCE 登录**，按 scope 勾选授权；Token 仅存 Keychain，支持多个 Cloudflare 账号并存切换。 - **域名与 DNS**——域名列表、DNS 记录增删改查、一键代理开关、域名设置。 - **流量分析**——基于 GraphQL Analytics API，用 Swift Charts 绘制图表（24 小时免费，7 天 / 30 天需 Pro）。 - **Workers**——脚本列表与详情，以及实时日志流（类似 `wrangler tail` 的 WebSocket trace），配合锁屏与灵动岛 Live Activity。 - **Snippets**——查看、编辑、新建 zone 级 Cloudflare 边缘代码及其触发规则。 - **存储**——R2 存储桶与对象浏览、D1 SQL 查询控制台、KV 键值管理。 - **安全与网络**——WAF 自定义规则（查看 / 启停）与 Cloudflare 隧道状态。 - **Apple Watch App**——在手腕上查看域名与 24 小时请求，并支持表盘 complication。 - **系统深度集成**——主屏与锁屏小组件、控制中心控件、Siri / App Intents、Spotlight 索引、后台 Token 静默刷新、iPad 双栏布局。 - **9 语言本地化**：简体中文、繁體中文（台灣）、繁體中文（香港）、English、日本語、Español (México)、한국어、Português (Brasil)、Português (Portugal)。 ### 免费、Pro 与开源 App 免费版支持单账号与完整的域名 / DNS 功能。在 App Store 官方版中，Pro 订阅（或一次性买断）可解锁多账号、存储 Tab（R2 / D1 / KV）、Workers 实时日志、WAF、隧道、Snippets，以及 7 天 / 30 天流量分析。所有主屏与锁屏小组件、Apple Watch App 以及全部 Siri 捷径始终免费。 本仓库采用 **AGPL-3.0 + Commons Clause** 许可：自行编译自用完全自由——为自编译构建添加 `OPENSOURCE_UNLOCKED` 编译条件，即可零成本解锁**全部** Pro 功能。Commons Clause 仅限制将本软件用于商业销售，AGPL 允许的其余权利不受影响。详见 [LICENSE](LICENSE)、[TRADEMARK.md](TRADEMARK.md) 与 [CLA.md](CLA.md)。 ### 仓库结构 ``` orange-cloud/ ├── apps/ │ ├── ios/ # The iOS / iPadOS / watchOS app (Swift / SwiftUI, Xcode project) │ ├── android/ # The Android client (Kotlin / Jetpack Compose) — in active development │ └── web/ # Landing page + OAuth callback relay (Next.js on Cloudflare Workers) ├── package.json # pnpm workspaces root └── turbo.json ``` ### 自行编译 1. **Xcode 26 或更高版本**，打开 `apps/ios/Orange Cloud/Orange Cloud.xcodeproj`。App 面向 iOS 17 与 watchOS 10.6，并内嵌 Apple Watch 配套 App。 2. 自建 **Cloudflare OAuth Client** 并部署你自己的回调中转（见 [`apps/web/`](apps/web/README.md)）——官方 Client ID 与 `orange-cloud.chatiro.app` 中转不向第三方构建开放。 3. 向主 target 的 `SWIFT_ACTIVE_COMPILATION_CONDITIONS` 添加 `OPENSOURCE_UNLOCKED` 以解锁全部功能。 4. 将 Bundle ID、App Group 与签名团队改为你自己的。 ## 中文 Orange Cloud 是一款面向 iPhone、iPad 与 Apple Watch 的 Cloudflare 第三方管理客户端，完全使用 Swift 与 SwiftUI 构建。与其他客户端不同，它通过 Cloudflare 官方 **OAuth 2.0 + PKCE** 流程登录——无需手动复制粘贴 API Token。以 iOS 17 为基线，并在支持的设备上渐进增强 iOS 18 / 26 的新能力。 ### 功能 - **OAuth 2.0 + PKCE 登录**，按 scope 勾选授权；Token 仅存 Keychain，支持多个 Cloudflare 账号并存切换。 - **域名与 DNS**——域名列表、DNS 记录增删改查、一键代理开关、域名设置。 - **流量分析**——基于 GraphQL Analytics API，用 Swift Charts 绘制图表（24 小时免费，7 天 / 30 天需 Pro）。 - **Workers**——脚本列表与详情，以及实时日志流（类似 `wrangler tail` 的 WebSocket trace），配合锁屏与灵动岛 Live Activity。 - **Snippets**——查看、编辑、新建 zone 级 Cloudflare 边缘代码及其触发规则。 - **存储**——R2 存储桶与对象浏览、D1 SQL 查询控制台、KV 键值管理。 - **安全与网络**——WAF 自定义规则（查看 / 启停）与 Cloudflare 隧道状态。 - **Apple Watch App**——在手腕上查看域名与 24 小时请求，并支持表盘 complication。 - **系统深度集成**——主屏与锁屏小组件、控制中心控件、Siri / App Intents、Spotlight 索引、后台 Token 静默刷新、iPad 双栏布局。 - **9 语言本地化**：简体中文、繁體中文（台灣）、繁體中文（香港）、English、日本語、Español（墨西哥）、한국어、Português（巴西）、Português（葡萄牙）。 ### 免费、Pro 与开源 App 免费版支持单账号与完整的域名 / DNS 功能。在 App Store 官方版中，Pro 订阅（或一次性买断）可解锁多账号、存储 Tab（R2 / D1 / KV）、Workers 实时日志、WAF、隧道、Snippets，以及 7 天 / 30 天流量分析。所有主屏与锁屏小组件、Apple Watch App 以及全部 Siri 捷径始终免费。 本仓库采用 **AGPL-3.0 + Commons Clause** 许可：自行编译自用完全自由——为自编译构建添加 `OPENSOURCE_UNLOCKED` 编译条件，即可零成本解锁**全部** Pro 功能。Commons Clause 仅限制将本软件用于商业销售，AGPL 允许的其余权利不受影响。详见 [LICENSE](LICENSE)、[TRADEMARK.md](TRADEMARK.md) 与 [CLA.md](CLA.md)。 ### 仓库结构 ``` orange-cloud/ ├── apps/ │ ├── ios/ # iOS / iPadOS / watchOS App（Swift / SwiftUI，Xcode 工程） │ ├── android/ # Android 客户端（Kotlin / Jetpack Compose）——开发中 │ └── web/ # 落地页 + OAuth 回调中转（Next.js on Cloudflare Workers） ├── package.json # pnpm workspaces 根 └── turbo.json ``` ### 自行编译 1. **Xcode 26 或更高版本**，打开 `apps/ios/Orange Cloud/Orange Cloud.xcodeproj`。App 面向 iOS 17 与 watchOS 10.6，并内嵌 Apple Watch 配套 App。 2. 自建 **Cloudflare OAuth Client** 并部署你自己的回调中转（见 [`apps/web/`](apps/web/README.md)）——官方 Client ID 与 `orange-cloud.chatiro.app` 中转不向第三方构建开放。 3. 向主 target 的 `SWIFT_ACTIVE_COMPILATION_CONDITIONS` 添加 `OPENSOURCE_UNLOCKED` 以解锁全部功能。 4. 将 Bundle ID、App Group 与签名团队改为你自己的。 贡献流程与 CLA 详见 [CONTRIBUTING.md](CONTRIBUTING.md)。

标签：Cloudflare, iOS, MITRE ATT&CK, OAuth, SwiftUI, 客户端, 移动开发, 程序员工具