# 云存储上传插件

## 插件说明

`xn_oss_upload` 是一款专为 **XiunoBBS 论坛系统** 开发的文件上传插件，支持将论坛附件、头像、编辑器内图片等内容上传至多种主流云存储服务，包括：

- Cloudflare R2
- 阿里云 OSS
- 七牛云对象存储
- 腾讯云 COS
- 本地存储（可选保留）

通过接入云服务，本插件可帮助站长减轻服务器负担、提高访问速度、提升用户体验。

## ✅ 适用场景

该插件适用于以下场景：

- 使用轻量 VPS 或本地存储空间有限的论坛站点
- 需要将头像、附件、编辑器图片统一上传至云存储的论坛
- 希望提升资源访问速度并配合 CDN 实现文件加速
- 拓展多云兼容性，便于未来更换或集成更多云服务

---

## ✨ 功能列表

- 多云存储支持：Cloudflare R2、七牛云、阿里 OSS、腾讯云 COS
- 支持上传类型：头像、附件、编辑器图片
- 自动区分不同文件类型路径
- 云端文件访问链接自动替换
- 可选切换至本地存储
- 简洁配置，快速部署

---

## 安装说明

1. 下载插件压缩包
2. 解压到 `plugin` 目录
3. 在后台插件中心启用插件
4. 配置授权信息和存储设置

## 使用说明

### 存储服务配置说明

#### 七牛云配置

- AccessKey：七牛云账号的 AccessKey
- SecretKey：七牛云账号的 SecretKey
- Bucket：存储空间名称
- 域名：访问域名，需要带 https://或 http://

#### 阿里云 OSS 配置

- AccessKeyId：阿里云账号的 AccessKeyId
- AccessKeySecret：阿里云账号的 AccessKeySecret
- Endpoint：地域节点地址
- Bucket：存储空间名称
- 域名：访问域名，需要带 https://或 http://

#### 腾讯云 COS 配置

- SecretId：腾讯云账号的 SecretId
- SecretKey：腾讯云账号的 SecretKey
- Region：地域信息
- Bucket：存储空间名称
- 域名：访问域名，需要带 https://或 http://

#### Cloudflare R2 配置

- AccountId：Cloudflare 账号 ID
- AccessKeyId：R2 的 AccessKeyId
- AccessKeySecret：R2 的 AccessKeySecret
- Bucket：存储空间名称
- 域名：访问域名，需要带 https://或 http://

## 常见问题

1. 上传失败

   - 检查存储服务配置是否正确
   - 确认存储空间是否有足够权限
   - 查看服务器错误日志获取详细信息

2. 文件无法访问
   - 检查域名配置是否正确
   - 确认域名是否已备案（国内服务商要求）
   - 检查存储空间访问权限设置

## 技术支持

• 作者：Surile
• QQ：51414792
• 邮箱：mhecy98@gmail.com

加入单版本支持

售价：66

完整版目前也就支持两家服务（Cloudflare R2、七牛云）

售价：120

请勿盲目购买，根据自身需求在购买