explaingit

matsuridayo/nekoboxforandroid

★ 20,813KotlinAudience · developerComplexity · 3/5MaintainedLicenseSetup · moderate

TLDR

A free Android app that routes your internet traffic through various proxy protocols like Shadowsocks, WireGuard, and Trojan to bypass restrictions or enhance privacy.

Mindmap

mindmap
  root((repo))
    What it does
      Routes traffic via proxies
      Supports 15+ protocols
      Manages subscriptions
    Protocols supported
      Shadowsocks
      WireGuard
      Trojan variants
      HTTP and SOCKS
    Key features
      Plugin system
      Subscription parsing
      Android 5.0+
    Use cases
      Bypass geo-blocks
      Privacy protection
      Network routing

Things people build with this

USE CASE 1

Route your Android phone's internet through a proxy server to access geo-blocked content or services.

USE CASE 2

Import proxy subscriptions from services like Shadowsocks or ClashMeta to manage multiple proxy configurations.

USE CASE 3

Extend the app with custom proxy protocols by downloading and installing plugins.

USE CASE 4

Protect your mobile traffic by tunneling through WireGuard or other privacy-focused protocols.

Tech stack

KotlinAndroidsing-boxWireGuard

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Android SDK and emulator/device setup; building native components (sing-box, WireGuard) may need additional toolchain configuration.

Free to use and modify under GPL-3.0, but any distributed changes must also be open-source.

In plain English

NekoBox for Android is a universal proxy client for Android built on the sing-box proxy core. It supports a wide range of proxy protocols including SOCKS (4/4a/5), HTTP(S), SSH, Shadowsocks, VMess, Trojan, VLESS, AnyTLS, ShadowTLS, TUIC, Hysteria 1 and 2, WireGuard, Trojan-Go, NaiveProxy, and Mieru. Additional protocols are available via downloadable plugins. The app requires Android API 21 or higher and is licensed under GPL-3.0. It is available for download from GitHub Releases. The app supports subscription formats including widely used formats such as Shadowsocks, ClashMeta, and v2rayN, as well as sing-box outbound format. Only outbound node parsing is supported; diversion rules and similar settings from subscription files are ignored. The README notes that the Google Play version has been controlled by a third party since May 2024 and is non-open-source, so users are advised to download only from GitHub Releases. The project is based on the SagerNet/sing-box core, with the Android GUI derived from shadowsocks-android and SagerNet.

Copy-paste prompts

Prompt 1
How do I set up NekoBox for Android to use a Shadowsocks proxy from a subscription link?
Prompt 2
Show me how to add a custom WireGuard configuration to NekoBox for Android.
Prompt 3
What proxy protocols does NekoBox support and how do I enable each one?
Prompt 4
How can I create a plugin for NekoBox for Android to add a new proxy protocol?
Prompt 5
Explain how to import a ClashMeta subscription into NekoBox for Android.
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.