ClawdBot + Cloudflare Tunnel + Zero-Trust 部署指南

选择二：使用临时域名测试

• 这会创建一个临时的 Tunnel，并给你一个临时域名
• 这个域名可以用于测试，但每次重启 Tunnel 可能会变化

cloudflared tunnel --url http://localhost:8080

1.3 验证域名状态

在 Cloudflare Dashboard 中：

• 左侧菜单选择你的域名
• 你应该看到域名状态显示为"有效"
• DNS 记录中应该有一些默认记录

第二步：安装 Cloudflare Tunnel

Cloudflare Tunnel 是一个工具，它会在你的服务器和 Cloudflare 之间建立一个安全的加密隧道。

2.1 Windows 系统安装

方法一：使用 Chocolatey

以管理员身份打开 PowerShell，运行以下命令：

choco install cloudflared -y

如果还没有安装 Chocolatey：

Set-ExecutionPolicy Bypass -Scope Process-Force;[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;iex((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

方法二：手动下载安装

1. 下载 cloudflared
   • 访问：https://github.com/cloudflare/cloudflared/releases/latest
   • 找到 cloudflared-windows-amd64.exe
2. 安装到系统
   • 将下载的文件重命名为 cloudflared.exe
   • 复制到 C:\Windows\System32\ 目录
3. 验证安装
   • 打开新的 PowerShell 窗口，运行：cloudflared --version

2.2 Linux 系统安装

Ubuntu/Debian 系统

curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb -o cloudflared.deb
sudo dpkg -i cloudflared.deb

CentOS/RHEL/Rocky Linux 系统

curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-x86_64.rpm -o cloudflared.rpm
sudo rpm -i cloudflared.rpm

通用方法（所有 Linux 系统）

wget https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64
sudo mv cloudflared-linux-amd64 /usr/local/bin/cloudflared
sudo chmod +x /usr/local/bin/cloudflared

2.3 macOS 系统安装

方法一：使用 Homebrew

brew install cloudflared

方法二：手动下载安装

1. 下载 cloudflared
   • 访问：https://github.com/cloudflare/cloudflared/releases/latest
   • 找到对应架构的包
2. 解压文件

   tar -xzf cloudflared-darwin-amd64.tgz
   sudo mv cloudflared /usr/local/bin/cloudflared
   sudo chmod +x /usr/local/bin/cloudflared
   

2.4 验证安装成功

无论使用哪种方法，最后都应该能运行：

cloudflared --version

第三步：配置 Cloudflare Tunnel

3.1 登录 Cloudflare

这一步会将你的 cloudflared 工具与你的 Cloudflare 账户关联起来。

cloudflared tunnel login

1. 浏览器自动打开，登录 Cloudflare 账户
2. 选择你要使用的域名
3. 验证登录成功后，会在用户目录下生成证书文件

3.2 创建 Tunnel

Tunnel 是连接你服务器和 Cloudflare 的通道。

cloudflared tunnel create clawdbot-tunnel

输出中的 ID 就是你的 Tunnel ID，请复制并保存。

cloudflared tunnel list

3.3 创建配置文件

配置文件告诉 Tunnel 如何路由流量。

配置文件位置：

• Windows: C:\Users\你的用户名\.cloudflared\config.yml
• Linux: ~/.cloudflared/config.yml
• macOS: ~/.cloudflared/config.yml

编辑配置文件内容：

tunnel: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
credentials-file: /root/.cloudflared/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.json
ingress:
  - hostname: clawdbot.yourdomain.com
    service: http://localhost:8080
  - service: http_status:404

创建配置文件 (Linux):

mkdir -p ~/.cloudflared
nano ~/.cloudflared/config.yml

3.4 配置 DNS 记录

现在需要在 Cloudflare 中配置 DNS 记录，将你的域名指向 Tunnel。

1. 登录 Cloudflare Dashboard
2. 进入 DNS 设置
3. 添加 CNAME 记录
   • 类型：CNAME
   • 名称：clawdbot
   • 目标：Tunnel-ID.cfargotunnel.com
   • 代理状态：已代理（橙色云朵）

nslookup clawdbot.yourdomain.com

3.5 测试运行 Tunnel

cloudflared tunnel run clawdbot-tunnel

打开浏览器，访问：https://clawdbot.yourdomain.com

3.6 配置为系统服务（自动启动）

Windows 系统

方法一：使用 NSSM

.
ssm.exe install CloudflaredTunnel "C:\Windows\System32\cloudflared.exe" "tunnel --config C:\Users\你的用户名\.cloudflared\config.yml run clawdbot-tunnel"

Linux 系统

创建 systemd 服务文件

sudo nano /etc/systemd/system/cloudflared.service

内容：

[Unit]
Description=Cloudflare Tunnel
After=network.target

[Service]
Type=simple
User=root
ExecStart=/usr/local/bin/cloudflared tunnel --config /root/.cloudflared/config.yml run clawdbot-tunnel
Restart=on-failure
RestartSec=5s

[Install]
WantedBy=multi-user.target

启用服务：

sudo systemctl daemon-reload
sudo systemctl enable cloudflared
sudo systemctl start cloudflared

macOS 系统

创建 launchd plist 文件

nano ~/Library/LaunchAgents/com.cloudflare.cloudflared.plist

加载服务：

launchctl load ~/Library/LaunchAgents/com.cloudflare.cloudflared.plist

第四步：安装 ClawdBot

4.1 获取 ClawdBot

方法一：从 GitHub 下载

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot

方法二：下载预编译版本

wget https://github.com/clawdbot/clawdbot/releases/latest/download/clawdbot-linux-amd64.tar.gz
tar -xzf clawdbot-linux-amd64.tar.gz

4.2 使用 Docker 安装（推荐）

创建 docker-compose.yml

version: '3.8'
services:
  clawdbot:
    image: clawdbot/clawdbot:latest
    container_name: clawdbot
    restart: unless-stopped
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      - NODE_ENV=production
      - PORT=8080
    volumes:
      - ./data:/app/data
      - ./logs:/app/logs

启动服务

docker-compose up -d

4.3 手动安装

如果是 Node.js 应用：

npm install
npm start

如果是 Python 应用：

pip install -r requirements.txt
python app.py

4.4 重要配置：只监听 localhost

非常重要： ClawdBot 应该只监听 localhost 或 127.0.0.1，不要监听 0.0.0.0。

Docker 方式：

ports:
  - "127.0.0.1:8080:8080"

Node.js 应用：

app.listen(8080, '127.0.0.1', () => {
  console.log('Server running on http://127.0.0.1:8080');
});

Python 应用：

app.run(host='127.0.0.1', port=8080)

4.5 安装后验证清单

• ClawdBot 服务正在运行
• 可以通过 http://localhost:8080 访问
• 端口只监听 127.0.0.1:8080
• 日志中没有错误信息

第五步：配置 Zero-Trust 登录

5.1 启用 Zero Trust

1. 登录 Cloudflare Dashboard
2. 选择计划
   • 选择"免费"计划
3. 设置团队名称
   • 输入一个团队名称

5.2 配置身份提供商

选项 A：使用 One-time PIN

1. 进入认证设置
2. 启用 One-time PIN

选项 B：使用 Google/Microsoft/GitHub 登录

1. 创建 OAuth 应用
2. 在 Cloudflare 中配置
   • Client ID 和 Client Secret

5.3 创建访问策略

1. 进入应用设置
2. 选择应用类型
   • 选择"Self-hosted"
3. 配置策略
   • Policy name: Allow Team Members
   • Action: Allow
   • Include: Emails

5.4 验证 Zero-Trust 配置

1. 访问应用
   • 访问：https://clawdbot.yourdomain.com
2. 测试登录
   • 使用配置的身份提供商登录

第六步：测试和验证

6.1 测试 Tunnel 连接

cloudflared tunnel info clawdbot-tunnel
sudo systemctl status cloudflared

6.2 测试 Zero-Trust 登录

1. 清除浏览器缓存
2. 访问应用
3. 验证登录流程

6.3 测试安全性

测试直接访问（应该失败）

curl http://你的服务器IP:8080

检查安全头

curl -I https://clawdbot.yourdomain.com

常见问题详细解答

Q1: Tunnel 无法启动

可能原因和解决方案：

1. Tunnel ID 错误
2. 证书文件路径错误
3. 权限问题

Q2: DNS 解析失败

可能原因和解决方案：

1. DNS 记录未正确配置
2. DNS 传播延迟
3. 域名服务器未更改

Q3: 访问显示 502 Bad Gateway

可能原因和解决方案：

1. 服务未运行
2. 端口不正确
3. 服务只监听 localhost

Q4: Zero-Trust 登录后无法访问

可能原因和解决方案：

1. Tunnel 配置问题
2. ClawdBot 服务问题
3. Zero-Trust 配置问题

进阶配置（可选）

1. 多 Tunnel 负载均衡

在不同服务器上运行不同的 Tunnel。

2. 健康检查和自动故障转移

配置重试和超时。

3. 监控和告警

使用 Cloudflare Analytics。

4. 性能优化

启用 Cloudflare 缓存。

5. 安全加固

配置 WAF 规则。

部署完成

如果你已经完成了以上所有步骤，恭喜你！你已经成功部署了 ClawdBot，并通过 Cloudflare Tunnel 和 Zero-Trust 实现了安全访问。

部署检查清单

• Cloudflare 账户已注册
• 域名已添加到 Cloudflare
• Cloudflare Tunnel 已安装
• Tunnel 已创建并配置
• DNS 记录已配置
• ClawdBot 已安装并运行
• Zero-Trust 已启用
• 所有测试通过

后续维护

1. 定期更新
2. 备份配置
3. 监控告警
4. 定期审计

需要帮助？

1. 查看日志
2. 检查配置
3. 参考文档
   • Cloudflare Tunnel 官方文档
   • Cloudflare Zero Trust 文档