bridge / frp
BRIDGE + FRPC 0.71.1

一个客户端，
两种连接方式。

默认使用 bridge。加上 --frp，切换到原生 frpc。
继续使用现有 Web token，连接你的本地服务。

获取客户端 查看配置方法 →
clockbridge-cli两种模式

# 不加参数，保持 bridge 命令行

$ clockbridge-cli --help

# 使用 frpc，自动读取 token / user_name

$ clockbridge-cli --frp --bridge-token -c frpc.toml
HTTP / WebSocket / TCPMUXfrpc v0.71.1
01 / DOWNLOADS

选择你的系统

开发构建

解压即可使用。压缩包内含客户端、配置模板、使用说明及第三方许可证。

Windows

x64 / amd64 · ZIP 6.09 MB

下载 Windows
查看 SHA256bb1746d185eef0886e40db94a065a7872bc9ba6d1453579288c1367b310c7eea

Linux

x64 / amd64 · ZIP 6.08 MB

下载 Linux
查看 SHA25641d3afc31454dc9506fa9d38fd962f57809259d36cb6498c672b6d2cc978deae

构建 dev-32eea8f-frp0.71.1-bt1 · 校验文件 · 构建信息 · 许可证

Linux 集成测试已通过；Windows 运行与 MSTSC 桌面登录尚待实机验证。当前只提供 x64 构建。

02 / QUICK START

把服务连接起来

先获取 token：飞书登录 → 自动保存到本机

需要 Python 3。打开原有 Web 的 Token 文档 ↗，或直接按下面步骤操作：

  1. 下载登录脚本并运行 login。
  2. 在浏览器打开终端输出的授权链接，完成飞书登录；将页面的一次性 code 粘回终端。code 不是 token，不要把 code 写进 token 文件。
  3. 脚本会自动保存 feishu-token 与 feishu-user_name；运行 status 查看保存路径和 user_name。已有有效登录可直接复用。
获取 token · Windows PowerShell
Windows 登录
Invoke-WebRequest "https://dev.clock-p.com/nonweb/feishu-token-cli.py" -OutFile .\feishu_oauth_client.py
py -3 .\feishu_oauth_client.py login
py -3 .\feishu_oauth_client.py status
获取 token · Linux Shell
Linux 登录
curl -fsSL "https://dev.clock-p.com/nonweb/feishu-token-cli.py" -o ./feishu_oauth_client.py
python3 ./feishu_oauth_client.py login
python3 ./feishu_oauth_client.py status

默认文件：Windows %APPDATA%\dev.clock-p.com\feishu-token；Linux ~/.dev.clock-p.com/feishu-token。使用 --local 登录时位于当前目录 ./.dev.clock-p.com/feishu-token。

--bridge-token 优先读取 CLOCKBRIDGE_HTTPS_PROXY_TOKEN_PATH 指定的文件，其次读取当前目录、用户目录的登录文件；同时读取同目录的 feishu-user_name。找不到 token 或 user_name 会报错，不会使用 user_id 代替。

1

登录一次，自动复用 token

按上面的步骤完成登录。使用 --frp --bridge-token 自动配置 token 传递和鉴权 scopes，无需手写 token 路径或复制 token 内容。

FRP_CA_FILE 指向可信的 CA PEM 文件，用于验证注册入口证书。Windows 请替换示例路径；Linux 示例适用于 Debian / Ubuntu。

2

填写实例与目标

推荐使用 user_name，不要用 user_id 拼域名。实例填写 demo-public，启动时会自动补成 demo-<user_name>-public。HTTP 模板默认转发 127.0.0.1:8080，按实际服务修改 localIP / localPort。

-public 公开访问，由目标服务验证账号密码；-user 私有 HTTP 访问，需要 Bearer token。

启动前配置心跳，避免每约 90 秒断线

本站 frps 要求 90 秒内收到应用层心跳。frpc v0.71.1 默认启用连接复用时不发送这种心跳；仅配置 auth.additionalScopes 不会启用发送。缺少下面配置时，服务端会报 heartbeat timeout 并关闭隧道，RDP 随后可能自动重连。计时从 frpc 控制连接建立时开始，所以刚打开桌面数秒也可能遇到断线。

在目标机器的 frpc.toml 顶层、所有 [[proxies]] 和其他表头之前加入以下两行；已有同名配置时修改原值，不要重复添加：

frpc.toml · 顶层心跳配置
transport.heartbeatInterval = 30
transport.heartbeatTimeout = 90

当前发布的 --bridge-token 版本也需要显式配置这两项。请使用下方 -c frpc.toml 的方式校验并启动；保存后停止旧客户端进程，再执行启动命令。修改 .rdp 文件不会生效。保留 HeartBeats / NewWorkConns 鉴权 scopes 和服务端超时检查。

Windows · PowerShell
PowerShell
$env:FRP_SERVER_ADDR = "register.frp.clock-p.com"
$env:FRP_INSTANCE = "demo-public"
$env:FRP_CA_FILE = "C:\path\ca-bundle.pem"
Copy-Item .\frpc-http.toml.example .\frpc.toml
.\clockbridge-cli.exe --frp --bridge-token verify -c .\frpc.toml
.\clockbridge-cli.exe --frp --bridge-token -c .\frpc.toml
Linux · Shell
Shell
chmod +x ./clockbridge-cli
export FRP_SERVER_ADDR=register.frp.clock-p.com
export FRP_INSTANCE=demo-public
export FRP_CA_FILE=/etc/ssl/certs/ca-certificates.crt
cp frpc-http.toml.example frpc.toml
./clockbridge-cli --frp --bridge-token verify -c frpc.toml
./clockbridge-cli --frp --bridge-token -c frpc.toml

注册成功后，示例 HTTP 地址为 https://demo-<user_name>-public.frp.clock-p.com。
--frp 必须放在第一个参数；配置校验通过后再启动。配置模板：HTTP / WebSocket ↗

自动模式与原生模式

--bridge-token 紧跟 --frp，自动读取凭据、配置 OIDC file source 与 HeartBeats / NewWorkConns，并同步代理 name/subdomain 为 user_name 路由。也支持 http、tcpmux 子命令；原始配置文件不会被修改。

不加 --bridge-token 时完全使用原生 frpc：手动填写完整的 user_name 实例名，并为模板设置 WEB_TOKEN_FILE。frpc 的 -i 是本地 IP，--token 是原生共享密钥，不能用它们替代 Web token。更新 token 文件后重启客户端。

03 / TCP & RDP

通用 TCP，也能用于远程桌面

TCPMUX / HTTP CONNECT

使用 TCP 配置模板，实例名以 -public 结尾。额外设置 FRP_LOCAL_IP 和 FRP_LOCAL_PORT，指定真正的目标服务。

后端可以是任意 TCP 协议。CONNECT 按注册域名选择隧道，不会为客户端单独开放服务器端口。CONNECT 入口仅在服务端内部监听，公网客户端需通过已部署的协议入口接入。

RD Gateway

MSTSC 的网关填写 rdp.clock-p.com:8443。目标计算机填写已注册的 public 路由域名，frpc 的本地端口指向目标 RDP 服务。

使用 .rdp 模板 替换目标和网关占位符。直接发起连接，没有中间跳转页面。网关目前匿名接入，目标 Windows 仍需账号密码；仅支持 TCP。