需要登录的路由
标记了
meta.requiresAuth: true的页面,未登录会被守卫重定向到/login?redirect=原路径。
1. 控制台 /dashboard
- 组件:
Dashboard.vue - Meta:
titleKey: 'menu.dashboard'、requiresAuth: true、noScroll: true - 数据来源:
/info(服务统计)、/user type=info(用户信息,经userStore.fetchUserInfo())、/traffic.php type=trend(流量趋势) - 功能:
- 服务统计:在线客户端、总流量、在线节点、今日流量、今日启动次数、总入网 / 出网、今日入网 / 出网
- 用户信息:用户名、邮箱、用户 ID、UUID、实名认证状态、注册时间
- 流量统计:剩余流量、今日已用、隧道使用(已用 / 上限)、流量趋势曲线
- 每日签到:
userStore.sign(),展示累计签到天数、累计获得流量、上次签到时间 - 交流群入口、广告横幅(登录用户可见)
- 说明: 流量趋势来自
/traffic.php type=trend,默认 7 天,最大 90 天
2. 隧道管理 /proxies
- 组件:
Proxies.vue - Meta:
titleKey: 'menu.proxies'、requiresAuth: true、noScroll: true - 功能:
- 隧道列表:名称、类型、本地 / 远程端口、节点、状态、加密 / 压缩标记
- 搜索与批量选择(按名称 / 类型过滤、全选 / 清空、批量操作)
- 新建隧道:TCP / UDP / HTTP / HTTPS / XTCP / STCP,支持随机名称、随机端口、可用端口范围提示
- 编辑 / 删除隧道,启用 / 禁用(
toggle),强制下线(forcedown) - 导出配置文件(ini / toml)
- P2P 隧道展示连接密钥(
sk)与绑定域名(domain) - 简单启动:调用
/esirun.php type=create生成隧道启动密钥,弹窗给出 Windows (frpc.exe -esirun <密钥> -i https://api.hayfrp.1zyq1.com/)与 Linux (./frpc -esirun <密钥> -i https://api.hayfrp.1zyq1.com/)两条命令;STCP / XTCP 不支持并给出提示 - 隧道上下线状态变化时,若用户在设置页开启了通知,会推送浏览器通知(
notifyProxyStatus())
3. 联机大厅 /lobby
- 组件:
Lobby.vue - Meta:
titleKey: 'menu.lobby'、requiresAuth: true、noScroll: true - 功能:
- 房间卡片墙:房间名称、介绍、在线状态、房主 / 访客、是否加密(密码锁)
- 搜索房间名称,分页翻页
- 开房:选择自己名下的 P2P(XTCP / STCP)隧道,或内联新建一条 P2P 隧道;可设置房间密码
- 房间详情抽屉:加入房间、实时状态轮询、获取 / 复制连接密钥、房间聊天(拉取 / 发送 / 清空)、房主删除房间
- 接口:
/oh.php(list/add/join/run/remove/check/getchat/clearchat/sendchat),详见 联机大厅 API
4. 用户设置 /settings
- 组件:
UserSettings.vue - Meta:
titleKey: 'user.settings'、requiresAuth: true - 功能:
- 修改用户名(
/user type=cuname) - 修改密码(邮箱验证码 + 重置,
findpassem→findpassct) - 绑定 QQ(绑定后头像自动使用 QQ 头像)
- 重置 FRP 连接 Token(
/user type=retoken,旧客户端配置立即失效) - 浏览器通知设置:请求通知权限、开关「隧道状态变更通知」
- 申请成为服务商(
/dashboard/besp,填写申请理由) - 展示实名认证状态与 FRP 连接 Token / CSRF
- 修改用户名(
5. 面板个性化 /customize
- 组件:
Customize.vue - Meta:
titleKey: 'preference.title'、requiresAuth: true - 功能:
- 主题色、头部背景色、卡片背景色(
NColorPicker) - 紧凑模式(减小卡片与表单项间距)、动画效果、二次元风格(动漫壁纸背景)
- 保存 / 重置默认
- 主题色、头部背景色、卡片背景色(
- 存储: 写入
localStorage的customize_settings(主题色等通过 CSS 变量--primary-color、--header-bg、--card-bg生效);二次元风格存于animeStyle
6. 服务商控制台 /sp
- 组件:
ServiceProvider.vue - Meta:
titleKey: 'serviceProvider.title'、requiresAuth: true - 权限: 需要登录,且账号为服务商(
userInfo.sprovider === true) - 功能:
- 服务商独立登录(
/dashboard/login,服务商 Token 取自userInfo.token,不复用登录csrf) - 服务器列表:名称、域名、主机名、在线状态、在线时长、用户组、隧道类型支持
- 添加 / 编辑 / 删除服务器:国家、地区、简称、描述、Frps 端口、管理端口与密码、上下行带宽、端口范围、禁用端口、隧道类型、建站开关
- 单个 / 批量状态检测、一键配置(生成配置命令与配置文件预览)
- 公告管理:读取当前公告、发布公告(支持 HTML,渲染前经
DOMPurify清洗) - 申请管理:批准 / 忽略 / 删除全部申请
- 非服务商用户可见「申请成为服务商」入口
- 服务商独立登录(
7. 启动器授权 /launcher
- 组件:
Launcher.vue - Meta:
titleKey: 'menu.launcher'、requiresAuth: true - 功能:
- 通过本机
http://localhost:21100与 HayFrp 启动器通信 - 「一键授权」:
GET /csrf?csrf=<登录 Token>完成授权,成功后延时 500ms 请求/wake唤醒启动器 - 进入页面自动探测启动器是否运行(3 秒超时的探活请求),可手动刷新状态
- 展示授权状态、启动器连接状态、授权说明与常见问题(端口 21100 被占用等情况)
- 通过本机
- 安全: Token 仅在本机回环地址传输,不上传服务器
8. 云控设备 /cloud-control(别名 /rwmc_oauth)
- 组件:
CloudControl.vue - Meta:
titleKey: 'menu.cloudControl'、requiresAuth: true、noScroll: true - 功能:
- 设备列表:设备码、主机名、系统、CPU / 内存 / 磁盘占用、在线状态、自启配置
- 绑定设备:填写设备码完成绑定;从授权链接(
/rwmc_oauth)进入时会先询问是否绑定 - 下发命令:
runcmd执行命令或自定义动作,内置危险命令拦截 - 快捷截屏、查看执行日志(列表 / 单条详情,支持图片日志)
- 保存自动命令(设备上线后自动执行)、手动触发自动命令
- 解绑设备
- 接口:
/rwmc.php,使用application/x-www-form-urlencoded,详见 云控 API