README_zh_CN.md

English | 简体中文

AsteriskNG

一个 Android Xray GUI 客户端，使用 Xray-core、AndroidLibXrayLite 和 hev-socks5-tunnel 实现。

Telegram Channel

Asterisk4Magisk

功能

• VPN Service、TPROXY(ROOT) 和 TUN2SOCKS(ROOT) 运行模式
• VMess、VLESS、Trojan、Shadowsocks、Socks、HTTP、Hysteria2、WireGuard、策略组和链式代理支持
• v2rayNG、mihomo 订阅格式支持
• 管理 geoip.dat、geosite.dat、geoip-only-cn-private.dat 和 Xray 可执行文件等资源文件
• 通过 Magisk service.d 脚本支持 ROOT 模式开机自启
• MIUIX Compose UI

预览

运行模式

VPN Service

• 无需 root 权限。
• 使用 Android VpnService。
• 适合常规 Android 应用级 VPN 使用场景。

TPROXY(ROOT)

• 需要 root 权限。
• 通过 libsu 直接运行本地 Xray 可执行文件。
• 使用 iptables 和策略路由处理透明代理流量。
• 使用已配置的透明代理端口作为 Xray 入站。

TUN2SOCKS(ROOT)

• 需要 root 权限。
• 通过 libsu 直接运行本地 Xray 可执行文件。
• 使用 hev-socks5-tunnel 创建固定 TUN 设备 asterisk0。
• 使用 Xray 的本地 SOCKS5 入站作为隧道目标。
• 与 TPROXY 共享大部分 ROOT 路由和应用代理行为，但流量会通过 TUN 设备转发，而不是通过 Xray 的 TPROXY 入站。

资源文件

• 运行时文件存储在应用私有的 files/xray 目录中，通常为 /data/user/0/org.asterisk.zcc.ang/files/xray。
• 内置 Xray 可执行文件会从 native libraries 还原，也可以手动替换为 xray 可执行文件，或替换为包含 xray 的 zip 压缩包。
• geoip.dat 和 geosite.dat 可以从内置 assets 还原、从在线来源更新，或手动替换。
• 内置更新来源包括 Loyalsoldier/v2ray-rules-dat、v2fly/geoip、v2fly/domain-list-community、Chocolate4U/Iran-v2ray-rules 和 runetfreedom/russia-v2ray-rules-dat。

开发

使用 Android Studio 打开项目根目录，或通过 Gradle wrapper 构建：

.\gradlew.bat assembleDebug

macOS 或 Linux：

./gradlew assembleDebug

构建过程会：

• 使用 Android SDK 和 NDK
• 下载或准备内置 Xray-core 资源
• 构建 native setuidgid helper
• 为 arm64-v8a、armeabi-v7a、x86 和 x86_64 打包 native 运行时组件

如果 Gradle 找不到 Android NDK，请在 local.properties 中设置 ndk.dir，设置 ANDROID_NDK_HOME，或在 Android SDK 下安装 NDK。

WSA

对于 WSA，可以使用以下命令授予 VPN 权限：

appops set org.asterisk.zcc.ang ACTIVATE_VPN allow

许可

GPL-3.0

致谢

• @XTLS/Xray-core
• @2dust/AndroidLibXrayLite
• @heiher/hev-socks5-tunnel
• @topjohnwu/libsu
• @compose-miuix-ui/miuix
• @2dust/v2rayNG
• @Loyalsoldier/v2ray-rules-dat
• @v2fly/geoip
• @v2fly/domain-list-community
• @Chocolate4U/Iran-v2ray-rules
• @runetfreedom/russia-v2ray-rules-dat