用途:将本地 HTTP 服务暴露为稳定的公开 https 地址,格式为 https://<node>.<tailnet>.ts.net,使用真实证书,URL 不含端口号,无需 ngrok 账号或单独付费方案。适用场景包括:为本地开发服务器、静态 dist/ 目录、MCP 服务器、webhook 接收器或追踪面板提供公开 URL;当浏览器自动化工具(如 agent-browser、微虚拟机中的 Playwright、Vercel Sandbox、AgentCore 云浏览器)无法访问 127.0.0.1、192.168.x.x 或 100.x.x.x 时;用户要求从手机访问、分享给他人或暴露到公网时。
不适用场景:仅需同局域网访问时直接绑定 0.0.0.0:<port> 即可;仅需 tailnet 内部访问时应使用 tailscale serve 而非 funnel;生产流量(大请求体、文件上传、持续高 RPS)因 Funnel 实际约限速 1 MB/s 而不适合;用户明确要 ngrok、Cloudflare Tunnel 等其它工具时。
主要能力:负责 tailscale funnel 的预检、端口槽位决策、绑定接口决策、验证链与拆除。前提是已安装 Tailscale 且节点已登录 tailnet。
必要用法要点:Funnel 仅发布 443、8443、10000 三个端口,每端口仅一个映射,新映射会静默替换旧映射;tailscale funnel reset 会清除节点上所有 Serve 与 Funnel 映射且不可撤销,应改用 tailscale funnel --https=<port> off 清除单个端口。预检命令:tailscale serve status、tailscale funnel status。映射命令示例:tailscale funnel --bg --https=<funnel-port> http://127.0.0.1:<local-port>,--bg 使映射在 shell 退出和守护进程重启后保持。需将本地应用绑定到 127.0.0.1。部分开发服务器(Astro preview、Vite、Next.js dev)会校验 Host 头导致 403,需配置 allowedHosts 或改用不校验 Host 的静态服务器。CLI 显示 Funnel on 不代表公网可达,需独立验证 ACL 门、公网路径与外部客户端三层。macOS 下 host/dig 与 curl 使用不同解析器,应以 curl 或 dscacheutil 验证。MagicDNS 需先在 tailnet 管理控制台启用。其余内容(脚本细节、Makefile 集成等)资料中有提及,此处不展开。