AsteriskBOX 是一个 Android 上的 sing-box 图形界面客户端,支持无 root 的 VPN 模式以及多种基于 root 的透明代理模式。

Stars

9

7 天增长

暂无数据

Fork 数

1

开放 Issue

0

开源协议

GPL-3.0

最近更新

2026-07-28

AI 仓库情报摘要
FR-AI / ANALYSIS

为什么值得关注

它为功能强大的 sing-box 代理工具提供了现代化的 Material 3 用户界面,兼具 root 与非 root 运行方式,可通过二维码、文件或订阅链接轻松导入配置,并通过官方 API 实现实时监控。

适合谁使用

  • 需要高级代理或 VPN 功能的 Android 用户
  • 希望使用透明代理且拥有 root 权限的高级用户
  • 将 sing-box 集成到 Android 应用的开发者
  • 寻求传统 VPN 客户端之外灵活替代方案的用户

典型使用场景

  • 在无 root 权限下运行基于 VPN 的代理服务
  • 使用 root 权限为设备所有流量配置透明代理
  • 通过订阅 URL 或二维码快速导入代理配置
  • 通过 API 实时查看流量、测试延迟并切换代理节点

项目优势

  • 同时支持无 root 的 VPN 模式和多种 root 模式(TPROXY、TUN、TUN2SOCKS、BPF2SOCKS)
  • root 模式使用官方 sing-box 二进制文件,确保可靠性与功能一致
  • 支持通过二维码、本地文件或订阅链接导入严格的 JSON 配置
  • 通过 sing-box 命令 API 提供实时状态、流量和连接管理

使用前须知

  • 高级设置需具备 sing-box JSON 配置知识
  • root 模式依赖设备 root 权限,可能存在兼容性问题
  • eBPF 模式(BPF2SOCKS)需要内核支持 eBPF 功能

README 快速开始

English | 简体中文

AsteriskBOX

An Android sing-box GUI client. VPN Service mode uses AndroidLibBoxLite; ROOT modes execute the official sing-box Android binary.

Telegram Channel

Asterisk4Magisk

Features

  • VPN Service, TPROXY(ROOT), TUN(ROOT), TUN2SOCKS(ROOT), and BPF2SOCKS(ROOT) run modes
  • Strict sing-box JSON configurations from QR code, local file, or URL subscription
  • Official sing-box command API for status, traffic, connections, modes, proxy selection, and delay tests
  • ROOT start-on-boot script generation through Magisk service.d
  • Material 3 Compose UI

Run Modes

VPN Service

  • Works without root permission.
  • Runs sing-box in the app process through AndroidLibBoxLite JNI and its local command server.
  • Uses Android VpnService; the optional Hev TUN path continues to use hev-socks5-tunnel.

TPROXY(ROOT)

  • Runs the official sing-box Android binary with a TPROXY inbound.
  • Uses iptables and policy routing for transparent proxy traffic.

TUN(ROOT)

  • Runs the official sing-box Android binary with the fixed TUN device asterisk0.
  • Keeps sing-box auto_route disabled and applies app-managed iptables and policy routing rules.
  • Supports the System, gVisor, and Mixed TUN stacks.

TUN2SOCKS(ROOT)

  • Uses hev-socks5-tunnel to create asterisk0.
  • Sends tunnel traffic to a local sing-box SOCKS5 inbound.

BPF2SOCKS(ROOT)

  • Uses eBPF and the native bpf2socks helper to send TCP and UDP traffic to a local sing-box SOCKS5 inbound.
  • Requires the eBPF capability probe to pass before startup.

ROOT address monitor

All ROOT modes use the native asteriskd monitor to maintain local-address bypass rules and optional IPv6 state. Runtime binaries, configuration, PID files, helpers, and logs remain in the app-private files/sing-box directory. Only the boot entry script is installed outside it at /data/adb/service.d/asteriskbox_start.sh.

Resource Files

  • The bundled ROOT core is the official sing-box Android binary selected by ProjectConfig.SING_BOX_VERSION and may be manually replaced from the resource page.
  • Direct CIDR IPv4/IPv6 files and custom resource files can be replaced or updated from configured URLs.
  • Rule sets remain part of the sing-box JSON configu

项目描述

A sing-box GUI client for Android, support VPN Service, TPROXY(ROOT), TUN(ROOT), TUN2SOCKS(ROOT) and BPF2SOCKS(ROOT)

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

immaghzbad
immaghzbad GitHub avatar

AetherST

AetherST Tunnel is an Android VPN client designed for high-performance censorship circumvention, using advanced protocols like MASQUE, WireGuard, and nested WireGuard (Gool) to evade Deep Packet Inspection.

移动开发
45
Blaizzy
精选
Blaizzy GitHub avatar

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI 与机器学习AI 视觉与语音
985
makecindy
精选
makecindy GitHub avatar

cindy

Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.

AI 与机器学习大语言模型
958