Cloudflare on heyaohua's Bloghttps://blog.heyaohua.com/tags/cloudflare/Recent content in Cloudflare on heyaohua's Blogheyaohua's Bloghttps://blog.heyaohua.com/og-image.pnghttps://blog.heyaohua.com/og-image.pngHugozh-cnThu, 09 Oct 2025 12:30:00 +0800Dify + Cloudflare Tunnel 部署指南https://blog.heyaohua.com/posts/2025/10/dify-cloudflare-tunnel-deployment/Thu, 09 Oct 2025 12:30:00 +0800https://blog.heyaohua.com/posts/2025/10/dify-cloudflare-tunnel-deployment/本指南详细介绍如何使用 Docker 部署 Dify，并通过 Cloudflare Tunnel 实现安全的外网访问。本指南详细介绍如何使用 Docker 部署 Dify，并通过 Cloudflare Tunnel 实现安全的外网访问。

前置条件

  • macOS 系统
  • 已安装 Docker 和 Docker Compose
  • 拥有 Cloudflare 账户
  • 拥有一个域名并托管在 Cloudflare

第一步：部署 Dify

1.1 克隆 Dify 仓库

cd /Users/heyaohua/Server
git clone https://github.com/langgenius/dify.git
cd dify/docker

1.2 配置环境变量

# 复制环境变量模板
cp .env.example .env

# 编辑环境变量文件
vim .env

关键配置项：

  • SECRET_KEY: 生成一个安全的密钥
  • DB_USERNAME, DB_PASSWORD: 数据库用户名和密码
  • REDIS_PASSWORD: Redis 密码

1.3 启动 Dify 服务

# 启动所有服务
docker-compose up -d

# 检查服务状态
docker-compose ps

确保以下服务正常运行：

  • docker-nginx-1: 端口 80, 443
  • docker-api-1: 端口 5001
  • docker-web-1: 端口 3000
  • docker-plugin_daemon-1: 端口 5003

第二步：安装 Cloudflare Tunnel

2.1 安装 cloudflared

# 使用 Homebrew 安装
brew install cloudflared

2.2 登录 Cloudflare

cloudflared tunnel login

这会打开浏览器，选择要使用的域名进行授权。

第三步：创建和配置 Tunnel

3.1 创建 Tunnel

# 创建名为 dify-tunnel 的隧道
cloudflared tunnel create dify-tunnel

记录返回的 Tunnel ID，例如：e5e75674-d270-4201-ab9e-ea858c091d91

3.2 创建配置文件

在 Dify docker 目录下创建 config.yaml：

tunnel: e5e75674-d270-4201-ab9e-ea858c091d91
credentials-file: /Users/heyaohua/.cloudflared/e5e75674-d270-4201-ab9e-ea858c091d91.json

ingress:
  - hostname: dify.yourdomain.com
    service: http://127.0.0.1:80
  - service: http_status:404

重要说明：

  • 将 tunnel 值替换为你的实际 Tunnel ID
  • 将 credentials-file 路径中的 ID 替换为你的实际 Tunnel ID
  • 将 dify.yourdomain.com 替换为你的实际域名

3.3 配置 DNS 记录

# 为域名创建 DNS 记录（如果不存在）
cloudflared tunnel route dns dify-tunnel dify.yourdomain.com

如果提示记录已存在，可以跳过此步骤。

第四步：测试 Tunnel 连接

4.1 手动测试

# 设置 DNS 解析并启动隧道
cd /Users/heyaohua/Server/Dify/docker
GODNS=1.1.1.1 cloudflared tunnel --config config.yaml run

4.2 验证连接

在浏览器中访问 https://dify.yourdomain.com，确认可以正常访问 Dify 界面。

第五步：配置系统服务（后台运行）

5.1 安装基础服务

cloudflared service install

5.2 创建自定义服务配置

创建 com.cloudflare.cloudflared.plist 文件：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
        <dict>
                <key>Label</key>
                <string>com.cloudflare.cloudflared</string>
                <key>ProgramArguments</key>
                <array>
                        <string>/opt/homebrew/bin/cloudflared</string>
                        <string>tunnel</string>
                        <string>--config</string>
                        <string>/Users/heyaohua/Server/Dify/docker/config.yaml</string>
                        <string>run</string>
                </array>
                <key>RunAtLoad</key>
                <true/>
                <key>StandardOutPath</key>
                <string>/Users/heyaohua/Library/Logs/com.cloudflare.cloudflared.out.log</string>
                <key>StandardErrorPath</key>
                <string>/Users/heyaohua/Library/Logs/com.cloudflare.cloudflared.err.log</string>
                <key>KeepAlive</key>
                <dict>
                        <key>SuccessfulExit</key>
                        <false/>
                </dict>
                <key>ThrottleInterval</key>
                <integer>5</integer>
                <key>EnvironmentVariables</key>
                <dict>
                        <key>GODNS</key>
                        <string>1.1.1.1</string>
                </dict>
        </dict>
</plist>

注意： 将配置文件路径替换为你的实际路径。

5.3 安装和启动服务

# 复制配置文件到 LaunchAgents 目录
cp com.cloudflare.cloudflared.plist /Users/heyaohua/Library/LaunchAgents/

# 卸载旧服务（如果存在）
launchctl unload /Users/heyaohua/Library/LaunchAgents/com.cloudflare.cloudflared.plist

# 加载新服务
launchctl bootstrap gui/$(id -u) /Users/heyaohua/Library/LaunchAgents/com.cloudflare.cloudflared.plist

5.4 验证服务状态

# 检查服务是否运行
launchctl list | grep cloudflared

# 查看服务日志
tail -f /Users/heyaohua/Library/Logs/com.cloudflare.cloudflared.err.log

服务管理命令

启动服务

launchctl bootstrap gui/$(id -u) /Users/heyaohua/Library/LaunchAgents/com.cloudflare.cloudflared.plist

停止服务

launchctl bootout gui/$(id -u) /Users/heyaohua/Library/LaunchAgents/com.cloudflare.cloudflared.plist

查看服务状态

launchctl list | grep cloudflared

查看实时日志

# 查看输出日志
tail -f /Users/heyaohua/Library/Logs/com.cloudflare.cloudflared.out.log

# 查看错误日志
tail -f /Users/heyaohua/Library/Logs/com.cloudflare.cloudflared.err.log

故障排除

1. DNS 解析问题

如果遇到 DNS 解析错误：

# 临时使用 Cloudflare DNS
GODNS=1.1.1.1 cloudflared tunnel --config config.yaml run

2. 端口冲突

确保本地 80 端口没有被其他服务占用：

# 检查端口占用
lsof -i :80

# 检查 Docker 服务状态
docker-compose ps

3. 权限问题

确保 cloudflared 有足够的权限访问配置文件和日志目录。

4. 服务无法启动

检查配置文件路径是否正确，Tunnel ID 是否匹配。

安全建议

  1. 定期更新: 保持 Dify 和 cloudflared 为最新版本
  2. 访问控制: 在 Cloudflare 控制台配置访问策略
  3. 监控日志: 定期检查服务日志，监控异常访问
  4. 备份配置: 备份重要的配置文件和数据库

总结

完成以上步骤后，你将拥有：

  • ✅ 完全部署的 Dify 服务
  • ✅ 通过 HTTPS 的安全外网访问
  • ✅ 自动启动的后台服务
  • ✅ 完整的日志记录和监控

现在你可以通过 https://dify.yourdomain.com 安全地访问你的 Dify 服务，无需担心服务器重启或网络中断的问题。

创建时间: 2025年10月9日 适用版本: Dify latest, cloudflared 2025.9.1 系统要求: macOS with Docker

]]>Cloudflare R2 与 rclone 使用教程https://blog.heyaohua.com/posts/2024/07/cloudflare-r2-rclone-guide/Wed, 03 Jul 2024 10:00:00 +0800https://blog.heyaohua.com/posts/2024/07/cloudflare-r2-rclone-guide/Cloudflare R2 是 Cloudflare 提供的对象存储服务，类似于 AWS S3，但无出站流量费用，非常适合存储和分发图片、视频等静态资源。rclone 是一个命令行工具，可以用来管理云存储，包括 Cloudflare R2。本教程将指导您如何使用 rclone 配置和管理 Cl...1. 简介

Cloudflare R2 是 Cloudflare 提供的对象存储服务，类似于 AWS S3，但无出站流量费用，非常适合存储和分发图片、视频等静态资源。rclone 是一个命令行工具，可以用来管理云存储，包括 Cloudflare R2。本教程将指导您如何使用 rclone 配置和管理 Cloudflare R2 存储。

2. 准备工作

2.1 安装 rclone

macOS (使用 Homebrew):

brew install rclone

Linux:

curl https://rclone.org/install.sh | sudo bash

Windows:

  • 下载安装程序：https://rclone.org/downloads/
  • 运行安装程序并按照提示操作

2.2 获取 Cloudflare R2 凭证

  1. 登录 Cloudflare 控制台：https://dash.cloudflare.com/
  2. 选择「R2」服务
  3. 点击「管理 R2 API 令牌」或「创建 API 令牌」
  4. 创建新的 API 令牌，确保具有读写权限
  5. 记录生成的 Access Key ID 和 Secret Access Key
  6. 记录您的 Cloudflare 账户 ID（在 Cloudflare 控制台右侧边栏可以找到）

3. 配置 rclone

3.1 基本配置

  1. 打开终端或命令提示符，运行：
rclone config

选择 n 创建新的远程配置

输入远程配置名称，例如 cloudflare

选择存储类型，输入 s3 对应的编号

选择 S3 提供商，输入 Cloudflare R2 对应的编号

输入 Access Key ID

输入 Secret Access Key

输入区域，可以直接按 Enter 使用默认值 auto

输入端点 URL，格式为：https://<ACCOUNT_ID>.r2.cloudflarestorage.com

将 <ACCOUNT_ID> 替换为您的 Cloudflare 账户 ID

当询问是否要编辑高级配置时，选择 y（是）

3.2 高级配置

在高级配置中，重点关注以下参数：

force_path_style：设置为 true（这对 Cloudflare R2 很重要）

upload_cutoff：控制切换为分块上传的文件大小阈值

  1. 默认值为 200MiB，适用于大多数情况
  2. 如果主要上传小文件，可以提高到 500MiB

如果有大文件或网络不稳定，可以降低到 50-100MiB

chunk_size：分块上传时的块大小，默认为 5MiB

max_upload_parts：分块上传的最大块数，默认为 10000

其他参数可以保持默认值

完成配置后，选择 y 保存配置。

4. 使用 rclone 管理 R2 存储

4.1 创建存储桶

在 Cloudflare 控制台中创建存储桶：

  1. 进入 R2 服务页面
  2. 点击「创建存储桶」
  3. 输入存储桶名称，例如 images
  4. 点击「创建」

4.2 基本操作命令

列出存储桶:

rclone lsd cloudflare:

列出存储桶中的文件:

rclone ls cloudflare:存储桶名

上传单个文件:

rclone copy 本地文件路径 cloudflare:存储桶名/目标路径

上传整个目录:

rclone copy 本地目录路径 cloudflare:存储桶名/目标路径

同步目录（将删除目标中不存在于源的文件）:

rclone sync 本地目录路径 cloudflare:存储桶名/目标路径

下载文件:

rclone copy cloudflare:存储桶名/文件路径 本地目录路径

删除文件:

rclone delete cloudflare:存储桶名/文件路径

删除目录:

rclone purge cloudflare:存储桶名/目录路径

4.3 高级操作

使用 --dry-run 预览操作:

rclone sync 本地目录路径 cloudflare:存储桶名/目标路径 --dry-run

设置并行传输数:

rclone copy 本地目录路径 cloudflare:存储桶名/目标路径 --transfers=4

显示传输进度:

rclone copy 本地目录路径 cloudflare:存储桶名/目标路径 -P

设置带宽限制:

rclone copy 本地目录路径 cloudflare:存储桶名/目标路径 --bwlimit=10M

5. 配置 R2 公共访问与 CDN

5.1 设置公共访问权限

  1. 在 Cloudflare 控制台中，进入 R2 服务页面
  2. 选择您的存储桶
  3. 点击「设置」选项卡
  4. 在「公共访问」部分，选择「公开可读」

5.2 配置自定义域名

  1. 在 Cloudflare 控制台中，进入 R2 服务页面
  2. 选择您的存储桶
  3. 点击「设置」选项卡
  4. 在「公共访问」部分，点击「添加自定义域」
  5. 输入您想要使用的域名，例如 images.example.com
  6. 按照提示完成 DNS 配置

5.3 在网站中使用 R2 资源

配置完成后，您可以通过以下方式在网站中引用 R2 中的资源：

// 使用 R2 默认域名
const imagePath = `https://<ACCOUNT_ID>.r2.cloudflarestorage.com/存储桶名/文件路径`;

// 使用自定义域名
const imagePath = `https://images.example.com/文件路径`;

6. 维护与最佳实践

6.1 定期同步

设置定期同步任务，确保本地和 R2 存储保持一致：

创建定时任务 (cron job):

# 编辑 crontab
crontab -e

# 添加定时任务，每天凌晨 2 点执行同步
0 2 * * * rclone sync /本地路径 cloudflare:存储桶名/目标路径 --log-file=/path/to/logfile.log

6.2 监控与日志

使用 --log-file 参数记录操作日志：

rclone sync /本地路径 cloudflare:存储桶名/目标路径 --log-file=/path/to/logfile.log

6.3 修改现有配置

如果需要修改已有的 rclone 配置：

  1. 运行 rclone config
  2. 选择 e 编辑现有远程配置
  3. 选择要修改的配置名称
  4. 按照提示修改相应参数
  5. 完成后保存配置

7. 故障排除

7.1 常见错误

连接错误:

  • 检查账户 ID 是否正确
  • 确认 API 密钥是否有效
  • 验证网络连接是否正常

权限错误:

  • 确认 API 令牌具有适当的权限
  • 检查存储桶访问策略

上传失败:

  • 尝试减小 chunk_size 和 upload_cutoff 值
  • 使用 -v 参数查看详细日志

7.2 调试命令

# 检查配置
rclone config show cloudflare

# 详细日志
rclone copy 本地文件路径 cloudflare:存储桶名/目标路径 -v

# 非常详细的日志
rclone copy 本地文件路径 cloudflare:存储桶名/目标路径 -vv

8. 结语

通过本教程，您已经学会了如何使用 rclone 配置和管理 Cloudflare R2 存储。R2 结合 Cloudflare 的 CDN 网络，可以为您的网站提供高性能、低成本的静态资源存储和分发解决方案，特别适合图片、视频等大文件的存储和全球分发。

本文档基于实际配置经验编写，适用于需要将静态资源从本地服务器迁移到 Cloudflare R2 的网站管理员和开发者。

]]>