akashaProxy 快速上手
Android 透明代理
分步配置教程
akashaProxy 是面向 Root Android 的透明代理项目，基于 mihomo 原生内核（不使用 Smart 内核特性），支持 Magisk 与 KernelSU 环境以及 tproxy、tun、redirect 三种代理模式。下面按“下载安装 → 导入订阅或配置 → 连接 → 检查是否生效”四个步骤说明完整配置流程。
-
步骤一 · 下载安装
从官方 Release 获取模块并刷入
从官方 Release 获取 zip（官方 Release 提供 akashaProxy-20260825-e3ba5d6.zip，官方 Makefile 默认构建 Android 平台的 arm64-v8a 架构），并按 Magisk 或 KernelSU 的模块安装方式刷入。管理器内的具体菜单或按钮名称以官方文档为准。
模块刷入完成后，固定工作路径为 /data/adb/akashaProxy/。项目配置文件包括 clash.config、config.yaml、config.example.yaml、packages.list 以及 run 目录中的日志文件。
-
步骤二 · 导入订阅或配置
重命名默认模板并填写订阅链接
进入模块工作路径 /data/adb/akashaProxy/。官方 Release 说明首次使用需要将 config.example.yaml 重命名为 config.yaml，并填写 config.yaml 中 proxy-providers 的订阅链接；其余未列出的详细配置项名称以官方文档为准。
- 原生策略组与规则集
- 官方默认配置模板使用 mihomo 原生组类型，并包含策略组、规则集与分流规则；广告拦截规则使用 AWAvenue Ads Rule。
- Geo 数据与按包名分流
- 项目使用内置 GeoSite.dat 与 GeoIP.dat 处理大类分流数据；Android 上可按应用包名使用 PROCESS-NAME 进行分流，并配合 packages.list 管理。
-
步骤三 · 连接与热重载
启动代理服务脚本或执行热重载
完成配置文件保存后即可启动透明代理连接。启动时使用 clash.service 与 clash.iptables 脚本，停止时使用对应的 -k 参数。项目支持 tproxy、tun、redirect 三种代理模式，具体模式设置项名称以官方文档为准。
日常修改配置前可使用 clash.tool 执行热重载。官方说明热重载前会检查配置文件、内核状态和 mihomo -t 语法校验。
-
步骤四 · 检查是否生效
通过管理面板与 run 目录日志确认状态
代理启动后，可通过浏览器访问模块提供的 zashboard 管理面板地址 http://127.0.0.1:9090/ui 查看策略组与连接状态；KernelSU 用户也可直接使用模块自带 WebUI（面板内具体菜单名称以官方文档为准）。
如需进一步排查配置校验或分流情况，可前往工作路径 /data/adb/akashaProxy/ 下查看 run 目录中的日志文件，结合 mihomo -t 语法校验结果确认规则与代理是否正常生效。
遇到问题？查看常见问题解答
如果在刷入模块、重命名 config.example.yaml、使用 clash.tool 热重载或访问 http://127.0.0.1:9090/ui 管理面板时遇到疑问，可以前往常见问题页面查看针对下载安装、订阅连接与日志排查的详细解答。
如何选择兼容的订阅服务
akashaProxy 基于 mihomo 原生内核运行，本身不提供任何代理节点，需要在 config.yaml 的 proxy-providers 中填写可用的外部订阅链接。如果您想了解如何挑选兼容 mihomo 配置格式的订阅服务，请前往机场推荐页面查阅挑选要点与配置说明。