How shadowsocks/shadowsocks-android works
Shadowsocks for Android is a proxy client: a user selects a server profile and starts the service, which establishes proxy, transparent-proxy, or VPN routing. The graph includes profile and preference management, ACL routing, subscriptions, plugin support, and boot/direct-boot behavior alongside the main connection workflow. Relationships are limited to the provided excerpts and SOURCE INDEX references; unsampled implementations are represented only where the tree and index support them.
Main entry points: BaseService.kt Service controller · ProfileManager.kt Profile management · ShadowsocksConnection.kt Service connection · MainActivity.kt Main screen
Components 25
Client interfaces
- Main screen
mobile/src/main/java/com/github/shadowsocks/MainActivity.kt - Profile editor
mobile/src/main/java/com/github/shadowsocks/ProfileConfigActivity.kt - TV interface
tv/src/main/java/com/github/shadowsocks/tv/MainPreferenceFragment.kt - Quick toggle
mobile/src/main/java/com/github/shadowsocks/bg/TileService.kt - Rule editor
mobile/src/main/java/com/github/shadowsocks/acl/CustomRulesFragment.kt - Subscription screen
mobile/src/main/java/com/github/shadowsocks/subscription/SubscriptionFragment.kt
Connection runtime
- Service connection
core/src/main/java/com/github/shadowsocks/aidl/ShadowsocksConnection.kt - Service controller
core/src/main/java/com/github/shadowsocks/bg/BaseService.kt - VPN routing
core/src/main/java/com/github/shadowsocks/bg/VpnService.kt - Proxy mode
core/src/main/java/com/github/shadowsocks/bg/ProxyService.kt - Transparent proxy
core/src/main/java/com/github/shadowsocks/bg/TransproxyService.kt - Proxy processes
core/src/main/java/com/github/shadowsocks/bg/Executable.kt
Profiles and settings
- Access rules
core/src/main/java/com/github/shadowsocks/acl/Acl.kt - Profile management
core/src/main/java/com/github/shadowsocks/database/ProfileManager.kt - Profile model
core/src/main/java/com/github/shadowsocks/database/Profile.kt - Profile database
core/src/main/java/com/github/shadowsocks/database/PrivateDatabase.kt - Settings store
core/src/main/java/com/github/shadowsocks/preference/DataStore.kt - Direct boot state
core/src/main/java/com/github/shadowsocks/utils/DirectBoot.kt - Boot receiver
core/src/main/java/com/github/shadowsocks/BootReceiver.kt
Supporting capabilities
- Subscription service
core/src/main/java/com/github/shadowsocks/subscription/SubscriptionService.kt - Subscription data
core/src/main/java/com/github/shadowsocks/subscription/Subscription.kt - Plugin manager
core/src/main/java/com/github/shadowsocks/plugin/PluginManager.kt - Plugin options
plugin/src/main/java/com/github/shadowsocks/plugin/PluginOptions.kt
Other components
- User
- Android network
Connections 24
- User → Main screen: configures and starts
- Main screen → Service connection: connects to
mobile/src/main/java/com/github/shadowsocks/MainActivity.kt - TV interface → Service connection: connects to
tv/src/main/java/com/github/shadowsocks/tv/MainPreferenceFragment.kt - Quick toggle → Service connection: toggles service
mobile/src/main/java/com/github/shadowsocks/bg/TileService.kt - Service connection → Service controller: binds service
core/src/main/java/com/github/shadowsocks/aidl/ShadowsocksConnection.kt - Service controller → VPN routing: dispatches mode
core/src/main/java/com/github/shadowsocks/aidl/ShadowsocksConnection.kt - Service controller → Proxy mode: dispatches mode
core/src/main/java/com/github/shadowsocks/aidl/ShadowsocksConnection.kt - Service controller → Transparent proxy: dispatches mode
core/src/main/java/com/github/shadowsocks/aidl/ShadowsocksConnection.kt - Service controller → Proxy processes: starts processes
core/src/main/java/com/github/shadowsocks/bg/BaseService.kt - VPN routing → Android network: routes VPN traffic
core/src/main/java/com/github/shadowsocks/bg/VpnService.kt - Service controller → Access rules: loads rules
core/src/main/java/com/github/shadowsocks/bg/BaseService.kt - Rule editor → Access rules: edits rules
mobile/src/main/java/com/github/shadowsocks/acl/CustomRulesFragment.kt - Main screen → Profile management: selects profile
- Profile editor → Profile management: edits profile
- Profile management → Profile model: manages profiles
core/src/main/java/com/github/shadowsocks/database/ProfileManager.kt - Profile management → Profile database: reads and writes
core/src/main/java/com/github/shadowsocks/database/ProfileManager.kt - Profile management → Direct boot state: updates boot profile
core/src/main/java/com/github/shadowsocks/database/ProfileManager.kt - Service controller → Settings store: reads configuration
core/src/main/java/com/github/shadowsocks/bg/BaseService.kt - Boot receiver → Service controller: starts on boot
core/src/main/java/com/github/shadowsocks/bg/BaseService.kt - Subscription service → Profile management: creates profiles
core/src/main/java/com/github/shadowsocks/subscription/SubscriptionService.kt - Subscription service → Subscription data: processes subscription
core/src/main/java/com/github/shadowsocks/subscription/SubscriptionService.kt - Subscription screen → Subscription service: manages subscriptions
mobile/src/main/java/com/github/shadowsocks/subscription/SubscriptionFragment.kt - Service controller → Plugin manager: resolves plugins
core/src/main/java/com/github/shadowsocks/plugin/PluginManager.kt - Plugin manager → Plugin options: handles options
core/src/main/java/com/github/shadowsocks/plugin/PluginManager.kt