Gate Tunnel 用户指南
本文档基于客户端 v1.0.0 实际功能编写,涵盖从安装登录到隧道穿透、流量观测与套餐计费的完整操作流程。
简介
Gate Tunnel 是一款基于 Cloudflare Tunnel 的 Windows 桌面客户端。它将 cloudflared 进程管理、隧道配置、流量统计与账户体系整合在同一界面中,让你无需命令行即可将本地 Web 服务发布为公网 HTTPS 地址。
客户端采用 Tauri 2 + Vue 3 构建,通过连接 Gate 服务端完成用户认证、隧道元数据管理与计费。本地 cloudflared 进程由客户端直接启动与守护。
环境要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows 10 / 11(64 位) |
| 网络 | 可访问 Gate 服务端与 Cloudflare API |
| 本地服务 | 已在 127.0.0.1 或指定地址上运行的 HTTP / HTTPS Web 服务 |
| 账户 | 在 Gate 平台注册的用户名与密码(首个注册用户自动成为管理员) |
快速开始
以下步骤帮你在几分钟内完成第一次穿透:
-
下载并安装客户端
从官网 下载页面 获取 Windows 安装包,安装后启动 Gate Tunnel。 -
登录账户
输入用户名与密码登录。若服务端启用了人机验证(Cloudflare Turnstile),需先完成验证。 -
启动本地 Web 服务
例如在本机8080端口运行你的前端或 API 服务:http://127.0.0.1:8080 -
使用禅模式一键连接
进入默认的「隧道管理」页(禅模式),确认本地端口为8080,点击中央的 闪电连接 · 一键启动 按钮。 -
复制公网地址
连接成功后,界面会显示 公网访问地址(HTTPS)。复制该地址即可从外网访问你的本地服务。
禅模式(闪电连接)
禅模式是进入客户端后的默认视图,适合日常快速调试:输入端口、一键连接、复制地址。
界面说明
- 闪电连接按钮:中央大按钮,状态依次为「闪电连接 · 一键启动」→「闪电连接中…」→「闪电已连接 · 点击停止」。
- 本地端口:点击端口芯片可修改,范围 1–65535,设置会保存在本机。
- 公网访问地址:连接成功后显示,可直接复制。
- 隧道配额:右上角显示已用 / 总额度;无限制套餐显示「无限制」。
复用机制
再次连接时,客户端会优先复用已有的禅模式隧道并启动,不会额外占用隧道配额。若提示「已复用现有隧道并启动」,表示未创建新隧道。
配额已满
当隧道数量达到套餐上限时,会弹出「隧道配额已满」提示,可前往「套餐中心」升级方案或购买隧道扩容包。
切换列表模式
页面顶部有 禅模式 / 列表模式 切换开关。列表模式适合管理多条隧道、编辑协议与子域名等详细配置。
隧道管理(列表模式)
列表模式提供隧道的完整生命周期管理:创建、启动、停止、编辑与删除。
隧道列表
| 列名 | 说明 |
|---|---|
| 名称 | 隧道显示名称 |
| 端口 | 本地转发端口 |
| 协议 | HTTP 或 HTTPS |
| 公网链接 | 分配的 HTTPS 访问地址,支持一键复制 |
| 状态 | 运行中 / 已停止 / 异常 |
| 创建时间 | 隧道创建日期 |
| 到期 | 关联会员权益的到期时间 |
创建隧道
点击 创建隧道,填写以下字段:
| 字段 | 必填 | 说明 |
|---|---|---|
| 名称 | 是 | 便于识别的隧道名称 |
| 访问方式 | 否 | HTTP 或 HTTPS,决定转发到本地服务时使用的协议 |
| 本地地址 | 否 | 默认 127.0.0.1 |
| 本地端口 | 是 | 本地 Web 服务监听的端口 |
| 子域名 | 是 | 公网地址的前缀部分,创建后不可在编辑中修改 |
| 域名 | 是 | 管理员在后台配置的可用域名 |
| 自动启动 | 否 | 创建后是否立即启动隧道 |
填写子域名与域名后,界面会实时预览完整的公网地址。
编辑隧道
可修改:名称、访问方式、本地地址、本地端口、自动启动。公网地址、子域名与域名创建后不可更改,如需更换请删除后重新创建。
启动与停止
点击操作列的启动 / 停止按钮。启动时客户端会在本机拉起 cloudflared 进程;停止时会终止对应进程。删除隧道前建议先停止运行中的实例。
流量统计
「流量统计」页展示隧道在选定时间范围内的流量与请求数据,默认最近 30 天,支持自定义日期范围与导出 CSV 报表。
总览
- KPI 卡片:总流量、上传、下载、请求数、活跃隧道数(含环比趋势)。
- 流量趋势:按日的流量折线图。
- 协议分布:HTTP / HTTPS 流量占比。
- 隧道排行:流量 Top 5 隧道。
- 实时速率:当前上传 / 下载速率。
- 隧道状态:运行中数量与总隧道数。
其他视图
- 按隧道:各隧道的流量明细。
- 按协议:协议维度汇总。
- 按地域:基于 Cloudflare 边缘节点的国家 / 地区估算。
- 自定义:按隧道、协议多选筛选后查看 KPI 与表格。
页面每 60 秒自动刷新一次数据。
日志中心
日志中心分为运行日志(本机 cloudflared 实时输出)与数据库日志(登录、访问、操作记录)。
运行日志
筛选条件:
- 级别:INFO / WARN / ERROR / DEBUG
- 类型:连接 / 系统 / HTTP
- 隧道:按隧道过滤
- 关键词:搜索日志内容
点击任意一行可打开详情抽屉,查看完整日志行、隧道 ID、输出流(stdout / stderr)等信息。
数据库日志
| 标签页 | 内容 |
|---|---|
| 登录日志 | 登录 IP、地理位置、成功 / 失败状态与原因 |
| 访问日志 | 页面访问记录、IP 与地理位置 |
| 操作记录 | API 命令调用、耗时、结果与 IP |
套餐中心
「套餐中心」用于查看当前权益与购买新套餐。页面顶部展示当前套餐名称、到期时间与本月已用流量进度条。
套餐类型
- 月付 / 季付 / 年付:按时长的会员套餐,含隧道配额与流量额度。
- 隧道扩容:在现有套餐基础上增加可创建隧道数量。
- 流量包:额外购买流量额度。
购买流程
- 在套餐卡片上点击 立即购买(免费方案显示「免费方案」)。
- 在弹窗中确认套餐详情,选择 微信支付 或 支付宝。
- 使用手机扫描二维码完成支付。
- 支付成功后权益自动生效,可点击「查看订单」跳转订单页。
若存在未完成的待支付订单,系统会提示是否继续支付该订单。
我的订单
查看所有购买记录,支持按状态筛选:待支付、已支付、已取消、已退款。
- 待支付订单:显示剩余支付时间(30 分钟超时),可「继续支付」或「取消订单」。
- 已支付 / 其他状态:可查看详情或「再次购买」跳转套餐中心。
订单详情包含:订单号、套餐名称、金额、支付方式、状态、交易单号及各时间节点。
我的钱包
钱包页展示账户资金概况与流水记录。
概览指标
- 当前余额:可用于消费的账户余额。
- 可划转佣金:邀请返利产生的可用佣金。
- 累计入账 / 累计支出:历史资金汇总。
充值
点击充值,选择预设金额(¥10 / 50 / 100 / 200 / 500)或输入自定义金额(1–10000 元),选择支付方式后扫码完成充值。
余额流水
流水类型包括:余额充值、管理员调整、消费抵扣、佣金划转。每条记录显示变动金额、变动后余额、关联订单与备注。
邀请推广
每位用户拥有唯一邀请码与邀请链接(格式:{注册页地址}?invite={邀请码}),可一键复制或分享。
返利规则
- 好友通过你的邀请码注册。
- 好友完成付费订单后,你获得对应比例的佣金返利(比例由平台配置)。
- 返利计入「可用佣金」,可在钱包中查看流水。
若活动暂停,页面会显示「活动暂停」标签。
数据面板
- 累计邀请 / 累计返利 / 可用佣金:个人邀请统计。
- 邀请记录:好友注册时间与返利到账情况。
- 邀请排行榜:平台邀请人数 Top 10。
设置中心
设置分五个标签页,修改后需点击 保存设置 生效。
常规设置
- 开机自启、关闭最小化到托盘、启动后自动连接
- 主题:深色 / 浅色
- 语言:简体中文
- 日志保留天数、日志级别、日志目录(只读)
- 数据目录、缓存大小、清除缓存
- 自动检查更新、检查频率(每天 / 每周)
网络设置
- 启用代理 与 代理地址
- DNS 服务器:自定义 DNS 列表
隧道设置
- 默认本地地址:
127.0.0.1(只读) - 默认本地端口、默认协议(HTTP / HTTPS)
通知设置
- 连接成功通知、错误告警通知
高级设置
当前为占位页,后续版本开放更多选项。
关于与帮助
「关于与帮助」页展示客户端版本号、产品标语,以及三个外部入口:
- 官方网站:https://gateweb.maven666.cloud/
- 使用文档:即本文档
- 意见反馈:发送邮件至 15035267995@163.com
页面底部展示平台公告,由管理员在后台发布。公告类型包括:公告、活动、维护。
常见问题
连接失败或一直显示「连接中」?
- 确认本地 Web 服务已在指定端口运行,可用浏览器访问
http://127.0.0.1:端口验证。 - 检查网络是否能访问 Cloudflare;若使用代理,在「设置 → 网络」中配置。
- 打开「日志中心 → 运行日志」,查看 ERROR 级别输出定位原因。
公网地址能打开但显示错误页面?
- 确认隧道的访问方式与本地服务协议一致(HTTP 服务选 HTTP,HTTPS 服务选 HTTPS)。
- 确认本地端口填写正确。
隧道配额已满怎么办?
删除不再使用的隧道,或前往「套餐中心」购买更高配额套餐 / 隧道扩容包。
支付后权益未生效?
在「我的订单」确认订单状态为「已支付」。若仍为待支付,点击「继续支付」完成付款。长时间未到账请联系管理员并提供订单号。
忘记密码?
在登录页点击「忘记密码」,输入用户名与注册邮箱,获取验证码后重置密码。邮箱验证功能需管理员在后台配置 SMTP。
如何联系技术支持?
发送邮件至 15035267995@163.com,附上问题描述、客户端版本号与相关日志截图。