# frpc-Android

**Repository Path**: skyuning/frpc-Android

## Basic Information

- **Project Name**: frpc-Android
- **Description**: Android,安卓版frpc，一个快速反向代理，可帮助您将NAT或防火墙后面的本地服务器暴露给Internet。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 32
- **Forks**: 17
- **Created**: 2019-05-06
- **Last Updated**: 2025-04-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# frp-Android

[README](https://github.com/FrpcCluster/frpc-Android/blob/master/README.md) | [中文介绍](https://github.com/FrpcCluster/frpc-Android/blob/master/README_zh.md)


# 项目介绍

frp 源项目 [https://github.com/fatedier/frp](https://github.com/fatedier/frp)

frp 帮助网站 [https://www.frp.fun/](https://www.frp.fun/)

QQ群 [222670265](https://jq.qq.com/?_wv=1027&k=5kkmkwa)


## 项目 demo 简要图

<img src="https://github.com/TelDragon/Dragon/blob/master/image/frp-Android-02.png" width="266" alt="frp-Android-02.png">   <img src="https://github.com/TelDragon/Dragon/blob/master/image/frp-Android-03.png" width="266" alt="frp-Android-03.png">   <img src="https://github.com/TelDragon/Dragon/blob/master/image/frp-Android-04.png" width="266" alt="frp-Android-04.png">

## 开发说明

* [编译流程](https://github.com/FrpcCluster/frpc-Android/blob/master/Compile_zh.md)
* 软件[Android studio 3.2](http://www.android-studio.org/)
* Android, .aar 库
frp使用gombile实现了一份go代码编译为android和ios平台下面可以直接调用的sdk类库

## Android SDK 用法
在Android系统提供的sdk形式是一个后缀为.aar的类库文件,开发的时候只需要把arr类库文件引入android项目即可.

* 导入包

```java
import frpclib.Frpclib;
```

## 项目逻辑

* 启动初始化，写入预连接的服务器地址，服务器端口号，服务器toke
* 添加隧道
  * tcp协议，加密/压缩为非必选项，其他必填项
  * udp协议，加密/压缩为非必选项，其他必填项
  * http协议，加密/压缩为非必选项，自定义域名/泛域名二选一必填项
  * https协议，加密/压缩为非必选项，自定义域名/泛域名二选一必填项
* 隧道列表，可以复制分享列表内容

## 支持情况

* 支持
  * 手机免root
  * 自定义添加服务器
  * 协议 tcp、udp、http、https
  * 加密、压缩
  * 动态添加隧道、删除隧道 (热加载)
  * 自定义域名、泛域名
  * 分享隧道信息
  * 后台运行
  * 支持 frps 0.13.0/0.15.0/0.16.0/0.17.0/0.18.0/0.21.0
* 不支持
  * 保存配置文件(退出软件app后重新进入需再次填写信息)

  
 ## 开发计划
 
* 支持多frps服务器版本 0.13.0/0.15.0/0.16.0/0.17.0/0.18.0/0.21.0
* 支持IOS 苹果app [https://github.com/TelDragon/frpc-IOS](https://github.com/TelDragon/frpc-IOS)
* 用户平台登录
* 获取frps服务器列表信息，提供用户服务器选择匹配
* 保存配置信息
* 抛弃frpc.ini 启动文件，直接使用“execute”函数执行命令
  
## 为 frpc-Android 做贡献

frpc-Android 是一个免费且开源的项目，我们欢迎任何人为其开发和进步贡献力量。

* 在使用过程中出现任何问题，可以通过 [issues](https://github.com/TelDragon/frpc-Android/issues) 来反馈。
* Bug 的修复可以直接提交 Pull Request 到 dev 分支。
* 如果是增加新的功能特性，请先创建一个 issue 并做简单描述以及大致的实现方法，提议被采纳后，就可以创建一个实现新特性的 Pull Request。
* 欢迎对说明文档做出改善，帮助更多的人使用 frp，特别是英文文档。
* 贡献代码请提交 PR 至 dev 分支，master 分支仅用于发布稳定可用版本。
* 如果你有任何其他方面的问题，欢迎反馈至 542867428@qq.com 共同交流。

**提醒：和项目相关的问题最好在 [issues](https://github.com/TelDragon/frpc-Android/issues) 中反馈，这样方便其他有类似问题的人可以快速查找解决方法，并且也避免了我们重复回答一些问题。**

## 捐助

* 如果您觉得[frpc-Android](https://github.com/TelDragon/frpc-Android)对你有帮助，欢迎给予我们一定的捐助来维持项目的长期发展。

<img src="https://github.com/TelDragon/Dragon/blob/master/image/WeChat.png" width="266" alt="frp-Android-02.png"> <img src="https://github.com/TelDragon/Dragon/blob/master/image/Alipay.png" width="266" alt="frp-Android-02.png">
 
* 感谢

[bjbjoaoa@qq.com](mailto:bjbjoaoa@qq.com) [momo@188.com](mailto:momo@188.com) [zqy1301@qq.com](mailto:zqy1301@qq.com)