Web 隧道浏览器

需要 Codux 2.0+

Web 隧道浏览器需要 Codux Desktop 和 codux-agent 2.0 或更高版本。桌面端与主机端都使用 2.0+ 版本时，地球按钮和内置诊断页才能稳定工作。

Web 隧道浏览器用于在 Codux 桌面主控端打开运行在已配对远程主机上的 Web 应用。它适合 Vite、Next.js、Astro、Rails、Laravel，或任何绑定在主机端机器上的 HTTP 开发服务。

在远程项目里点击地球图标 Web Tunnel Browser 后，Codux 会打开一个独立代理的 Chromium 浏览器。这个浏览器的 HTTP、HTTPS、WebSocket 和 HMR 流量都会通过加密的 Iroh 链路转发到主机端。

解决什么问题

如果主机端运行了一个开发服务：

http://127.0.0.1:5173/

这个地址指的是主机端的 localhost，不是当前桌面主控端的 localhost。把同一个 URL 输入到 Web 隧道浏览器里，Codux 会在主机端解析并打开它。

同一条隧道也支持：

• 运行在主机端的 localhost 和 127.0.0.1 服务
• 主机端可访问的局域网地址
• .local 名称
• 主机端可见的 VPN 路由
• 主机端 DNS 或 /etc/hosts 绑定的开发域名
• HTTPS、WebSocket 和 HMR 升级流量

打开诊断页

每个 codux-agent 2.0+ 主机都会内置一个诊断页：

http://127.0.0.1:8765/

点击地球图标 Web Tunnel Browser 时，Codux 默认会打开这个页面，用来确认：

• 隧道健康状态
• 实时往返延迟
• 浏览器是否真的走了 Web Tunnel 代理

在同一台电脑上测试也会走同一套隧道链路。要验证真实跨机器可达性，请把 codux-agent 跑在另一台机器上，再用 Codux Desktop 连接它。

浏览器行为

Codux 会用一个临时、代理隔离的 profile 打开 Chromium 系浏览器。这样 Web Tunnel 代理不会 污染你的日常浏览器会话，也不会改系统浏览器代理设置。

在 macOS 上，Codux 会按顺序尝试：

1. Google Chrome
2. Chromium
3. Microsoft Edge
4. Brave Browser

如果没有可用的 Chromium 系浏览器，Codux 会显示错误，不会回退到 Safari 或系统默认浏览器。 原因是 Safari 不能稳定启动一个「仅当前窗口使用独立代理」的浏览器会话。

安全边界

主控端本地的 127.0.0.1 代理监听口只是浏览器进入加密隧道的入口。它不是目标服务器，也 不代表目标 URL 在主控端解析。目标主机、DNS 和网络可达性都由已配对的 Codux 主机端判断。