# easytier-pro-installer

**Repository Path**: easytier/easytier-pro-installer

## Basic Information

- **Project Name**: easytier-pro-installer
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2026-05-22
- **Last Updated**: 2026-10-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# EasyTier Agent

跨平台一键部署工具。运行后自动引导完成登录、获取注册密钥、下载 EasyTier、安装系统服务的全部流程。

> **下载源说明**：install 脚本优先从 **Gitee** 下载 installer 二进制，若失败则自动回退到 GitHub。

## 快速安装

### Linux / macOS

```bash
curl -fsSL https://raw.githubusercontent.com/EasyTier-Pro/installer/main/install.sh | bash
```

国内网络可改用 gitee：
```bash
curl -fsSL https://gitee.com/easytier/easytier-pro-installer/raw/main/install.sh | bash
```

默认下载到 `~/.local/share/easytier-pro-installer/`，可通过环境变量指定：
```bash
curl -fsSL https://raw.githubusercontent.com/EasyTier-Pro/installer/main/install.sh | INSTALL_DIR=/usr/local/bin bash
```

### Windows (PowerShell)

```powershell
irm https://raw.githubusercontent.com/EasyTier-Pro/installer/main/install.ps1 | iex
```

国内网络可改用 gitee：
```powershell
irm https://gitee.com/easytier/easytier-pro-installer/raw/main/install.ps1 | iex
```

默认下载到 `%LOCALAPPDATA%\easytier-pro-installer\`，可通过参数指定：
```powershell
& ([scriptblock]::Create((irm https://raw.githubusercontent.com/EasyTier-Pro/installer/main/install.ps1))) -InstallDir C:\Tools
```

## 用法

通过 install 脚本运行后会自动启动 installer，无需手动找到文件：

```bash
# Linux / macOS（每次运行都会检查更新并自动启动）
curl -fsSL https://gitee.com/easytier/easytier-pro-installer/raw/main/install.sh | bash

# Windows
irm https://gitee.com/easytier/easytier-pro-installer/raw/main/install.ps1 | iex
```

如需手动运行已下载的 installer：

```bash
# Linux / macOS
~/.local/share/easytier-pro-installer/easytier-pro-installer

# Windows
%LOCALAPPDATA%\easytier-pro-installer\easytier-pro-installer.exe
```

首次运行后，直接执行上述路径即可，不再需要通过 install 脚本。

运行示例：
```bash
~/.local/share/easytier-pro-installer/easytier-pro-installer
# 等价于
~/.local/share/easytier-pro-installer/easytier-pro-installer install
```

典型流程：

```
$ ~/.local/share/easytier-pro-installer/easytier-pro-installer
您尚未登录 Console，正在引导登录...

正在获取登录验证码...

请在浏览器中完成登录:
  访问链接: https://casdoor.easytier.cn/login/oauth/device/xxxxx
  验证码:   abcdef

✅ 登录成功！

工作空间: 个人空间

注册密钥:
  1. my-key
  2. [创建新密钥]
选择 [1-2]: 1
使用注册密钥: my-key

配置服务器: tcp://console.easytier.cn:22020/xxxxx

平台: linux-x86_64

安装目录: /home/user/.local/share/easytier-pro-installer/easytier

正在查询最新版本...
最新版本: v2.6.4

正在下载: https://github.com/.../easytier-linux-x86_64-v2.6.4.zip
[####################] 100% 下载完成

正在解压...
EasyTier 已就绪: ...
  core: .../easytier-core
  cli:  .../easytier-cli

正在安装系统服务...
正在启动服务...

✅ 部署完成！EasyTier 服务已安装并启动。
```

## 其他操作

```bash
# 更新已安装的 EasyTier
~/.local/share/easytier-pro-installer/easytier-pro-installer update

# 更新到指定版本
~/.local/share/easytier-pro-installer/easytier-pro-installer update --version v2.6.4

# 查看服务状态
~/.local/share/easytier-pro-installer/easytier-pro-installer status

# 只使用免提权的系统服务管理器查询状态
~/.local/share/easytier-pro-installer/easytier-pro-installer status --native

# 只使用 easytier-cli 查询状态，兼容性更广但可能需要提权
~/.local/share/easytier-pro-installer/easytier-pro-installer status --legacy

# 卸载服务，保留已下载文件和缓存
~/.local/share/easytier-pro-installer/easytier-pro-installer uninstall

# 彻底卸载，删除安装目录和缓存压缩包
~/.local/share/easytier-pro-installer/easytier-pro-installer uninstall --purge
```

## 可选参数

| 参数 | 环境变量 | 说明 |
|------|----------|------|
| `-s, --server` | `EASYTIER_CONSOLE_URL` | Console 地址，默认 `https://api.console.easytier.net` |
| `--config-server` | `EASYTIER_CONFIG_SERVER` | 覆盖 config server 地址 |
| `-i, --install-dir` | `EASYTIER_INSTALL_DIR` | 安装目录 |
| `--debug` | - | 开启调试日志，默认写入当前目录下的 `easytier-pro-installer.debug.log` |

子命令参数：

| 子命令 | 参数 | 环境变量 | 说明 |
|--------|------|----------|------|
| `install` | `-v, --version` | `EASYTIER_VERSION` | 指定安装的 EasyTier 版本号 |
| `update` | `-v, --version` | `EASYTIER_VERSION` | 指定更新到的 EasyTier 版本号 |
| `status` | `--native` | - | 只使用免提权的系统服务管理器查询 |
| `status` | `--legacy` | - | 只使用 `easytier-cli service --name easytier-pro status` 查询 |
| `uninstall` | `--purge` | - | 彻底删除安装目录和缓存压缩包 |

`status` 默认先使用免提权查询；如果系统服务管理器无法确认服务状态且安装目录中存在 `easytier-cli`，会自动降级到 `easytier-cli service --name easytier-pro status`。

## 桌面端集成

桌面应用可以随安装包内置 `easytier-pro-installer` 二进制，然后用子进程调用 `desktop` 子命令。桌面端负责登录、选择注册密钥和 Console UI，installer 只负责本机 EasyTier 服务生命周期，并向 `stdout` 输出 JSON Lines 事件。

```bash
printf '%s' '{}' | easytier-pro-installer desktop status --json
```

常用命令：

```bash
easytier-pro-installer desktop status --json
easytier-pro-installer desktop install --json
easytier-pro-installer desktop update --json
easytier-pro-installer desktop uninstall --json
```

安装请求示例：

```json
{
  "bootstrap_token": "BOOTSTRAP_TOKEN",
  "install_dir": "/opt/easytier",
  "config_server": "tcp://console.easytier.net:22020",
  "version": "v2.6.4"
}
```

`install` 使用桌面端传入的 `bootstrap_token` 创建服务；`update` 必须传入目标 `version` 并会更新二进制后重启服务；`uninstall` 可传 `purge: true` 删除安装目录和缓存。`status` 只返回本机 core/cli、版本、machine id 和服务状态，不访问 Console。

## 构建

```bash
cd agent
cargo build --release
```

## 支持平台

- Linux (x86_64, aarch64, arm)
- Windows (x86_64, arm64)
- macOS (x86_64, aarch64)
- FreeBSD (x86_64)