lxh2875931338/frps-console

Fork 0

Files

T

lxh2875931338 c8693a4f0e 完整版frps下readme内容

2026-07-28 00:01:38 +08:00

10 KiB

Raw Blame History

frps-console

轻量级 frps 服务端管理面板 —— 让流量中转尽在掌握

📖 简介

frps-console 是专为 frp 服务端（frps）设计的轻量级 Web 管理工具。与 frpc-console 形成姊妹篇，一个管理客户端，一个管理服务端。

本项目作为 frp-console 系列套件的项目之一，延续 frpc-console 的设计哲学：以无限接近原生占用的情况下，实现完全图形化的控制工具。实测内存占用约 92MB（面板 60MB + frps 32MB），512MB 云服务器轻松跑。

✨ 核心特性

🔐 首次启动引导 —— Web 端完成管理员注册，无需 CLI 交互
🖥️ 服务端配置管理 —— 通过 WebUI 管理 frps 核心参数（bindPort / token / log / tcpMux），告别手动编辑 TOML
📊 客户端状态概览 —— 实时查看连接到 frps 的所有客户端列表，包含在线状态、连接时间、协议版本（v1/v2）
📄 运行日志面板 —— WebUI 内实时查看 frps 运行日志，8 秒自动轮询
🔄 配置热加载 —— 修改配置后一键热加载，无需重启 frps 服务
🖥️ 多平台支持 —— Linux AMD64 / ARM64 / ARMv7 全平台兼容
🐳 容器化就绪 —— 提供 Docker 镜像与一键部署脚本，开箱即用
🎨 深色磨砂玻璃 UI —— 与 frpc-console 保持统一的视觉风格

🚀 快速开始

🐧 二进制安装（推荐）

适用于 Linux 服务器，无需 Docker，单文件运行。

👉 详见：二进制安装指南

🐳 Docker 部署（一键脚本）

适用于 Linux 服务器，自动编译 + 自动部署。

curl -sSL https://git.whitetop.xyz/lxh2875931338/frps-console/raw/main/deploy.sh | sudo bash

👉 详见：Docker 安装指南

🔧 源码编译

适合开发者或需要自定义配置的用户。

git clone https://git.whitetop.xyz/lxh2875931338/frps-console.git
cd frps-console
go mod tidy
go build -o frps-console .
./frps-console

首次访问 http://localhost:9365 注册管理员账户即可开始使用。

🗂️ 项目结构

frps-console/
├── main.go                   # 入口
├── api.go                    # HTTP 路由 & Handler
├── db.go                     # SQLite 数据库操作
├── auth.go                   # JWT 认证 & 密码管理
├── frps.go                   # frps 管理核心逻辑
├── toml_parser.go            # TOML 解析器
├── static/                   # 前端静态资源
│   ├── index.html
│   ├── app.js
│   ├── style-1.css           # 全局基础样式
│   ├── style-2.css           # 登录页样式
│   ├── style-3.css           # 主界面样式
│   └── style-4.css
├── bin/                      # 内嵌 frps 二进制 (多平台)
│   ├── frps_windows_amd64.exe
│   ├── frps_linux_amd64
│   ├── frps_linux_arm64
│   └── frps_linux_arm_hf
├── frps.tmpl                 # frps 配置模板
├── Dockerfile
└── go.mod

⚙️ 配置说明

环境变量

变量	说明	默认值
PORT	监听端口	9365

数据存储

· 数据库文件：./frps-console.db
· frps 配置文件：./frps.toml
· frps 日志文件：./frps.log

🛠️ 开发指南

# 克隆项目
git clone https://git.whitetop.xyz/lxh2875931338/frps-console.git
cd frps-console

# 安装依赖
go mod tidy

# 开发模式运行
go run .

# 编译生产版本
go build -ldflags="-s -w" -o frps-console .

前端开发

前端使用 Vue 3 CDN，无需额外构建工具。修改 static/ 目录下的文件后，刷新浏览器即可预览效果。

🔧 常见问题

Q: 如何修改管理员密码？

登录后，在「全局配置」页面顶部找到「账户管理」区域，输入当前密码和新密码即可。

Q: frps 启动失败怎么办？

首次启动的话，console会创建一个全新的、符合官方规范的toml配置文件。
如果使用中出现启动失败问题，可以在console内重新配置一次服务端参数，或者导入已有的toml即可恢复
如果依旧无效，请查看 ./frpc.log 日志文件。

Q: 支持哪些 frp 版本？

目前支持情况如下：

系统	架构版本	版本号
Linux	AMD64/x86-64	0.70.0
Linux	ARM64/Aarch64	0.70.0
Linux	ARM_hf/ARMv7l	0.70.0

Q: frps-console 和 frpc-console 有什么区别？

对比项	frpc-console	frps-console
管理对象	frpc（客户端）	frps（服务端）
适用场景	软路由、小主机、本地服务穿透	VPS、云主机、流量中转
默认端口	9300	9365
核心功能	隧道增删改查 + 导入导出 TOML	服务端配置 + 客户端状态概览

Q: 如果 frps-console 进程挂了，frps 本身会受影响吗？

不会。

这是 frp-console 系列工具与同类项目最核心的区别之一。我们称之为 “阴阳模式”。

什么是“阴阳模式”？

以人的观察为出发点：

阴：看不见的业务流（frps 进程、toml 配置文件、隧道连接）
阳：看得见的管理面板（Web 界面、API 服务）

大多数管理工具走的是 “阳阴模式”：面板是“大脑”，业务是“肢体”。大脑一旦停止工作，肢体也就瘫痪了。

frps-console 走的是“阴阳模式”：业务是根基，面板是工具。

阴主导阳：业务不依赖面板存活，面板只是用来观察和调整业务状态的手段
阳依附于阴：面板的存在是为了服务业务，而不是反过来

二进制部署：

frps-console 启动时，会以子进程的方式拉起 frps，并为它创建一个独立的进程会话（Setsid）。即使 SSH 断开导致 frps-console 进程退出，frps 也会被系统的 init 进程（PID 1）接管，继续在后台稳定运行。配置文件（frps.toml）是持久化文件，不依赖 console 进程存活。

Docker 部署：

容器使用 --restart=always 策略，frps-console 进程意外退出时，Docker 守护进程会自动重启整个容器。重启后重新拉起 frps 子进程。数据目录通过卷挂载持久化，容器重启不会丢失任何配置。

核心原则：

console 只做“配置的保管者”和“进程的启动者”，而不是“配置的持有者”或“进程的绑定者”。即使 console 完全离线，已经生成的 frps.toml 依然存在，frps 进程依然可以独立运行。

管理面板可以丢，业务功能打死不能停。

Q: 支持 frps 的所有功能吗？

frps-console 覆盖了 frps 最核心的配置管理功能，包括 bindPort、token、log、tcpMux 等。如果你有更复杂的需求（如 Dashboard API 数据可视化、多 frps 管理），欢迎提 issue，我们会评估是否加入。

🧠 设计哲学

frps-console 遵循 “够用就好” 的原则：

frp 是轻量工具，管理工具也应该是轻量的。
能用 SQLite 就不用 PostgreSQL，能用 Vue CDN 就不用 React 全家桶。
前端能做的事，后端不加额外复杂度。
删掉一个容器等于删掉所有垃圾，所以用 Docker 隔离是对的。
面板的存在应该是为了服务业务的，而不该是反过来主导业务的。

📝 更新日志

2.0-Release（LTS，首次公开发布，与 frpc-console 2.0-LTS 同步）

这是 frps-console 的首次正式发布。frps-console 没有 1.x 系列——在 v1.x 阶段，它尚处于内部测试形态，从未公开发布。首次公开发布直接定为 2.0-LTS，与 frpc-console 的 LTS 版本对齐，后续版本号将与 frpc-console 保持同步。

· 🚀 服务端配置管理 —— 通过 WebUI 管理 frps 核心参数，告别手动编辑 TOML
· 📊 客户端状态概览 —— 实时查看连接到 frps 的所有客户端列表
· 📄 运行日志面板 —— WebUI 内实时查看 frps 日志，8 秒自动轮询
· 🔄 配置热加载 —— 修改配置后一键热加载，无需重启 frps
· 🔐 首次启动 Web 注册 —— 无需命令行交互即可完成管理员账户创建
· 🖥️ 多平台支持 —— Linux AMD64 / ARM64 / ARMv7 全平台兼容
· 🐳 容器化就绪 —— Docker 镜像 + 一键部署脚本，开箱即用
· 🎨 深色磨砂玻璃 UI —— 与 frpc-console 保持统一的视觉风格
· 🔒 数据库自动迁移 —— 升级时自动备份 + 迁移，数据零丢失
· 🧩 frp v2 协议就绪 —— frps 已升级至 0.70.0 LTS，原生支持 v2 协议（v2 开关在 frpc 侧开启）

📄 许可证

🙏 相关项目援引

FRP 生态互补工具

· MoonProxy —— 基于 Tauri v2 + Vue 3 + Rust 构建的跨平台 FRP 桌面客户端（frpc GUI），面向 macOS 与 Windows，MIT 协议开源。

· frpc-console —— 姊妹篇，管理 frpc 客户端，已发布 2.0-LTS，同步 LTS 维护。

🙏 致谢

· fatedier/frp —— 强大的内网穿透工具
· gin-gonic/gin —— 高性能 Go Web 框架
· vuejs/vue —— 渐进式 JavaScript 框架

10 KiB Raw Blame History Unescape Escape