sing-box/docs/clients/android/features.md
Bruce Wayne 378f151c75
Some checks failed
Build / Calculate version (push) Has been cancelled
Build / Build binary (push) Has been cancelled
Build / Build binary-1 (push) Has been cancelled
Build / Build binary-2 (push) Has been cancelled
Build / Build binary-3 (push) Has been cancelled
Build / Build binary-4 (push) Has been cancelled
Build / Build binary-5 (push) Has been cancelled
Build / Build binary-6 (push) Has been cancelled
Build / Build binary-7 (push) Has been cancelled
Build / Build binary-8 (push) Has been cancelled
Build / Build binary-9 (push) Has been cancelled
Build / Build binary-10 (push) Has been cancelled
Build / Build binary-11 (push) Has been cancelled
Build / Build binary-12 (push) Has been cancelled
Build / Build binary-13 (push) Has been cancelled
Build / Build binary-14 (push) Has been cancelled
Build / Build binary-15 (push) Has been cancelled
Build / Build binary-16 (push) Has been cancelled
Build / Build binary-17 (push) Has been cancelled
Build / Build binary-18 (push) Has been cancelled
Build / Build binary-19 (push) Has been cancelled
Build / Build binary-20 (push) Has been cancelled
Build / Build binary-21 (push) Has been cancelled
Build / Build binary-22 (push) Has been cancelled
Build / Build binary-23 (push) Has been cancelled
Build / Build binary-24 (push) Has been cancelled
Build / Build binary-25 (push) Has been cancelled
Build / Build binary-26 (push) Has been cancelled
Build / Build binary-27 (push) Has been cancelled
Build / Build binary-28 (push) Has been cancelled
Build / Build binary-29 (push) Has been cancelled
Build / Build binary-30 (push) Has been cancelled
Build / Build binary-31 (push) Has been cancelled
Build / Build binary-32 (push) Has been cancelled
Build / Build binary-33 (push) Has been cancelled
Build / Build binary-34 (push) Has been cancelled
Build / Build binary-35 (push) Has been cancelled
Build / Build binary-36 (push) Has been cancelled
Build / Build binary-37 (push) Has been cancelled
Build / Build Darwin binaries (push) Has been cancelled
Build / Build Darwin binaries-1 (push) Has been cancelled
Build / Build Darwin binaries-2 (push) Has been cancelled
Build / Build Windows binaries (push) Has been cancelled
Build / Build Windows binaries-1 (push) Has been cancelled
Build / Build Windows binaries-2 (push) Has been cancelled
Build / Build Android library (386) (push) Has been cancelled
Build / Build Android library (amd64) (push) Has been cancelled
Build / Build Android library (arm) (push) Has been cancelled
Build / Build Android library (arm64) (push) Has been cancelled
Build / Build Android (other) (push) Has been cancelled
Build / Build Android (other-legacy) (push) Has been cancelled
Build / Publish Android (push) Has been cancelled
Build / Build Windows client (arm64) (push) Has been cancelled
Build / Build Windows client (x64) (push) Has been cancelled
Build / Build Windows client (x86) (push) Has been cancelled
Build / Build Linux client (arm64) (push) Has been cancelled
Build / Build Linux client (armv7l) (push) Has been cancelled
Build / Build Linux client (x64) (push) Has been cancelled
Build / Build Apple library (ios-arm64) (push) Has been cancelled
Build / Build Apple library (macos-amd64) (push) Has been cancelled
Build / Build Apple library (macos-arm64) (push) Has been cancelled
Build / Build Apple library (tvos-arm64) (push) Has been cancelled
Build / Build Apple release clients (push) Has been cancelled
Build / Build Apple release clients-1 (push) Has been cancelled
Build / Build Apple App Store clients (push) Has been cancelled
Build / Build Apple App Store clients-1 (push) Has been cancelled
Build / Build Apple App Store clients-2 (push) Has been cancelled
Build / Upload builds (push) Has been cancelled
Build / Cache GC (push) Has been cancelled
documentation: Fix endpoint_independent_nat
2026-09-10 16:47:09 +08:00

3.5 KiB

:material-decagram: Features

UI options

  • Display realtime network speed in the notification

Service

SFA allows you to run sing-box through ForegroundService or VpnService (when TUN is required).

TUN

SFA provides an unprivileged TUN implementation through Android VpnService.

TUN inbound option Available Note
interface_name :material-close: Managed by Android
inet4_address :material-check: /
inet6_address :material-check: /
mtu :material-check: /
gso :material-close: No permission
auto_route :material-check: /
strict_route :material-close: Not implemented
inet4_route_address :material-check: /
inet6_route_address :material-check: /
inet4_route_exclude_address :material-check: /
inet6_route_exclude_address :material-check: /
stack :material-check: /
include_interface :material-close: No permission
exclude_interface :material-close: No permission
include_uid :material-close: No permission
exclude_uid :material-close: No permission
include_android_user :material-close: No permission
include_package :material-check: /
exclude_package :material-check: /
platform :material-check: /
Route/DNS rule option Available Note
process_name :material-close: No permission
process_path :material-close: No permission
process_path_regex :material-close: No permission
package_name :material-check: /
package_name_regex :material-check: /
user :material-close: Use package_name instead
user_id :material-close: Use package_name instead
wifi_ssid :material-check: Fine location permission required
wifi_bssid :material-check: Fine location permission required

Override

Overrides profile configuration items with platform-specific values.

Per-app proxy

SFA allows you to select a list of Android apps that require proxying or bypassing in the graphical interface to override the include_package and exclude_package configuration items.

In particular, the selector also provides the “China apps” scanning feature, providing Chinese users with an excellent experience to bypass apps that do not require a proxy. Specifically, by scanning China application or SDK characteristics through dex class path and other means, there will be almost no missed reports.

Chore

  • The working directory is located at /sdcard/Android/data/io.nekohasekai.sfa/files (External files directory)
  • Crash logs is located in $working_directory/stderr.log