au_oss 阿里云OSS对象储存插件

插件介绍

au_oss 是专为 Z-Blog 开发的阿里云对象存储（OSS）插件，可以将网站上传的附件自动同步到阿里云 OSS，实现静态资源的云存储，减轻服务器压力，提高网站访问速度。

功能特性

• ✅ 自动上传：文章附件上传时自动同步到阿里云 OSS

• ✅ 多种模式：支持三种上传策略，灵活满足不同需求

• ✅ 批量同步：一键同步历史附件到阿里云 OSS

• ✅ 链接替换：一键替换文章内容中的附件链接

• ✅ 附件预览：附件管理中直接预览 OSS 上的图片

安装说明

1. 在应用中心下载本插件

2. 登录 站点 后台，进入「插件管理」

3. 找到「阿里云OSS对象储存」插件，点击「启用」

配置说明

基本配置

在插件启用后，点击「配置」进入设置页面。

上传模式

插件提供三种上传模式：

1. 保留本地_返回OSS直链

• 本地服务器保留文件副本

• 前端访问使用 OSS 直链

• ✨ 推荐：兼顾访问速度和数据安全

2. 删除本地_返回OSS直链

• 上传成功后删除本地服务器文件

• 前端访问使用 OSS 直链

• 💾 节省服务器存储空间

3. 保留本地_返回本地链接

• 仅作为 OSS 备份使用

• 前端访问仍使用本地链接

• 🛡️ 适用于数据灾备场景

OSS预览

• 勾选后在附件管理页面可以看到 OSS 附件的预览图

• 仅对图片类型文件生效

阿里云控制台配置指南

1. 获取 AccessKey

1. 登录 阿里云 RAM 控制台

2. 点击「创建 AccessKey」

3. 保存生成的 AccessKeyId 和 AccessKeySecret

4. ⚠️ 注意：AccessKeySecret 只显示一次，请妥善保管

2. 创建 OSS Bucket

1. 登录 阿里云 OSS 控制台

2. 点击「创建 Bucket」

3. 设置 Bucket 名称和地域

4. 存储类型选择「标准存储」

5. 读写权限设置为「公共读」

3. 地域说明

常用地域列表：

同步功能使用

同步历史附件

1. 进入「阿里云OSS同步」页面

2. 点击「开始同步」

3. 插件会自动遍历所有附件，逐个上传到 OSS

4. 同步过程可以随时停止，支持断点续传

链接替换

同步完成后，需要将文章内容中的附件链接替换为 OSS 链接：

• 一键替换附件为 OSS 链接：将所有本地域名替换为 OSS 域名

• 一键替换附件为本地链接：将所有 OSS 域名换回本地域名（回滚操作）

⚠️ 重要提示：

• 一键替换有风险，操作前请务必备份数据库

• 该功能仅处理文章内容中的链接，不涉及文件同步/下载

常见问题

Q1: 上传失败怎么办？

A: 检查以下几点：

1. AccessKeyId 和 AccessKeySecret 是否正确

2. Bucket 名称和地域是否匹配

3. OSS Bucket 是否设置为「公共读」权限

4. 服务器网络是否能正常访问阿里云 OSS

Q2: 配置好后还是显示本地链接？

A:

1. 确认「插件状态」已勾选启用

2. 确认「上传模式」不是「仅备份」模式

3. 新上传的附件才会生效，历史附件需要手动同步

Q3: 同步时出现超时错误？

A: 请修改 php.ini 配置：

max_execution_time = 300
memory_limit = 256M

Q4: 更换域名后怎么办？

A:

1. 修改插件配置中的「域名」

2. 执行「一键替换附件为 OSS 链接」更新文章内容

注意事项

1. 目录修改：「保存目录」一旦投入使用，请勿随意更改，否则历史附件链接会失效

2. 数据备份：执行任何数据库操作前（如链接替换），请务必备份数据库

3. 权限设置：OSS Bucket 需要设置「公共读」权限，否则图片无法正常访问

4. 费用说明：使用阿里云 OSS 会产生相应的存储和流量费用，请参考阿里云官方定价

技术支持

• 作者：@神经元

• 邮箱：shejiz@qq.com

• 博客：https://blog.rcku.cn

更新日志

v0.0.1 (2026-04-16)

• 初始版本发布

• 实现基础的 OSS 上传功能

• 支持批量同步和链接替换

许可证

本插件采用 MIT 许可证开源。