用户浏览器
    ↓ HTTPS
Cloudflare 全球网络
    ↓ 安全隧道
Cloudflare Tunnel (cloudflared)
    ↓ localhost
你的本地服务 (NAS 上的博客)

# 拉取镜像
docker pull cloudflare/cloudflared:latest

# 查看运行中的容器
docker ps

# 查看所有容器（包括已停止）
docker ps -a

# 启动容器
docker start <容器名>

# 查看容器日志
docker logs -f <容器名>

# 删除容器
docker rm <容器名>

用户浏览器 → [正向代理服务器] → 目标网站
   ↑                              ↓
   └────────── 代理返回 ──────────┘

用户浏览器 → [Cloudflare 反向代理] → 你的本地服务
              ↓ 加密隧道
           cloudflared

1. 浏览器查询本地 DNS 缓存
2. 若无缓存，向 DNS 服务器发起请求
3. DNS 服务器查询根域名服务器
4. 逐级查询直到找到 example.com 的 DNS 服务器
5. DNS 服务器返回 blog.example.com 对应的 IP 地址
6. 浏览器使用该 IP 地址建立连接

# 检查 Docker 版本
docker --version

# 检查 Docker Compose 版本（V2）
docker compose version

# 查看 Docker 信息
docker info

# 验证 Docker Compose
docker compose version

# 如果显示 command not found，可以手动安装
# 或使用 docker-compose（V1）命令
docker-compose --version

# 使用 dig 命令查看 DNS 解析
dig NS yourdomain.com

# 或使用在线工具
# https://www.whatsmydns.net/

cloudflared/
├── docker-compose.yaml   # 主配置文件
├── .env                  # 环境变量（Token 配置）
└── .gitignore            # Git 忽略配置

# Cloudflare Tunnel Token 配置
# 请勿将此文件提交到版本控制系统

# 隧道 Token（从 Cloudflare Zero Trust 获取）
TUNNEL_TOKEN=你的隧道Token

version: '3.8'

# Cloudflare Tunnel 隧道配置
x-cloudflared_defaults: &cloudflared_defaults
  image: cloudflare/cloudflared:latest
  network_mode: host  # 必须使用 host 模式
  restart: always
  command:
    - tunnel
    - --no-autoupdate
    - --protocol=http2
    - --edge-ip-version=4
    - run
  logging:
    driver: json-file
    options:
      max-size: "10m"
      max-file: "3"
  healthcheck:
    test: ["CMD", "cloudflared", "tunnel", "info"]
    interval: 60s
    timeout: 10s
    retries: 3
  mem_limit: 128m
  cpus: 0.5

services:
  # Cloudflare Tunnel 服务
  cloudflared:
    <<: *cloudflared_defaults
    container_name: cloudflared
    env_file:
      - .env
    environment:
      - TUNNEL_TOKEN=${TUNNEL_TOKEN}

# 敏感文件
.env
*.log

# 进入目录
cd /path/to/cloudflared

# 启动服务
docker compose up -d

# 查看状态
docker compose ps

# 查看日志
docker compose logs -f

# 重启服务
docker compose restart

services:
  # 博客服务隧道
  cloudflared-blog:
    <<: *cloudflared_defaults
    container_name: cloudflared-blog
    env_file:
      - .env
    environment:
      - TUNNEL_TOKEN=${TUNNEL_TOKEN_BLOG}

  # 导航服务隧道
  cloudflared-nav:
    <<: *cloudflared_defaults
    container_name: cloudflared-nav
    env_file:
      - .env
    environment:
      - TUNNEL_TOKEN=${TUNNEL_TOKEN_NAV}

# 博客服务隧道 Token
TUNNEL_TOKEN_BLOG=你的博客隧道Token

# 导航服务隧道 Token
TUNNEL_TOKEN_NAV=你的导航隧道Token

command:
  - --protocol=http2    # 推荐：HTTP/2 协议，性能更好
  # 或
  - --protocol=h2mux    # 备选：基于 mux 的协议

command:
  - --edge-ip-version=4  # 仅 IPv4（推荐，大部分网络环境）
  # 或
  - --edge-ip-version=auto  # 自动选择（IPv4/IPv6）

docker compose logs -f cloudflared

# 1. 确认隧道状态
docker compose ps

# 2. 检查本地服务
curl http://localhost:8090

# 3. 查看 Cloudflare 仪表板
# Networks → Tunnels → 查看连接状态

services:
  cloudflared-blog:
    <<: *cloudflared_defaults
    container_name: cloudflared-blog
    env_file:
      - .env
    environment:
      - TUNNEL_TOKEN=${TUNNEL_TOKEN_BLOG}

services:
  cloudflared-nav:
    <<: *cloudflared_defaults
    container_name: cloudflared-nav
    env_file:
      - .env
    environment:
      - TUNNEL_TOKEN=${TUNNEL_TOKEN_NAV}

services:
  cloudflared-nas:
    <<: *cloudflared_defaults
    container_name: cloudflared-nas
    env_file:
      - .env
    environment:
      - TUNNEL_TOKEN=${TUNNEL_TOKEN_NAS}