几个月前我写过《OpenCode + OpenTunnel:让手机直接和家里电脑上的 AI 编程助手对话》。那套东西确实好用:随机子域 + blind TLS,一条命令便把 localhost 挂到了公网。
但用久了,有两个点越来越硌得慌:
- 地址是别人给的:
ROUTE.ID.opentunnel.xyz,换条路由就换地址,收藏夹都存不住 - 地址本身就是凭证:README 自己写得明明白白——
it is not authentication。地址不泄露纯靠「猜不到」,一旦泄露就完全门户大开,且没法单独撤销
现在手里有域名(ycxdev.com)也有 Cloudflare 账号,于是动手换。
换完之后顺手去关旧的 OpenTunnel,结果撞上一件更值得写的事:它根本没关掉,而我差点就信了「已经关了」。后半篇全是这次排查。
目标形态
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 侧:三条命令 + 一个配置文件
安装与建隧道
winget install --id Cloudflare.cloudflared -e
cloudflared tunnel login # 弹出浏览器,选域名、点授权cloudflared tunnel create oc # 记下输出里的隧道 IDcloudflared tunnel route dns oc oc.ycxdev.com # 参数:隧道名 + 主机名login 这步必须人工点浏览器(它把授权证书写到 ~/.cloudflared/cert.pem),没有无头环境的纯 CLI 路径。route dns 会自动往你的 zone 里写一条指向隧道的 CNAME。
然后是配置文件 ~/.cloudflared/config.yml:
tunnel: occredentials-file: C:\Users\ycx\.cloudflared\<TUNNEL_ID>.jsonprotocol: http2ingress: - 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 failedUDP Connectivity region2.v2.argotunnel.com FAIL QUIC connection failedTCP Connectivity region1.v2.argotunnel.com PASS HTTP/2 connection successfulTCP 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。自己起服务是:
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 里,重启不变。
两个原则:
- 监听地址只留
127.0.0.1。翻仓库配置时发现过一版旧配置监听0.0.0.0、密码是字面量opencode——那意味着局域网里任何设备都能直连这台机器上的 opencode。现在的版本是回环 + 随机密码。 - 密码强度要对得起「这个端口挂在公网上」。43 位随机串,爆破在数学上不可行。
验证三连,一条都不能少:
| 请求位置 | 凭据 | 结果 |
|---|---|---|
| 本机直连 49374 | 无 | 401 |
| oc.ycxdev.com | 无 | 401 |
| oc.ycxdev.com | 正确密码 | 200 |
坑 3:开机自启,但没有管理员权限
cloudflared service install 装 Windows 服务要过 UAC。没有管理员权限,退到用户级方案:启动文件夹里放一个 VBS,登录时静默拉起,无黑窗:
' %USERPROFILE%\.cloudflared\start-tunnel.vbsSet sh = CreateObject("WScript.Shell")sh.Run "cmd /c """ & sh.ExpandEnvironmentStrings("%USERPROFILE%") & "\.cloudflared\start-tunnel.cmd""", 0, Falsesh.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:
curl.exe -s http://127.0.0.1:49374/ -o local.htmlcurl.exe -s https://ROUTE.opentunnel.xyz/ -o public.htmlGet-FileHash local.html, public.html | Select-Object -ExpandProperty Hash# 两行哈希完全一致逐字节相同。 结论明确:公网那个页面不是「某个第三方服务」,就是从你自己这台机器出去的内容,经隧道原样中继。这也顺带证明了它是透明反代——不是缓存、不是克隆。
3. 鉴权穿透测试
页面能打开 ≠ 数据能拿到。逐条测 API:
| 请求 | 本机直连 | 经 OpenTunnel |
|---|---|---|
/api/session 无凭据 | 401 | 401 |
/api/session 带密码 | 200 | 200 |
/api/event(SSE 事件流)无凭据 | 401 | 401 |
而且两边的 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、限速、日志一概没有
- 不可轮换:同一条路由地址固定,泄露了只能关掉重开
三、真正关闭 + 怎么验证「真的关了」
关闭
opencode service unset remote移除配置里的远程路由,伴随一次服务重启(在会话里操作的话,会短暂断线)。隧道客户端进程随之消失,边缘侧这条路由随即失效。
验证:别只测「关了没」,要设对照组
单测一条「打不开」没有说服力——可能是你网络坏了、可能 DNS 抽风。要设计对照组:
| 测试对象 | 结果 | 说明 |
|---|---|---|
| 旧路由子域(测试组) | TLS 握手失败 | 连接在握手层就断了 |
opentunnel.xyz 基础域名(对照组) | HTTP 200 | 同一域族、同一条网络路径,服务本身活着 |
oc.ycxdev.com(对照组) | HTTP 200 | 新链路没被误伤 |
三者同时成立,结论才站得住:网络没坏,死的就是这一条路由。
浏览器里的 Failed to fetch 是什么意思
关闭后,之前打开着那个页面的标签页会在控制台开始报:
ClientError: Transport: Failed to fetchTypeError: 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 真正关闭,用对照组验证 |
两个比配置本身更值钱的教训:
- 摘要输出不等于真相。 一个命令打印
remote: {}很轻松,但真正的事实躺在配置文件里。排查问题时直接看源头数据,别信任何「看起来是这么回事」的中间层。 - 验证「关掉了」要设计对照组。 只有「测试组失败 + 对照组正常」同时成立,才能把「你的网络问题」和「服务真的死了」区分开。测任何「服务不可用」,都值得配一个「同环境下的已知可用目标」。