帮助与支持Help and support

遇到问题，
我们从证据开始。When something breaks,
start with evidence.

请勿公开订阅地址、激活码、节点密码、私钥或完整配置。Never post subscription URLs, activation keys, node passwords, private keys, or complete profiles.

提交问题前Before reporting

  1. 确认正在使用的版本、构建号和 macOS 版本。Record the AetherRoute version, build, and macOS version.
  2. 在“设置 → 诊断”导出隐私安全报告。Export the privacy-safe report from Settings → Diagnostics.
  3. 说明使用透明代理还是 TUN、问题是否可复现，以及其他代理软件是否同时运行。State whether you use Transparent Proxy or TUN, whether it reproduces, and whether another proxy app is running.
  4. 若单个节点失败，确认同一节点在独立客户端中的实际握手结果。For a node-specific failure, confirm the same node's real handshake in an independent client.

联系渠道Contact

GitHub Issues

适合可复现的错误、兼容性问题和功能建议。For reproducible bugs, compatibility issues, and feature requests.

创建问题Open an issue

Security

安全漏洞请遵循仓库 SECURITY.md 的私密报告流程，不要创建公开问题。For vulnerabilities, follow the private reporting process in SECURITY.md instead of opening a public issue.

安全策略Security policy

首次启用网络扩展Enable the Network Extension

透明代理和 TUN 可以路由网络流量，因此 macOS 15 或更高版本要求您亲自批准。AetherRoute 会把您带到正确的系统设置页面，但不会绕过、自动点击或模拟这项安全授权。Transparent Proxy and TUN can route network traffic, so macOS 15 or later requires your approval. AetherRoute takes you to the correct System Settings page but never bypasses, auto-clicks, or simulates this security authorization.

  1. 将 AetherRoute 拖到“应用程序”，打开后导入或选择一个有效配置，再点击连接。Move AetherRoute to Applications, open it, import or select a valid profile, then click Connect.
  2. 出现“批准网络扩展”卡片后，点击“打开系统设置”。When the “Approve Network Extension” card appears, click “Open System Settings.”
  3. 在“通用 → 登录项与扩展”中继续滚动到页面底部的“扩展”区域；不要操作上方的“登录时打开”列表。In General → Login Items & Extensions, scroll to the Extensions section at the bottom. Do not use the Open at Login list.
  4. 找到“网络扩展”，点右侧信息按钮 ⓘ，打开 AetherRoute，然后点“完成”。Next to Network Extensions, click the info button, turn on AetherRoute, then click Done.
  5. 返回 AetherRoute，点击“已批准，重新检查”；应用会继续刚才的连接。Return to AetherRoute and click “Approved — Check Again.” The app resumes the pending connection.
不需要降低系统安全性。Reduced Security is not required. AetherRoute 使用 Apple 的用户空间 Network Extension，不需要关闭 SIP，也不需要在恢复模式启用内核扩展。如果这台 Mac 由组织管理且开关不可用，请联系管理员批准网络扩展。AetherRoute uses Apple's user-space Network Extension. It does not require disabling SIP or enabling kernel extensions in Recovery. If this Mac is managed and the switch is unavailable, ask your administrator to approve the Network Extension.

查看 Apple 的“登录项与扩展”官方说明Read Apple's Login Items & Extensions guide

仍然看不到 AetherRoute？Still cannot find AetherRoute?

  1. 确认 App 位于“应用程序”文件夹，而不是仍从 DMG 或下载目录运行。Confirm the app is in Applications rather than running from the DMG or Downloads.
  2. 完全退出 AetherRoute，重新打开，再点击一次连接以重新提交安装请求。Quit AetherRoute completely, reopen it, and click Connect once to submit the installation request again.
  3. 若系统要求重启，请先保存工作并按提示重启；返回后点击“已批准，重新检查”。If macOS asks for a restart, save your work and restart as instructed; then return and click “Approved — Check Again.”
  4. 仍失败时，在“设置 → 诊断”导出隐私安全报告，并附上错误文字；不要发送订阅、节点密码或私钥。If it still fails, export the privacy-safe report from Settings → Diagnostics and include the exact error text. Never send subscriptions, node passwords, or private keys.