项目介绍
Cloudflare Tunnel 由内网连接器主动建立隧道,将指定服务接入域名入口。适合没有公网 IPv4 的场景,访问控制和源站协议仍需单独配置。
连接器从内网主动连接 Cloudflare,域名请求再经隧道到达所配置的服务。无需为每个应用开放入站端口,但连接器必须能够访问源站,域名路由与访问控制也需要配置。
适合为家庭服务建立远程入口。飞牛的图形封装与官方 cloudflared 是不同管理方式,选择其中一种后应记录隧道、域名和源站映射,避免重复创建入口。
核心功能
| 功能 | 作用与使用方式 |
|---|---|
| 主动建连 | 连接器从内网建立隧道。 |
| 域名映射 | 为指定主机名设置对应内网服务。 |
| 源站转发 | 区分用户访问协议与连接器到源站的协议。 |
| 访问策略 | 为管理页面增加身份验证或限制。 |
| 连接诊断 | 分别检查连接器、域名解析和应用响应。 |
功能示意

图 1:自制功能示意图,概括本文的使用要点。
项目信息
| 项目 | 说明 |
|---|---|
| 类型 | 配置指南 |
| 分类 | NAS 与运维 |
| 官方入口或文档 | 直接访问 |
| 整理日期 | 2026-11-14 |
群晖 Compose 安装
Cloudflare Tunnel 容器主动向 Cloudflare 建立连接,不需要在 NAS 发布管理端口。先在 Cloudflare Zero Trust 中创建自己的隧道并取得连接令牌,域名须已接入自己的 Cloudflare 账户。
1. 创建项目目录
群晖先安装并启动 Container Manager。通过 SSH 登录后执行下列命令,只为本项目准备目录:
sudo -i
mkdir -p /volume1/docker/cloudflare-tunnel
cd /volume1/docker/cloudflare-tunnel
if [ ! -s .env ]; then
umask 077
{
:
} > .env.initializing
printf '输入你自己 Cloudflare Tunnel 的连接令牌: ' > /dev/tty
IFS= read -r CF_TUNNEL_TOKEN < /dev/tty
test -n "$CF_TUNNEL_TOKEN" || { echo "输入不能为空"; exit 1; }
printf "CF_TUNNEL_TOKEN='%s'\n" "$CF_TUNNEL_TOKEN" >> .env.initializing
mv .env.initializing .env
fi
chmod 600 .env
命令会提示输入自己的服务地址或授权信息,输入值仅写入本项目的私有 .env。启动前核对输入正确,已有文件不会自动覆盖。填写值不要包含单引号或换行;需要复杂字符时直接用文本编辑器按 Compose 的环境文件格式编辑。
2. 保存完整 Compose
在 /volume1/docker/cloudflare-tunnel/compose.yaml 保存下面的配置。在 Container Manager 中新建项目时,项目路径选择 /volume1/docker/cloudflare-tunnel 并导入该文件;有 .env 的项目要保留它与 Compose 在同一目录。
services:
cloudflare-tunnel:
image: cloudflare/cloudflared:latest
container_name: cloudflare-tunnel
restart: unless-stopped
command:
- tunnel
- --no-autoupdate
- run
- --token
- ${CF_TUNNEL_TOKEN}
挂载参数冒号左侧是群晖的实际目录,右侧是应用内目录。以上只挂载本项目所需的数据;若已有同类数据,请先备份再调整路径。端口冲突时只改宿主机一侧,应用内端口保持不变。
3. 检查、拉取与启动
cd /volume1/docker/cloudflare-tunnel
docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps
docker compose logs --tail=100
在 Cloudflare Zero Trust 控制台查看隧道连接状态;此容器通过你配置的公共主机名提供访问,不另外打开本地管理网页。若群晖仍使用旧 Docker 套件且只有 docker-compose,将命令中的 docker compose 替换为对应命令。
首次使用与验证
在 Zero Trust 控制台确认隧道为 Healthy,再添加一个测试公共主机名。服务地址填写容器实际能访问的 NAS 地址与端口,不要把容器的 localhost 当成 NAS。网页后台若有 WebSocket 或大文件上传,分别验证;私有管理页面应配置 Cloudflare Access 访问策略。
先保存一条测试数据或完成一次最小任务,再执行 docker compose restart,确认设置及应该持久化的数据仍在。无服务端持久化目录的纯前端工具,应通过自身导出功能保存工作结果。
常见问题
- 页面打不开:运行
docker compose ps检查状态;查看日志里的初始化错误,核对端口冲突和 DSM 防火墙。不要把容器的 IP 当作固定访问地址。 - 数据目录为空:应用内应填写 Compose 冒号右侧的目录;核对宿主机文件是否已放到对应左侧目录。
- 目录无法写入:先查看日志和目录权限,仅为对应数据目录授予镜像实际运行用户需要的权限,不对整个
/volume1设置 777。 - 拉取镜像失败:先排查 Container Manager 的仓库网络;应用自己的 HTTP 代理设置与 Docker 守护进程拉取镜像的代理设置是两件事。
更新、备份与停止
更新前保存 compose.yaml、.env,并备份上面映射的项目数据。数据库服务应先使用自身的数据库备份,或停止整个项目后复制完整数据目录,不能只复制运行中的单个数据库文件。
cd /volume1/docker/cloudflare-tunnel
docker compose pull
docker compose up -d
docker compose logs --tail=100
临时停止使用 docker compose stop,重新启动使用 docker compose start。卸载容器用 docker compose down,不要附加 -v,也不要直接删除宿主机数据目录。涉及数据库迁移的升级,先保留原镜像版本和完整备份,再安排维护窗口。