📂 第一步：Fork 项目#

1. 访问 CloudFlare ImgBed 项目
2. 点击右上角的 “Fork” 按钮
3. 选择您的 GitHub 账户
4. 确认 Fork 完成

🏗️ 第二步：创建 Pages 项目#

🗄️ 第三步：配置数据库#

数据库用于存储文件元数据，是必需的组件，可选数据库为 KV 数据库和 D1 数据库。两者对比如下表所示，根据自己使用场景从其中选择一种配置即可。

重要提示 KV 数据库和 D1 数据库只需要配置其中一个即可，不需要同时配置两个！建议根据上表选择适合自己的数据库类型。

🔄 第四步：重新部署#

绑定数据库后需要重新部署以生效：

1. 进入项目的「部署」页面
2. 找到最新的部署记录
3. 点击右侧的「…」菜单
4. 选择「重试部署」
5. 等待部署完成

访问管理后台#

访问 https://your-domain/dashboard

提示 管理后台默认无需密码，登录后请及时设置管理员用户名和密码。

配置 Telegram 渠道#

1. 左上角菜单栏进入「系统设置」→「上传设置」
2. 找到「Telegram 渠道配置」
3. 点击「添加渠道」
4. 填入准备好的 Token 和 Chat ID：
   • 渠道名称：自定义名称（如：主渠道）
   • Bot Token：从 @BotFather 获得的 Token
   • Chat ID：频道 ID（有 - 号时需要保留）
   • 代理 URL：（可选）自定义代理地址，用于代理 Telegram API 请求
   • 启用状态：开启
5. 点击「保存设置」

关于代理配置 如果您的服务器无法直接访问 Telegram API，可以配置代理 URL。您可以使用 Cloudflare Worker 搭建简单的代理服务：

1
export default {
2
    async fetch(request) {
3
        const url = new URL(request.url);
4
        const target = `https://api.telegram.org${url.pathname}${url.search}`;
5
        const resp = await fetch(target, {
6
            method: request.method,
7
            headers: request.headers,
8
            body: request.body,
9
            redirect: 'follow'
10
        });
11
        return new Response(resp.body, {
12
            status: resp.status,
13
            headers: resp.headers
14
        });
15
    }
16
};

部署此 Worker 后，将 Worker 地址填入代理 URL 字段即可。

配置 R2 渠道#

服务器部署时默认添加了 Cloudflare R2 存储方式，以下步骤仅针对 Cloudflare 部署方式：

1. 在项目设置中绑定 R2 存储桶：

   • 选择「设置」→「绑定」
   • 添加「R2 存储桶」
   • 变量名称：img_r2
   • R2 存储桶：选择已创建的存储桶

2. 在管理后台配置：

   • 进入「系统设置」→「上传设置」
   • 配置 R2 渠道参数
   • 如需图像审查，填入 R2 公开访问链接

注意 请注意 Cloudflare R2 的免费额度限制，超过后可能会产生费用。

配置 S3 渠道#

在管理后台的 S3 渠道配置中填入：

• Access Key ID：访问密钥 ID
• Secret Access Key：机密访问密钥
• Bucket Name：存储桶名称
• Endpoint：服务端点（完整 URL，如 https://s3.us-east-005.backblazeb2.com）
• PathStyle：路径样式（如需兼容旧 S3 版本，开启此选项）
• Region：存储区域（可选）
• CDN 域名：（可选）自定义 CDN 加速域名，设置后优先通过 CDN 读取文件

配置 Discord 渠道#

在管理后台的 Discord 渠道配置中填入：

• 渠道名称：自定义名称
• Bot Token：Discord Bot Token
• Channel ID：Discord 频道 ID
• Is Nitro：是否为 Nitro 用户（Nitro 用户单文件限制为 25MB，普通用户为 10MB）
• 代理 URL：（可选）自定义代理地址

配置 HuggingFace 渠道#

在管理后台的 HuggingFace 渠道配置中填入：

• 渠道名称：自定义名称
• Token：HuggingFace Access Token（从 https://huggingface.co/settings/tokens 获取）
• Repo：仓库名称（格式：username/repo-name，用户名须填写正确，会自动创建 dataset 类型仓库）
• Is Private：是否为私有仓库

提示 HuggingFace 渠道支持大文件直传，适合上传超过 20MB 的文件。对于大文件，系统会自动使用 LFS 协议进行分片上传。

认证管理#

• 用户端认证：用于 Web 端用户登录和 API 认证
• 管理端认证：管理员用户名和密码，用于访问管理后台

上传管理#

1
# 参考命令
2
docker run -d -p 127.0.0.1:5000:5000/tcp \
3
  --env PORT=5000 \
4
  --restart=always \
5
  eugencepoi/nsfw_api:latest

访问管理#

远端遥测#

便于开发者进行bug的捕捉和定位，但是过程中可能收集到访问链接、域名等信息，如您不愿意泄露类似信息给项目开发者，请在管理后台禁用此功能。

随机图像 API#

目录：开放随机图权限的目录，默认为根目录，多个目录用逗号分隔；目录均采用绝对路径，例如/img/cover，表示该目录及其所有子目录的文件可被随机图API访问。

访客图库#

允许未登录用户访问指定目录的文件，可用于创建公开图库或相册展示。

• 启用公开浏览：开启或关闭公开浏览功能
• 允许访问的目录：开放公开访问权限的目录，多个目录用逗号分隔；目录均采用绝对路径（可不写开头的/），例如/img/gallery,/img/wallpapers

提示 启用后，用户可通过 /browse/目录名 路径访问公开图库，例如 /browse/img/gallery

CloudFlare API Token#

正常情况下，因为CloudFlare CDN缓存的存在，在管理端进行删除、拉黑、加白名单等操作不会立即生效，需要等到缓存过期才能生效。为了让操作立即生效，建议设置此项：

• CF_ZONE_ID：绑定域名的 Cloudflare Zone ID 获取方法
• CF_EMAIL：Cloudflare 账户邮箱
• CF_API_KEY：Cloudflare Global API Key 获取方法

WebDAV#

WebDAV 服务相关设置，详细介绍和使用方式请查看 API 文档。

• 启用 WebDAV 服务：开启或关闭 WebDAV 服务
• 用户名：WebDAV 登录用户名
• 密码：WebDAV 登录密码
• 上传渠道：通过 WebDAV 上传文件时使用的存储渠道，支持 Telegram、Cloudflare R2、S3、Discord、HuggingFace
• 指定渠道名：当选择的上传渠道有多个配置时，可指定具体使用哪个渠道名称进行上传

基础认证配置#

存储渠道配置#

功能开关配置#

安全配置#

CDN 缓存配置#