AeroBox for Android
快速上手教程
订阅导入与
代理配置流程
AeroBox for Android 是基于 sing-box / libbox 的 Android 原生通用代理软件,界面基于 Material 3 与 Jetpack Compose。本页整理从下载安装、导入订阅或配置、开启连接到检查是否生效的通用上手流程;官方文档未给出可核实的详细步骤,具体菜单名、按钮名与设置项名称以官方文档与官方发布为准。
- 第一阶段 · 下载安装
- GitHub Releases 获取
- 系统要求 Android 12 及以上(minSdk 31),从官方发布页获取安装文件并完成安装。
- 第二阶段 · 导入配置
- 订阅管理与本地扫码
- 支持 Clash YAML、URI 订阅与 sing-box JSON,支持本地、扫码和单节点导入。
- 第三阶段 · 开启连接
- 路由与 VPN 代理
- 可切换全局代理、规则分流与直连,支持分应用代理、自定义 DNS 与开机自连。
- 第四阶段 · 检查生效
- 延迟测试与运行日志
- 提供节点延迟测试、运行日志与通知栏快捷切换,便于核查连接与分流状态。
- 支持订阅与配置格式
- YAML / URI / JSON
- Clash / Clash.Meta YAML、常见 URI 订阅、sing-box outbound JSON 与常见 JSON 节点列表
- 支持代理协议
- 主流协议广泛覆盖
- Shadowsocks / 2022、VMess、VLESS、Trojan、AnyTLS、Hysteria 2、TUIC、SOCKS5、HTTP Proxy、Naive
- 路由与分流控制
- 三模式 + 官方 Geo
- 路由可切换全局代理、规则分流与直连,使用官方 Geo 规则集并支持分应用代理
- DNS 与连接特性
- DoT / DoH + IPv6
- DNS 可自定义(支持 DoT 与 DoH),支持 IPv6、开机自连与断线自动重连
快速上手四步通用教程
这是一篇基于官方 README 能力说明整理的 AeroBox for Android 使用教程,目标是让第一次接触这款软件的人先建立准确预期,再打开应用对照界面逐步熟悉。AeroBox for Android 是基于 sing-box / libbox 的 Android 原生通用代理软件,采用 VPN 模式承载代理流量。本文不逐项描述每个点击位置,因为应用界面会随版本变化,详细操作以当前应用界面为准;但文中列出的功能范围、支持协议和导入格式,都来自公开的官方 README。
-
步骤 01环境准备与安装
下载安装 AeroBox for Android
下载入口与系统要求
AeroBox for Android 的下载入口以 GitHub Releases 为准,安装文件与版本信息也以官方发布页为准。市面上可能存在多个自称官网的页面或同名应用,下载前请看清开发者、包名或签名,以及官方发布页所指向的内容。不要因为某个页面长得像官网就默认它就是官方来源。
系统要求是 Android 12 及以上,minSdk 31。也就是说,低于这一版本的设备可能无法安装或运行。实际支持范围仍以官方发布说明为准。
核心定位:VPN 模式与订阅导入
AeroBox for Android 基于 sing-box / libbox 提供 Android VPN 模式代理。它不是一个单纯的节点列表浏览器,也不是把订阅规则完整复制进本地的配置中心。README 明确写到,当前主要导入节点信息,订阅中的分流规则等信息不会直接照搬进应用配置。这一点对刚从其他代理工具切换过来的用户尤其重要。
订阅管理方面,应用支持手动更新与自动更新,也支持读取部分订阅流量与到期信息。节点导入方式包括本地导入、扫码导入和单节点导入。你可以把常见的 URI 节点订阅、Clash / Clash.Meta YAML、sing-box outbound JSON 或常见 JSON 节点列表拿来做导入尝试,但最终能否完整识别,取决于订阅内容的具体写法,而不是应用把所有字段都进行等价处理。
-
步骤 02节点与订阅管理
导入订阅或配置信息
支持的协议与订阅格式
协议支持范围较广,包括 Shadowsocks、Shadowsocks 2022、VMess、VLESS、Trojan、AnyTLS、Hysteria 2、TUIC、SOCKS5、HTTP Proxy 和 Naive。看到这一串协议时,不必逐一理解每个名称,只需要知道它覆盖了相当一部分主流代理协议,适合需要同时处理多种节点格式的场景。
订阅格式则与节点来源密切相关。常见 URI 节点订阅和 sing-box outbound JSON 都属于可尝试导入的格式。Clash / Clash.Meta YAML 也被支持,但这不意味着 YAML 中的所有分流策略都会进入应用。由于应用当前主要导入节点信息,订阅里的规则、分组或策略组可能不会在应用内出现。这是一个需要提前管理的预期。
路由模式:全局、规则分流与直连
路由模式可以切换全局代理、规则分流与直连,这是日常使用中最常调整的部分。全局代理适合希望所有流量都经过节点的场景;规则分流则依赖 Geo 规则集完成按地区或域名走不同路径的判断;直连模式则让流量不经过代理。
AeroBox for Android 使用官方 Geo 规则集,这意味着规则分流的底层判断有公开来源可查。具体某条流量走哪条路径,取决于当前选择的模式与规则匹配结果。阅读时不要期待应用会显示每条连接的完整匹配过程,更稳妥的做法是先通过延迟测试和运行日志观察整体表现。
分应用代理:只让部分应用走代理
分应用代理是 AeroBox for Android 的一个实用能力。它让用户不必把所有应用都塞进同一条代理通道,而是可以给不同应用分配不同处理方式。常见的思路是,把需要访问特定网络的应用走代理,把银行、支付或本地服务类应用保持直连。
由于本文不虚构具体菜单名称和路径,这里只给出通用观察建议:打开应用后先找到与分应用代理相关的设置区域,看看列表里是否列出了你已安装的应用。然后从影响范围小的应用开始尝试,确认切换后该应用的网络是否按预期变化。不要把多个敏感应用一起改动,否则一旦流量走向不符合预期,排查会变得很麻烦。
-
步骤 03路由设置与启动
选择模式并开启连接
DNS 与连接行为
DNS 可自定义,并支持 DNS over TLS 与 DNS over HTTPS。这对希望避免 DNS 查询被中间网络观察的用户来说比较有价值。自定义 DNS 不等于所有流量都自动走加密 DNS,还要看路由模式和节点配置是否配合。
连接行为方面,AeroBox for Android 支持 IPv6、开机自连与断线自动重连。开机自连适合需要长时间保持连接的用户,断线自动重连则能减少手动干预。延迟测试和运行日志是观察连接状态的直接入口:延迟测试帮助你了解节点可达性,运行日志则在连接异常时提供线索。通知栏快捷切换则让开关代理不必每次都进入主界面。
界面与许可证
界面基于 Material 3 与 Jetpack Compose,这意味着应用在 Android 12 及以上设备上会跟随较为现代的 Material 设计语言。界面风格不直接决定代理效果,但会直接影响日常操作是否顺手。阅读时如果看到布局和传统代理工具差异较大,不需要担心功能缺失,而是先熟悉主要区域之间的切换方式。
源码公开,许可证为 GPL-3.0-or-later。公开源码意味着有能力的用户可以自行查看实现细节,但这不代表每个人都应该从源码编译安装。日常使用仍以官方发布页提供的安装文件为准。
-
步骤 04状态核查与日常切换
检查代理连接是否生效
一块重要限制:订阅规则不会被照搬
这篇 AeroBox for Android 使用教程需要反复强调的一点是:订阅中的分流规则等信息不会直接照搬进应用配置。这句话来自官方 README,不是本文的观点。它意味着你过去在别的工具里习惯的“导入订阅即完成全套配置”的思路,在这里不成立。
实际影响是,导入订阅后你可能会发现节点已经出现,但规则、策略组或某些自动选择逻辑没有出现。这不是导入失败,而是应用当前的设计范围如此。遇到这种情况,先不要反复重新导入,而是检查节点是否可用,再手动调整路由模式和分应用代理设置。把这一条理解清楚,能避免大量无意义的排障时间。
上手顺序与后续阅读
建议的上手顺序是先确认系统版本,再从官方发布页获取安装文件。安装后先不要急着导入一堆订阅,而是用一个来源明确、结构简单的节点或订阅做测试,判断导入结果是否符合预期。随后再逐步尝试协议支持范围内的其他格式。
运行日志和延迟测试应当成为日常观察工具,而不是只在出问题时才打开。因为它们能够直接反映当前连接状态,并且比“感觉网络变慢”这类判断可靠得多。后续如果想深入了解 sing-box 的配置语法,可以阅读 sing-box 官方文档;但 AeroBox 本身不自动等同于 sing-box 的全部配置能力,应用内界面仍然是最直接的参考。所有步骤描述只作为阅读和观察建议,遇到界面差异时,以当前应用界面为准。
配置过程中遇到问题?
如果在安装、导入订阅或开启 VPN 模式代理时遇到疑问,可以先核查以下三个常见注意点,或前往常见问题页查看完整解答。
- 规则说明 导入订阅后原分流规则未生效?
-
AeroBox for Android 当前主要导入订阅中的节点信息,订阅文件自带的分流规则等信息不会直接照搬进应用配置。请在应用内选择全局代理、规则分流(使用官方 Geo 规则集)或直连模式。
- 状态排查 节点无法连接或解析异常怎么查?
-
请使用客户端提供的节点延迟测试功能确认节点可用性,并结合运行日志查看具体连接状态;同时可检查自定义 DNS(支持 DNS over TLS 与 DNS over HTTPS)或尝试手动更新订阅。
- 版本与环境 应用无法安装或找不到对应设置?
-
请确认设备满足 Android 12 及以上系统要求(minSdk 31),且安装包下载自 GitHub Releases。由于不同版本的界面细节可能随更新调整,具体名称与支持情况均以官方文档与官方发布为准。
还没有可用的节点或订阅链接?
AeroBox for Android 本身是基于 sing-box / libbox 的客户端工具,需要配合合规的代理节点或订阅服务使用。前往「机场推荐」页面,了解如何按协议兼容性(如 VLESS、Hysteria 2、TUIC、Trojan、Shadowsocks 2022 等)与订阅格式(Clash YAML、URI、sing-box JSON)选择合适的订阅服务。