Windows x64 与 Android ARM64 的 sing-box 图形客户端
中文 · English
下载 AikoBox · 自用快速上手 · 问题反馈
AikoBox 以 sing-box 为唯一代理内核。Windows 端兼容 Clash YAML 订阅，并重点保护系统代理恢复、候选配置校验与故障回滚；Android 端通过系统 VpnService 运行锁定版本的 libbox。
Warning
AikoBox 仍处于 0.x Beta。Windows 预发行包目前没有受信任的 Authenticode 签名，可能触发“未知发布者”或 SmartScreen；Android APK 使用项目固定发布证书签名。首次使用时请保留现有代理和配置备份，不要立即把 Beta 作为设备唯一的联网方案。
| 能力 | Windows x64 | Android arm64-v8a |
|---|---|---|
| 原生 sing-box JSON | 支持 | 支持 |
| Clash YAML 与订阅 URI | 支持 | 暂不支持 |
| 订阅管理与自动更新 | 支持 | 暂不支持 |
| 节点延迟测试 | 支持 | 暂不支持 |
| 普通系统代理 | 支持 | 不适用 |
| TUN / 系统 VPN | 安装版支持 | 支持 |
| 应用分流 | 通过规则配置 | 暂不支持 |
| 安全更新与回滚 | 支持 | 配置校验后切换 |
Android 当前公开版专注于可靠运行原生 sing-box JSON。Clash YAML 转换、订阅管理、节点测速、应用分流和自动更新订阅在后续版本计划中；README 不把实验代码中的能力视为已发布功能。
请只从 GitHub Releases 下载。
aikobox-windows-<version>-x64-setup.exe：安装到 Program Files，支持系统代理和 TUN；安装及 TUN 需要管理员授权。aikobox-windows-<version>-x64-portable.exe：单文件便携版，仅支持普通系统代理。- 两个文件目前均为明确标注的未签名 Beta。发布工作流会验证它们确实未签名，并附带 SHA-256。
aikobox-android-<version>-arm64-v8a.apk：Android 7.0（API 24）或更高，仅支持 ARM64。- APK 使用固定发布证书签名；证书 SHA-256：
8896E81ED78BAACCD385DB95D4591FAA8EC7EF5A87D488258DBA53DA65276B94 - 不提供 Play 商店、armeabi-v7a、x86 或 x86_64 安装包。
每个二进制都有同名 .sha256，Release 还提供统一的 SHA256SUMS.txt、构建清单、第三方许可审计，以及核心组件的对应源码和许可证材料。
在 PowerShell 中校验下载文件：
$file = '.\aikobox-windows-0.1.0-beta.3-x64-setup.exe'
$expected = ((Get-Content "$file.sha256") -split '\s+')[0]
$actual = (Get-FileHash $file -Algorithm SHA256).Hash.ToLowerInvariant()
$actual -ceq $expected结果必须为 True。校验和只能证明文件与发布清单一致，不能替代可信下载来源和代码签名。
- 保留当前可用的代理软件。
- 导入订阅链接并等待节点出现。
- 先选择节点并启用普通系统代理，不要第一次就启用 TUN。
- 验证网页和常用应用正常联网。
- 退出 AikoBox，确认 Windows 系统代理已恢复且仍可联网。
- 从 Release 安装 ARM64 APK，并允许系统 VPN 和通知权限。
- 从本地文件、HTTPS 地址或粘贴内容导入原生 sing-box JSON。
- 先执行配置校验，再授予 VPN 权限并连接。
- 测试 Wi-Fi、移动网络切换和停止连接。
完整的安全试用步骤见 自用快速上手。
- 失败关闭：关键配置无法安全转换或校验失败时，拒绝切换，不静默退回直连。
- 保护现有连接：候选配置先校验；系统代理恢复或核心停止失败时，不假装退出成功。
- 可验证供应链：锁定 sing-box、libbox 和 sysproxy 来源、版本、哈希及许可证证据。
- 不静默安装：应用和内核更新都需要用户明确操作。
- 最小化秘密暴露：订阅 URL、认证信息、控制器密钥和日志按敏感信息处理。
- Windows 10 或 Windows 11，x64。
- 普通系统代理不需要管理员权限。
- TUN 只在安装版可用，并需要管理员授权。
- 不支持 macOS、Linux、Windows on ARM 或 32 位 Windows。
- Android 7.0（API 24）或更高，arm64-v8a。
- 必须授予 VPN 权限；Android 13 及以上还需通知权限。
- 当前仅导入原生 sing-box JSON，不承诺 Clash YAML、订阅 URI、应用分流、快捷磁贴或开机自启。
src/：Windows Electron 客户端、Clash 订阅处理和 sing-box 转换。apps/android/：当前 Release 使用的精简 Android 客户端。mobile/：实验中的下一代 Android 客户端，包含更多 UI 和跨平台转换工作；不属于当前公开 APK。
两套 Android 代码的功能不能混为一谈。只有 .github/workflows/release.yml 构建并验证的 apps/android/ 会进入当前 GitHub Release。
Windows 开发要求 Node.js 22 和仓库声明的 pnpm 版本：
corepack enable
pnpm install --frozen-lockfile
node scripts/prepare.mjs --x64
pnpm run review
pnpm test
pnpm run build:win当前 Android 发布链锁定 Flutter 3.44.4、JDK 17、Go 1.24.7、Android SDK 36 和 NDK r28。完整的 libbox 构建、签名、ABI 与许可证验证以 质量工作流 和 发布工作流 为准。
- Android Clash YAML 与订阅 URI 转换
- Android 订阅管理和手动刷新
- Android 节点延迟测试
- Android 应用分流
- Android 后台自动更新订阅
- Windows 受信任代码签名
路线图表示开发方向，不承诺具体发布日期。
- 安全问题请按 SECURITY.md 私密报告，不要公开订阅、令牌或未脱敏日志。
- 开发和提交要求见 CONTRIBUTING.md。
- 第三方组件、来源和许可证见 THIRD_PARTY_NOTICES.md。
AikoBox fork 自 Clash Party，感谢其贡献者。项目依据 GPL-3.0-only 开源。