功能总览

本文介绍 Cloud Blox 的主要功能，并索引各模块的详细使用教程。

产品概述

Cloud Blox 提供对象存储与文件管理能力，支持将文件存储到多种后端（本地、云存储等），并通过管理后台、S3 协议、WebDAV 协议或绑定域名访问。支持计费、插件扩展、内容审核、通知与媒体处理。

管理后台

• 通过浏览器访问管理端，完成用户与权限、存储桶与文件、存储通道、系统配置等管理。
• 提供登录、验证码、注册与找回密码等认证能力。
• 支持菜单、角色、部门、字典等系统配置。
• 支持社交账号登录（第三方登录绑定）。

存储与上传

• 多通道存储：可配置多种存储后端（如本地、S3 兼容、云厂商对象存储、网盘等），按存储桶分配通道。
• 统一上传：管理端与 S3 协议的上传均先写入临时目录，经校验后由后台任务异步同步到所选通道，支持大文件与分片上传。
• TUS 分片上传：管理端支持 TUS 协议的可恢复分片上传，断点续传更可靠。
• 删除与回收站：支持软删除（回收站）与硬删除，删除时由后台任务按引用计数清理物理文件。
• 对象到期：支持为文件设置过期时间，到期后由定时任务自动删除。

S3 兼容 API

• 提供与 S3 兼容的接口，便于使用标准 S3 客户端或 SDK 上传、下载、列举、删除对象。
• 支持 AWS Signature V4 认证与预签名 URL。
• 支持分片上传、对象复制、桶 ACL（私有 / 公有读 / 公有读写）等常用能力。

WebDAV 协议

• 提供标准 WebDAV 协议接入，支持按存储桶创建 WebDAV 账号。
• 兼容主流 WebDAV 客户端（如 RaiDrive、Cyberduck、macOS Finder、rclone 等）直接挂载访问。
• 支持目录列表、文件上传下载、创建目录、复制、移动、删除等操作。
• 支持只读账号和路径限制。
• 提供 WebDAV 操作日志查看。

资源访问与媒体处理

• 通过绑定域名访问存储桶内的文件，支持自定义域名与 HTTPS。
• CDN 加速（商业版）：支持接入第三方 CDN 通道（如阿里云 ESA），为绑定域名提供 CDN 加速、SSL 证书托管。
• DNS 检测：提供 DNS 记录检测工具，可一键检测域名验证 TXT、证书验证 TXT、CNAME 等记录是否已正确配置。
• 支持图片处理（缩放、裁剪、水印、格式转换等）与音视频处理（转码、截帧等），按处理次数或时长计费。

计费

• 按用量日结算，支持容量、上传/出口/回源流量、请求次数、图片/视频/音频处理、图片/视频/音频审核等指标。
• 支持阶梯定价、套餐、资源包与用户钱包，管理端可查看账单与计费明细。
• 支持充值、订单管理、余额扣费与资源包抵扣。

插件扩展

存储插件

扩展多种存储后端，目前内置以下存储类型：

类型	说明
本地存储	将文件保存在服务器本机磁盘
AWS S3	兼容 S3 协议的对象存储（AWS、MinIO、各云厂商 S3 接口等）
又拍云 USS	又拍云对象存储
天翼云盘 PC	天翼云盘 PC 版存储
FTP	通过 FTP 协议写入远程服务器
SFTP	通过 SFTP 协议写入远程服务器
WebDAV	通过 WebDAV 协议写入支持 WebDAV 的存储
夸克网盘	夸克网盘对接
蓝奏云	蓝奏云对接
UC 网盘	UC 网盘对接
QQ 邮箱文件中转站	QQ 邮箱文件中转站对接
支付宝云存储	支付宝云存储对接
HuggingFace	HuggingFace 仓库存储

实际可选类型以管理后台「通道管理 → 新增」中的列表为准。

审核插件

对接内容审核服务，目前支持：

插件	说明
阿里云内容安全	阿里云绿网内容审核（图片、视频、音频）
大模型视觉审核	基于 LLM 视觉模型的内容审核

CDN 插件

对接第三方 CDN 服务，目前支持：

插件	说明
阿里云 ESA	阿里云边缘安全加速（SaaS 模式）

通知插件

对接多种通知渠道，统一管理通知发送，目前支持：

插件	说明
钉钉机器人	钉钉群机器人 Webhook 通知
飞书机器人	飞书群机器人 Webhook 通知
企业微信机器人	企业微信群机器人 Webhook 通知
SMTP 邮件	通用 SMTP 邮件发送
阿里云邮件推送	阿里云 DirectMail 邮件发送
阿里云短信	阿里云短信服务
腾讯云短信	腾讯云短信服务

支付插件

对接支付渠道，支持充值与资源包购买。

定时任务

系统内置多种定时任务，自动执行后台运维操作：

任务	周期	说明
统计刷新	每 5 分钟	刷新存储桶和通道的存储统计信息
区域健康检查	每分钟	检测所有区域端点的连通性和延迟（仅主节点）
节点指标上报	每分钟	采集 CPU/内存/磁盘/网络等指标写入 ClickHouse
用量快照采集	每小时	从 MySQL 和 ClickHouse 采集用量数据
日结算	每小时（凌晨 3 点起）	每日凌晨结算前一日费用
资源包过期检查	每小时	检查并标记过期资源包
对象到期自动删除	每小时	删除已设置到期时间且已到期的对象
临时文件清理	每 5 分钟	清理异步上传的临时分片文件
副本备份	每 5 分钟	将待备份文件复制到副本通道
数据迁移	每分钟	执行 S3 数据迁移任务
队列孤儿任务恢复	每 15 分钟	恢复长时间处于执行中但丢失的任务
ClickHouse 日志 TTL 同步	按配置	同步日志保留期限
MySQL 日志清理	按配置	清理操作日志、登录日志等历史记录

新增插件时，系统会自动发现并加载。

系统总览与监控

• 节点资源监控：实时展示所有节点的 CPU、内存、磁盘、网络、负载等系统资源使用情况。
• 业务统计：今日与昨日对比、环比变化、多维趋势图表（注册、存储桶、对象、请求、流量等）。
• 多节点视图：多节点部署时自动采集所有区域节点的运行状态，离线节点有明确标识。
• 历史指标：最多 30 天的节点 CPU/内存/磁盘/网络历史趋势图表。
• 存储概况：通道数、存储桶数、对象总数、容量使用情况一览。
• 队列状态：各异步任务队列的待处理任务数实时展示。
• 流量统计：今日请求数、上传/访问/删除次数、流量统计与 24 小时趋势图。

缓存管理

• 查看系统各类内存缓存（区域配置、存储桶元数据、域名解析、访问控制等）的状态与 TTL。
• 支持手动失效指定类型的缓存，跨节点缓存通过 Redis 发布订阅同步失效。

内容审核

• 对接内容审核服务，对上传的图片、视频、音频进行安全审核。
• 支持多个审核通道（阿里云内容安全、大模型视觉审核等），按存储桶配置审核策略。
• 提供审核记录查询与统计，支持人工复审。
• 审核按图片/视频/音频分别计费。

通知管理

• 对接多种通知渠道（钉钉、飞书、企业微信、邮件、短信等），统一管理通知发送。
• 支持配置通知触发事件（如任务失败、审核结果、资源包到期等）。
• 提供发送记录查询与状态追踪。

支付系统

• 对接支付渠道，支持用户充值和资源包购买。
• 管理端可查看支付订单、配置支付通道与路由规则。

区域与多节点

• 支持配置多个区域节点，实现跨区域存储与访问。
• 区域健康检查自动监测各节点状态。
• 支持跨区域请求转发。
• 区域支持域名配置（CDN 通道绑定、强制 CDN、ICP 备案要求等）。

数据迁移

• 支持从 S3 兼容存储源批量迁移数据到本平台。
• 提供迁移任务管理，支持暂停、恢复、重试。
• 可按前缀筛选需要迁移的文件，支持跳过已存在文件、单文件大小限制等策略。
• 支持配置迁移时间窗口。

其他能力

• 回源：可配置回源规则，支持异步回源、同步回源和重定向三种模式，从指定源站拉取文件并写入存储。
• 存储桶备份：支持将存储桶数据备份到 S3 兼容存储（其他区域、MinIO 等），支持按前缀/后缀过滤、同步删除。
• 副本通道（商业版）：多副本冗余存储，自动将文件复制到副本通道。
• 访问控制：支持防盗链（Referer / UA / IP 黑白名单）、读写权限（公开读 / 私有读）。
• 限速限流（商业版）：上传/下载限速限流。
• CORS：按存储桶配置跨域资源共享规则。
• 对象到期：支持为文件设置过期时间，到期后由定时任务自动删除。
• 资源包：管理端创建资源包模板，用户可购买资源包获取额外用量额度。
• 首页模板：支持自定义首页模板，包含布局、页面、静态资源与文档中心。
• 日志：存储桶访问日志、通道操作日志、计费事件等可写入 ClickHouse 便于分析；支持外部日志接入。
• 系统版本：系统配置中展示版本信息、运行环境、更新日志与文档链接，支持一键检测更新。

详细教程索引

模块	文档	说明
入门	版本对比	免费版、商业版、源码版区别与选择
入门	安装教程	环境、脚本安装与首次使用
入门	后台管理入门	登录、界面、菜单与角色
对象存储	存储桶与文件	创建桶、文件管理、上传、回收站、绑定域名、回源、存储桶备份、访问控制、CORS、数据迁移、WebDAV、日志、密钥、媒体处理
系统管理	权限管理	用户、角色、菜单、部门、字典
系统管理	通道管理	存储通道新增、编辑、下线与容量管理
系统管理	存储插件	存储类型一览与配置说明
系统管理	CDN 通道	CDN 通道与域名加速配置
系统管理	存储管理	通道、副本通道、存储桶、区域、套餐、资源包
系统管理	运维与审核通知	系统总览、任务、队列、定时任务、系统配置、公告、消息、计费明细、审核、通知、缓存管理
系统管理	日志与支付	登录记录、操作日志、发送记录、支付订单、支付配置
用户端	计费管理	账单中心、我的钱包、收支明细、价格与优惠、我的资源包、订单记录
协议与访问	S3 协议	实现的 S3 API、端点与认证、存储桶与对象、分片上传、跨区域与权限
协议与访问	WebDAV 协议	开通、账号、连接地址、客户端、日志
扩展	首页模板开发	概述与快速开始、目录结构、config 与 routes、布局与页面、模板数据与函数、静态资源与文档中心、开发与部署流程