tunnelto 安装使用教程
🔥 免费开源的内网穿透工具，ngrok 最佳平替
📋 目录
1. 项目介绍
2. 对比 ngrok
3. 核心功能
4. 安装步骤
5. 使用方法
6. 自建服务端
7. 常见问题
🎯 项目介绍
tunnelto 是一个免费开源的内网穿透工具，可以将你本地运行的服务（如 localhost:3000）通过一个公网 URL 暴露出去，方便远程访问和调试。简单来说，就是让外网访问你的 localhost！
✨ 核心优势：不用买服务器，一行命令让外网访问你的 localhost！
项目信息 详情
GitHub 地址 github.com/agrinman/tunnelto
官方网站 tunnelto.dev
Star 数量 5.5k+
开发语言 Rust（高性能、单一二进制文件）
开源协议 MIT License（可商用）
📊 对比 ngrok
为什么选择 tunnelto 而不是 ngrok？看看对比就知道了：
功能 tunnelto ngrok（免费版）
价格 完全免费 $9-29/月
会话时长 无限制 2小时限制
带宽限制 无限制 有预警
拦截页面 无 有警告页面
开源 MIT 开源 闭源
自托管 支持 企业版支持
💡 省钱小技巧：ngrok 付费版每年 $96-348，而 tunnelto 完全免费，一年能省下一台云服务器的钱！
🛠️ 核心功能
● 项目演示：给客户演示本地开发的项目，无需部署到服务器
● Webhook 调试：接收第三方 Webhook（如 Stripe、微信等）回调
● 移动开发：手机 App 测试时连接本地后端服务
● 安全可控：代码开源可审计，支持自建服务端
📥 安装步骤
方式一：一键安装脚本（推荐）
curl -sL https://tunnelto.dev/install.sh | sh
方式二：Homebrew（macOS）
brew install tunnelto
方式三：Cargo（Rust 用户）
cargo install tunnelto
方式四：手动下载
从 GitHub Releases 下载对应系统的二进制文件：
● macOS: tunnelto-darwin-amd64 / tunnelto-darwin-arm64
● Linux: tunnelto-linux-amd64
● Windows: tunnelto-windows-amd64.exe
✅ 安装完成后，运行 tunnelto –version 验证是否安装成功！
🚀 使用方法
1. 启动本地服务
首先确保你的本地服务已经在运行，比如：
# 示例：启动一个 Node.js 项目
npm run dev
# 假设运行在 localhost:3000
2. 创建隧道
# 将本地 3000 端口暴露到公网
tunnelto –port 3000
运行后会返回一个公网 URL，类似：
https://abc123.tunnelto.dev -> localhost:3000
3. 自定义子域名
# 使用自定义子域名
tunnelto –port 3000 –subdomain myproject
# 访问：https://myproject.tunnelto.dev
4. 指定本地地址
# 如果本地服务不在 localhost
tunnelto –port 3000 –local-host 192.168.1.100
常用参数
参数 说明 示例
–port 本地端口 –port 8888
–subdomain 自定义子域名 –subdomain demo
–local-host 本地服务地址 –local-host 127.0.0.1
–key API Key（付费用户） –key xxx
🔧 自建服务端（高级用法）
如果你想完全掌控，可以自己搭建 tunnelto 服务端。
1. 克隆代码
git clone https://github.com/agrinman/tunnelto.git
cd tunnelto
2. 编译服务端
# 需要安装 Rust
cargo build –release –bin tunnelto-server
3. 配置域名
你需要：
● 一个域名（如 tunnel.yourdomain.com）
● 配置 DNS 泛解析：*.tunnel.yourdomain.com → 服务器 IP
● SSL 证书（推荐使用 Let’s Encrypt 通配符证书）
4. 启动服务端
./target/release/tunnelto-server
⚠️ 注意：自建服务端需要一定的运维能力，普通用户直接使用官方服务即可！
❓ 常见问题
Q1: tunnelto 和 ngrok 哪个更稳定？
ngrok 作为商业产品，在稳定性和功能上确实更全面。但对于开发调试场景，tunnelto 完全够用，而且免费无限制！
Q2: 可以用于生产环境吗？
不建议。tunnelto 主要用于开发调试场景，生产环境建议使用正式的云服务或反向代理。
Q3: tunnelto 怎么解决国内访问慢的问题？
官方服务部署在海外，国内用户可能需要自建服务端以获得更好的体验。
Q4: 支持 HTTPS 吗？
支持！tunnelto 官方服务自动提供 HTTPS，自建服务端需要自行配置证书。
Q5: 为什么会出现连接失败？
可能是网络环境问题（如防火墙、代理），也可能是本地服务未正常启动。建议先检查本地服务是否可访问，再尝试更换端口或自建服务端。
Q6: 可以使用国内服务器吗？
可以，但需要自行在国内服务器部署服务端，并确保域名已备案。