Mac：三步开始使用
- 下载免费 Beta 或稳定版，打开 DMG，将 AetherRoute 拖入“应用程序”，再从“应用程序”打开。
- 在“配置”中添加自己的订阅、节点或本地配置。路由资源已随应用提供，无需单独下载数据库。
- 回到“概览”点击连接，按下方步骤批准 macOS 网络扩展，然后返回应用继续连接。
免费版不需要账号或付费激活。应用本身不提供订阅或代理节点。
Mac：首次启用网络扩展
透明代理和 TUN 可以路由网络流量，因此 macOS 15 或更高版本要求您亲自批准。AetherRoute 会把您带到正确的系统设置页面，但不会绕过、自动点击或模拟这项安全授权。
- 将 AetherRoute 拖到“应用程序”，打开后导入或选择一个有效配置，再点击连接。
- 出现“批准网络扩展”卡片后，点击“打开系统设置”。
- 在“通用 → 登录项与扩展”中继续滚动到页面底部的“扩展”区域；不要操作上方的“登录时打开”列表。
- 找到“网络扩展”，点右侧信息按钮 ⓘ，打开 AetherRoute，然后点“完成”。
- 返回 AetherRoute，点击“已批准，重新检查”；应用会继续刚才的连接。
不需要降低系统安全性。AetherRoute 使用 Apple 的用户空间 Network Extension，不需要关闭 SIP，也不需要在恢复模式启用内核扩展。如果这台 Mac 由组织管理且开关不可用，请联系管理员批准网络扩展。
显示已连接，但网页打不开
“已连接”不能保证每个节点和网站都能访问。先确认实际网页是否可用，再按以下顺序排查：
- 确认当前配置和选择的节点正确；需要代理的网站应使用代理节点，避免误选 DIRECT（直连）。
- 如果还有其他代理或 VPN 软件正在连接，先断开它们，再重新连接 AetherRoute 一次。
- 尝试另一个已知可用的节点，并访问两个不同的网站。记录是所有网站都失败，还是只有某个网站无法访问。
- 仍然失败时，记录使用的是 TUN 还是透明代理，以及页面或应用显示的错误，再导出下方的诊断报告。
如需恢复原有网络，先点击“断开连接”。不要为了排查而关闭系统完整性保护或删除系统网络文件。
仍然看不到 AetherRoute？
- 确认 App 位于“应用程序”文件夹，而不是仍从 DMG 或下载目录运行。
- 完全退出 AetherRoute，重新打开，再点击一次连接以重新提交安装请求。
- 若系统要求重启，请先保存工作并按提示重启；返回后点击“已批准，重新检查”。
- 仍失败时，在“设置 → 诊断”导出隐私安全报告，并附上错误文字；不要发送订阅、节点密码或私钥。
Mac 与多台 iPhone：iCloud 加密配置同步
例如：在 Mac 整理好订阅后，将配置同步到日常使用的 iPhone 与备用 iPhone。多台设备共享配置，但连接开关仍独立控制；不会因为一台设备连接或断开，就要求其他设备做相同操作。
- 在 Mac 和每台 iPhone 上安装支持 iCloud 同步的 AetherRoute 版本，并登录同一 Apple 账户。
- 在系统设置中开启「iCloud 密码与钥匙串」，并在每台设备的 App 中分别启用 iCloud 同步。
- 先在已有配置的设备上传，再在其他 Mac 或 iPhone 上拉取配置。云端与本地已有配置会合并，每台设备保留自己的活动配置和连接控制。
功能预告：iPhone 端同步仍在测试与完善，以上为预期使用方式，以正式发布版本为准。配置使用 AES-256-GCM 加密后写入 iCloud；若提示密钥不可用，请检查相关设备的 Apple 账户及 iCloud 钥匙串设置，等待系统完成同步后重试。
iPhone：系统要求与测试进度
iPhone 版仅支持 iOS 26 及以上版本，不支持更早的 iOS 系统。适用机型为 iPhone 12 系列及后续机型，设备需升级至受支持的系统版本后才能安装使用。即将上架，部分功能仍在测试与优化中，暂未开放公开下载。具体上架时间与下载方式将在官网公布。
提交问题前
- 确认正在使用的版本、构建号和 macOS 版本。
- 在“设置 → 诊断”导出隐私安全报告。
- 说明使用透明代理还是 TUN、问题是否可复现，以及其他代理软件是否同时运行。
- 若单个节点失败，说明它是否能在你原来使用的客户端中正常连接。
官方支持渠道
- GitHub Issues：适合可复现的错误、兼容性问题和功能建议。
- 安全漏洞：请遵循仓库 SECURITY.md 的私密报告流程，不要创建公开问题。