How matsuridayo/nekoboxforandroid works
NekoBox for Android is a sing-box-based universal proxy client. The main workflow is configuring proxy profiles and routing preferences, selecting a profile, then starting a background proxy service (including Android VPN mode) to handle traffic; subscription updates, plugins, protocol formats, and connection testing are additional capabilities. The graph combines README claims with the supplied source excerpts and SOURCE INDEX references; several implementation details are unsampled, so uncertain links are omitted or marked dashed.
Main entry points: BaseService.kt Service lifecycle · ProxyInstance.kt Proxy instance · MainActivity.kt Main interface · DataStore.kt Runtime preferences
Components 20
Profiles and routing
- Profile editor
app/src/main/java/io/nekohasekai/sagernet/ui/profile - Route editor
app/src/main/java/io/nekohasekai/sagernet/ui/RouteSettingsActivity.kt - Profile manager
app/src/main/java/io/nekohasekai/sagernet/database/ProfileManager.kt - Group manager
app/src/main/java/io/nekohasekai/sagernet/database/GroupManager.kt - Profiles and rules
app/src/main/java/io/nekohasekai/sagernet/database/SagerDatabase.kt - Runtime preferences
app/src/main/java/io/nekohasekai/sagernet/database/DataStore.kt - Subscription updates
app/src/main/java/io/nekohasekai/sagernet/bg/SubscriptionUpdater.kt - Per-app routing
app/src/main/java/io/nekohasekai/sagernet/ui/AppManagerActivity.kt
Proxy runtime
- Service lifecycle
app/src/main/java/io/nekohasekai/sagernet/bg/BaseService.kt - Proxy instance
app/src/main/java/io/nekohasekai/sagernet/bg/proto/ProxyInstance.kt - VPN tunnel
app/src/main/java/io/nekohasekai/sagernet/bg/VpnService.kt - Service controls
app/src/main/java/io/nekohasekai/sagernet/bg/ServiceNotification.kt - Traffic monitoring
app/src/main/java/io/nekohasekai/sagernet/bg/proto/TrafficUpdater.kt
Protocols and integrations
- Proxy formats
app/src/main/java/io/nekohasekai/sagernet/fmt - Plugin manager
app/src/main/java/io/nekohasekai/sagernet/plugin/PluginManager.kt - Native core
libcore/box.go
Android app shell
- Main interface
app/src/main/java/io/nekohasekai/sagernet/ui/MainActivity.kt - Application setup
app/src/main/java/io/nekohasekai/sagernet/SagerNet.kt - Network monitor
app/src/main/java/io/nekohasekai/sagernet/utils/DefaultNetworkListener.kt
Other components
- User
Connections 21
- User → Main interface: configures
README.md - Main interface → Profile editor: edits profiles
- Main interface → Route editor: edits routing
- Route editor → Runtime preferences: saves preferences
app/src/main/java/io/nekohasekai/sagernet/ui/RouteSettingsActivity.kt - Route editor → Profile manager: creates rules
app/src/main/java/io/nekohasekai/sagernet/ui/RouteSettingsActivity.kt - Profile manager → Profiles and rules: reads and writes
app/src/main/java/io/nekohasekai/sagernet/database/ProfileManager.kt - Group manager → Profiles and rules: reads and writes
app/src/main/java/io/nekohasekai/sagernet/database/GroupManager.kt - Group manager → Subscription updates: reconfigures
app/src/main/java/io/nekohasekai/sagernet/database/GroupManager.kt - Profile manager → Profiles and rules: persists profiles
app/src/main/java/io/nekohasekai/sagernet/database/ProfileManager.kt - Application setup → Runtime preferences: initializes with
app/src/main/java/io/nekohasekai/sagernet/SagerNet.kt - Application setup → Network monitor: starts monitor
app/src/main/java/io/nekohasekai/sagernet/SagerNet.kt - Application setup → Main interface: references
app/src/main/java/io/nekohasekai/sagernet/SagerNet.kt - Service lifecycle → Proxy instance: launches
app/src/main/java/io/nekohasekai/sagernet/bg/BaseService.kt - Service lifecycle → Service controls: manages
app/src/main/java/io/nekohasekai/sagernet/bg/BaseService.kt - VPN tunnel → Service lifecycle: extends
app/src/main/java/io/nekohasekai/sagernet/bg/VpnService.kt - Service lifecycle → Runtime preferences: reads settings
app/src/main/java/io/nekohasekai/sagernet/bg/BaseService.kt - Proxy instance → Plugin manager: loads plugins
- Proxy instance → Proxy formats: uses protocol configs
- Proxy instance → Native core: starts core
- Service lifecycle → Traffic monitoring: updates traffic
- Per-app routing → Runtime preferences: stores app selection
app/src/main/java/io/nekohasekai/sagernet/ui/AppManagerActivity.kt