前期准备

在开始部署 CloudFlare ImgBed 之前，您需要根据要使用的存储渠道进行相应的准备工作。

1. 渠道说明

项目支持使用不同的存储渠道作为后端存储，每种渠道有不同的优缺点和限制，您可以根据自己的需求选择合适的渠道。

渠道类型	优点	限制
Telegram Bot	完全免费、无限容量	大于20MB文件需分片存储
Cloudflare R2	无文件大小限制、企业级性能	超出10G免费额度后收费，需要绑定支付方式
S3 兼容存储	选择多样、价格灵活	根据服务商定价
Discord	完全免费、简单易用	大于10MB文件需分片存储
HuggingFace	完全免费、支持大文件直传	需要 HuggingFace 账号
WebDAV	兼容性广、支持自建存储	根据服务商定价

2. Telegram Bot 渠道

2.1 获取 TG_BOT_TOKEN

在 Telegram 中搜索 @BotFather
发送 /newbot 命令
按提示输入 Bot 名称和用户名
获得 Bot Token（格式：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

2.2 获取 TG_CHAT_ID

创建一个新的 Telegram 频道（Channel）
将创建的 Bot 添加为频道管理员
给予 Bot 消息管理的权限

在频道中发送一条测试消息
向 @VersaToolsBot 转发这条消息
获得频道 ID（示例：-1001234567890）

注意

频道 ID 前面有 - 号时需要保留
Bot 必须具有频道管理员权限

3. Cloudflare R2 渠道

3.1 创建 R2 存储桶

登录 Cloudflare Dashboard
选择 "R2 存储对象"

点击 "创建存储桶"
输入存储桶名称（全局唯一）
选择存储区域
点击 "创建存储桶"

3.2 配置公开访问（可选）

如果需要启用图像审查功能：

进入创建的存储桶
选择 "Settings" → "Public access"
启用 "Allow Access" 或配置自定义域名
记录完整公开访问链接（如 https://your-bucket.r2.cloudflarestorage.com/）

4. S3 兼容存储

4.1 支持的服务商

服务商	地区	特点
Amazon S3	全球	最原始的 S3 服务
七牛云	中国	国内访问速度快
又拍云	中国	CDN 加速
Backblaze B2	美国	价格便宜
Cloudflare R2	全球	与 Cloudflare 生态集成
MinIO	全球	开源 S3 兼容存储

提示

以上为经过测试的 S3 兼容存储服务商，其他 S3 兼容服务商未经测试，有概率出现兼容问题。

4.2 需要准备的信息

S3_ACCESS_KEY_ID：访问密钥 ID
S3_SECRET_ACCESS_KEY：私有访问密钥
S3_BUCKET_NAME：存储桶名称
S3_ENDPOINT：服务端点 URL
S3_REGION：存储区域（可选）

5. Discord 渠道（由 @林酱佬贡献）

5.1 创建 Discord Bot

访问 Discord Developer Portal
点击 "New Application" 创建应用
进入 "Bot" 页面，点击 "Add Bot"
复制 Bot Token

5.2 获取 Channel ID

在 Discord 客户端中启用开发者模式（用户设置 → 高级 → 开发者模式）
创建一个用于存储文件的频道
右键点击频道，选择 "复制频道 ID"
将 Bot 添加到服务器并授予发送文件的权限

注意

普通用户文件大小限制为 10MB
Nitro 用户文件大小限制为 25MB
需要确保 Bot 有发送消息和附件的权限
Discord 官方有接口频率限制，不建议将此渠道用作大规模并发场景

6. HuggingFace 渠道（由 @林酱佬贡献）

6.1 创建 HuggingFace 账号

访问 HuggingFace 并注册账号

6.2 获取 Access Token

登录后访问 Token 设置页面
点击 "New token" 创建新 Token
选择 "Write" 权限
复制生成的 Token

提示

HuggingFace 渠道支持大文件直传，推荐用于上传超过 20MB 的文件。

7. WebDAV 渠道

WebDAV 渠道允许您使用任何支持 WebDAV 协议的存储服务作为后端存储，例如 Nextcloud、Alist、坚果云等。

7.1 需要准备的信息

WebDAV 基础地址：WebDAV 服务的完整 URL（如 https://dav.example.com/remote.php/dav/files/user/imgbed/）
用户名：（可选）WebDAV 认证用户名
密码：（可选）WebDAV 认证密码
公开访问链接：（可选）如果 WebDAV 存储有对应的公开 HTTP/CDN 地址，配置后服务端支持直接从该地址读取文件
自定义请求头：（可选）额外的 HTTP 请求头，JSON 格式

提示

WebDAV 渠道兼容性广泛，适合已有 WebDAV 存储服务的用户。

前期准备 ​

1. 渠道说明 ​

2. Telegram Bot 渠道 ​

2.1 获取 TG_BOT_TOKEN ​

2.2 获取 TG_CHAT_ID ​

3. Cloudflare R2 渠道 ​

3.1 创建 R2 存储桶 ​

3.2 配置公开访问（可选） ​

4. S3 兼容存储 ​

4.1 支持的服务商 ​

4.2 需要准备的信息 ​

5. Discord 渠道（由 @林酱 佬贡献） ​

5.1 创建 Discord Bot ​

5.2 获取 Channel ID ​

6. HuggingFace 渠道（由 @林酱 佬贡献） ​

6.1 创建 HuggingFace 账号 ​

6.2 获取 Access Token ​

7. WebDAV 渠道 ​

7.1 需要准备的信息 ​

🚀 下一步 ​