{"id":22219303,"url":"https://github.com/acedroidx/frp-android","last_synced_at":"2025-04-12T15:43:06.001Z","repository":{"id":50288579,"uuid":"320878561","full_name":"AceDroidX/frp-Android","owner":"AceDroidX","description":"A frp client for Android. 一个Android的frp客户端","archived":false,"fork":false,"pushed_at":"2025-02-18T00:32:46.000Z","size":67106,"stargazers_count":263,"open_issues_count":16,"forks_count":63,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-03T23:08:32.998Z","etag":null,"topics":["android","frp"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AceDroidX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-12-12T16:52:25.000Z","updated_at":"2025-04-02T10:25:17.000Z","dependencies_parsed_at":"2025-02-27T12:39:02.053Z","dependency_job_id":null,"html_url":"https://github.com/AceDroidX/frp-Android","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AceDroidX%2Ffrp-Android","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AceDroidX%2Ffrp-Android/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AceDroidX%2Ffrp-Android/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AceDroidX%2Ffrp-Android/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AceDroidX","download_url":"https://codeload.github.com/AceDroidX/frp-Android/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248590938,"owners_count":21129916,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","frp"],"created_at":"2024-12-02T22:42:16.099Z","updated_at":"2025-04-12T15:43:05.980Z","avatar_url":"https://github.com/AceDroidX.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# frp-Android\nA frp client for Android  \n一个Android的frpc客户端\n\n简体中文 | [English](README_en.md)\n\n\u003cdiv style=\"display:inline-block\"\u003e\n\u003cimg src=\"./image/image1.png\" alt=\"image1.png\" width=\"200\"\u003e\n\u003cimg src=\"./image/image2.png\" alt=\"image2.png\" width=\"200\"\u003e\n\u003c/div\u003e\n\n## 编译方法\n\n如果您想自定义frp内核，可以通过Github Actions或通过Android Studio编译\n\n### 通过Github Actions编译\n\n1. 将您的apk签名密钥文件转为base64，以下为Linux示例\n```shell\nbase64 -w 0 keystore.jks \u003e keystore.jks.base64\n```\n2. fork本项目\n3. 转到Github项目的此页面：Settings \u003e Secrets and variables \u003e Actions \u003e Repository secrets\n4. 添加以下四个环境变量：\n```KEY_ALIAS``` ```KEY_PASSWORD``` ```STORE_FILE``` ```STORE_PASSWORD```  \n其中```STORE_FILE```的内容为步骤1的base64，其他环境变量内容请根据您的密钥文件自行填写\n5. Push提交自动触发编译或在Actions页面手动触发\n\n### 通过Android Studio编译\n\n1. 在项目根目录创建apk签名密钥设置文件```keystore.properties```，内容参考同级的```keystore.example.properties```\n2. 使用Android Studio进行编译打包\n\n## 常见问题\n### 项目的frp内核(libfrpc.so)是怎么来的？\n直接从[frp的release](https://github.com/fatedier/frp/releases)里把对应ABI的Linux版本压缩包解压之后重命名frpc为libfrpc.so  \n项目不是在代码里调用so中的方法，而是把so作为一个可执行文件，然后通过shell去执行对应的命令  \n因为Golang的零依赖特性，所以可以直接在Android里通过shell运行可执行文件\n\n### 开机自启与后台保活\n按照原生Android规范设计，如有问题请在系统设置内允许开机自启/后台运行相关选项","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facedroidx%2Ffrp-android","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Facedroidx%2Ffrp-android","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Facedroidx%2Ffrp-android/lists"}