Skip to content

0.8.3 — first public release

Choose a tag to compare

@unera unera released this 18 Nov 23:49
· 7 commits to main since this 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) as libxray.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:1099 with 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.