# LIPX-desktop

**Repository Path**: labmem000/lipx-desktop

## Basic Information

- **Project Name**: LIPX-desktop
- **Description**: LIPX TCP端口代理工具 桌面图形客户端
- **Primary Language**: Kotlin
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 4
- **Forks**: 0
- **Created**: 2022-06-17
- **Last Updated**: 2026-04-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Javafx, Netty, labmem, Kotlin, p5r

## README

# LIPX Desktop

`LIPX Desktop` 是一个基于 `JavaFX + Kotlin` 的桌面端内网穿透/代理管理工具，支持正向连接、反向连接、服务端管理、托盘常驻和密钥管理。

![LIPX Desktop 截图](imgs/img.png)

## 项目状态

- 当前版本：`3.2.0`
- 桌面端网络层已移除 `Netty`
- 当前通信实现基于 `smart-socket`
- 支持 `GraalVM CE 25` 原生打包
- 默认包含托盘、密钥列表、服务端管理、客户端配置管理

## 技术栈

- `JDK 25`
- `Kotlin 2.3.20`
- `JavaFX 24.0.1`
- `smart-socket 1.8.4`
- `Fastjson2 2.0.61`
- `GraalVM Native Build Tools`

## 环境要求

- Windows
- `JDK 25`
- `GraalVM CE 25.0.0`：仅在需要 `nativeCompile` 时使用

## 本地开发

推荐直接走 Gradle 入口启动：

```powershell
./gradlew.bat :app:run
```

完整构建：

```powershell
./gradlew.bat build --console plain
```

native-image配置获取：

```powershell
graalvm-ce-25.0.0\bin\java.exe -agentlib:native-image-agent=config-output-dir=../../src/main/resources/META-INF/native-image,experimental-class-define-support -jar app-3.2.0-all.jar
```

## 原生打包

生成 Windows 原生可执行文件：

```powershell
./gradlew.bat nativeCompile --console plain
```

生成安装包：

```powershell
./gradlew.bat buildWinInstaller --console plain
```

默认输出位置：

- 原生可执行文件：`app/build/native/nativeCompile/`
- 安装包：`app/build/native/`

## 启动参数

支持以下启动参数：

- `--secret:<文件路径>`
  - 指定启动时使用的密钥文件
- `--debug`
  - 打开调试日志

示例：

```powershell
./gradlew.bat :app:run --args="--debug"
```

## 密钥与本地数据
启动优先级：

1. 如果传入 `--secret:...`，优先使用外部密钥
2. 否则使用数据目录下的 `secret.key`
3. 如果数据目录里没有，就用随包资源里的默认 `secret.key` 初始化