> 本地跑着 API 想让远程同事调试？在本地写了个页面想给客户看？开发环境需要接收 Webhook？别折腾 frp、ngrok 了，试试这个。

## 痛点：内网穿透为什么这么烦？

做开发的都遇到过这个场景：

- 本地起了个服务，想让同事/客户远程访问
- 需要接收第三方 Webhook 回调（微信支付、GitHub 等）
- AI 生成的前端页面想发给甲方预览

传统方案要么收费（ngrok），要么配置复杂（frp 需要自备服务器），要么不稳定。

其实 Cloudflare 早就提供了**免费的内网穿透服务** —— Cloudflare Tunnel。问题是，原生的 `cloudflared` 命令行工具操作太繁琐：创建隧道要登录浏览器、配 DNS 要去 Dashboard 手动加 CNAME、管理多个隧道要手动 ps + kill……

**所以我们做了 cftunnel。**

## cftunnel 是什么？

cftunnel 是 Cloudflare Tunnel 的 CLI 管理器，用 Go 编写，MIT 开源。

它不是 cloudflared 的替代品，而是**增强层** —— 把原本需要十几步的操作封装成一条命令。

![terminal-demo.gif](https://developer.qcloudimg.com/http-save/yehe-11993100/0ab75d7fecb5f52967a4448b17b585cf.gif)

没错，就这么简单：

```bash
cftunnel quick 3000
```

你的 `localhost:3000` 立刻获得一个 `https://xxx.trycloudflare.com` 公网域名。**免注册、免配置、免费。**

## 它解决了什么问题？

![compare-chart.gif](https://developer.qcloudimg.com/http-save/yehe-11993100/c17d0bcf01a554335b72b8bc25117b90.gif)

| 对比项 | 原生 cloudflared | cftunnel |
|--------|-----------------|----------|
| 免域名穿透 | 手动操作多步 | `cftunnel quick <端口>` 一条命令 |
| 自有域名绑定 | 手动创建隧道 + DNS + 凭证 | `cftunnel config` 交互式配置 |
| 多隧道管理 | 手动 ps + kill | `list` / `stop` 统一管理 |
| 配置文件 | 分散的 JSON + cert | YAML 集中管理 |
| 开机自启 | 手动写 systemd/launchd | `cftunnel install` 一键注册 |
| 清理资源 | 手动删隧道 + 删 DNS + 删配置 | `cftunnel destroy` 一键清理 |

**核心理念：cftunnel = cloudflared 的最佳拍档，不是替代，是增强。**

## 架构原理

![architecture.gif](https://developer.qcloudimg.com/http-save/yehe-11993100/b868af8866ced608800754185e30b88c.gif)

cftunnel 的工作流程很简单：

1. **cftunnel** 作为 CLI 管理器，负责配置管理和进程编排
2. 它自动下载并启动 **cloudflared** 守护进程
3. cloudflared 与 **Cloudflare Edge** 建立加密隧道
4. 互联网用户通过 Cloudflare 边缘节点访问你的本地服务

整个过程无需公网 IP，流量经过 Cloudflare 全球 CDN 加速，自带 HTTPS。

## 两种使用模式

### 模式一：免域名（零配置）

适合临时分享和调试，装好就能用：

```bash
cftunnel quick 3000
# ✔ 隧道已启动: https://xxx-yyy-zzz.trycloudflare.com
```

Ctrl+C 退出后域名自动失效。

### 模式二：自有域名（稳定持久）

需要固定域名？cftunnel 也能一键搞定：

![custom-domain.gif](https://developer.qcloudimg.com/http-save/yehe-11993100/7afa4d7f158e95b1d96e6f8c90618f5c.gif)

```bash
# 交互式配置
cftunnel config
# ? 隧道名称: my-app
# ? 本地端口: 3000
# ? 自有域名: app.example.com
# ✔ 配置已保存

# 启动
cftunnel start my-app
# ✔ 隧道已启动，域名已绑定
#   https://app.example.com → localhost:3000
```

DNS 记录自动创建，凭证自动管理，不用去 Cloudflare Dashboard 点来点去。

## 安装

**一行命令搞定：**

macOS / Linux：
```bash
curl -fsSL https://raw.githubusercontent.com/qingchencloud/cftunnel/main/install.sh | bash
```

Windows（PowerShell）：
```powershell
irm https://raw.githubusercontent.com/qingchencloud/cftunnel/main/install.ps1 | iex
```

或者用 Go 安装：
```bash
go install github.com/qingchencloud/cftunnel@latest
```

支持 macOS (Intel/Apple Silicon) + Linux (amd64/arm64) + Windows (amd64/arm64) 全平台。

## 更多亮点

- **AI 友好** — 内置 Claude Code Skills，AI 助手可以直接帮你管理隧道
- **桌面客户端** — 不想敲命令？[cftunnel-app](https://github.com/qingchencloud/cftunnel-app) 提供可视化 GUI
- **自动更新** — `cftunnel update` 一键升级到最新版
- **开机自启** — `cftunnel install` 注册系统服务，重启不丢隧道

## 开源地址

- GitHub: https://github.com/qingchencloud/cftunnel
- 官网: https://cftunnel.qt.cool
- 桌面客户端: https://github.com/qingchencloud/cftunnel-app
- 当前版本: v0.4.2
- 协议: MIT

---

**Star 一下？** 如果 cftunnel 帮到了你，去 GitHub 点个 Star 就是最好的支持。

有问题或建议？欢迎提 Issue 或加入讨论。

本地跑着 API 想让远程同事调试？在本地写了个页面想给客户看？开发环境需要接收 Webhook？别折腾 frp、ngrok 了，试试这个。

一条命令，localhost 秒变公网域名 — cftunnel 开源发布

本地跑着 API 想让远程同事调试？在本地写了个页面想给客户看？开发环境需要接收 Webhook？别折腾 frp、ngrok 了，试试这个！

数据库

cftunnel是CloudflareTunnel的CLI管理器，简化内网穿透流程，一键实现本地服务公网访问。支持免域名快速分享和自有域名绑定，无需复杂配置，全平台兼容。开源免费，解决开发调试、Webhook回调等场景下的内网穿透难题，比ngrok更简单高效。

命令行工具

服务器

Windows

GitHub

Linux

JSON

2026新春采购季

domain

4核4G3M云服务器 新用户低至38元/年！

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

一条命令，localhost 秒变公网域名 — cftunnel 开源发布-腾讯云开发者社区-腾讯云

一条命令，localhost 秒变公网域名 — cftunnel 开源发布

一条命令，localhost 秒变公网域名 — cftunnel 开源发布

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐