sing-box for Android
SFA lets you manage and run local or remote sing-box configuration files and provides platform-specific implementations such as TUN transparent proxying.
Features
UI options
- Show real-time network speed in the notification bar
Service
SFA runs sing-box through a ForegroundService, or a VpnService when TUN is required.
TUN
SFA provides a non-privileged TUN implementation through Android VpnService.
| TUN input option | Available | Note |
|---|---|---|
interface_name | ❌ | Managed by Android |
inet4_address | ✅ | / |
inet6_address | ✅ | / |
mtu | ✅ | / |
gso | ❌ | No permission |
auto_route | ✅ | / |
strict_route | ❌ | Not implemented |
inet4_route_address | ✅ | / |
inet6_route_address | ✅ | / |
inet4_route_exclude_address | ✅ | / |
inet6_route_exclude_address | ✅ | / |
endpoint_independent_nat | ✅ | / |
stack | ✅ | / |
include_interface | ❌ | No permission |
exclude_interface | ❌ | No permission |
include_uid | ❌ | No permission |
exclude_uid | ❌ | No permission |
include_android_user | ❌ | No permission |
include_package | ✅ | / |
exclude_package | ✅ | / |
platform | ✅ | / |
| Route/DNS rule option | Available | Note |
|---|---|---|
process_name | ❌ | No permission |
process_path | ❌ | No permission |
process_path_regex | ❌ | No permission |
package_name | ✅ | / |
user | ❌ | Use package_name instead |
user_id | ❌ | Use package_name instead |
wifi_ssid | ✅ | Requires precise location permission |
wifi_bssid | ✅ | Requires precise location permission |
Overrides
Override configuration options with platform-specific values.
Per-app proxy
SFA lets you choose, in the graphical interface, which Android apps to proxy or bypass, overriding the include_package and exclude_package options.
The picker also offers a scan for "domestic apps" that improves the experience for users in China by helping them bypass apps that do not need a proxy. It detects these apps by scanning characteristics of domestic apps and SDKs (such as dex class paths), so almost nothing is missed.
Other
- The working directory is
/sdcard/Android/data/io.nekohasekai.sfa/files(external files directory) - Crash logs are written to
$working_directory/stderr.log
System requirements
- Android 5.0 or later
Download
- Play Store
- Play Store (Beta)
- GitHub Releases
- F-Droid (signed uniformly via reproducible builds)