何时使用 tunelo

当用户需要以下操作时，请使用 tunelo：

• - 远程预览文件 — 给我看看那个PDF、让我在手机上浏览这些文件
• 共享本地开发服务器 — 给我一个链接访问你的React应用
• 向同事演示内容 — 把URL发给我，让我测试一下
• 从其他设备访问本地主机 — 移动端测试、远程调试
• 共享目录 — 项目文件、文档、媒体文件、数据集

以下情况请勿使用 tunelo：

• - 用户仅需本地访问（请使用 python3 -m http.server 或 tunelo serve . --local）
• 文件已托管在公共位置

安装

bash
curl -fsSL https://tunelo.net/install.sh | sh

如果安装后找不到 tunelo，二进制文件位于 /usr/local/bin/tunelo。

命令

暴露本地HTTP服务

bash
tunelo http 3000 # 暴露端口3000 → 获取公共HTTPS URL
tunelo http 5173 # React/Vite开发服务器
tunelo http 8080 # 任意本地服务
tunelo http 3000 --private # 需要访问码才能访问

使用网页浏览器提供文件服务

bash
tunelo serve . # 当前目录 → 带文件浏览器的公共URL
tunelo serve ./dist # 指定目录
tunelo serve ~/Documents # 任意路径
tunelo serve . --local # 仅本地预览（无隧道，无公共URL）
tunelo serve . -l -p 8000 # 在端口8000上进行本地预览

文件浏览器在浏览器中运行 — 支持目录浏览、代码语法高亮、Markdown渲染、PDF查看器、图片/视频/音频播放、CSV/Excel表格。所有功能内置于二进制文件中，无需依赖。

选项

bash
tunelo http --relay my.server:4433 # 使用自定义中继服务器
tunelo http -H 192.168.1.100 # 转发到非本地主机
tunelo http --private # 自动生成访问码
tunelo http --code mysecret # 设置特定访问码

默认中继服务器为 tunelo.net:4433（免费公共中继）。自托管时使用 --relay。

典型代理工作流程

用户说把这些文件分享给我

bash
tunelo serve /path/to/files

将输出中的公共URL提供给用户

用户说我想在手机上查看

bash

如果有开发服务器正在运行：

如果只是文件：

用户说让我的同事测试API

bash
tunelo http 8080 --private

提供共享URL（包含访问码）

用户说先在本地预览

bash
tunelo serve ./dist --local

在 http://localhost:3000 打开，无公共URL

工作原理

浏览器 → HTTPS → 中继服务器 → QUIC隧道 → 客户端 → 本地主机/文件服务器

• - 自动分配公共HTTPS URL（随机子域名，如 abc123.tunelo.net）
• QUIC传输 — 加密、多路复用、低延迟
• 连接断开时自动重连
• 会话限制：公共中继上的隧道约2小时后过期