https://github.com/acedroidx/frp-android
A frp client for Android. 一个Android的frp客户端
https://github.com/acedroidx/frp-android
android frp
Last synced: about 1 year ago
JSON representation
A frp client for Android. 一个Android的frp客户端
- Host: GitHub
- URL: https://github.com/acedroidx/frp-android
- Owner: AceDroidX
- License: apache-2.0
- Created: 2020-12-12T16:52:25.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2025-02-18T00:32:46.000Z (over 1 year ago)
- Last Synced: 2025-04-03T23:08:32.998Z (about 1 year ago)
- Topics: android, frp
- Language: Kotlin
- Homepage:
- Size: 64 MB
- Stars: 263
- Watchers: 4
- Forks: 63
- Open Issues: 16
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# frp-Android
A frp client for Android
一个Android的frpc客户端
简体中文 | [English](README_en.md)
## 编译方法
如果您想自定义frp内核，可以通过Github Actions或通过Android Studio编译
### 通过Github Actions编译
1. 将您的apk签名密钥文件转为base64，以下为Linux示例
```shell
base64 -w 0 keystore.jks > keystore.jks.base64
```
2. fork本项目
3. 转到Github项目的此页面：Settings > Secrets and variables > Actions > Repository secrets
4. 添加以下四个环境变量：
```KEY_ALIAS``` ```KEY_PASSWORD``` ```STORE_FILE``` ```STORE_PASSWORD```
其中```STORE_FILE```的内容为步骤1的base64，其他环境变量内容请根据您的密钥文件自行填写
5. Push提交自动触发编译或在Actions页面手动触发
### 通过Android Studio编译
1. 在项目根目录创建apk签名密钥设置文件```keystore.properties```，内容参考同级的```keystore.example.properties```
2. 使用Android Studio进行编译打包
## 常见问题
### 项目的frp内核(libfrpc.so)是怎么来的？
直接从[frp的release](https://github.com/fatedier/frp/releases)里把对应ABI的Linux版本压缩包解压之后重命名frpc为libfrpc.so
项目不是在代码里调用so中的方法，而是把so作为一个可执行文件，然后通过shell去执行对应的命令
因为Golang的零依赖特性，所以可以直接在Android里通过shell运行可执行文件
### 开机自启与后台保活
按照原生Android规范设计，如有问题请在系统设置内允许开机自启/后台运行相关选项