Repository navigation
0.8.3 — first public release
What it is
A local SOCKS5 proxy on the Xray kernel that does not create a VPN. Many apps refuse to work
while a VPN is on — banks, government services — and they check the network transport, which is a
VPN for every ordinary client. This one runs the kernel as a plain process: it listens on loopback
as a SOCKS5 proxy with a username and a password, and the apps that want it are pointed at it.
The trade is explicit: only apps with their own proxy settings can use it.
What works
- Xray
v26.11.9(arm64) aslibxray.so— since Android 10 an app may not execute a file from its
own data directory, and the native library directory is the one place it may run from; - SOCKS5 on
127.0.0.1:1099with generated credentials; optional HTTP proxy on a second port for
browsers that cannot speak SOCKS with a password; vless://,vmess://,trojan://,ss://links and subscriptions (plain list or base64);
transports TCP, WebSocket, gRPC, HTTP/2; TLS and REALITY;- two domain lists — "direct" and "always through the server", the second read first;
- a quick settings tile, a foreground notification that names the mode, autostart on boot and after
an update; - the proxy is up whenever the app is; the button chooses the direction, not the existence.
Verified on a phone
Telegram through the SOCKS proxy; the proxy test reports the exit address; the tile switches the
mode; 14 unit tests over link parsing and config generation.
Known limits written into the app's help: Chrome and YouTube have no proxy settings on Android,
WhatsApp's proxy speaks its own protocol, and Firefox needs an extension (Proxy Toggle works).
Where
https://github.com/unera/byecensor — public, MIT, CI builds a debug APK and runs tests.