logo
0
0
WeChat Login

FileKoalaUpload - Typecho 文件考拉上传插件

功能特性

  • 图床上传:自动识别图片格式(JPG、PNG、GIF、WebP等),上传到文件考拉图床
  • 文件上传
    • 小文件(低于阈值):自动永久保存,无下载次数限制
    • 大文件(超过阈值):提醒用户手动上传,避免误操作
  • 简单配置:只需在插件设置中配置API密钥即可使用

安装方法

  1. FileKoalaUpload 文件夹上传到 /usr/plugins/ 目录
  2. 登录Typecho后台,进入「控制台」→「插件」
  3. 启用「FileKoalaUpload」插件
  4. 点击插件设置,配置API信息

配置说明

必填配置

  • API基础URL:文件考拉API的基础URL,例如 https://yourdomain.com/api
  • Access Key:在文件考拉平台生成的Access Key
  • Secret Key:在文件考拉平台生成的Secret Key

可选配置

  • 大文件阈值(MB):默认50MB,超过此大小的文件将被视为大文件
  • 启用图床上传:是否启用图片自动上传到图床(默认:是)
  • 启用文件上传:是否启用普通文件上传功能(默认:是)

获取API密钥

  1. 访问文件考拉平台
  2. 登录账号
  3. 进入「用户中心」→「API密钥」页面
  4. 生成新的Access Key和Secret Key
  5. 将密钥填入插件配置中

使用方法

安装并配置完成后,在编辑文章时:

  1. 点击编辑器工具栏的「上传」按钮
  2. 选择要上传的文件
  3. 插件会自动:
    • 图片 → 上传到图床
    • 小文件 → 永久保存到文件存储
    • 大文件 → 提示手动上传

技术细节

图片上传流程

  1. 检测文件是否为图片格式
  2. 调用 POST /api/v1/image/upload 接口上传
  3. 返回图片URL及缩略图URL

文件上传流程

  1. 计算文件MD5和大小
  2. 调用 POST /api/v1/file/presignedUrl 获取预签名URL
  3. 使用预签名URL直接上传到S3存储
  4. 调用 POST /api/v1/file/confirm 确认上传
  5. 设置下载次数为0(不限制),有效期为永久

兼容性

  • Typecho 1.0+
  • PHP 5.6+
  • 需要cURL扩展支持

注意事项

  • 请妥善保管API密钥,不要泄露
  • 大文件上传建议直接使用文件考拉平台,避免服务器超时
  • 插件会自动回退到Typecho默认上传方式,确保上传功能始终可用

版本历史

v1.0.0 (2026-01-28)

  • 初始版本发布
  • 支持图片上传到图床
  • 支持文件自动上传和大小判断
  • 支持大文件提示功能

许可证

MIT License

作者

Your Name

问题反馈

如有问题或建议,请在GitHub提交Issue。

About

文件考拉typecho插件

Language
PHP71.2%
HTML28.8%