
FileKoalaUpload - Typecho 文件考拉上传插件
- 图床上传:自动识别图片格式(JPG、PNG、GIF、WebP等),上传到文件考拉图床
- 文件上传:
- 小文件(低于阈值):自动永久保存,无下载次数限制
- 大文件(超过阈值):提醒用户手动上传,避免误操作
- 简单配置:只需在插件设置中配置API密钥即可使用
- 将
FileKoalaUpload 文件夹上传到 /usr/plugins/ 目录
- 登录Typecho后台,进入「控制台」→「插件」
- 启用「FileKoalaUpload」插件
- 点击插件设置,配置API信息
- API基础URL:文件考拉API的基础URL,例如
https://yourdomain.com/api
- Access Key:在文件考拉平台生成的Access Key
- Secret Key:在文件考拉平台生成的Secret Key
- 大文件阈值(MB):默认50MB,超过此大小的文件将被视为大文件
- 启用图床上传:是否启用图片自动上传到图床(默认:是)
- 启用文件上传:是否启用普通文件上传功能(默认:是)
- 访问文件考拉平台
- 登录账号
- 进入「用户中心」→「API密钥」页面
- 生成新的Access Key和Secret Key
- 将密钥填入插件配置中
安装并配置完成后,在编辑文章时:
- 点击编辑器工具栏的「上传」按钮
- 选择要上传的文件
- 插件会自动:
- 图片 → 上传到图床
- 小文件 → 永久保存到文件存储
- 大文件 → 提示手动上传
- 检测文件是否为图片格式
- 调用
POST /api/v1/image/upload 接口上传
- 返回图片URL及缩略图URL
- 计算文件MD5和大小
- 调用
POST /api/v1/file/presignedUrl 获取预签名URL
- 使用预签名URL直接上传到S3存储
- 调用
POST /api/v1/file/confirm 确认上传
- 设置下载次数为0(不限制),有效期为永久
- Typecho 1.0+
- PHP 5.6+
- 需要cURL扩展支持
- 请妥善保管API密钥,不要泄露
- 大文件上传建议直接使用文件考拉平台,避免服务器超时
- 插件会自动回退到Typecho默认上传方式,确保上传功能始终可用
- 初始版本发布
- 支持图片上传到图床
- 支持文件自动上传和大小判断
- 支持大文件提示功能
MIT License
Your Name
如有问题或建议,请在GitHub提交Issue。