它是什么
初次听说 akashaProxy 的用户，往往会先问它和常见的桌面端或手机端图形客户端有什么不同。简单来说，akashaProxy 是面向 Root Android 的透明代理项目。它并不在手机桌面上生成一个常规的独立客户端图标，而是作为系统底层的模块运行，官方说明支持 Magisk 与 KernelSU 环境。
在核心架构上，该项目基于 mihomo 原生内核构建。官方 Release 明确说明内核仍是 mihomo 原生内核，不使用 Smart 内核特性。由于运行在具备 Root 权限的系统环境中，项目支持 tproxy、tun、redirect 三种代理模式，能够直接对整机或指定 Android 应用的网络流量进行透明接管与规则分流。
在分流能力方面，官方默认配置模板使用 mihomo 原生组类型，并包含策略组、规则集与分流规则。项目使用内置 GeoSite.dat 与 GeoIP.dat 处理大类分流数据，同时官方文档说明广告拦截规则使用 AWAvenue Ads Rule。而在 Android 系统特有的应用管理上，项目可按应用包名使用 PROCESS-NAME 进行分流，满足不同应用走不同出口的需求。
从哪里下载
获取系统级模块时，确认下载来源的可靠性是第一步。akashaProxy 项目源码在 GitHub 公开仓库中提供，所有正式构建的模块安装包均通过官方 Release 页面发布。本站仅提供使用指南与配置说明，不是官方网站，下载与版本信息请务必以官方发布为准。
前往官方 Release 页面后，可以看到官方 Release 提供 akashaProxy-20260825-e3ba5d6.zip 模块压缩包。下载前还需要确认自己手机的处理器架构：官方 Makefile 默认构建 Android 平台的 arm64-v8a 架构，其他架构或具体设备的兼容情况以官方文档为准。
将 akashaProxy-20260825-e3ba5d6.zip 下载到手机本地存储后，保持 zip 压缩包原样即可，不需要手动解压。接下来打开手机上已安装的 Magisk 或 KernelSU 管理器，按照对应的模块安装方式选择该 zip 文件刷入，管理器内的具体菜单名称以官方文档为准。
安装后先做什么
在 Magisk 或 KernelSU 中完成模块刷入并按提示重启设备后，新手最常见的问题是不知道去哪里找设置界面。这是因为 akashaProxy 的配置与运行文件全部集中在固定的系统目录下，模块工作路径为 /data/adb/akashaProxy/。你需要使用具备 Root 权限的文件管理器进入该目录。
打开 /data/adb/akashaProxy/ 后，建议先不要急着改动参数，而是花一分钟认清目录内的核心文件结构。根据已核实的项目信息，配置文件包括以下几个部分：
- clash.config 與 config.example.yaml：分别为模块的配置文件与官方提供的默认配置模板文件。
- config.yaml：mihomo 内核实际读取的主配置文件，首次使用时需要由默认配置模板重命名生成。
- packages.list 与 run 目录：packages.list 用于管理应用包名配置，而 run 目录中的日志文件则记录运行状态与排查信息。
熟悉这几个文件的位置后，后续无论是填入订阅链接、调整按应用包名分流，还是查看运行日志，都能在 /data/adb/akashaProxy/ 目录下直接找到对应入口，各个文件内部未列出的详细参数项以官方文档为准。
导入订阅或配置并连接
确认工作路径下的文件结构无误后，就可以开始导入订阅并完成第一次连接。akashaProxy 模块本身只提供基于 mihomo 原生内核的透明代理与分流框架，不包含任何代理节点，因此你需要提前准备好可用的订阅链接。
官方 Release 说明首次使用需要将 config.example.yaml 重命名为 config.yaml，并填写 proxy-providers 中的订阅链接。具体操作时，在 /data/adb/akashaProxy/ 目录中将默认模板重命名为 config.yaml，再用文本编辑器打开它，找到 proxy-providers 字段，将你自己的订阅链接准确填入并保存。
得益于官方默认配置模板已经使用 mihomo 原生组类型，并包含策略组、规则集与分流规则，同时内置 GeoSite.dat 与 GeoIP.dat 处理大类分流数据，填写好 proxy-providers 订阅链接后，内核即可拉取节点并按预设规则工作。如果你希望针对手机上的特定应用单独指定走向，可以在配置中按应用包名使用 PROCESS-NAME 进行分流，或结合 packages.list 进行管理。
保存好 config.yaml 并完成启动或热重载后，怎样管理节点和确认连接呢？模块提供 zashboard 管理面板地址 http://127.0.0.1:9090/ui，你只需在手机浏览器中访问该地址，即可打开图形化的 zashboard 面板查看策略组状态；此外，KernelSU 用户也可使用模块自带 WebUI。面板内的具体按钮与子菜单名称以官方文档为准。
连不上时先检查什么
第一次配置透明代理时，如果遇到保存配置后没有生效、或者打开网页提示无法连接的情况，切忌盲目重复刷入模块。按照从文件命名、语法校验到运行日志的顺序逐一检查，通常很快就能定位原因。
首先检查模块工作路径 /data/adb/akashaProxy/ 下是否确实存在 config.yaml。不少新手直接在 config.example.yaml 上修改并保存，忘了将其重命名为 config.yaml，导致内核没有读取到新填写的 proxy-providers 订阅链接。
其次检查配置语法是否通过校验。官方说明热重载前会检查配置文件、内核状态和 mihomo -t 语法校验。在编辑 YAML 文件填写订阅链接或添加 PROCESS-NAME 分流规则时，如果因为多打空格、缩进错位或字符格式不对导致 mihomo -t 语法校验未通过，热重载保护机制就会阻止错误配置生效。
最后，去查看 /data/adb/akashaProxy/run 目录中的日志文件，并打开浏览器访问 http://127.0.0.1:9090/ui（或 KernelSU 模块自带 WebUI）。通过 run 目录下的日志记录，可以清楚看到内核状态、配置文件检查结果以及规则分流情况，从而判断究竟是配置文件格式有误，还是外部订阅链接本身无法拉取。
下一步读什么
当你顺利在浏览器中打开 http://127.0.0.1:9090/ui 的 zashboard 管理面板，并看到 proxy-providers 中的订阅节点正常加载时，说明 akashaProxy 已经在你的 Root Android 设备上完成了第一次连接。
接下来，如果你想进一步掌握服务启动与停止脚本、热重载操作细节，可以继续阅读本站的分步配置教程；如果在日常使用 tproxy、tun、redirect 模式或配置 packages.list 时遇到具体疑问，也可以随时前往常见问题支持页查阅解答。
完成首次连接后，建议再回到 config.yaml 与 packages.list 逐项阅读，理解代理模式、规则集和应用包名分流之间的关系。对于 Magisk 与 KernelSU 的不同安装入口，始终以各自管理器和项目文档显示的选项为准；遇到异常时保留 run/run.logs 与 run/kernel.log，再按现象逐项缩小范围。这样可以把一次安装变成可重复的配置流程，也能避免把订阅链接、规则文件和内核日志混在一起处理。
如果需要继续学习，可以先阅读教程页的启动与停止顺序，再查看问题排查文章中的 mihomo -t 语法检查。akashaProxy 的工作路径固定在 /data/adb/akashaProxy/，文件名本身就是排查线索：clash.config 管理模块启动配置，config.yaml 保存 mihomo 配置，packages.list 参与应用范围管理，run 目录则提供日志。围绕这些真实文件建立自己的记录，比反复更换设置更容易定位问题。每次只改一项，记录前后差异，后续回退也会更清楚。