阿里云OSS

让博客图片与附件飞上云端

阿里云OSS为 BlogKit 提供开箱即用的阿里云 OSS 对象存储集成：本地上传照常进行，插件自动把文件同步到你的 OSS 桶，并可一键将全站图片/附件地址切换为 OSS 直链——节省服务器带宽、借力阿里云 CDN 加速，而文章内容一个字都不用改。

核心功能

• 实时镜像同步——文章图片、封面、评论图片、用户头像、站点 Logo 上传后自动推送 OSS（含缩略图与 WebP 副本）；同步失败自动记录、可重推，绝不影响本地上传；
• 全站直链切换——输出层替换、内容零改写：开启即走 OSS 直链，关闭立即回退本地，完全可逆；
• 存量迁移——历史附件一键全量同步，断点续传、自动判重；
• 连接测试——配置保存前一键验证，按官方错误码给出具体原因（密钥错误/桶不存在/权限不足/时钟偏差），少走弯路。

使用前提

• 已开通阿里云 OSS 并创建 Bucket（建议公有读）；
• 创建 RAM 子账号并授予该 Bucket 的读写权限（插件配置页附核对清单）；
• 如需直链加速：绑定已备案的自定义域名——OSS 默认域名访问文件会强制下载（新 Bucket 无法关闭该限制），插件会在未绑定域名时阻止开启直链开关并给出引导。

安全与可逆

AccessKey 仅保存在你自己的服务器数据库中，绝不进入前端与日志；本地始终保留完整源文件（云上只是副本），卸载插件后整站自动回退纯本地访问，零残留。