cf cg:Cloudflare Tunnel 与 CGNAT 环境穿透:内网服务外网访问实操教程
学完本教程,你将彻底解决在处于运营商 CGNAT(无公网 IPv4)环境下,如何无需公网 IP、不依赖路由器端口映射,将本地 Web 服务或内网应用免费且安全地发布到公网的问题。
1. 前期环境与资源准备
在执行穿透前,必须具备两项基础资源:一个经过 Cloudflare 托管 DNS 解析的独立域名,以及一台处于 CGNAT 环境下的本地宿主机(支持 Linux、Windows 或 macOS)。

具体做法:
第一,登录 Cloudflare 官网,添加你的域名,并根据提示修改域名注册商处的 Nameservers(NS 记录),确保域名状态变为“Active”。
第二,明确本地需要穿透的服务端口。例如,本地运行在 `http://127.0.0.1:8080` 的 Web 管理面板,或运行在 `127.0.0.1:3000` 的自建服务。确保该服务在本地局域网内能够稳定访问。
2. 安装 Cloudflare 客户端(cloudflared)
`cloudflared` 是建立安全加密隧道的核心守护进程。
具体做法:
在 Linux(以 Debian/Ubuntu 为例)终端中执行以下命令下载并安装最新版的官方包:
```bash
curl -L --output cloudflared.deb https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb
sudo dpkg -i cloudflared.deb
```
如果是 Windows 用户,前往 Cloudflare 官方 GitHub Releases 页面下载 `cloudflared-windows-amd64.msi` 安装包,完成默认安装,并确保 `cloudflared` 路径已写入系统环境变量。
3. 客户端授权登录
需要将本地的 `cloudflared` 客户端与你的 Cloudflare 账户进行凭据绑定。
具体做法:
在终端执行登录命令:
```bash
cloudflared tunnel login
```
终端会输出一个类似 `https://dash.cloudflare.com/argotunnel?callback=...` 的长链接。复制该链接至浏览器中打开,登录你的 Cloudflare 账户,并在授权页面中选中你准备使用的根域名,点击“Authorize”。授权成功后,终端会自动拉取一个名为 `cert.pem` 的证书文件并存放在默认目录(Linux 通常在 `~/.cloudflared/`,Windows 通常在 `C:\Users\用户名\.cloudflared\`)。
4. 创建专属穿透隧道(Tunnel)
基于授权凭证,建立一条唯一的虚拟隧道。
具体做法:
在终端输入创建命令,并为隧道指定一个名称(例如叫 `my-homelab`):
```bash
cloudflared tunnel create my-homelab
```
命令执行完毕后,终端会返回该隧道的唯一 UUID(一串类似 `xxxx-xxxx-xxxx-xxxx` 的字符串),并在配置目录下生成对应的凭证文件 `UUID.json`。请记录该 UUID。
5. 编写隧道配置文件(config.yml)
通过配置文件将外部域名、隧道与本地服务端口建立映射规则。
具体做法:
在 `~/.cloudflared/` 目录下创建并编辑 `config.yml` 文件:
```yaml
tunnel: 你的隧道UUID
credentials-file: /root/.cloudflared/你的隧道UUID.json
ingress:
- hostname: sub.yourdomain.com
service: http://localhost:8080
- service: http_status:404
```
注意:
- 将 `tunnel` 后面的内容替换为第4步生成的实际 UUID。
- 将 `credentials-file` 路径指向实际的 JSON 文件位置。
- `hostname` 填写你希望分配给该服务的二级域名。
- `service` 填写本地服务的协议和端口。
- 最底部的 `- service: http_status:404` 是兜底规则,不可省略。
6. 配置 DNS 路由路由解析
将二级域名通过 CNAME 记录绑定到刚才创建的隧道上。
具体做法:
在终端直接执行内置的 DNS 绑定命令:
```bash
cloudflared tunnel route dns my-homelab sub.yourdomain.com
```
执行后,Cloudflare 会自动在你的域名 DNS 列表中增加一条指向 `UUID.cfargotunnel.com` 的 CNAME 记录,且默认开启代理模式(小黄云)。
7. 启动测试与后台服务化配置
先在控制台验证联通性,确认无误后注册为开机自启系统服务。
具体做法:
首先执行运行测试:
```bash
cloudflared tunnel --config ~/.cloudflared/config.yml run my-homelab
```
打开外部网络(如手机断开 WiFi 使用 5G 数据流量),访问 `https://sub.yourdomain.com`,确认可以正常打开内网页面。
测试成功后,按 `Ctrl + C` 退出前台程序,执行系统服务安装命令使其在后台常驻:
```bash
sudo cloudflared service install
sudo systemctl start cloudflared
sudo systemctl enable cloudflared
```
常见坑点提醒:
1. 本地服务协议混淆:如果本地服务本身未配置 SSL,`service` 必须写 `http://` 而不是 `https://`;如果本地是自签证书的 HTTPS 服务,需在配置文件的 `ingress` 项下增加 `originRequest: noTLSVerify: true`,否则隧道会因证书校验失败报错 502。
2. 配置文件缩进格式:`config.yml` 对缩进极度敏感,不能使用 Tab 键,必须使用标准两个空格进行层级缩进,最后必须包含 404 兜底规则,缺少会导致服务拒绝启动。
3. 滥用 TOS 封号风险:Cloudflare 协议(TOS)严格禁止仅通过免费 CDN 传输大流量非 HTML 媒体内容。避免使用该穿透承载大容量 Plex/Emby 视频流媒体外网直链推流,或将其当作网盘下载节点,否则极易触发封号或域名禁用。
4. 客户端双开冲突:配置为系统服务(systemctl)后,切勿在终端再次手动运行 `cloudflared tunnel run`,否则多实例并发争抢同一隧道凭证会导致连接频繁闪断。