AI repository intelligence

FR-AI / ANALYSIS

Why it is worth attention

It provides a comprehensive, modern Material 3 user interface for the powerful sing-box proxy tool, enabling both root and non-root operation, easy configuration via QR codes, files, or subscriptions, and real-time monitoring through the official sing-box API.

Who it is for

Android users who need advanced proxy or VPN functionality
Power users who want transparent proxy with root access
Developers integrating sing-box into Android applications
Users seeking a flexible alternative to traditional VPN clients

Use cases

Run a VPN-based proxy without root permissions
Configure transparent proxy for all device traffic with root
Import proxy configurations from subscription URLs or QR codes
Monitor traffic, test latency, and switch proxy nodes via the API

Strengths

Supports both non-root VPN and multiple root modes (TPROXY, TUN, TUN2SOCKS, BPF2SOCKS)
Uses official sing-box binary for root modes, ensuring reliability and feature parity
Allows strict JSON configuration import from QR codes, local files, or URL subscriptions
Provides real-time status, traffic, and connection management through the sing-box command API

Considerations

Requires knowledge of sing-box JSON configuration for advanced setup
Root modes depend on device root access and may have compatibility issues
eBPF mode (BPF2SOCKS) requires kernel support for eBPF capabilities

README quick start

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

Description

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

Related repositories

Similar projects matched by category, topics, and programming language.

immaghzbad

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.

Mobile

Blaizzy

Featured

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 & Machine LearningAI Vision & Audio

985

makecindy

Featured

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 & Machine LearningLarge Language Models

958