# service-leran

**Repository Path**: uyevan/service-leran

## Basic Information

- **Project Name**: service-leran
- **Description**: Android local service.
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-16
- **Last Updated**: 2026-10-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PocketServer (掌上全栈服务器集群与轻量开发工作台)

<p align="center">
  <img src="app/src/main/res/mipmap-xxxhdpi/ic_launcher.webp" width="96" height="96" alt="PocketServer Logo" />
</p>

<p align="center">
  <strong>运行在 Android 设备上的全功能、免 Root、极简美学服务器集群与多语言运行时矩阵</strong>
</p>

<p align="center">
  <a href="#核心视觉画廊"><img src="https://img.shields.io/badge/Design-iOS_27_Minimalist-007AFF.svg" alt="Design"></a>
  <a href="#15-大运行时矩阵"><img src="https://img.shields.io/badge/Runtimes-15+-34C759.svg" alt="Runtimes"></a>
  <a href="#自研硬核技术亮点"><img src="https://img.shields.io/badge/Architecture-Rootless_Sandbox-AF52DE.svg" alt="Architecture"></a>
  <a href="#快速上手与编译部署"><img src="https://img.shields.io/badge/Android-API_29+-FF9500.svg" alt="Android"></a>
</p>

---

## 📖 项目简介

**PocketServer** 是一款专为 Android 移动平台打造的全栈级本地服务器集群管理与运行套件。无需获取设备 Root 权限，即可在口袋里的手机或平板上瞬间启动完整的 Web 网关、企业级后端、关系型/内存数据库、语言运行环境、内网穿透隧道甚至是本地轻量大模型推理引擎。

整套应用深度融合 **iOS 27 超轻量拟物/卡片磨砂美学（Minimalist Frosted Glass）**，摒弃了传统终端类工具繁杂晦涩的字符界面，带来细腻温润的质感、直观的集群生命周期控制与沉浸式的全栈开发调试体验。

---

## 📱 核心视觉画廊

| 🚀 集群监控与状态面板 | ⚡ 运行态与动态指示器 |
| :---: | :---: |
| <img src="docs/screenshots/01_dashboard.png" width="300" alt="集群监控与状态" /> | <img src="docs/screenshots/01_dashboard_running.png" width="300" alt="运行态与动态指示器" /> |

| 🌐 微服务与语言环境集群 | 🏷️ 真实品牌图标与全生态服务 |
| :---: | :---: |
| <img src="docs/screenshots/01_dashboard_cluster.png" width="300" alt="微服务与语言环境集群" /> | <img src="docs/screenshots/01_dashboard_services_more.png" width="300" alt="真实品牌图标与服务" /> |

| ⚙️ 服务参数与生命周期管理 | 📦 15+ 运行时生态软件商店 |
| :---: | :---: |
| <img src="docs/screenshots/02_service_detail.png" width="300" alt="服务参数与生命周期管理" /> | <img src="docs/screenshots/03_runtime_store.png" width="300" alt="15+ 运行时软件商店" /> |

| 📝 内置代码与配置文件编辑器 | 📜 实时终端控制台与运行日志 |
| :---: | :---: |
| <img src="docs/screenshots/04_config_editor.png" width="300" alt="内置代码编辑器" /> | <img src="docs/screenshots/05_logs.png" width="300" alt="实时终端控制台日志" /> |

---

## 🛠️ 15 大原生运行时矩阵

PocketServer 提供开箱即用的一键下载、无缝安装与环境适配，覆盖现代全栈开发与边缘部署的各个维度：

### 1. Web 服务器与网关
- **Nginx (v1.26+)**：高性能 Web 网关与反向代理，支持 FastCGI 协议、自定义 MIME 类型及动静分离。
- **PHP-FPM (v8.2+)**：高性能 PHP FastCGI 进程管理器，支持完整的 PHP 扩展和现代动态脚本解析。

### 2. Java 企业级运行容器
- **OpenJDK 17 (Headless LTS)**：精简高效的 64 位 Java 运行时，兼顾稳定性能与低内存开销。
- **Apache Tomcat 10 (v10.1+)**：企业级 Java Servlet 与 JSP 容器，支持标准 WAR 包部署与运行。

### 3. 现代脚本语言与构建体系
- **Node.js (v20 LTS)**：V8 驱动的 JavaScript/TypeScript 运行时，原生配套 **npm** 包管理器。
- **Python (v3.11+)**：现代通用脚本环境，支持原生 pip 与第三方纯 Python 包依赖管理。
- **Dart SDK (v3.3+)**：高性能客户端与服务端 Dart 脚本编译器与运行工具。
- **Gradle (v8.7+)**：面向企业工程的多语言与 Android 原生项目构建系统。

### 4. 数据库与轻量后端
- **Redis (v7.2+)**：内存高速 Key-Value 缓存与发布订阅消息系统。
- **SQLite 3 (v3.45+)**：轻量级嵌入式关系数据库引擎。
- **MariaDB (v11.2+)**：MySQL 兼容的完整企业级关系数据库，具备健全的事务机制与 InnoDB 存储引擎。
- **PocketBase (v0.22+)**：Go 语言打造的单文件全栈实时后端，自带 Web 管理后台、用户系统与实时 WebSocket API。

### 5. 内网穿透与跨网隧道
- **FRP Client (v0.56+)**：高性能反向代理穿透工具，支持 TCP、UDP、HTTP、HTTPS 协议映射公网。
- **Cloudflared (v2024+)**：基于 Cloudflare Zero Trust 的云端安全隧道客户端。

### 6. 端侧 AI 与边缘推理
- **llama.cpp (b2600+)**：经过 arm64 NEON 指令集高度优化的轻量端侧大模型推理引擎，支持在移动设备上本地离线运行 GGUF 格式大模型。

---

## 💡 自研硬核技术亮点

1. **免 Root 独立沙箱与 Bionic Linker 兼容补丁**
   - 针对 Android 系统底层的 Bionic libc 与安全机制，自主设计补丁装载系统。内置 `libcrypt.so`、`libandroid-execinfo.so`、`libexecinfo.so`、`libandroid-spawn.so`、`libandroid-shmem.so` 等关键动态链接库，彻底解决标准 Linux 二进制在 Android 平台上的符号解析缺失与 IPC 共享内存问题。
2. **端口占用智能探测与安全释放机制 (Port Guard)**
   - 针对移动端后台保活及进程反复重启可能引发的端口冲突（如 8080、9000、3306、6379），内置多级安全探测与熔断机制：在服务启动前精准探查端口状态与归属进程，支持一键安全杀除残留占位，杜绝 `Address already in use` 报错。
3. **MariaDB 移动端自动化适配引擎**
   - 自动化引导并静默初始化 `data/mysql` 核心系统表，自适应重构临时目录（`TMPDIR`）与 UNIX Domain Socket 路径，完美避开 Android 权限限制导致的 PID 文件丢失和 socket 握手失败异常。
4. **轻量化多线程分片下载与解压管道**
   - 直连官方镜像与高质量 arm64 构建源，支持大文件多分片流式下载、实时进度回调与自动化 `.deb` / `.tar.gz` 解包归档，实现环境一键装配。
5. **极简主义卡片交互 (iOS 27 Aesthetics)**
   - 界面整体基于 16dp/20dp 现代大圆角卡片、细腻的半透明磨砂质感投影以及清晰层级的色彩系统，所有服务均配备高清官方品牌彩色图标与细分标签。

---

## 🏗️ 快速上手与编译部署

### 环境要求
- **构建环境**：Android Studio Iguana / Ladybug / Koala 或更新版本
- **JDK 版本**：JDK 17 LTS
- **Android SDK**：API Level 34 (Compile & Target)
- **目标设备**：Android 10.0+ (API 29+)，arm64-v8a 架构（主流 Android 手机及平板、arm64 模拟器）

### 编译步骤

```bash
# 1. 克隆代码仓库
git clone https://gitee.com/uyevan/service-leran.git
cd service-leran

# 2. 检查本地环境依赖 (可使用当前目录的 gradlew 包装器)
./gradlew --version

# 3. 编译 Debug APK
./gradlew assembleDebug

# 4. 直接安装部署至连接的设备或模拟器
./gradlew installDebug
```

编译产物将生成在：
`app/build/outputs/apk/debug/app-debug.apk`

---

## 📂 项目结构概览

```
pocket-server/
├── app/
│   ├── src/main/
│   │   ├── assets/
│   │   │   └── runtime_libs/       # 自研移植补丁库 (.so)
│   │   ├── java/com/pocketserver/app/
│   │   │   ├── core/               # 进程控制器、端口检测、环境下载解压
│   │   │   ├── model/              # 服务元数据、运行状态模型
│   │   │   └── ui/                 # iOS 27 卡片界面、Store、Editor、Logs
│   │   └── res/                    # 矢量品牌图标、布局及样式资源
│   └── build.gradle.kts
├── docs/
│   └── screenshots/                # 实机运行高清截图集
├── build.gradle.kts
├── settings.gradle.kts
└── README.md
```

---

## 📄 开源许可与鸣谢

本项目遵循 [MIT License](LICENSE) 开源协议。

感谢开源社区生态的卓越贡献：
- [Termux Packages](https://github.com/termux/termux-packages) 提供的 aarch64 预编译二进制基础设施与工具链支持
- [llama.cpp](https://github.com/ggerganov/llama.cpp) 提供的端侧端到端大模型推理方案
- [PocketBase](https://pocketbase.io/) 提供的轻量化嵌入式后端架构