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

• Exclave

  

• NaïveProxy plugin

  • This plugin is distributed by upstream directly.

• Mieru plugin

  • You can also use the version distributed by upstream directly.

• Hysteria 2 plugin, TUIC v5 plugin and Juicity plugin

  • These protocols have been implemented in core. These plugins are updated for compatibility reason only.

• Other obsolete plugins

  • These plugins are no longer maintained for various reasons. They are provided for archival purpose only. It is not recommended to use them.

Google will soon block apps from directly installing (or so-called "sideloading"). If you are a user who values digital freedom, we need your voice to say no. Your support will not only help save this app, but also help defend software freedom and open distribution.

Copyright (C) 2023 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 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
• SagerNet
• Matsuri
• NekoBox
• husi