2739 字
14 分钟
从 OpenTunnel 到 Cloudflare Tunnel:自有域名 + 真鉴权,附一次「以为关了其实没关」的排查

几个月前我写过《OpenCode + OpenTunnel:让手机直接和家里电脑上的 AI 编程助手对话》。那套东西确实好用:随机子域 + blind TLS,一条命令便把 localhost 挂到了公网。

但用久了,有两个点越来越硌得慌:

  • 地址是别人给的:ROUTE.ID.opentunnel.xyz,换条路由就换地址,收藏夹都存不住
  • 地址本身就是凭证:README 自己写得明明白白——it is not authentication。地址不泄露纯靠「猜不到」,一旦泄露就完全门户大开,且没法单独撤销

现在手里有域名(ycxdev.com)也有 Cloudflare 账号,于是动手换。

换完之后顺手去关旧的 OpenTunnel,结果撞上一件更值得写的事:它根本没关掉,而我差点就信了「已经关了」。后半篇全是这次排查。


目标形态#

sequenceDiagram autonumber participant B as 浏览器(任意设备) participant CF as Cloudflare 边缘 participant CD as cloudflared(家里) participant OC as opencode
127.0.0.1:49374 CD->>CF: 主动拨出,建立反向隧道 Note over CD,CF: 全程只出不进,没有任何入站端口 B->>CF: HTTPS 访问 oc.ycxdev.com CF->>CD: 请求沿已建立的连接送回家里 CD->>OC: 转发到 127.0.0.1:49374 OC-->>CD: 响应 CD-->>CF: 原路返回 CF-->>B: HTTPS 响应

核心变化一句话:入口从「别人的随机子域」换成「自己的域名」,鉴权从「URL 保密」换成「真密码」。


一、cloudflared 侧:三条命令 + 一个配置文件#

安装与建隧道#

Terminal window
winget install --id Cloudflare.cloudflared -e
cloudflared tunnel login # 弹出浏览器,选域名、点授权
cloudflared tunnel create oc # 记下输出里的隧道 ID
cloudflared tunnel route dns oc oc.ycxdev.com # 参数:隧道名 + 主机名

login 这步必须人工点浏览器(它把授权证书写到 ~/.cloudflared/cert.pem),没有无头环境的纯 CLI 路径。route dns 会自动往你的 zone 里写一条指向隧道的 CNAME。

然后是配置文件 ~/.cloudflared/config.yml:

tunnel: oc
credentials-file: C:\Users\ycx\.cloudflared\<TUNNEL_ID>.json
protocol: http2
ingress:
- hostname: oc.ycxdev.com
service: http://127.0.0.1:49374
- service: http_status:404

最后那条 catch-all 是必需的——不写 cloudflared 拒绝启动。它也是安全习惯的一部分:没匹配上的域名一律 404,而不是落进某条默认规则。

坑 1:QUIC 起不来,先把传输协议写死#

第一次启动,日志里的连通性预检长这样:

UDP Connectivity region1.v2.argotunnel.com FAIL QUIC connection failed
UDP Connectivity region2.v2.argotunnel.com FAIL QUIC connection failed
TCP Connectivity region1.v2.argotunnel.com PASS HTTP/2 connection successful
TCP Connectivity region2.v2.argotunnel.com PASS HTTP/2 connection successful

原因:本机跑着 TUN 模式的代理,UDP 出不去(QUIC 跑在 UDP 7844)——代理软件普遍只接管 TCP。虽然预检建议降级到 http2,但进程仍在反复重试 QUIC 超时。把 protocol: http2 写进配置后,一次握手成功。

TIP

不管是本地代理、公司防火墙还是运营商级 NAT 拦 UDP,解法都一样:写死 protocol: http2 走 TCP。别赌它「自己会降级」。

坑 2:想挂 Access,先要过「绑卡」这关#

原计划是挂 Cloudflare Access:浏览器访问先弹 Google 登录,只有我能进,还能审计谁在什么时候来过。

实际到激活 Zero Trust 免费版那一步:流程要求填账单信息并授权付款方式,即使每月 $0。

这个站的铁律是不绑任何卡(整站跑在免费额度上),所以这条路线当场放弃,退到应用层鉴权。

顺带一个冷知识:Access 只能保护 HTTP/HTTPS。就算绑了卡,SSH、RDP、数据库这类裸 TCP 也不在它的保护范围里(那要上 cloudflared access 客户端模式)。

鉴权落在哪一层#

opencode 自带 HTTP Basic Auth。自己起服务是:

Terminal window
opencode serve --hostname 127.0.0.1 --port 4096
# → server listening on http://127.0.0.1:4096
# → server password xxxxxxxx…(43 位随机串)

用桌面版的不用自己起——它的后台服务常驻在 127.0.0.1:49374,端口和密码固定记在 ~/.config/opencode/service.json 里,重启不变。

两个原则:

  1. 监听地址只留 127.0.0.1。翻仓库配置时发现过一版旧配置监听 0.0.0.0、密码是字面量 opencode——那意味着局域网里任何设备都能直连这台机器上的 opencode。现在的版本是回环 + 随机密码。
  2. 密码强度要对得起「这个端口挂在公网上」。43 位随机串,爆破在数学上不可行。

验证三连,一条都不能少:

请求位置凭据结果
本机直连 49374无401
oc.ycxdev.com无401
oc.ycxdev.com正确密码200

坑 3:开机自启,但没有管理员权限#

cloudflared service install 装 Windows 服务要过 UAC。没有管理员权限,退到用户级方案:启动文件夹里放一个 VBS,登录时静默拉起,无黑窗:

' %USERPROFILE%\.cloudflared\start-tunnel.vbs
Set sh = CreateObject("WScript.Shell")
sh.Run "cmd /c """ & sh.ExpandEnvironmentStrings("%USERPROFILE%") & "\.cloudflared\start-tunnel.cmd""", 0, False

sh.Run 的第二个参数 0 = 隐藏窗口。验证方式很土但有效:杀掉进程 → 双击 VBS → 看新进程起来 + 公网 200。

WARNING

用户级自启 = 登录后触发。机器重启后如果没人登录桌面,隧道不在。要真正的「开机即通」,只能装系统服务(需要管理员)。


二、换完了,去关旧的——打脸开始#

新链路跑通后,顺手去关旧的 OpenTunnel。之后发生的事,比配置本身值得写。

第一次结论(错的)#

先看后台服务的状态命令,输出里表示远程隧道的字段是空的:

$ opencode service get
{ "remote": {}, "remoteAccepted": true, "hostname": "127.0.0.1", "port": 49374 }

remote: {}——空的。判断:隧道已关,收工。

然后被打脸:那条 OpenTunnel 地址还能打开,正常渲染出完整界面。

重新取证#

教训一句话:摘要输出 ≠ 真相,去看源头文件。

1. 查配置文件#

~/.config/opencode/service.json(真实文件,不是命令摘要):

{
"remote": { "route": "ROUTE_ID" },
"remoteAccepted": true,
"hostname": "127.0.0.1",
"port": 49374,
"password": "…"
}

那条 route 一直都在。命令的摘要显示不可信,文件才是事实。

2. 逐字节比对:公网页面到底是谁给的?#

把公网地址的首页和本机 127.0.0.1:49374 的首页各拉一份,比对 SHA256:

Terminal window
curl.exe -s http://127.0.0.1:49374/ -o local.html
curl.exe -s https://ROUTE.opentunnel.xyz/ -o public.html
Get-FileHash local.html, public.html | Select-Object -ExpandProperty Hash
# 两行哈希完全一致

逐字节相同。 结论明确:公网那个页面不是「某个第三方服务」,就是从你自己这台机器出去的内容,经隧道原样中继。这也顺带证明了它是透明反代——不是缓存、不是克隆。

3. 鉴权穿透测试#

页面能打开 ≠ 数据能拿到。逐条测 API:

请求本机直连经 OpenTunnel
/api/session 无凭据401401
/api/session 带密码200200
/api/event(SSE 事件流)无凭据401401

而且两边的 401 响应逐字节一致:同样的 WWW-Authenticate: Basic realm="Secure Area" 头、同样的 JSON body。

结论:鉴权是生效的。陌生人拿到那条 URL,得到的是「锁着的门 + 公开的静态壳」,拿不到任何数据。(壳本身在公网本来就是公开的——新入口的首页同样谁都能加载,它不含数据。)

4. 一个反直觉现象:/server/<一段 base64>/… 全都返回壳#

把 URL 里那段 base64 解码,出来就是 OpenTunnel 域名自身。/server/<base64>/… 是 Web 应用自己的前端路由,用来在 URL 里携带「我要连哪个服务器」。这类路径不匹配后端的 /api/* 路由,命中 SPA 的 fallback,于是返回首页壳——所以对 /server/<…>/api/xxx 的探测看到的全是壳而不是 401。这不代表绕过,只代表这个路径根本到不了 API 层。

放大镜检查发光的指纹与锁:核对「公网响应来自哪台机器」的取证过程

5. 所以它确实是「多余的第二扇门」#

不是裸奔,但也绝不该留着:

  • 第三方中继:所有界面流量(对话、工具输出、文件内容)都经过 OpenTunnel 的基础设施转发
  • capability URL:地址泄露 = API 面直接暴露给全网扫描。虽然要过密码,但为什么要把爆破面留给它?
  • 绕过 Cloudflare:这条链路不经过自己的域名,WAF、限速、日志一概没有
  • 不可轮换:同一条路由地址固定,泄露了只能关掉重开

三、真正关闭 + 怎么验证「真的关了」#

关闭#

Terminal window
opencode service unset remote

移除配置里的远程路由,伴随一次服务重启(在会话里操作的话,会短暂断线)。隧道客户端进程随之消失,边缘侧这条路由随即失效。

验证:别只测「关了没」,要设对照组#

单测一条「打不开」没有说服力——可能是你网络坏了、可能 DNS 抽风。要设计对照组:

flowchart LR Q[这条路由真的死了吗] --> A[测试组 旧路由子域] Q --> B[对照组一 opentunnel 基础域名] Q --> C[对照组二 新入口 oc.ycxdev.com] A --> A2[TLS 握手失败] B --> B2[HTTP 200 服务本身正常] C --> C2[HTTP 200 新链路正常] A2 --> R[网络没坏 死的只是这条路由] B2 --> R C2 --> R
测试对象结果说明
旧路由子域(测试组)TLS 握手失败连接在握手层就断了
opentunnel.xyz 基础域名(对照组)HTTP 200同一域族、同一条网络路径,服务本身活着
oc.ycxdev.com(对照组)HTTP 200新链路没被误伤

三者同时成立,结论才站得住:网络没坏,死的就是这一条路由。

浏览器里的 Failed to fetch 是什么意思#

关闭后,之前打开着那个页面的标签页会在控制台开始报:

ClientError: Transport: Failed to fetch
TypeError: Failed to fetch

注意它不是 HTTP 4xx/5xx——Failed to fetch 是浏览器 fetch API 在「请求根本没拿到响应」时抛的网络层异常(DNS 失败、连接被拒、TLS 失败都会是这个)。请求死在边缘侧,从头到尾没有到达这台机器。如果隧道还活着,这个请求会拿到一个正经的 HTTP 响应(401 或 200),错误形态会完全不同。

顺带:那条子域的 DNS 仍然解析(OpenTunnel 是通配解析)。解析 ≠ 可用。判断服务的真实状态,以「连接能不能建立」为准,而不是「域名能不能解析」。


小结#

事项结论
随机子域换成自有域名 oc.ycxdev.com
URL 即凭证换成 HTTP Basic 鉴权(43 位随机密码)
第三方中继换成 Cloudflare Tunnel(纯出站连接,零入站端口)
Access 保护想挂但要绑卡,放弃;改用应用层鉴权
自启无管理员权限 → 登录时用户级自启
旧隧道opencode service unset remote 真正关闭,用对照组验证

两个比配置本身更值钱的教训:

  1. 摘要输出不等于真相。 一个命令打印 remote: {} 很轻松,但真正的事实躺在配置文件里。排查问题时直接看源头数据,别信任何「看起来是这么回事」的中间层。
  2. 验证「关掉了」要设计对照组。 只有「测试组失败 + 对照组正常」同时成立,才能把「你的网络问题」和「服务真的死了」区分开。测任何「服务不可用」,都值得配一个「同环境下的已知可用目标」。
从 OpenTunnel 到 Cloudflare Tunnel:自有域名 + 真鉴权,附一次「以为关了其实没关」的排查
https://ycxdev.com/posts/opentunnel-to-cloudflare-tunnel/
作者
YCX
发布于
2026-10-15
许可协议
CC BY-NC-SA 4.0