存储插件介绍

本文介绍 Cloud Blox 中的存储插件是什么、系统支持哪些存储类型，以及在「通道管理」中如何选择与配置。面向运维与管理员，不涉及开发实现。

什么是存储插件

• 系统通过存储插件支持多种存储后端。每种插件对应一种存储类型，在「新增通道」时以类型形式出现在下拉列表中。
• 选择某类型后，通道配置表单会展示该类型所需的配置项（如路径、Endpoint、密钥、桶名等），由系统根据插件定义动态生成。
• 不同产品版本或部署可能启用不同的插件集合，实际可选类型以管理后台「通道管理 → 新增」中的列表为准。

存储类型一览

系统内置以下存储类型：

类型	说明	典型配置项
本地存储	将文件保存在服务器本机磁盘指定目录，适合单机或内网部署	存储路径
AWS S3	对接兼容 S3 协议的对象存储（如 AWS S3、MinIO、阿里云 OSS、腾讯云 COS 等），支持路径风格与虚拟主机风格	Endpoint、Access Key、Secret Key、桶名、区域
又拍云 USS	又拍云对象存储	操作员账号、密码、空间名
天翼云盘 PC	天翼云盘 PC 版存储	账号认证信息、目录配置
FTP	通过 FTP 协议写入远程服务器目录	主机、端口、用户名、密码、路径
SFTP	通过 SFTP 协议写入远程服务器目录，支持密钥认证	主机、端口、用户名、密码/密钥、路径
WebDAV	通过 WebDAV 协议写入支持 WebDAV 的存储或网盘	地址、用户名、密码、路径
夸克网盘	夸克网盘对接	账号认证信息、目录
蓝奏云	蓝奏云对接	账号认证信息、目录
UC 网盘	UC 网盘对接	账号认证信息、目录
QQ 邮箱文件中转站	QQ 邮箱文件中转站对接，利用邮箱附件空间存储文件	邮箱账号、认证信息
支付宝云存储	支付宝云存储对接	账号认证信息
HuggingFace	HuggingFace 仓库存储，适合 AI 模型与数据集文件	Token、仓库名、组织

具体类型列表以后台「新增通道」时下拉选项为准；部分类型可能受版本或授权控制。

在通道管理中如何选择

1. 进入 系统管理 → 存储管理 → 通道管理，点击「新增」。
2. 在「存储类型」下拉中选择要使用的类型（即对应一种存储插件）。
3. 表单会切换为该类型所需的配置项，按提示填写并保存。
4. 若提供「测试连接」按钮，建议保存前先测试，确保 Endpoint、密钥等正确。

配置项说明（通用概念）

不同存储类型的配置项不同，常见概念包括：

• 路径 / 存储目录：本地或远程文件存放的根路径。
• Endpoint / 地址：对象存储或 API 的服务地址（如 https://s3.xxx.com）。
• Access Key / Secret Key：对象存储或云服务的访问密钥与私钥。
• 桶名 / 空间名：对象存储中的桶或空间名称。
• 主机、端口、用户名、密码：FTP/SFTP/WebDAV 等协议所需的连接与认证信息。
• 区域（Region）：对象存储的区域标识，如 us-east-1、cn-hangzhou 等。
• 路径风格（Path Style）：S3 请求路径格式，关闭则使用虚拟主机风格。

具体字段含义以表单旁的说明或占位符为准；各类型要求的必填项不同，未填写完整时保存可能报错。

插件缓存

部分存储插件（如天翼云盘、蓝奏云、夸克网盘等）会缓存文件夹 ID 等稳定数据到内存和 Redis（若配置），以提升访问性能。系统重启后可从 Redis 自动恢复缓存。

注意事项

• 密钥与密码不要泄露；编辑通道时若未修改敏感项，系统通常保留原值。
• 使用云厂商或第三方存储时，请确认其计费、限速与可用性，避免影响业务。
• 部分类型对单文件大小、路径格式、并发等有限制，使用前可查阅产品说明或联系运维。
• 网盘类存储（天翼云盘、夸克、蓝奏云、UC 等）的稳定性和速度取决于网盘服务本身，建议用于非核心或低频场景。