# EasyTier Connector

**Repository Path**: myqfeng/et-connector

## Basic Information

- **Project Name**: EasyTier Connector
- **Description**: 使用 Qt Framework 编写 EasyTier Web控制台连接器，运行在系统托盘，方便将本地节点接入 Web 控制台
- **Primary Language**: C++
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: https://console.easytier.net
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-04-17
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# EasyTier 控制台连接器

基于 Qt6 的 Windows 系统托盘应用程序，用于管理 EasyTier 远程控制台连接。应用程序常驻系统托盘，通过 `easytier-cli.exe` 将 EasyTier Core 注册为 Windows 系统服务进行管理，提供连接管理、开机自启等功能。

## 安装说明
平台支持：Windows（Win 10 1809以上）、Linux（Ubuntu24.04+，Debian12+，Arch/Manjaro）

### Windows
Windows 用户请直接前往 Releases 页面下载exe安装包，双击运行即可安装

### Linux
对于 Ubuntu/Debian 用户，请前往 Releases 页面下载 Deb 包，使用如下命令安装
```bash
sudo dpkg -i /path/to/your/packge.deb

# 若提示依赖缺失请执行以下命令后再次安装
sudo apt install -f
```

对于 Arch/Manjaro 用户，您可以从 AUR 进行安装，以`yay`管理器为例
```bash
sudo pacman -Syu yay       # 安装yay
yay -S easytier-connector  # 安装EasyTier Connector
```

## 功能特性

### 核心特性

- 双击托盘图标打开 Web 控制台
- 连接状态持久化保存
- 系统托盘常驻运行
- 进程生命周期管理（启动超时 30s，停止超时 10s）
- 修改密钥后自动重连
- 启动/停止进度提示

## 项目结构

```
et-connector/
├── src/                      # 源代码
│   ├── main.cpp              # 程序入口，命令行解析，单实例检测
│   ├── SystemTray.h/cpp      # 系统托盘主类
│   ├── ETRunService.h/cpp    # EasyTier 系统服务管理器（静态类）
│   ├── ConfigManager.h/cpp  # JSON 配置文件管理
│   ├── SettingsDialog.h/cpp # 连接密钥设置对话框
│   ├── AboutDialog.h/cpp    # 关于软件对话框
│   ├── CasdoorLogin.h/cpp   # Casdoor 登录认证
│   └── QuitConfirmDialog.h/cpp # 退出确认对话框
├── assets/                   # 图标资源 (SVG/ICO)
├── etcore/                   # EasyTier Core 依赖
│   ├── windows/              # Windows 平台依赖
│   │   ├── easytier-cli.exe  # 命令行管理工具
│   │   ├── easytier-deamon.exe # 守护进程
│   │   ├── wintun.dll       # Wintun 驱动
│   │   ├── Packet.dll       # 网络包处理
│   │   └── WinDivert64.sys  # 网络数据包拦截驱动
│   └── linux/               # Linux 平台依赖
├── docs/                     # 使用文档
├── package/                  # 打包脚本
│   ├── windows/              # Windows 安装包
│   └── linux/                # Linux 安装包 (DEB/AUR)
└── CMakeLists.txt            # CMake 构建配置
```

## 构建说明

### 环境要求

- Qt 6.11 或更高版本
- CMake 3.16+
- llvm-mingw 或 MSVC 编译器

### 构建步骤

```bash
# 1. 创建构建目录
mkdir build && cd build

# 2. 配置 CMake（指定 Qt 路径）
cmake .. -DCMAKE_PREFIX_PATH=/path/to/Qt6.11

# 3. 编译
cmake --build . --config Release

# 4. 安装（输出到 Install/bin/ 目录，自动部署 Qt 运行时）
cmake --install .
```

### 命令行参数

| 参数 | 说明 |
|------|------|
| `--auto-start` | 开机自启模式启动（不显示启动通知） |
| `--help` | 显示帮助信息 |
| `--version` | 显示版本号 |

## 配置说明

配置文件位于 `%LOCALAPPDATA%/EasyTier/config.json`：

```json
{
  "connectionKey": "your-connection-key",
  "autoStart": false,
  "autoReconnect": false
}
```

| 配置项 | 说明 |
|--------|------|
| `connectionKey` | EasyTier 连接地址密钥 |
| `autoStart` | 开机自启开关 |
| `autoReconnect` | 自动回连开关 |

## 运行原理

### 进程管理

应用程序管理 `etcore/easytier-deamon.exe` 进程：

```
启动参数: --config