A proxy client powered by a modified version of v2ray-core. It is a fork of SagerNet.

• NaïveProxy plugin (use upstream releases directly)
• Hysteria 2 plugin
• Mieru plugin or use upstream releases directly
• Juicity plugin
• TUIC v5 plugin
• Other obsolete plugins

Google Play Protect has ever declared that this app "may be harmful" and blocks it from installation. There is no guarantee that this won't happen again in the future. It is nonsense to demand that developers prove their innocence.

Copyright (C) 2023 by dyhkwong
Copyright (C) 2021 by nekohasekai <contact-sagernet@sekai.icu>

This program (except for all files in directory "library/core/clash") is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

All files in directory "library/core/clash" are free software: you can redistribute them and/or modify them under the terms of the GNU General Public License as published by the Free Software Foundation, version 3.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

Is Exclave not in your language, or the translation is incorrect or incomplete? Get involved in the translations on Hosted Weblate.

Please report issues here. Do not report issues to upstream because the core used is heavily modified.

• For crashes, log file using "debug" log level is required. Log files may contain secret keys used to connect to servers. Please remove potential sensitive information or encrypt with GPG before posting them publicly.
• For memory leak and high system resource usage, pprof profile is required. Long press "About" - "Version" to enable pprof HTTP server settings and kill and restart the app to take effect.
• Encrypt with this GPG public key if the issue contains sensitive information or you are reporting a vulnerability.

Wiki. The wiki may contain potentially distressing or otherwise sensitive content. Viewer discretion is advised.

• Install and configure Git, JDK, Android SDK, Android NDK, Go and this Go Mobile fork.
• Use Git to clone this project. Also clone the corresponding submodule library/core and/or plugin submodules if needed.
• Replace release.keystore with your own. It can be generated by Java keytool.
• Append the following lines to your local.properties.

    KEYSTORE_PASS=your_keystore_pass
    ALIAS_NAME=your_alias_name
    ALIAS_PASS=your_alias_pass

• Build Exclave:
  • Build libcore: ./run lib core
  • Download assets: ./gradlew :app:downloadAssets (or update assets: ./gradlew :app:updateAssets)
  • Build the app: ./gradlew :app:assembleOssRelease
  • APK files are located in app/build/outputs/apk/
• Build a plugin:
  • Build native binaries: ./run plugin [hysteria2|juicity|mieru|tuic5|shadowquic|naive]
  • Build the plugin:./gradlew :plugin:[hysteria2|juicity|mieru|tuic5|shadowquic|naive]:assembleOssRelease
  • Plugin APK files are located in plugin/[hysteria2|juicity|mieru|tuic5|shadowquic|naive]/build/outputs/apk/

• See app/build.gradle.kts, buildSrc/build.gradle.kts and library/proto-stub/build.gradle.kts for Android libraries used in Exclave.
• See library/core/go.mod for Go libraries used in Exclave.
• See plugin/api/build.gradle.kts for Android libraries used in plugins.
• geosite.dat is downloaded from https://github.com/v2fly/domain-list-community/releases. It is licensed under the MIT license.
• geoip.dat is downloaded from https://github.com/v2fly/geoip/releases. It is licensed under CC-BY-4.0.
• mozilla_included.pem is downloaded from https://www.ccadb.org/resources. It is licensed under CDLA-2.0 Permissive.
• Submodules are for compiling native binaries of plugins. They are executables that run in separate processes and therefore not subjected to the restrictions of GPL. Please refer to submodule repositories for their respective licenses.

• Shadowsocks by Mygod, madeye, et al.
• SagerNet by nekohasekai et al.
• Matsuri by arm64v8a et al.
• NekoBox by arm64v8a et al.
• husi by xchacha20-poly1305 et al.