Frp Panel搭建

南鸢宸羲
2026-06-08
点 赞
0
热 度
1
评 论
0
  1. 首页
  2. 软件部署合集
  3. Liunx
  4. Frp Panel搭建
阅读 -- 次

下载的包里将config.yaml文件修改配置

server:
  host: "0.0.0.0"
  port: 8088
  mode: "debug"

database:
  driver: "sqlite"
  dsn: "frp-panel.db"

redis:
  addr: "192.144.237.185:6379"
  password: "txredis"
  db: 7

jwt:
  # !! 必须修改为随机字符串 !!
  secret: "xCAlGJVJangZ1CzEN6bE7bisYI7AQ94i"
  expire_time: 24h
  issuer: "frp-panel"

frp:
  default_version: "0.69.1"
  github_mirror: "https://ghfast.top"
  download_timeout: 300
  # 面板自身的 webhook 地址,部署后修改为实际地址 当前服务器ip地址即可
  plugin_webhook_url: "http://192.144.237.185:8088/api/plugin/webhook"
  # !! 所有 frps 共用的认证 token,必须修改 !!
  server_token: "wsh1009147564@vip.qq.com"

admin:
  email: "wsh1009147564@vip.qq.com"
  # !! 首次登录后立即修改 !!
  password: "wsh9210832"

在修改frps.toml文件配置

bindPort = 7000

webServer.addr = "0.0.0.0"
webServer.port = 700
webServer.user = "wshlyl"
webServer.password = "wsh9210832"

# 指向面板的 webhook
httpPlugin.addr = "192.144.237.185"
httpPlugin.port = 8088
httpPlugin.path = "/api/plugin/webhook"
httpPlugin.ops = ["Login", "NewProxy", "CloseProxy", "Ping"]

运行命令

cd server
nohup ./frp-panel -config config.yaml > frp-panel.log 2>&1 &

官网配置说明文件

FRP Panel 使用手册

目录

  1. 快速开始
  2. 配置文件详解
  3. 首次登录
  4. 添加 frps 服务器
  5. 用户注册与套餐
  6. 创建代理
  7. 连接方式
  8. 支付配置
  9. 邀请返利系统
  10. 优惠券系统
  11. 系统设置
  12. 监控与告警
  13. 常见问题

1. 快速开始

方式一:直接运行

  1. 下载对应平台的 frp-panel 二进制文件和 config.yaml
  2. 编辑 config.yaml(详见下一节)
  3. 运行:
./frp-panel -config config.yaml

方式二:Docker 运行

docker run -d \
  --name frp-panel \
  -p 8080:8080 \
  -v /path/to/config.yaml:/app/config.yaml \
  -v /path/to/data:/app/data \
  frp-panel:latest


2. 配置文件详解

配置文件 config.yaml 是启动前必须编辑的文件。以下是完整示例,标注了必须修改的项目:

server:
  host: "0.0.0.0"       # 监听地址,一般不用改
  port: 8080             # 面板端口,按需修改
  mode: "debug"          # debug / release,生产环境用 release

database:
  driver: "sqlite"       # 目前仅支持 sqlite
  dsn: "frp-panel.db"   # 数据库文件路径

redis:
  addr: "localhost:6379"
  password: ""
  db: 0

jwt:
  # !! 必须修改:JWT 签名密钥,改为任意随机字符串 !!
  secret: "CHANGE-ME-TO-A-RANDOM-SECRET-KEY"
  expire_time: 24h       # 登录 token 有效期
  issuer: "frp-panel"

frp:
  default_version: "0.68.0"   # frp 版本
  github_mirror: "https://github.com"  # GitHub 下载镜像
  download_timeout: 300       # 下载超时(秒)
  # !! 必须修改:面板自身的 webhook 地址,改为实际部署地址 !!
  plugin_webhook_url: "http://YOUR-PANEL-IP:8080/api/plugin/webhook"
  # !! 必须修改:所有 frps 共用的认证 token,改为随机字符串 !!
  server_token: "CHANGE-ME-TO-A-RANDOM-TOKEN"

admin:
  email: "admin@example.com"  # 管理员邮箱,按需修改
  # !! 必须修改:管理员初始密码 !!
  password: "CHANGE-ME"

必须修改的 4 项

配置项 说明 示例
jwt.secret JWT 签名密钥 aB3x$kL9mN2pQ7rS
frp.plugin_webhook_url 面板 webhook 地址 http://162.251.94.184:8080/api/plugin/webhook
frp.server_token frps 认证 token myRandomToken123
admin.password 管理员密码 StrongP@ssw0rd

注意:plugin_webhook_url 中的 IP 必须是面板服务器的公网 IP(或内网 IP,取决于 frps 能否访问到面板)。


3. 首次登录

  1. 启动面板后,浏览器访问 http://YOUR-IP:8080
  2. 使用配置文件中设置的管理员邮箱和密码登录
  3. 登录后请立即修改密码(用户中心 → 修改密码)

4. 添加 frps 服务器

登录管理后台后,进入 服务器管理 页面,点击 添加服务器。

必填字段

字段 说明
名称 服务器标识,如 “美国节点”
IP 地址 frps 服务器的公网 IP
绑定端口 frps 的 bind_port,默认 7000
Dashboard 端口 frps 的 dashboard_port,默认 7500
Dashboard 用户名 frps dashboard 的用户名,默认 admin
Dashboard 密码 frps dashboard 的密码

可选字段

字段 说明
Vhost HTTP 端口 frps 的 vhost_http_port,用于 HTTP 代理
Vhost HTTPS 端口 frps 的 vhost_https_port,用于 HTTPS 代理
Token frps 的 token(如果 frps 配置了 token)

frps 端配置要求

frps 端需要启用 dashboard 并配置 httpPlugin 指向面板 webhook:

# frps.toml
bindPort = 7000

webServer.addr = "0.0.0.0"
webServer.port = 7500
webServer.user = "admin"
webServer.password = "your_dashboard_password"

# 指向面板的 webhook
httpPlugin.addr = "YOUR-PANEL-IP"
httpPlugin.port = 8080
httpPlugin.path = "/api/plugin/webhook"
httpPlugin.ops = ["Login", "NewProxy", "CloseProxy", "Ping"]


5. 用户注册与套餐

注册设置

在 系统设置 中可以控制是否开放注册:

  • registration_enabled: 是否允许新用户注册
  • login_enabled: 是否允许登录(维护时可关闭)

套餐管理

管理后台 → 套餐管理,可以创建不同等级的套餐:

字段 说明
名称 套餐名,如 “基础版”
最大代理数 用户可创建的代理数量上限
最大带宽 每个代理的带宽上限(字节/秒)
最大流量 每月总流量上限(字节)
最大端口数 可使用的端口数量
有效期(天) 套餐有效天数
月付/季付/年付价格 0 表示免费

系统内置了 4 个默认套餐:Free、Basic、Pro、Enterprise。


6. 创建代理

用户登录后进入 我的代理 页面,点击 创建代理。

通用字段

字段 说明 必填
名称 代理标识 是
类型 tcp / udp / http / https / stcp / xtcp 是
本地 IP 要转发的目标 IP,默认 127.0.0.1 否
本地端口 要转发的目标端口 是
启用加密 是否加密传输 否
启用压缩 是否压缩传输 否
带宽限制 代理级别的带宽限制(字节/秒) 否

按类型填写

TCP / UDP 代理

  • 远程端口(必填):用户通过此端口访问你的服务

HTTP / HTTPS 代理

  • 自定义域名:绑定的域名(如 app.example.com)
  • 子域名:使用平台提供的子域名(如 myapp.your-domain.com)
  • 两者至少填一个

STCP / XTCP 代理

  • 密钥(必填):访客端连接时需要的密钥

7. 连接方式

方式一:Frpc-Desktop 客户端(推荐)

  1. 下载 Frpc-Desktop 客户端
  2. 在面板 个人中心 复制你的 API Key
  3. 在 Frpc-Desktop 中添加服务器,填入:
    • 服务器 IP
    • 绑定端口(默认 7000)
    • API Key(作为认证凭据)
  4. 点击连接,客户端会自动拉取你的代理配置

方式二:官方 frpc 客户端

在代理详情页点击 获取配置,复制 frpc 配置文件内容,保存为 frpc.toml 后运行:

./frpc -c frpc.toml


8. 支持的支付方式

管理后台 → 支付配置,目前支持:

支付方式 说明
支付宝(当面付) 需要签约当面付,填写应用 ID 和私钥
USDT (TRC20) 填写 TRC20 收款地址

支付宝配置

字段 说明
App ID 支付宝开放平台应用 ID
私钥 应用 RSA2 私钥
支付宝公钥 支付宝提供的公钥
异步通知 URL 面板回调地址,格式 http://YOUR-IP:8080/api/payment/notify/alipay

USDT 配置

字段 说明
TRC20 地址 你的 USDT-TRC20 收款地址
汇率 USDT 对人民币汇率(如 7.2)

9. 邀请返利系统

用户在 邀请好友 页面获取邀请码,分享给好友注册后可获得返利。

设置

在 系统设置 中配置:

  • invite_rebate_level1_percent: 一级返利比例(%),默认 10
  • invite_rebate_level2_percent: 二级返利比例(%),默认 5

规则

  • 好友通过邀请码注册后,其每次充值,邀请人都会获得返利
  • 二级返利:被邀请人再邀请第三人,原邀请人也能获得二级返利
  • 返利金额记录在 返利记录 中,管理员可手动处理提现

10. 优惠券系统

管理后台 → 优惠券管理,可以创建优惠券:

字段 说明
代码 优惠券代码,如 WELCOME20
类型 固定金额 / 百分比折扣
值 金额(元)或折扣百分比
最低消费 使用门槛(元)
有效期 过期时间
最大使用次数 0 表示不限

用户在下单时输入优惠券代码即可抵扣。


11. 系统设置

管理后台 → 系统设置,可配置以下项目:

设置项 说明
registration_enabled 是否开放注册
login_enabled 是否允许登录
site_title 站点标题
site_announcement 站点公告(支持 HTML)
smtp_host 邮件服务器地址
smtp_port 邮件服务器端口
smtp_user 邮件用户名
smtp_password 邮件密码
smtp_from 发件人地址
invite_rebate_level1_percent 一级返利比例
invite_rebate_level2_percent 二级返利比例

12. 监控与告警

服务器监控

面板每 30 秒自动轮询 frps dashboard API,获取:

  • 代理连接状态
  • 流量统计(上传/下载)
  • 客户端连接数

告警规则

管理后台 → 告警管理,可设置告警规则:

  • 流量使用百分比告警
  • 服务器离线告警
  • 代理异常告警

流量限制

  • 用户流量超限时,所有代理将自动禁用
  • 套餐带宽上限在创建/修改代理时强制校验

13. 常见问题

Q: frps 连接面板失败?

检查 plugin_webhook_url 是否正确,确保 frps 所在服务器能访问面板的 8080 端口。

Q: 代理状态显示"未连接"?

  1. 确认 frpc 客户端已启动并连接成功
  2. 检查 frps dashboard 是否正常工作
  3. 等待 30 秒(轮询间隔)后刷新

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

登录后进入 个人中心 → 修改密码。

Q: 如何备份数据?

备份 frp-panel.db 文件即可(SQLite 数据库)。

Q: 端口 1024 以下无法使用?

系统限制远程端口必须 >= 1024,这是安全策略,无法修改。

Q: 如何升级 frp-panel?

  1. 停止当前面板
  2. 替换二进制文件
  3. 重新启动(数据库会自动迁移)

快速参考

操作 路径
管理后台 http://IP:8080/admin
用户面板 http://IP:8080
plugin_webhook http://IP:8080/api/plugin/webhook
支付宝回调 http://IP:8080/api/payment/notify/alipay
数据库文件 frp-panel.db(同目录下)
配置文件 config.yaml(同目录下)

官网简易安装说明文件

FRP Panel 全量发布包

目录结构

release-full/ ├── server/ # 服务端(部署到 Linux 服务器) │ ├── frps # frps 服务端程序(v0.68.0) │ ├── frpc # frpc 客户端程序(v0.68.0,可选) │ ├── frp-panel # 管理面板程序 │ ├── config.yaml # 面板配置文件(必须修改) │ ├── frps.toml # frps 示例配置 │ ├── frpc.toml # frpc 示例配置 │ ├── 使用手册.md # 完整使用手册 │ └── LICENSE └── client/ └── Frpc-Desktop/ # Windows 客户端(免安装,直接运行)

快速开始

  1. 将 server/ 目录上传到 Linux 服务器
  2. 编辑 config.yaml,修改以下 4 项:
  3. 配置 frps(参考 frps.toml,需添加 httpPlugin 配置指向面板)
  4. 运行面板:chmod +x frp-panel && ./frp-panel -config config.yaml
  5. 浏览器访问 http://服务器IP:8080 登录管理后台
  6. 客户端:解压 client/Frpc-Desktop/,运行 Frpc-Desktop.exe

详细说明请阅读 使用手册.md

下载地址:


余乃云水散人,栖于数字之墟。性耽幽静,常以青简为田,墨痕为穗。晨起推窗,听松风煮茶;夜阑掩卷,伴竹影扫阶。此间筑小筑三椽,藏闲话若干:或遇史海遗珠,则录以素札;偶得诗瓢碎玉,便缀作清吟。往来皆烟霞客,谈笑有鸿儒踪。诸君若得暇,不妨暂驻云履,共品一盏烟岚,半卷春秋。

南鸢宸羲

站长

具有版权性

请您在转载、复制时注明本文 作者、链接及内容来源信息。 若涉及转载第三方内容,还需一同注明。

具有时效性

文章目录

展开侧栏

欢迎来到南鸢宸羲的站点,为您导航全站动态

117 文章数
28 分类数
0 评论数
35标签数
最近评论