Files
frpc-console/readme.md
T
2026-08-04 11:25:42 +08:00

143 lines
4.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
frpc-console
让 FRP 回归工具本身,而不是变成一个需要持续维护的系统。
📌 定位
frpc-console 并不是一个“管理平台”。
它更像一个控制台——部署一次,配置一次,然后尽可能忘记它。
它不会接管 FRP 的运行方式,不会改变 FRP 的行为逻辑,也不会在系统中增加一个需要持续关注的组件。
它只是在 FRP 原本的工作方式之上,提供一个更自然、更符合直觉的入口:
· 不需要记忆命令行参数
· 不需要手动编辑 TOML
· 不需要在配置变更后手动重启
控制应该存在,但不应该成为负担。
🎨 设计哲学
frpc-console 遵循几条简单的原则:
1. 工具服务于用户,而不是要求用户适应工具。
功能的存在是为了解决问题,而不是为了证明工具的能力。一个功能如果带来了新的维护成本,那它就值得被重新审视。
2. 能自动完成的事情,不应该要求用户手动操作。
配置迁移、Schema 升级、进程保活——这些应该由工具自己处理,而不是交给用户去操心。
3. 功能越多,不代表体验越好。
每增加一个功能,都是在增加用户的认知负担。frpc-console 只在必要的时候增加功能,并且确保新增功能不会制造新的复杂性。
4. 当用户逐渐忘记 frpc-console 的存在时,它就是成功的。
一个工具最好的状态,是用户不需要记住它的存在。它应该在自己该在的地方待着,在需要的时候出现,在不需要的时候不打扰。
✨ 为什么叫 Console,而不是 Manager
Manager 暗示的是:有一个“管理者”和一个“被管理者”的层级关系。它会让人天然认为这个工具是系统的一部分,是需要一直在线、持续监控的核心组件。
但 frpc-console 不是这样的角色。
Console 更准确地描述了它的定位:
· 一个控制台,用户需要的时候走上去看一眼,调一下参数,然后离开
· 它不需要被持续感知
· 它的价值在于“当你需要的时候,它就在那里”,而不是“它一直在那里运转”
它只是一个入口,而不是一个中心。
🖥️ UI 设计
UI 没有采用功能繁重的复杂框架,而是选择了磨砂玻璃风格的轻量设计。
它的目标不是“看起来花哨”,而是“看起来舒服”——让界面在视觉上不喧宾夺主,让用户能够专注于需要完成的操作,而不是被界面本身分散注意力。
🚀 核心能力
首次启动引导
浏览器完成管理员注册,无需命令行交互,开箱即用。
隧道全生命周期管理
增删改查 + 一键启用/禁用。所有操作可视化,不需要手动编辑 TOML。
TOML 导入/导出
无缝迁移现有的 frpc 配置。你原来怎么配置的,现在依然可以用同样的方式配置。
配置热加载
修改配置后自动生效,不需要手动重启 frpc。
运行日志面板
WebUI 内实时查看 frpc 日志,不需要 SSH 进入服务器。
Ping 延迟检测
顶部导航实时显示 frpc 到 frps 的延迟,一目了然。
多平台支持
Windows / Linux / ARM 全平台兼容,单二进制交付。
Docker 容器化
提供 Docker 镜像,一键部署,数据持久化。
🧠 设计原则
frpc-console 始终遵循几条底层原则:
· 工具服务于用户,而不是要求用户适应工具。
· 功能越多,不代表体验越好。
· 能自动完成的事情,不应该要求用户手动操作。
· 当用户逐渐忘记 frpc-console 的存在时,它就是成功的。
📦 快速开始
Docker 部署(推荐)
```bash
curl -sSL https://git.whitetop.xyz/lxh2875931338/frpc-console/raw/main/run-deploy.sh | sudo bash
```
二进制部署
INSTALL_BINARY.md
Docker 部署指南
INSTALL_DOCKER.md
📄 License
MIT License © 2026 lxh2875931338
## 🙏 相关项目援引
### FRP 生态互补工具
· [MoonProxy](https://github.com/MoonProxyHQ/moonproxy-desktop) —— 基于 Tauri v2 + Vue 3 + Rust 构建的跨平台 FRP 桌面客户端(frpc GUI),面向 macOS 与 Windows,让内网穿透开箱即用,MIT协议开源。
### FRP 生态同类工具(暂无互引)
</br>
---
🙏 相关项目
· MoonProxy —— 跨平台 FRP 桌面客户端
· fatedier/frp —— 内网穿透工具的核心引擎
---
如果这个项目对你有用,欢迎给它点个 Star ⭐