# typecho插件_R2Storage

**Repository Path**: tz520/typecho-plugin-r2-storage

## Basic Information

- **Project Name**: typecho插件_R2Storage
- **Description**: 本插件为 Typecho 博客系统提供 Cloudflare R2 云存储对接功能，实现将图片、文件等附件直接存储至 R2 对象存储服务，释放服务器本地存储压力，同时借助 Cloudflare 全球 CDN 加速内容分发，提升网站访问速度与稳定性。  
- **Primary Language**: PHP
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-17
- **Last Updated**: 2025-05-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


### **Typecho 对接 Cloudflare R2 存储插件**  
#### **插件名称**：Cloudflare R2 存储  
#### **作者**：特控  
#### **版本**：1.0.0  
#### **适用平台**：Typecho 1.2+  
#### **项目地址**：[https://tj.tz520.cc](https://tj.tz520.cc)  


### **插件简介**  
本插件为 Typecho 博客系统提供 Cloudflare R2 云存储对接功能，实现将图片、文件等附件直接存储至 R2 对象存储服务，释放服务器本地存储压力，同时借助 Cloudflare 全球 CDN 加速内容分发，提升网站访问速度与稳定性。  


### **核心功能**  
1. **R2 存储无缝对接**  
   - 支持通过 Cloudflare R2 原生 API 上传、修改、删除文件，利用 S3 兼容接口实现高效存储操作。  
   - 自动生成文件访问 URL，支持自定义域名绑定（需在 Cloudflare 配置 CNAME 解析），通过 CDN 加速文件分发。  

2. **灵活的配置管理**  
   - 可视化配置面板，支持填写 R2 账户 ID、访问密钥、存储桶名称等核心参数。  
   - 可选启用日志记录功能，实时追踪文件操作状态（如上传成功/失败、删除记录等），便于调试和故障排查。  

3. **文件管理增强**  
   - 兼容 Typecho 原生附件管理流程，上传文件自动按年月路径归档（如 `2025/05/`），支持自定义文件命名规则（UUID 生成）。  
   - 无缝替换 Typecho 内置文件处理逻辑，附件删除时同步删除 R2 存储中的文件，确保数据一致性。  

4. **连接测试与监控**  
   - 提供“测试连接”功能，一键验证 R2 存储桶可用性及权限配置是否正确。  
   - 后台集成状态提示，直观显示连接结果（成功/失败）及错误信息。  


### **使用场景**  
- **静态资源存储**：将图片、CSS、JS 等静态文件存储于 R2，降低服务器负载，提升页面加载速度。  
- **大文件管理**：支持上传大文件（受限于 Cloudflare R2 规范），适合博客、论坛等内容型站点。  
- **数据备份与容灾**：通过 R2 实现文件异地存储，避免本地服务器数据丢失风险。  


### **安装与配置**  
#### **安装步骤**  
1. 下载插件压缩包，解压后将文件夹重命名为 `R2Storage`，上传至 Typecho 站点的 `usr/plugins/` 目录。  
2. 进入 Typecho 后台 → **插件管理**，找到“Cloudflare R2 存储”插件，点击“启用”。  

#### **配置指引**  
1. **获取 R2 配置参数**：  
   - **账户 ID**：登录 [Cloudflare Dashboard](https://dash.cloudflare.com/)，进入 R2 服务页面查看。  
   - **访问密钥**：在 R2 存储桶设置中创建新的 API 令牌，获取 Access Key ID 和 Secret。  
   - **存储桶名称**：在 R2 中创建的存储桶名称（区分大小写）。  

2. **填写插件配置**：  
   - 进入插件设置页面，依次填入账户 ID、访问密钥、存储桶名称，可选填写自定义域名（如 `https://cdn.yourdomain.com`）。  
   - 点击“测试连接”，验证配置是否正确。若成功，插件将显示“连接成功，R2 存储桶可用”。  

3. **启用日志（可选）**：  
   - 将“日志记录”设置为“启用”，插件将在 `usr/plugins/R2Storage/logs/` 目录生成操作日志，便于排查问题。  


### **注意事项**  
1. **自定义域名配置**：  
   - 自定义域名需先在 Cloudflare 域名管理中添加 CNAME 记录，指向 `*.r2.cloudflarestorage.com`，并确保 SSL 证书已正确配置（建议使用 Cloudflare 免费证书）。  

2. **权限要求**：  
   - 确保访问密钥拥有存储桶的 `s3:PutObject`、`s3:GetObject`、`s3:DeleteObject` 权限，可在 R2 存储桶 ACL 中配置。  

3. **文件类型限制**：  
   - 支持 Typecho 允许的所有附件类型，文件上传时自动校验扩展名（如图片、文档、压缩包等）。  


### **更新日志**  
- **v1.0.0（首发版本）**：  
  - 实现基础文件上传、修改、删除功能。  
  - 支持自定义域名与原生 R2 域名访问。  
  - 集成连接测试与日志记录功能。  


### **联系方式**  
- **作者邮箱**：admin@tz520.cc  
- **问题反馈**：通过插件项目页面或 Typecho 后台留言提交 Bug 或建议。  

通过本插件，您可以轻松将 Typecho 站点的文件存储迁移至 Cloudflare R2，享受低成本、高可靠性的云存储服务，同时借助 Cloudflare 全球网络加速内容分发，提升用户访问体验。