Cloudflare Pages 配置说明 _ CloudFlare ImgBed

本章节详细介绍 CloudFlare ImgBed 的各种配置选项和自定义设置。

🗂️ 存储渠道配置 ​

部署完成后访问您的域名，进入管理后台配置存储渠道。

访问管理后台 ​

访问 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 搭建简单的代理服务：

javascript

// worker.js
export default {
    async fetch(request) {
        const url = new URL(request.url);
        const target = `https://api.telegram.org${url.pathname}${url.search}`;
        const resp = await fetch(target, {
            method: request.method,
            headers: request.headers,
            body: request.body,
            redirect: 'follow'
        });
        return new Response(resp.body, {
            status: resp.status,
            headers: resp.headers
        });
    }
};

部署此 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 认证
• 管理端认证： 管理员用户名和密码，用于访问管理后台

上传管理 ​

图像审查 ​

审查渠道支持 nsfwjs 和 moderatecontent.com，可根据如下步骤自行配置。

1.moderatecontent.com ​

• 访问 ModerateContent
• 注册并获取免费 API Key（目前已不再支持免费注册）
• 在管理后台 "系统设置" → "安全设置" 中填入 API Key

2.nsfwjs ​

• 使用 Docker 部署 nsfwjs 审查服务

bash

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

• 在管理后台 "系统设置" → "安全设置" 中填入审查服务地址，如 https://nsfwjs.your.domain

访问管理 ​

• 域名过滤
  • 放行域名：允许访问的域名列表（留空放行所有域名，否则需要手动添加图床自身域名）
• 白名单模式：启用后仅允许加入白名单的文件被访问

🌐 网页设置 ​

前端网页相关设置，在管理后台的 "系统设置" → "网页设置" 中配置

🛠️ 其他设置 ​

其他设置项，在管理后台的 "系统设置" → "其他设置" 中配置

远端遥测 ​

便于开发者进行 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
• 指定渠道名：当选择的上传渠道有多个配置时，可指定具体使用哪个渠道名称进行上传

🔧 环境变量清单 ​

注意

环境变量设置方式在 v2.0 版本后已废弃，以下配置请在管理后台进行。

基础认证配置

存储渠道配置

Telegram 渠道

功能开关配置

安全配置

CDN 缓存配置

源自：

配置说明 | CloudFlare ImgBed

Tag： #图床 #Telegram #CloudFlare