功能总览

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

产品概述

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

管理后台

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

存储与上传

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

S3 兼容 API

• 提供与 S3 兼容的接口，便于使用标准 S3 客户端或 SDK 上传、下载、列举、删除对象。
• 支持分片上传等常用能力。

资源访问与媒体处理

• 通过绑定域名访问存储桶内的文件，支持自定义域名与 HTTPS。
• 支持图片处理（缩放、裁剪、水印、格式转换等）与音视频处理（转码、截帧等），按处理次数或时长计费。

计费

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

插件扩展

• 存储插件：扩展更多存储后端（如各类云存储、FTP、WebDAV 等）。
• 审核插件：对接内容审核服务（如图片/视频/音频审核）。
• 通知插件：对接钉钉、飞书、企业微信、邮件、短信等通知渠道。
• 支付插件：对接支付渠道，支持充值、资源包购买等。
• 定时任务：内置用量快照、日结算、清理等任务，可扩展更多定时任务。

新增插件时，在对应插件目录添加实现并注册即可，无需修改主程序入口。

其他能力

• 回源：可配置回源规则，从指定源站拉取文件并写入存储。
• 存储桶备份：支持将存储桶数据备份到其他区域或通道。
• 访问控制：支持防盗链、IP 黑白名单等。
• 日志：存储桶访问日志、通道操作日志、计费事件等可写入 ClickHouse 便于分析。

详细教程索引

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