OwnBox for Android 是基于 sing-box 的 Android 客户端,提供配置/订阅管理、节点测试、应用与域名分流、网络诊断和备份功能。它本身不提供节点或订阅;开始前需要准备自己有权使用的服务配置。

1. 从官方 Releases 下载正式版

打开 OwnBox 官方 GitHub Releases,优先下载标记为正式 Release 的安装包。仓库的 main 分支可能是预览版,版本号靠前或更新不代表它比正式版更适合日常使用;先读发布说明,确认正式版/预览版标记。

截至 2026-11-16,仓库 README 将最新正式版列为 v26.11.8,同时说明 main 分支处于 26.11.8.12-preview 预览迭代。版本会变化,下载时以 Releases 页面为准。

按设备架构选择 APK

官方发布说明提供的包包括:

APK 架构 常见用途
arm64-v8a 大多数较新的 Android 手机和平板
armeabi-v7a 部分较旧的 32 位 ARM 设备
x86_64 / x86 对应架构的 Android 模拟器或设备

不确定设备 ABI 时,先查设备的“关于手机”信息或用能显示 ABI 的系统工具确认,不要只凭系统是 64 位就猜包名。下载后按 Android 的安装提示操作;若系统要求“允许此来源安装未知应用”,只对刚才使用的可信下载来源临时授权。

核对发布校验和

官方 README 建议核对 Releases 页面提供的 SHA-256 校验信息。若发布条目附有校验文件或摘要,先确认它对应你下载的同一个文件名,再用本地工具计算 APK 的 SHA-256 并逐字符比较。校验值不一致、文件来自转存站,或发布页没有可对应的校验信息时,不要安装该文件。

安全提醒:项目的 SECURITY.md 明确说明,2026 年 9 月以前历史提交中出现的 release.keystore 文件或凭据应视为已泄露且不可信。不要从旧提交、网盘或第三方镜像取 APK,也不要把历史签名材料当作当前版本的信任依据。

2. 导入自己的配置

安装并打开应用后,导入你已有的节点配置或服务商提供的兼容订阅。具体入口和支持格式以当前版本界面及服务商说明为准;不要把网页登录密码、账号密码或任意 URL 当作订阅地址,也不要假定所有订阅格式都兼容。

配置导入后先检查节点/分组列表是否出现内容,再运行节点测试。若列表为空,先刷新一次订阅并查看应用给出的错误信息;确认订阅仍有效、没有流量/设备数限制,并确认手机当前网络能访问订阅地址。不要反复粘贴公开日志或截图中的完整订阅链接,因为其中可能包含访问凭据。

3. 完成首次 VPN 连接

  1. 在节点或策略组中选择一个可用选项;如果有“自动选择”一类策略,也可以先使用默认策略。
  2. 点击连接。Android 首次会显示系统 VPN 授权弹窗,确认后等待应用显示已连接。
  3. 打开浏览器访问一个你平时能访问的站点,再访问一个按当前规则应经代理的站点,分别验证直连和代理流量。
  4. 若页面无法打开,先断开连接并确认手机本身可上网,再连接一次。避免同时启动另一个 VPN、系统级过滤器或其他会接管 VPN 的应用。

OwnBox 还有按类别检查服务可达性的网络诊断功能。诊断结果用于区分 DNS、连接或特定服务可达问题,不等同于账号一定可登录,也不能替代你要访问的实际应用测试。

4. 常见问题排查

现象 排查顺序
安装时提示应用无法安装 核对 APK 架构、Android 版本要求、下载是否完整;从官方 Releases 重新下载并核对 SHA-256。不要混装来源不明或签名不同的历史包。
订阅更新成功但节点列表为空 查看订阅格式和服务商要求,确认订阅中确实有节点;检查更新日志、有效期、网络和账户限制。
节点测速超时 测速失败不一定表示所有流量都断开;换一两个节点复测,并用浏览器实际打开目标站点。再检查本地网络、节点状态和服务端策略。
应用显示已连接但网页不能访问 用直连网页确认基础网络,检查当前选择的节点/策略、分流规则和 DNS;确认没有另一款 VPN 同时占用系统 VPN。一次只改一项,便于定位。
只有部分应用无法连接 检查应用分流/按应用代理设置,以及该应用是否被设置为绕过;再看连接记录或诊断结果。
更新后启动或连接异常 先查看新版本发布说明;确认连接状态后再断开、重新打开应用。不要在未备份时清除应用数据,以免丢失本地配置。

如果需要向项目反馈,附上 OwnBox 版本、正式版/预览版、Android 版本、设备型号与 ABI、网络类型、代理模式、复现步骤和脱敏后的错误信息。提交前移除订阅 URL、节点密码、UUID、令牌、私钥、账号密码和 WebDAV 凭据;问题入口见 GitHub Issues。

5. 备份与跨设备迁移

需要备份时,可按当前版本的配置导出或 WebDAV 备份入口保存配置。首次使用先确认备份目标可访问,并在迁移前确认备份包含自己需要的配置。WebDAV 账号密码、应用密码和配置文件都属于敏感信息,不要放进公开仓库或公开截图。恢复前先留一份当前配置,避免错误备份覆盖仍可用的设置。

官方资料