# AliOssForTypecho v2.0.0
Typecho 阿里云 OSS 附件上传插件，基于 aliyun-oss-php-sdk 2.7.3。
环境要求
- PHP >= 7.2（推荐 PHP 8.0+，支持 PHP 8.4）
- Typecho 1.3+
- 阿里云 OSS Bucket 及 AccessKey
特性
| 特性 | 说明 |
|---|---|
| 签名版本 | 支持 V1（默认）和 V4（推荐），V4 更安全 |
| 大文件分片上传 | 开启后超过 5MB 的文件自动分片上传 |
| 缩略图 | 自定义宽高，URL 自动附加 x-oss-process=image/resize |
| WebP 转换 | 开启后自动附加 format,webp 参数，减小体积 |
| 图片质量压缩 | 支持 1-100 整数，仅对 JPG/WebP 有效 |
| 本地备份 | 可保留服务器端文件副本 |
安装
- 将
AliOssForTypecho目录放入usr/plugins/ - 进入 Typecho 后台 → 控制台 → 插件
- 找到 AliOssForTypecho，点击 启用
- 启用后点击 设置，填写 OSS 连接信息并保存
配置说明
基础配置（必填）
| 配置项 | 说明 |
|---|---|
| Bucket名称 | 阿里云 OSS Bucket 名称 |
| AccessKey ID | 阿里云 RAM 用户的 AccessKey ID |
| AccessKey Secret | 阿里云 RAM 用户的 AccessKey Secret |
| 区域选择 | OSS Bucket 所在地域 |
| 连接方式 | 外网 / 内网（同地域 ECS 使用内网免流量费） |
| 存储路径 | OSS 中的存储目录，以 / 结尾 |
上传配置
| 配置项 | 说明 |
|---|---|
| 签名版本 | V1（默认）/ V4（推荐，需正确填写区域） |
| 大文件分片上传 | 开启后 >5MB 文件自动分片 |
图片处理
| 配置项 | 说明 |
|---|---|
| 缩略图宽度/高度 | 如 200x200，可单独设置或留空不启用 |
| WebP 转换 | 开启后自动转换图片为 WebP 格式 |
| 图片质量 | 1-100，如 80 表示 80% 质量 |
卸载
- 在插件管理页面点击 禁用
- 删除
usr/plugins/AliOss/目录
常见问题
启用插件后提示"即插即用"无法设置？
请确认插件目录名正确为 AliOssForTypecho，且 Plugin.php 文件存在。
上传图片后 URL 不显示处理参数？
请确认已配置 Bucket 名称和 AccessKey，并检查 Bucket 区域选择是否正确。
V4 签名上传失败？
V4 签名依赖正确的区域配置，请检查 Endpoint 是否与 Bucket 所在区域一致。
重要提醒
日志与权限
为保证正确记录日志，请赋予以下目录写权限：
/www/sites/oyzm.cn/index/usr/uploads/ SELinux 用户请合理配置安全上下文，允许 Web 写入该目录。
定期查阅日志，及时处理异常事件。
上传失败处理
当文件成功上传到 OSS，但保存到服务器失败时，总体进度会显示 失败。
OSS 中的文件不会自动删除，请根据错误日志手动清理。
说明
AliOssForTypecho V2.0.0 基于 droomo 作者原版插件改造的 AliOSS 存储插件 原作者链接：https://www.droomo.top/AliOssForTypecho.html
优化升级作者：王大锤 - https://blog.wzu.me/chajian/alioss.html
插件截图
下载地址：
本文设置了评论可见，请在下方评论后刷新页面查看正文。去评论
测试
谢谢大佬