返回目录
开源项目系统与运维类新手

Frpc-Desktop:FRP 跨平台可视化桌面客户端

Frpc-Desktop 是 luckjiawei 开发的 FRP 跨平台桌面客户端,通过可视化界面管理 frpc 代理,实现内网穿透。支持全部 frp 版本、开机自启、可视化配置,免费开源,采用 MIT 许可证,项目已达成 10,000+ 下载里程碑。

0 次阅读2026/09/14 发布
Frpc-Desktop:FRP 跨平台可视化桌面客户端 来源图片

社区作者 · zZz

它解决什么问题

Frpc-Desktop 是一个面向 FRP 的跨平台桌面客户端,主打“可视化配置,轻松实现内网穿透”。主页宣传的核心能力包括:支持所有 frp 版本、开机自启、可视化配置、免费开源,并已达成 10,000+ 下载里程碑。

项目 Logo 见配图 1;项目被 HelloGitHub 推荐(配图 2);社区入口包括微信二维码(配图 3)与公众号二维码(配图 4,正文说明微信群超过 200 人无法扫码加入,需关注公众号入群),另有 Telegram 群 https://t.me/+4kziSBL3LxVmYzVl,并强调“禁止广告”。

界面截图(英文版):启动界面(配图 5)、代理管理 proxys manager(配图 6)、frp 下载 frp download(配图 7)、配置 config(配图 8)、日志 logger(配图 9)、关于 about(配图 10)。贡献者头像墙见配图 11,Star 历史曲线见配图 12。

作者说明:如果更喜欢 Web UI,可以尝试同一作者的 Podux —— 基于浏览器的 frpc 管理器。

TODO(规划中功能):开机自启;支持 user 与 meta_token 的多用户;便携版;新增 UDP 代理类型;支持 frps 快速分享;本地端口快速选择;支持 STCP 代理类型;通过镜像站点下载 frp;全部配置的导入/导出;一键清空全部配置;支持导入并识别 frpc.toml;TCP 与 UDP 协议支持批量端口;多语言支持;卡片/列表分页的代理快速搜索。

版本里程碑(按正文时间线):2026-05-21 发布 v1.2.6,新增下载代理选择;2026-03-26 发布 v1.2.5,修复已知问题;2025-09-10 发布 v1.2.3,修复已知问题、支持 proxy 协议、优化性能;2025-04-22 发布 v1.2.2,修复已知问题、支持 HTTP Locations;2025-03-25 发布 v1.2.1,修复已知问题、支持英文;2025-03-06 发布 v1.2.0,底层重构、提升稳定性;2025-01-09 发布 v1.1.

6;2024-12-04 发布 v1.1.5,优化体验、支持修改 webport、解决 GitHub 限流问题、日志优化;2024-11-08 发布 v1.1.4,修复已知问题;2024-10-14 发布 v1.1.3,支持 XTCP 协议、优化体验;2024-09-25 发布 v1.1.2,支持 HTTP basic auth、子域名;2024-09-07 发布 v1.1.0,支持批量端口、单代理开关控制;2024-08-24 发布 v1.0.9,支持镜像下载、配置导入导出;2024-08-17 发布 v1.0.

8,支持 STCP 代理;2024-08-11 v1.0.7;2024-08-09 v1.0.6;2024-08-06 v1.0.5;2024-08-06 v1.0.4,适配多用户插件;2024-07-17 v1.0.3,修复已知问题、新增自启动、新增 frp 版本删除;2024-01-29 v1.0.2,新增 Linux 客户端与代理模式;2023-12-01 v1.0.1;2023-11-28 v1.0。

常见问题(原文):1)macOS universal 构建在 better-sqlite3 预编译产物上失败——使用 electron-builder 26 构建时需保留 electron-builder.json5 中的 mac.x64ArchFiles 规则,使 better-sqlite3 提供的同名 darwin-x64.node 与 darwin-arm64.

node 预编译产物保留在 universal 应用中,由 better-sqlite3 在运行时选择匹配的二进制;在 macOS 上运行 npm run build:electron:mac 重新构建。2)Mac 提示应用已损坏——执行命令 sudo xattr -cr Frpc-Desktop.app。

许可与支持:许可证为 MIT;页面提供捐赠入口。

— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。

安装 / 开始使用

来源 README 未提供完整的“从下载到运行”逐步安装教程,以下仅整理正文可确认的内容,未写明处标注“待核验”:

一、准备环境

  1. 操作系统:项目为跨平台桌面客户端,正文提到 2024-01-29 发布的 v1.0.2 新增 Linux 客户端,说明覆盖 Windows / macOS / Linux;具体支持的系统版本与硬件要求来源未列出,待核验。
  1. 运行前提:需要自行准备可用的 frps 服务端及其配置信息;客户端侧需准备 frp 内核(正文提供“通过镜像站点下载 frp”的待办项,以及已有“frp download”界面与“下载代理选择”功能)。服务端搭建步骤来源未说明,待核验。
  1. 源码构建环境(仅正文提及的部分):Node.js/npm 环境与 electron-builder 26;其余依赖与版本要求待核验。

二、使用步骤(以界面流程说明)

  1. 启动应用,进入启动界面(配图 5 launch)。
  1. 在“frp download”界面下载所需的 frp 版本,项目支持全部 frp 版本,并可删除已下载版本(配图 7)。
  1. 在“config”界面进行可视化配置(配图 8)。
  1. 在代理管理界面新增/管理代理,支持 TCP、UDP、HTTP、XTCP、STCP 等类型以及批量端口、单代理开关(配图 6)。
  1. 在“logger”界面查看运行日志(配图 9)。
  1. 在“about”界面查看版本等信息(配图 10)。

三、源码构建命令(原文 Common Issues 中明确给出)

  1. 使用 electron-builder 26 构建 macOS universal 包时,需保留 electron-builder.json5 中的 mac.x64ArchFiles 规则,以保证 better-sqlite3 的 darwin-x64.node 与 darwin-arm64.node 预编译产物保留在 universal 应用中,运行时自动选择匹配二进制。

步骤 2 · 在 macOS 上执行重新构建命令:

可复制命令
npm run build:electron:mac

四、首次运行常见问题处理

  1. Mac 提示 App 已损坏,执行:sudo xattr -cr Frpc-Desktop.app
  2. macOS universal 构建在 better-sqlite3 预编译产物上失败:按上述第三条处理。
  1. 正文提到 v1.1.5 已解决 GitHub rate limit 问题,v1.2.6 新增下载代理选择,若下载 frp 内核受限可优先使用较新版本,具体镜像配置方式待核验。

五、安装包获取 正文未给出安装包的直接下载链接与安装器步骤说明,待核验。

来源教程配图

Logo
配图 1 · Logo查看原图
Featured|HelloGitHub
配图 2 · Featured|HelloGitHub查看原图
QR Code
配图 3 · QR Code查看原图
Official Account QR Code
配图 4 · Official Account QR Code查看原图
launch
配图 5 · launch查看原图
proxys manager
配图 6 · proxys manager查看原图
frp download
配图 7 · frp download查看原图
config
配图 8 · config查看原图

适用场景

在 Windows / macOS / Linux 桌面端以可视化界面配置并启动 frpc
实现内网穿透
将本地 TCP / UDP 服务通过 frps 暴露到公网
用于远程访问自建服务
管理多条代理配置
支持批量端口与单条代理开关控制
按需下载
切换与删除不同版本的 frp 内核
兼容所有 frp 版本
通过日志界面排查 frpc 连接与代理转发问题
导入导出全部配置
便于多机迁移或备份