1. 从本地到公网为什么我们需要一个公共隧道作为一名开发者我几乎每天都会遇到这样的场景本地开发的服务跑得好好的前端同事想联调一下接口或者需要给客户临时演示一个还在开发中的功能。这时候最头疼的问题就来了——我的服务在本地localhost:8080别人怎么访问传统的解决方案比如让同事连到公司内网、配置复杂的路由器端口转发或者把半成品代码部署到测试服务器每一步都充满了麻烦和不确定性。更别提那些需要微信、支付宝等第三方平台回调的本地服务了没有公网地址回调请求根本送不进来。这就是tunnelto这类工具存在的核心价值它能在你的本地开发环境和公网之间瞬间搭建起一座安全、临时的桥梁。你不需要购买云服务器不需要配置域名和SSL证书甚至不需要懂任何网络知识。tunnelto会为你生成一个唯一的、可通过互联网访问的临时域名例如your-app.tunnelto.dev所有发往这个域名的请求都会被自动、安全地转发到你本地的服务上。整个过程你只需要在命令行里敲几个单词。听起来是不是有点像ngrok没错它们解决的是同一类问题。但tunnelto在设计上更注重极简和开箱即用它用 Rust 编写性能出色并且完全开源。对于快速演示、临时分享、移动端调试或者 Webhook 开发测试来说它是一个轻量级且高效的瑞士军刀。接下来我就带你用最简单的三步亲手搭起你的第一座“隧道”。2. 环境准备与工具安装选对方法一步到位“工欲善其事必先利其器”。使用tunnelto的第一步自然是把它安装到你的电脑上。它支持 Windows、macOS 和 Linux 三大主流平台安装方式多样你可以根据自己最习惯的方式来。2.1 通过包管理器安装推荐这是最省心、也最容易管理版本的方式。如果你使用的是 macOS 且安装了 Homebrew或者使用的是 Linux 发行版那么包管理器是你的首选。对于 macOS 用户打开终端执行以下命令brew install tunneltoHomebrew 会自动处理依赖和安装路径完成后tunnelto命令就可以全局使用了。对于 Linux 用户特别是使用基于 Debian/Ubuntu 的系统可以使用cargoRust 的包管理器来安装。首先确保你的系统已经安装了 Rust 工具链如果没有可以通过curl --proto https --tlsv1.2 -sSf https://sh.rustup.rs | sh安装。然后执行cargo install tunnelto这个过程会从源码编译可能需要几分钟时间。注意通过cargo install安装后请确保$HOME/.cargo/bin目录已经添加到你的系统 PATH 环境变量中。你可以通过执行echo $PATH来检查如果没有需要在你的 shell 配置文件如~/.bashrc或~/.zshrc中添加一行export PATH$HOME/.cargo/bin:$PATH然后重启终端或执行source ~/.zshrc。2.2 直接下载预编译二进制文件如果你不想通过包管理器或者你的环境比较特殊直接从 GitHub Releases 页面下载预编译好的二进制文件是最直接的方法。访问tunnelto的 GitHub 仓库发布页https://github.com/agrinman/tunnelto/releases。找到最新版本的发布根据你的操作系统和架构下载对应的文件。例如对于 64 位的 macOS通常下载tunnelto_x86_64-apple-darwin.zip对于 64 位的 Linux下载tunnelto_x86_64-unknown-linux-musl.tar.gz。下载后解压你会得到一个名为tunnelto的可执行文件。将这个文件移动到系统可执行路径下例如/usr/local/bin/可能需要sudo权限# 以 macOS/Linux 为例假设解压后的文件在当前目录 chmod x tunnelto sudo mv tunnelto /usr/local/bin/或者你也可以把它放在任何你喜欢的位置然后将该目录添加到 PATH 中。2.3 验证安装与获取帮助安装完成后在终端里输入以下命令来验证是否安装成功并查看基本用法tunnelto --version tunnelto --help如果--version能正确输出版本号例如tunnelto 0.1.12并且--help能显示命令帮助信息那么恭喜你安装已经顺利完成。帮助信息里会列出所有可用的子命令和参数这是我们下一步操作的基础。这里有一个我个人的小经验对于这类经常使用的命令行工具我强烈建议通过包管理器安装。这不仅方便未来升级一句brew upgrade tunnelto或cargo install --force tunnelto即可也避免了手动管理二进制文件可能带来的路径混乱问题。尤其是在团队协作中统一安装方式能减少很多“在我机器上好好的”这类问题。3. 三步搭建你的第一个公共隧道安装好工具我们就可以开始实战了。所谓“三步”其实就是三个核心动作设置子域名、启动本地服务、运行tunnelto命令进行绑定。让我们一步步来。3.1 第一步规划与启动你的本地服务在搭建隧道之前你首先得有一个正在本地运行的服务。这个服务可以是任何监听本地端口的应用Web 后端服务比如用 Python Flask 框架写的运行在http://127.0.0.1:5000。前端开发服务器比如用npm run dev启动的 Vue 或 React 项目运行在http://localhost:3000。静态文件服务器比如用python -m http.server 8080启动的简易服务器。API 接口任何你正在开发的、监听某个端口如 8080, 3001, 9000 等的程序。为了演示我们启动一个最简单的 HTTP 服务器。打开一个新的终端窗口执行# 使用 Python 快速启动一个监听 8000 端口的 Web 服务器 python3 -m http.server 8000执行后你应该能看到类似Serving HTTP on 0.0.0.0 port 8000 (http://0.0.0.0:8000/) ...的输出。此时在浏览器中访问http://localhost:8000你应该能看到当前目录的文件列表。这说明你的本地服务已经就绪。关键点请务必记下你的服务监听的IP 地址和端口号。大多数情况下IP 是127.0.0.1或localhost端口就是你启动时指定的那个如 8000。tunnelto需要这个信息才能正确转发流量。3.2 第二步运行 Tunnelto 命令建立隧道现在保持你的本地服务在第一个终端窗口中运行。打开第二个终端窗口因为第一个窗口被本地服务占用了开始建立隧道。tunnelto最基础的命令格式是tunnelto set-auth your-auth-token tunnelto --port 本地端口号 --subdomain 你想要的子域名但这里有一个重要的概念身份验证。为了确保安全防止他人滥用你的账号或抢占子域名tunnelto服务需要你进行身份验证。你需要先设置一个认证令牌Auth Token。获取并设置 Auth Token 首次使用你需要访问tunnelto的官方控制台网站通常是https://tunnelto.dev或类似地址用 GitHub 账号登录。登录后在控制台里你会找到你的专属 Auth Token。它是一串长字符。 回到终端运行tunnelto set-auth YOUR_AUTH_TOKEN_HERE将YOUR_AUTH_TOKEN_HERE替换为你从控制台复制的真实令牌。这个命令会将令牌保存到你的本地配置文件中通常是~/.tunnelto/config.json以后使用就无需再次输入。启动隧道 设置好令牌后就可以启动隧道了。假设我的本地服务运行在8000端口并且我希望通过一个叫my-awesome-demo的子域名来访问那么命令如下tunnelto --port 8000 --subdomain my-awesome-demo执行这个命令后tunnelto会做以下几件事连接到tunnelto.dev的中继服务器。尝试为你注册my-awesome-demo.tunnelto.dev这个域名。如果该子域名未被占用则注册成功并开始监听。将本地8000端口与这个公共域名绑定。你会看到类似下面的输出 Starting tunnelto client... Authenticated as: your-github-username Public URL: https://my-awesome-demo.tunnelto.dev Forwarding traffic to: http://localhost:8000这行 Public URL: https://my-awesome-demo.tunnelto.dev就是你的公共访问地址任何人只要网络通畅现在都可以通过这个 URL 访问到你本地的8000端口服务。3.3 第三步验证与使用你的公共隧道隧道启动成功后验证就非常简单了。本地验证在你自己的电脑上打开浏览器直接访问https://my-awesome-demo.tunnelto.dev。你应该能看到和访问http://localhost:8000一模一样的内容即我们刚才启动的 Python 文件服务器列表。注意地址是HTTPS的tunnelto已经自动为你配置了 SSL 证书确保了传输安全。远程验证这才是隧道的真正威力所在。用你的手机切换为移动数据网络确保不在同一个局域网或者让同事、朋友在他们的电脑上打开同一个 URLhttps://my-awesome-demo.tunnelto.dev。如果他们也能看到你的本地服务内容那么恭喜你你的第一个公共隧道已经完美运行实测中的技巧与注意事项子域名命名尽量选择一个独特、易记的子域名。如果提示子域名已被占用换一个名字即可。服务就绪务必确保在运行tunnelto命令时你的本地服务python -m http.server 8000已经在运行并且监听正确的端口。如果tunnelto启动时连接不上本地的localhost:8000它会报错。命令行参数除了--port和--subdomaintunnelto还有其他有用参数。例如--host可以指定本地服务的 IP如果你的服务监听在0.0.0.0或另一个特定 IP可能需要用到。使用tunnelto --help可以查看所有选项。服务终止当你不需要隧道时直接在运行tunnelto的终端窗口中按Ctrl C即可安全关闭隧道。公共 URL 将立即失效。至此你已经掌握了tunnelto最核心、最常用的功能。从安装到启动再到通过公网访问整个过程清晰明了。但这只是开始tunnelto还有一些进阶特性和在实际开发中你会遇到的典型场景理解它们能让你用得更顺手。4. 进阶配置与典型应用场景解析掌握了基础用法后我们来看看如何更精细地控制隧道以及它在真实开发工作流中能解决哪些具体问题。4.1 绑定特定本地主机与多个服务默认情况下tunnelto假设你的服务运行在localhost即127.0.0.1。但有些时候你的服务可能监听在其他的网络接口上。例如在 Docker 容器内运行的服务其地址可能是172.17.0.2或者你想把隧道指向同一台机器上另一个虚拟机的服务。这时就需要使用--host参数来指定目标主机。命令格式如下tunnelto --port 8080 --subdomain my-docker-app --host 172.17.0.2这个命令会将公共域名my-docker-app.tunnelto.dev的流量转发到内网地址172.17.0.2的8080端口。另一个常见需求是同时暴露多个本地服务。tunnelto本身一次命令只能建立一个端口转发。如果你需要暴露多个端口例如一个前端服务在3000端口一个后端 API 在5000端口你有两种选择启动两个tunnelto实例分别使用不同的子域名和端口。# 终端1暴露前端 tunnelto --port 3000 --subdomain my-fe # 终端2暴露后端 tunnelto --port 5000 --subdomain my-api这样你会得到my-fe.tunnelto.dev和my-api.tunnelto.dev两个地址。使用本地反向代理在本地启动一个反向代理如 Nginx 或 Caddy将不同路径的请求代理到不同的本地服务然后只暴露这个反向代理的端口。这种方式更接近生产环境但设置稍复杂。4.2 处理 Webhook 与第三方服务回调这是tunnelto一个极其重要的应用场景。很多第三方服务如 GitHub Webhooks、Stripe 支付、Twilio 短信等需要向你服务器发送 POST 请求以通知事件。在开发阶段你的代码在本地根本没有公网 IP 地址接收这些回调。tunnelto完美地解决了这个问题。假设你正在开发一个处理 GitHub Webhook 的应用它运行在localhost:4567。启动你的应用。启动隧道tunnelto --port 4567 --subdomain my-webhook-listener。在 GitHub 仓库的 Webhook 设置页面将 “Payload URL” 设置为https://my-webhook-listener.tunnelto.dev/webhook假设你的处理路由是/webhook。现在每当该仓库有推送push等事件时GitHub 的服务器就会将事件详情 POST 到你提供的这个公共 URLtunnelto会将其无缝转发到你本地的4567端口你的开发程序就能实时接收到并处理这些数据了。注意由于tunnelto提供的域名是公开且临时的切勿用于接收生产环境的敏感数据或处理真实交易。它纯粹是一个开发测试工具。同时第三方服务可能对回调地址有安全性要求如必须是 HTTPStunnelto自动提供的 HTTPS 正好满足这一点。4.3 移动端真机调试与演示在开发移动端 H5 页面或混合应用时在手机浏览器或 App 的 WebView 中调试是一个痛点。用数据线连接电脑调试限制多而让手机和电脑处于同一 WiFi 下有时也不稳定或不可行。使用tunnelto你可以在电脑上启动前端开发服务器如npm run dev运行在localhost:3000。运行tunnelto --port 3000 --subdomain my-mobile-test。在手机的浏览器中直接输入https://my-mobile-test.tunnelto.dev。现在你的手机就能直接加载并运行你电脑上正在开发的前端代码了。任何在电脑上保存的代码更改热重载Hot Reload后手机页面也能实时刷新调试体验极佳。同样你也可以把这个链接发给产品经理或设计师让他们在真实的手机环境中体验效果收集反馈。4.4 隧道稳定性与网络环境考量tunnelto的免费服务对于临时性、低频次的开发调试和演示来说非常稳定。但你需要理解其工作原理所有流量都需要经过tunnelto.dev的服务器进行中转。这意味着延迟你的请求路径变成了手机/他人电脑 - tunnelto服务器 - 你的本地电脑会比直连本地局域网多一跳因此会有一些额外的网络延迟对于实时性要求极高的场景如在线游戏可能不适用但对于普通的 HTTP API 调用、页面访问完全足够。带宽限制免费服务通常会有带宽或流量限制具体需查看tunnelto的官方说明。对于传输大文件或视频流可能不是最佳选择。服务可用性依赖于tunnelto.dev官方服务器的可用性。虽然服务通常很稳定但在极端情况下也可能出现中断。因此我的建议是将tunnelto视为一个强大的“临时桥梁”和“调试利器”而非永久性的部署方案。对于需要长期、稳定、高性能的公网访问最终还是需要部署到云服务器或使用专业的反向代理服务。5. 常见问题排查与安全须知即使工具再简单在实际使用中也难免会遇到一些问题。下面我整理了几个最常见的“坑”及其解决方法以及必须牢记的安全准则。5.1 “子域名已被占用”错误当你运行tunnelto --subdomain myname时可能会看到错误提示告诉你该子域名不可用。Error: Failed to claim subdomain myname: Subdomain already in use.原因与解决tunnelto.dev下的所有子域名是全局共享的。就像注册用户名一样别人先注册了myname你就不能用了。解决方案换一个更独特、更复杂的子域名。可以尝试加上项目名、日期或随机字符例如myname-project-2024、demo-abc123。这是一个简单的资源竞争问题没有技术上的解决办法只能靠命名创意。5.2 “无法连接到本地主机”错误启动隧道时可能会遇到连接被拒绝的错误Error: Failed to connect to local server at http://localhost:8000: Connection refused原因与解决这几乎总是因为你的本地服务没有启动或者没有监听在tunnelto命令指定的端口和主机上。排查步骤确认服务已启动检查你运行本地服务的终端窗口确保进程还在运行没有报错退出。确认端口号核对tunnelto --port XXXX中的XXXX是否与本地服务实际监听的端口完全一致。确认主机地址如果你的服务不是监听在127.0.0.1或localhost请使用--host参数指定正确的主机 IP。使用网络工具验证在另一个终端用curl或telnet测试本地服务是否可访问。# 测试本地 8000 端口 curl -v http://localhost:8000 # 或者使用 telnet (如果系统有) telnet localhost 8000如果curl或telnet也连接失败那问题肯定出在你的本地服务上需要先解决本地服务的启动问题。5.3 隧道连接不稳定或时断时续有时隧道建立后访问时快时慢甚至偶尔超时。可能原因你的本地网络不稳定tunnelto客户端需要与远程服务器保持一个持久的 WebSocket 或类似的长连接。如果你的电脑网络波动尤其是 WiFi 信号弱可能导致连接中断。远程服务器负载或网络问题虽然不常见但tunnelto.dev的服务器也可能遇到高负载或临时网络问题。防火墙或代理干扰公司网络或某些防火墙策略可能会干扰或限制长连接。应对措施尝试切换到更稳定的网络环境如有线网络。重启tunnelto客户端重建连接。检查本地防火墙或安全软件设置确保其未阻止tunnelto客户端的出站连接。5.4 必须牢记的安全使用准则使用任何将本地环境暴露到公网的工具安全都是头等大事。请务必遵循以下原则仅用于开发与测试这是铁律。绝对不要将tunnelto生成的临时链接用于生产环境、处理真实用户数据、进行金融交易或存储任何敏感信息。它的域名是公开的且服务本身不提供高级别的安全审计和保障。控制暴露范围只暴露必要的服务。如果你本地的服务包含管理后台、数据库界面等敏感接口确保它们有额外的身份验证保护或者干脆不要通过隧道暴露它们。最好为演示专门启动一个干净的、仅包含演示功能的服务实例。及时关闭隧道演示或调试结束后立即按CtrlC终止tunnelto进程。公共链接一旦关闭就立即失效最大限度地减少暴露窗口。注意本地服务的安全确保你本地运行的服务本身没有严重的安全漏洞。因为隧道一旦建立你的本地服务就相当于在一个简陋的公网上运行了。保管好 Auth Token你的tunnelto认证令牌是个人凭证不要泄露。如果意外泄露应立即在tunnelto控制台重置令牌并重新在本地设置。tunnelto是一个设计精良的工具它通过简化复杂问题来提升开发效率。理解其边界——它是一个便捷的“临时桥梁”——并安全地使用它你就能在开发、调试、协作和演示中获得前所未有的灵活性。从今天起别再为“怎么让别人访问我的本地服务”这种问题烦恼了。