Self-hosted · frp control plane

把 frp 隧道管理得
更清楚一点

xfrp 是一个自托管的 frp 管理面板。中控只提供 API 和节点控制通道,网关独立运行 frps,客户端运行 frpc;代理、状态和流量集中在一个界面里。

中控 master API · 用户 · 节点控制
WebSocket ↓
网关 server 公网机器 · frps
frp tunnel ↓
客户端 client 内网机器 · frpc
代理 proxy TCP · UDP · HTTP · HTTPS

为长期运行而设计

控制面和数据面分开,节点断线自动重连,代理变更尽量不打断现有连接。

三种角色分离

master、server、client 各自独立二进制。中控不运行 frps,网关不保存业务数据。

节点控制通道

节点通过 WebSocket 连接中控,心跳检测在线状态,断线按指数退避重连。

代理热更新

只修改代理时,中控把最新配置推送到客户端,frpc 热更新而无需重启进程。

完整代理类型

支持 TCP、UDP、HTTP、HTTPS;表单编辑或直接编辑完整 frp 配置 JSON。

流量统计

网关心跳上报 frps 原始计数,中控按天换算增量,展示今日、累计和趋势。

双域账号体系

管理员和普通用户分表、分 API、分 Cookie,普通用户只能管理自己的资源。

部署路径清晰

一台公网网关,加上需要穿透的内网客户端,就可以开始。

启动中控

部署 xfrp-master,连接数据库,创建第一个管理员。

接入网关

在公网机器运行 xfrp-server,在管理端创建网关并复制安装命令。

添加客户端

内网机器运行 xfrp-client,创建代理并选择 TCP、UDP、HTTP 或 HTTPS。

从一台网关开始

控制台、网关和客户端都使用同一个中控地址,配置下发后自动生效。

阅读部署文档