使用文档

Gate Tunnel 用户指南

本文档基于客户端 v1.0.0 实际功能编写,涵盖从安装登录到隧道穿透、流量观测与套餐计费的完整操作流程。

简介

Gate Tunnel 是一款基于 Cloudflare Tunnel 的 Windows 桌面客户端。它将 cloudflared 进程管理、隧道配置、流量统计与账户体系整合在同一界面中,让你无需命令行即可将本地 Web 服务发布为公网 HTTPS 地址。

客户端采用 Tauri 2 + Vue 3 构建,通过连接 Gate 服务端完成用户认证、隧道元数据管理与计费。本地 cloudflared 进程由客户端直接启动与守护。

提示:当前版本仅支持 Windows 10 / 11(amd64),隧道目标协议为 HTTP / HTTPS。macOS / Linux 客户端规划中。

环境要求

项目 要求
操作系统 Windows 10 / 11(64 位)
网络 可访问 Gate 服务端与 Cloudflare API
本地服务 已在 127.0.0.1 或指定地址上运行的 HTTP / HTTPS Web 服务
账户 在 Gate 平台注册的用户名与密码(首个注册用户自动成为管理员)

快速开始

以下步骤帮你在几分钟内完成第一次穿透:

  1. 下载并安装客户端
    从官网 下载页面 获取 Windows 安装包,安装后启动 Gate Tunnel。
  2. 登录账户
    输入用户名与密码登录。若服务端启用了人机验证(Cloudflare Turnstile),需先完成验证。
  3. 启动本地 Web 服务
    例如在本机 8080 端口运行你的前端或 API 服务:
    http://127.0.0.1:8080
  4. 使用禅模式一键连接
    进入默认的「隧道管理」页(禅模式),确认本地端口为 8080,点击中央的 闪电连接 · 一键启动 按钮。
  5. 复制公网地址
    连接成功后,界面会显示 公网访问地址(HTTPS)。复制该地址即可从外网访问你的本地服务。
注意:禅模式默认以 HTTP 转发本地服务。若本地服务使用 HTTPS,请切换到「列表模式」,编辑对应隧道将访问方式改为 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

套餐中心

「套餐中心」用于查看当前权益与购买新套餐。页面顶部展示当前套餐名称、到期时间与本月已用流量进度条。

套餐类型

  • 月付 / 季付 / 年付:按时长的会员套餐,含隧道配额与流量额度。
  • 隧道扩容:在现有套餐基础上增加可创建隧道数量。
  • 流量包:额外购买流量额度。

购买流程

  1. 在套餐卡片上点击 立即购买(免费方案显示「免费方案」)。
  2. 在弹窗中确认套餐详情,选择 微信支付支付宝
  3. 使用手机扫描二维码完成支付。
  4. 支付成功后权益自动生效,可点击「查看订单」跳转订单页。

若存在未完成的待支付订单,系统会提示是否继续支付该订单。

我的订单

查看所有购买记录,支持按状态筛选:待支付、已支付、已取消、已退款。

  • 待支付订单:显示剩余支付时间(30 分钟超时),可「继续支付」或「取消订单」。
  • 已支付 / 其他状态:可查看详情或「再次购买」跳转套餐中心。

订单详情包含:订单号、套餐名称、金额、支付方式、状态、交易单号及各时间节点。

我的钱包

钱包页展示账户资金概况与流水记录。

概览指标

  • 当前余额:可用于消费的账户余额。
  • 可划转佣金:邀请返利产生的可用佣金。
  • 累计入账 / 累计支出:历史资金汇总。

充值

点击充值,选择预设金额(¥10 / 50 / 100 / 200 / 500)或输入自定义金额(1–10000 元),选择支付方式后扫码完成充值。

余额流水

流水类型包括:余额充值、管理员调整、消费抵扣、佣金划转。每条记录显示变动金额、变动后余额、关联订单与备注。

邀请推广

每位用户拥有唯一邀请码与邀请链接(格式:{注册页地址}?invite={邀请码}),可一键复制或分享。

返利规则

  • 好友通过你的邀请码注册。
  • 好友完成付费订单后,你获得对应比例的佣金返利(比例由平台配置)。
  • 返利计入「可用佣金」,可在钱包中查看流水。

若活动暂停,页面会显示「活动暂停」标签。

数据面板

  • 累计邀请 / 累计返利 / 可用佣金:个人邀请统计。
  • 邀请记录:好友注册时间与返利到账情况。
  • 邀请排行榜:平台邀请人数 Top 10。

设置中心

设置分五个标签页,修改后需点击 保存设置 生效。

常规设置

  • 开机自启关闭最小化到托盘启动后自动连接
  • 主题:深色 / 浅色
  • 语言:简体中文
  • 日志保留天数日志级别日志目录(只读)
  • 数据目录缓存大小清除缓存
  • 自动检查更新检查频率(每天 / 每周)

网络设置

  • 启用代理代理地址
  • DNS 服务器:自定义 DNS 列表

隧道设置

  • 默认本地地址127.0.0.1(只读)
  • 默认本地端口默认协议(HTTP / HTTPS)

通知设置

  • 连接成功通知错误告警通知

高级设置

当前为占位页,后续版本开放更多选项。

关于与帮助

「关于与帮助」页展示客户端版本号、产品标语,以及三个外部入口:

页面底部展示平台公告,由管理员在后台发布。公告类型包括:公告、活动、维护。

常见问题

连接失败或一直显示「连接中」?

  • 确认本地 Web 服务已在指定端口运行,可用浏览器访问 http://127.0.0.1:端口 验证。
  • 检查网络是否能访问 Cloudflare;若使用代理,在「设置 → 网络」中配置。
  • 打开「日志中心 → 运行日志」,查看 ERROR 级别输出定位原因。

公网地址能打开但显示错误页面?

  • 确认隧道的访问方式与本地服务协议一致(HTTP 服务选 HTTP,HTTPS 服务选 HTTPS)。
  • 确认本地端口填写正确。

隧道配额已满怎么办?

删除不再使用的隧道,或前往「套餐中心」购买更高配额套餐 / 隧道扩容包。

支付后权益未生效?

在「我的订单」确认订单状态为「已支付」。若仍为待支付,点击「继续支付」完成付款。长时间未到账请联系管理员并提供订单号。

忘记密码?

在登录页点击「忘记密码」,输入用户名与注册邮箱,获取验证码后重置密码。邮箱验证功能需管理员在后台配置 SMTP。

如何联系技术支持?

发送邮件至 15035267995@163.com,附上问题描述、客户端版本号与相关日志截图。