Bettbox 是基于 Mihomo 的多平台客户端和网络/DNS 调试工具。它不提供节点或订阅;开始前需要准备自己有权使用的兼容配置。官方仓库提供桌面和 Android 发布包,也说明鸿蒙 NEXT 可以通过卓易通运行 Android 版。

1. 从官方 Releases 选择版本

打开 Bettbox 官方 Releases,优先选择正式版而不是带 pre 的预览版,再按设备系统和 CPU 架构下载。不要把 Linux 包、Windows 安装包和 Android APK 混用,也不要从转存站获取安装文件。

截至 2026-11-16,最新正式版为 v1.19.8。官方 README 当前列出的平台范围包括:

平台 官方说明 选择提示
Windows 8.1 及以上,x64 / ARM64 按处理器架构选安装包;README 说明管理员权限安装包已处理日常权限流程。
macOS 12.0 及以上,Intel / Apple Silicon Intel 选 amd64,Apple Silicon 选 arm64;下载 DMG。
Linux Kernel 5.4 及以上,x64 / ARM64 根据发行版选 AppImage、DEB 或 RPM,并核对架构;Arch 社区包由第三方维护。
Android Android 8.0 及以上,ARMv8 / ARMv7 / x86_64 / Universal 一般先确认设备 ABI;不确定时使用官方 Universal 包(若该版本提供)。
Android TV 官方列有大屏适配 选择与电视盒子架构匹配的包。
HarmonyOS NEXT 官方说明可通过卓易通运行 这是兼容环境运行 Android 版,不是原生 HarmonyOS HAP。

版本、附件和系统要求可能更新,下载时以 README 与 Release 页面为准。

2. 安装并完成首次连接

  1. 安装对应平台的官方包,首次启动时按系统提示完成必要权限授权。
  2. 导入自己已有的兼容配置或服务方提供的订阅。具体格式和导入入口以当前版本界面及服务方说明为准;不要把网页登录密码当成订阅地址。
  3. 确认配置列表中能看到配置或节点,再按应用界面选择节点/策略并启动代理。
  4. 分别访问一个应直连的网站和一个预期走代理的网站,验证实际流量,不只看应用的“已连接”状态。

3. 按平台排查常见问题

平台/现象 处理顺序
Android 后台一段时间后断开 检查系统电池优化和后台运行权限,按 Bettbox README 的建议允许必要的后台运行;不同品牌 Android 的设置名称可能不同。
Windows 无法启动或被安全软件拦截 重新从官方 Releases 获取正确架构的安装包,查看系统安全提示和 Bettbox 版本;提交问题前记录错误原文。
macOS 首次启动被 Gatekeeper 阻止 官方 README 提醒当前版本可能未购买 Apple 商业开发者证书。先确认 DMG 来自官方 Release,再按 README 的右键“打开”流程;若不确定来源,不要绕过系统拦截。
macOS / Linux 开启 TUN 失败 首次创建虚拟网络接口时按系统提示授权;检查系统密码、系统网络权限和其他代理/TUN 程序冲突。
订阅导入失败 核对链接有效期、网络可达性和服务方提供的配置格式;官方建议先在服务方后台重置已失效的订阅链接,再重试。不要公开完整订阅 URL。
连接启动但网页不通 先确认基础网络可用,再检查当前节点/策略、DNS 和分流规则;关闭其他可能占用系统代理或 VPN 的程序后再做一次对照测试。
HarmonyOS NEXT 找不到原生安装方式 官方列出的方式是通过卓易通运行 Android 版;不要把 Android APK 当作原生 HAP 安装。

需要反馈时,通过 官方 GitHub Issues 附上 Bettbox 版本、设备/系统版本、架构、网络类型、复现步骤和脱敏日志。不要附订阅凭据或节点密码。

官方资料