# FrpcPilot
**frp 可视化桌面客户端 —— 告别手写** **`frpc.toml`**
下载 frpc、配置服务器、编排隧道、一键启动并实时查看日志，全部在同一个窗口里完成。
[](https://github.com/SparksFly91/FrpcPilot/releases)
[](./LICENSE)
[](#-下载安装)
[](https://v2.tauri.app/)
[](https://vuejs.org/)
[](https://github.com/SparksFly91/FrpcPilot/pulls)
运行数据按安装位置分类保存，目录规则与平台差异见 [数据目录说明](docs/数据目录说明.md)。
> 📘 **新手必读**：第一次搭建内网穿透？请阅读 **[《Frp 内网穿透搭建指南》](docs/Frp搭建内网穿透指南.md)** —— 从公网服务端搭建到用 FrpcPilot 一键开启穿透，手把手带你跑通第一个隧道。
***
## 🏷️ 关于「FrpcPilot」这个名字
> **FrpcPilot = Frpc + Pilot**（领航员）
- **Frpc** —— 取自 [frp](https://github.com/fatedier/frp) 的客户端组件 `frpc`，也是本项目服务的核心对象；
- **Pilot** —— 飞行员 / 领航员。frp 本身足够强大，却总离不开手写 `frpc.toml` 与敲命令启动；FrpcPilot 想做你的「frpc 领航员」，把这些繁琐的配置与命令行统统收进图形界面，带你稳稳起飞。
一句话：**让 frpc 起飞，你只管掌舵。** ✈️
***
## 📖 项目简介
**FrpcPilot** 是一个基于 **Tauri 2 + Vue 3 + TypeScript** 的 [frp](https://github.com/fatedier/frp) 图形化客户端。它把原本需要手工编辑 `frpc.toml` 的繁琐流程，变成「点几下就能跑起来」：在线下载 frpc、管理 frps 服务器与隧道、一键启动内网穿透，并实时回显运行日志。
得益于 Tauri 的轻量内核，应用体积小、内存占用低；后端使用 Rust + SQLite 本地持久化，数据完全保存在你自己的电脑上，不经过任何第三方服务。
> 当前版本 **v1.2.1**，已支持 Windows / macOS（Apple Silicon）/ Linux 三平台，并内置应用内自动更新。
***
## 🖼️ 界面预览
| 仪表盘 | 服务器 |
| ------------------------------- | ------------------------------- |
|  |  |
| 隧道列表 | Frpc 下载 |
| --------------------------------- | -------------------------------------- |
|  |  |
| 设置 · 常规 | 设置 · 外观 |
| ---------------------------------- | ------------------------------- |
|  |  |
***
## ✨ 功能特性
### 📊 仪表盘
- 一屏总览：服务器数量、隧道数量，以及主机名 / 系统 / 架构 / IP 地址等系统信息
- 选择 frpc 版本后「**一键启动 / 停止**」，运行状态实时联动
- **实时日志**：通过事件流回显 frpc 运行日志（保留最近 500 行，支持一键清空）
- 侧边栏常驻 **CPU / 内存占用** 与运行状态指示（🟢 运行正常 · 🔴 运行异常 · 🟡 未启动）
### 🖥️ 服务器管理
- frps 服务器的新增 / 编辑 / 删除
- 支持服务器地址、端口、鉴权 Token、传输协议、TLS 开关与备注
- 置顶与排序；启用开关（**同一时间仅允许启用一台**服务器）
### 🔀 隧道管理
- 覆盖 **TCP / UDP / HTTP / HTTPS / STCP / XTCP / SUDP / TCPMUX** 等代理类型
- 本地 IP / 端口、远程端口、自定义域名、子域名、URL 前缀
- 高级配置：密钥、加密、压缩、带宽限制、Proxy Protocol、健康检查、负载均衡
- 统一管理启用 / 置顶 / 排序
### 📦 Frpc 下载管理
- 在线拉取 frp 官方版本列表，按平台与架构筛选，支持「所有架构 frpc / frps」开关
- 一键下载并自动解压，实时显示下载 / 解压进度与状态（支持镜像加速）
- 导入本地已有的 `frpc` / `frps`，删除已下载版本、复制下载直链
- **页面级缓存**：应用运行期间仅首次进入时拉取版本列表，避免重复请求触发限流，需要更新时手动点击「刷新」
### 🚀 一键启动与进程管理
- 依据所选版本、已启用的服务器与隧道，自动生成 `frpc.toml` 并拉起独立进程
- 通过 `frpc-log` / `frpc-exit` 事件实时推送日志与进程退出信息
- 应用退出时自动结束 frpc 子进程，避免残留后台进程
### 🗂️ 系统托盘
- 常驻托盘菜单：**显示窗口 / 启动穿透 / 停止穿透 / 退出**
- 左键单击直达主窗口，右键展开菜单；菜单随运行状态与界面语言自动联动
- 「退出」会先停止正在运行的穿透，再退出整个应用
### 🔔 关闭行为
- 关闭窗口时可选「**最小化到系统托盘**」或「**直接退出**」
- 支持「每次询问」与「保持以上选择」两种策略，也可在「设置 - 常规」中随时修改
### 🎨 界面与体验
- **自定义标题栏**：Windows / macOS 双套方案，窗口可拖拽移动；macOS 还原原生红绿灯
- **明暗主题**：一键切换，Tailwind 暗色变体与 Ant Design Vue 暗色算法同步
- **磨砂玻璃视觉**：侧边栏、内容区与卡片统一为圆角 + `backdrop-filter` 半透明面板，透明度可调
- **窗口背景**：内置 9 张背景图，可自由挑选，保持原始比例自适应
- **国际化**：内置简体中文 / English，语言选择持久化并与组件库语言包联动
### 🔄 应用内自动更新
- 启动时静默检查更新，支持手动检查
- 更新弹窗以 **Markdown** 渲染更新说明并展示下载进度
- 支持「忽略该版本」、一键更新，安装完成后自动重启
### ⚙️ 设置中心
- **常规**：关闭行为、应用语言
- **外观**：主题模式、背景图片、磨砂玻璃透明度（卡片 / 弹窗，实时预览）
- **关于**：项目介绍、技术栈、使用流程、开源地址与版本信息
***
## 📥 下载安装
前往 **[Releases](https://github.com/SparksFly91/FrpcPilot/releases/latest)** 下载对应平台的安装包：
| 平台 | 安装包 |
| -------------------- | -------------------- |
| Windows | `.exe`（NSIS 安装程序） |
| macOS（Apple Silicon） | `.dmg` / `.app` |
| Linux | `.deb` / `.AppImage` |
装好后打开应用即可，后续版本会在应用内自动检查并更新。
> 🧭 **首次使用？** 还不清楚怎么搭建 frps 服务端、怎么配置隧道？请参考 [《Frp 内网穿透搭建指南》](docs/Frp搭建内网穿透指南.md)。
***
## 🧱 技术栈
| 分类 | 选型 |
| -------- | ----------------------------------------------------------------------------- |
| 桌面框架 | [Tauri 2](https://v2.tauri.app/)（Rust 后端） |
| 前端框架 | Vue 3（`